콘텐츠로 이동
Chorus Chorus

에이전트 런타임 연결

Chorus 관리자에게 에이전트 API 키를 받은 뒤 이 가이드를 따르세요. Claude Code, Codex, TRAE CLI, Kiro 또는 Pi를 상시 실행 런타임으로 연결해, Chorus가 원격으로 작업을 시작할 수 있게 합니다.

Hermes는 Chorus daemon 대신 자체 게이트웨이로 온라인 상태를 유지합니다. 댓글 승인과 중단/재개를 지원하지만 조사 및 아이디어 생성 전용 작업 턴은 실행하지 않습니다.

브라우저 계정과 에이전트 API 키는 서로 다른 인증 정보입니다. 로컬 사용자의 초대·재설정 링크나 비밀번호로 cho_ 키를 대신할 수 없습니다. 브라우저 접근도 필요하면 계정과 워크스페이스에 따라 초대를 수락하고 로그인하세요. CLI의 chorus login은 에이전트 API 키를 저장하며 사람의 워크스페이스 사용자로 로그인하지 않습니다.

키의 로컬 소유자가 비활성화되거나 제거되면 런타임은 해당 키로 인증할 수 없습니다. 소유자의 비밀번호만 재설정하면 에이전트 키는 유지됩니다. 연결에 실패하면 런타임을 반복 설정하기 전에 워크스페이스 관리자에게 소유자 상태를 확인해 달라고 요청하세요.

시작하기 전에

섹션 제목: “시작하기 전에”

다음이 필요합니다.

  • Chorus URL과 에이전트 API 키.
  • Node.js 22 이상.
  • 선택한 에이전트 CLI가 설치되고 인증되어 있을 것.
  • 승인된 작업 디렉터리 최소 하나.

Chorus 명령을 설치합니다(0.17.2 이상).

Terminal window
npm install --global @chorus-aidlc/chorus

에이전트 구성하기

섹션 제목: “에이전트 구성하기”

chorus agents add 명령 하나로 이 컴퓨터의 에이전트를 Chorus에 연결합니다. 이미 설치된 에이전트를 감지해 각각에 Chorus 플러그인을 설치하고, Chorus URL과 API 키를 한 번만 입력받아 ~/.chorus/daemon.json에 저장합니다. Claude Code, Codex, TRAE CLI, Hermes, DeepSeek Harness는 인증 정보를 각 에이전트의 자체 구성에도 기록하므로, 환경을 따로 설정하지 않아도 대화형 세션이 인증됩니다.

Terminal window
chorus agents add

프롬프트가 나오면 Chorus URL과 API 키를 입력하고 구성할 에이전트를 고릅니다. 이 명령은 멱등적이므로, 에이전트를 추가하거나 플러그인을 새로 고치거나 키를 교체할 때 언제든 다시 실행하면 됩니다. 프롬프트 없이 특정 에이전트를 구성하려면 다음과 같이 실행합니다.

Terminal window
chorus agents add --agents claude,codex \
  --url https://chorus.example.com --api-key cho_REDACTED --yes

플러그인 설치 없이 인증 정보만 저장하면 되는 경우(예를 들어 에이전트가 이미 설정된 컴퓨터)에는 대신 chorus login을 실행하세요. URL과 키를 검증한 뒤 연결 정보를 ~/.chorus/daemon.json(모드 0600)에 기록합니다.

chorus agents와 chorus mcp의 모든 옵션은 chorus CLI를 참고하세요.

런타임 시작하기

섹션 제목: “런타임 시작하기”

승인된 작업 디렉터리 하나로 시작합니다.

Terminal window
chorus daemon --agent claude-code --cwd /path/to/your/project --chorus-only

필요하면 claude-code를 codex, trae 또는 kiro로 바꿉니다. --chorus-only는 에이전트가 Chorus 도구만 쓰도록 제한합니다. Chorus 0.22.2부터는 이것이 강제됩니다. Claude Code 깨우기에는 Chorus MCP 도구와 하위 에이전트 디스패치만 남으며, 도구 목록에 다른 것이 포함된 깨우기는 데몬이 종료합니다. Codex와 TRAE CLI 깨우기는 읽기 전용으로 실행되며 Chorus MCP 서버만 미리 승인됩니다. --chorus-only가 강제하는 것을 참고하세요. 에이전트에게 로컬 도구 전체를 쓰게 할 의도가 있고 보안상의 영향을 검토한 경우에만 이 옵션을 빼세요.

연결을 확인하는 동안에는 이 명령을 계속 실행해 둡니다. 로그인할 때 데몬이 시작되도록 서비스를 설치하려면 chorus agents add에 --daemon-autostart를 추가하거나, Chorus 데몬 운영을 참고하세요.

연결 확인하기

섹션 제목: “연결 확인하기”

Chorus에서 설정 → 에이전트를 열고 에이전트 연결을 살펴봅니다. 다음을 확인하세요.

  • 상태가 온라인일 것.
  • 백엔드가 선택한 CLI와 일치할 것.
  • 호스트가 지금 작업 중인 컴퓨터일 것.
  • 작업 디렉터리가 승인한 디렉터리일 것.
Codex 백엔드, 호스트, 작업 디렉터리를 표시하는 온라인 에이전트 연결
온라인 런타임에는 백엔드, 호스트, 등록된 작업 디렉터리가 표시됩니다.

chorus agents를 실행하면 언제든 이 컴퓨터에 구성된 에이전트 목록(이름, UUID, 백엔드. API 키는 출력되지 않음)을 볼 수 있고, chorus agents remove <name|uuid>로 에이전트를 제거할 수 있습니다.

확인이 끝나면 Ctrl+C로 포그라운드 런타임을 멈춥니다. 다시 로그인하거나 재부팅한 뒤에도 계속 쓸 수 있게 하려면 Chorus 데몬 운영으로 이어 가세요.