시작하기 전에: 터미널은 해커의 전유물이 아닙니다
터미널의 검은 화면을 마주하면 왠지 무섭고 어렵게 느껴질 수 있습니다. 하지만 터미널은 마우스 클릭 대신 "키보드로 컴퓨터에게 일을 시키는 채팅창" 일 뿐입니다.
오타가 나거나 잘못된 명령어를 입력해도 컴퓨터가 고장 나지 않으니, 편안하고 가벼운 마음으로 한 단계씩 따라 해보세요.

📌 한눈에 보는 실습 로드맵

🧩 도구 설치 및 환경 의존성 구조

[사전 준비] 터미널(PowerShell) 관리자 권한으로 열기

터미널 도구를 설치할 때는 시스템 권한이 필요합니다. 반드시 관리자 권한 으로 실행해 주세요.
  1. 키보드의 Windows 로고 키 를 누르고 키보드로 powershell 을 입력합니다.
  2. 검색 결과 맨 위에 나타나는 Windows PowerShell 글자 위에 마우스 우클릭을 합니다.
  3. 메뉴에서 관리자 권한으로 실행 을 클릭합니다.
  4. "이 앱이 디바이스를 변경할 수 있도록 허용하시겠습니까?"라는 팝업창이 나타나면 [예] 를 누릅니다.
💡 터미널 복사 & 붙여넣기 꿀팁
튜토리얼 속 회색 코드 박스의 명령어를 복사(Ctrl + C)한 다음, 파워쉘 창 위에서 마우스 오른쪽 버튼을 딸깍 한 번만 누르면 자동으로 복사한 글자가 입력창에 붙여넣어집니다.

0단계: 윈도우 보안 빗장 풀기 (1회성 필수 작업)

윈도우는 알 수 없는 스크립트 파일이 실행되는 것을 기본적으로 막아두고 있습니다. 설치 프로그램이 정상적으로 동작하도록 이 빗장을 한 번만 열어줍니다.

파워쉘 창에 다음 명령어를 붙여넣고 Enter 를 누릅니다.
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
  • 체크포인트:
    명령어 실행 후 화면에 다음과 같은 확인 문구가 나타날 수 있습니다.
    실행 규칙 변경... [Y] 예(Y) [A] 모두 예(A) [N] 아니요(N)...
    이때 당황하지 마시고 키보드로 알파벳 대문자 Y 를 입력한 뒤 Enter 를 누르시면 됩니다.

1단계: 설치 방식 선택하기

사용자의 컴퓨터 상황에 맞게 3가지 경로 중 하나를 선택할 수 있습니다. 비개발자분들에게는 1번 경로를 강력히 권장합니다.
순위설치 경로권장 대상핵심 특징
추천방법 1. 윈도우 기본 패키지 관리자 (winget)모든 비개발자 (가장 간단)추가 프로그램 설치 없이 윈도우 기본 탑재 기능으로 1줄 해결
대안방법 2. Node.js 패키지 관리자 (npm)기존 개발 도구 보유자PC에 이미 Node.js가 깔려 있을 경우 익숙하게 설치 가능
대안방법 3. 공식 바이너리 직접 다운로드 (.exe)명령어 방식이 자꾸 막히는 분GitHub 릴리즈에서 실행 파일을 직접 받아 특정 폴더에 보관

2단계: Herdr 설치 및 정상 작동 확인

가장 안전하고 쉬운 방법 1 (winget) 기준으로 진행합니다.

1. 설치 명령어 입력

파워쉘 창에 아래 명령어를 복사해 넣고 Enter 를 누릅니다.
winget install herdr
(참고: 만약 사내 보안 정책 등으로 winget이 지원되지 않고 Node.js가 설치된 환경이라면 npm install -g herdr 명령어로도 설치가 가능합니다.)
다운로드 진행률 바가 100%까지 채워지며 성공적으로 설치되었습니다라는 녹색/흰색 문구가 뜹니다.
image.png

2. 설치 성공 여부 검증 (체크포인트)

