제안서 자동화 harness를 쓰기 위한 환경을 한 번에 준비합니다. git · GitHub CLI · Claude Code를 설치하고, GitHub 접근 토큰을 저장한 뒤, CONTRL 플러그인까지 설치를 마칩니다. 설치가 끝나면 Claude Desktop의 Claude Code 화면이 자동으로 열리고 입력창에 /contrl:setup 이 채워져 있습니다. Enter를 눌러 실행하면 됩니다. 자동으로 열리지 않으면 Claude Desktop을 직접 열어 입력하세요. (자동 열기는 macOS에서만 확인했고 Windows는 아직 검증 전입니다.)
아래 3단계가 끝나야 설치가 됩니다. 순서를 건너뛰면 마지막에 실패합니다.
- GitHub 계정을 만듭니다 (이미 있으면 그대로 씁니다).
- 계정 ID를 담당자에게 알려줍니다.
- 초대 메일을 받으면 수락합니다.
macOS · Linux — 터미널에서:
bash -c "$(curl -fsSL https://raw.githubusercontent.com/cliwant/contrl-setup/main/install.sh)"
Windows — 시작 메뉴에서 Windows PowerShell을 열고:
irm https://raw.githubusercontent.com/cliwant/contrl-setup/main/install.ps1 | iex
실행 중 GitHub 토큰을 입력하는 화면이 나옵니다. 화면에 표시된 토큰 발급 주소를 브라우저에서 열어 토큰을 만들고, 생성된 값을 복사해 붙여넣으면 됩니다. 입력한 값은 보안상 화면에 표시되지 않습니다.
설치 실패 메시지에서 가장 흔한 원인은 두 가지입니다. 토큰을 만들 때 repo 항목을 체크하지 않았거나, 초대 메일을 아직 수락하지 않은 경우입니다. 둘 다 확인했는데도 실패하면 담당자에게 화면에 나온 메시지를 그대로 전달해 주세요.