설치 직후 컴퓨터가 Herdr를 잘 인식했는지 확인합니다. 파워쉘에 아래 명령어를 입력하고 Enter 를 누릅니다.
herdr --version
화면에 herdr 0.x.x처럼 버전 번호 숫자가 출력된다면 설치가 100% 성공한 것입니다.
⚠ 트러블슈팅: "명령어를 찾을 수 없습니다"라는 빨간 에러가 떴나요?
새 도구가 깔렸을 때 윈도우가 경로(PATH)를 즉시 갱신하지 못해 나타나는 아주 흔한 현상입니다.
해결법: 지금 켜져 있는 파워쉘 창을 닫고, 파워쉘을 새로 다시 열어 herdr --version을 다시 입력해 보세요. 90% 이상 정상 인식됩니다.
image.png

3단계: 첫 실행과 화면 좌/우 쪼개기 (와우 모먼트)

이제 여러 AI 직원들이 동시에 상주할 "디지털 칸막이 사무실"을 열 차례입니다.

1. Herdr 관제 환경 띄우기

파워쉘 창에 아래 명령어를 입력하고 Enter 를 칩니다.
herdr

일반 터미널 창의 테두리가 정돈되며 세련된 Herdr 관제 작업창으로 바뀝니다.

image.png
image.png

2. 마법의 단축키: 화면을 좌우로 반 가르기

마우스를 쓰지 않고 키보드 단축키만으로 화면을 좌/우 2분할합니다.

  • 화면 분할 조작:
    1. 키보드의 Ctrl 키를 누른 상태에서 B 키를 누릅니다.
    2. 두 키에서 손을 완전히 뗍니다.
    3. 곧바로 키보드의 V 키를 누릅니다.
image.png
  • 결과 확인:
    화면 중앙에 수직 구분선이 생기며 왼쪽 방과 오른쪽 방으로 깔끔하게 쪼개집니다.
    • 왼쪽 방 (작업자 자리): 일꾼 에이전트(OpenCode 워커)가 초안을 작성하고 코드를 만드는 공간
    • 오른쪽 방 (검수자 자리): 검수 에이전트(OpenCode 리뷰어)가 팩트체크와 버그 검수를 맡는 공간
  • Opencode 실행 / 종료
    image.png
image.png

3. 방과 방 사이 자유롭게 이동하기

  • 창 이동 조작:
    1. Ctrl + B 를 누른 뒤 손을 뗍니다.
    2. 키보드 hjkl 를 누릅니다.
  • 깜빡이는 커서가 왼쪽과 오른쪽 창을 경쾌하게 오가는 것을 확인할 수 있습니다.
    image.png

4단계: 비상 탈출구 (패닉 방지 안전망)

터미널 작업 중 글자가 멈추거나 원치 않는 상황이 되어도 컴퓨터에는 아무런 해가 없습니다. 아래 세 가지만 기억해 두세요.

  1. 실행 중인 작업 멈추기 (브레이크):
    어떤 프로그램이 혼자 계속 돌거나 멈췄을 때는 키보드의 Ctrl + C 를 두세 번 연속으로 누릅니다.
  2. 분할 창 하나만 닫기:
    작업이 끝난 방에서 exit 를 타이핑하고 Enter 를 치면 해당 분할 창만 깔끔하게 사라집니다.
  3. 최후의 비상구 (완전 리셋):
    어떻게 수습해야 할지 모를 때는 파워쉘 창 맨 오른쪽 위의 X (닫기) 버튼을 마우스로 클릭해 창을 강제로 닫아버려도 무방합니다.

🎉 축하합니다! 관제탑 준비가 완료되었습니다

이제 혼자 일하는 답답한 단일 챗봇 창에서 벗어나, 한 화면에서 두 명 이상의 AI 직원을 일사불란하게 지휘할 수 있는 관제 공간 을 완성하셨습니다.
다음 튜토리얼에서는 준비된 왼쪽과 오른쪽 창에 가성비 뛰어난 실행 일꾼인 오픈코드(OpenCode) 를 각각 띄우고, 사람이 일일이 복사/붙여넣기를 하지 않아도 두 에이전트가 알아서 검수와 수정을 반복하는 실전 자가 수정 파이프라인(Self-Correction Loop) 을 함께 구성해 보겠습니다.