콘텐츠로 이동
Chorus Chorus

시작하기

이 가이드는 새 컴퓨터에서 시작해 로컬에서 동작하는 Chorus 설치까지 안내합니다. Node.js 22 이상과 npm이 필요합니다.

Chorus 설치하고 실행하기

섹션 제목: “Chorus 설치하고 실행하기”

Chorus 명령을 전역으로 설치합니다.

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

단일 사용자용 Default Auth 계정을 설정하고 Chorus를 실행합니다.

Terminal window
DEFAULT_USER=you@example.com \
DEFAULT_PASSWORD='choose-a-strong-password' \
chorus

Chorus는 로컬 데이터베이스를 만들고 필요한 마이그레이션을 적용한 뒤 웹 애플리케이션을 시작합니다. Chorus를 사용하는 동안에는 이 터미널을 열어 두세요.

로그인하기

섹션 제목: “로그인하기”

http://localhost:8637을 열고 위의 이메일을 입력한 뒤 계속을 선택합니다. 여러 ID가 표시되면 기본 비밀번호 계정을 선택하고 비밀번호를 입력합니다. 이 환경 변수 기반 계정은 슈퍼 관리자나 관리되는 로컬 워크스페이스 관리자가 아닙니다. 공용 컴퓨터에서는 값이 셸 기록에 남지 않게 하세요.

내장 데이터베이스는 로컬 단일 사용자용입니다. 공유 설치에서는 외부 PostgreSQL 또는 지원되는 Docker 배포를 사용하세요. 슈퍼 관리자와 인증 설정에서 OIDC 워크스페이스 또는 초기 관리자를 초대하는 로컬 계정 워크스페이스를 생성합니다. 개별 계정 대신 Default Auth 비밀번호를 공유하지 마세요. 로컬 사용자는 비공개 초대를 수락해 비밀번호를 설정하고 사용자 이름이나 이메일로 로그인합니다. 계정과 워크스페이스를 참고하세요.

에이전트 연결하기

섹션 제목: “에이전트 연결하기”
  1. 설정(Settings)을 엽니다.
  2. 설정 가이드를 찾아 설정 가이드 열기를 선택합니다.
  3. 에이전트 플랫폼을 선택합니다.
  4. 표시되는 설치와 연결 단계를 따릅니다.
  5. 가이드의 연결 확인을 완료합니다.

설정 가이드는 필요한 에이전트 인증 정보를 만들고, 선택한 플랫폼에 맞는 명령을 제공합니다. 다른 플랫폼의 명령을 재사용하지 마세요.

터미널이 더 편한가요? CLI를 설치하고 명령 하나만 실행하면 됩니다.

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

chorus agents add는 이미 설치되어 있는 에이전트를 감지하고, 각각의 Chorus 플러그인을 설치하며, 인증 정보를 설정합니다. chorus CLI와 에이전트 런타임 연결을 참고하세요.

플랫폼 비교, Chorus 플러그인 구성, 업그레이드와 제거 방법 등 에이전트 구성의 전체 그림은 에이전트 플랫폼을 참고하세요. 액세스 키, 원격 시작, 런타임을 온라인으로 유지하는 방법은 에이전트 액세스 준비를 비롯한 에이전트 설정 가이드에서 다룹니다.

다음에 할 일을 선택하세요.

  • 에이전트 터미널에서 사용: 플랫폼 체크인을 완료합니다. OpenCode와 범용 MCP 클라이언트는 대화형 전용입니다.
  • 원격 실행: Claude Code, Codex, TRAE CLI, Kiro, Pi는 Chorus daemon을 사용합니다. 연결 설정 후 세션을 시작합니다. OpenClaw와 Hermes는 자체 게이트웨이를 사용합니다. DeepSeek Harness는 별도 설정이 있으며 기본 등록은 offline입니다.

컴퓨터나 인증 정보를 다른 사람이 관리한다면 에이전트 액세스 준비부터 시작하세요.

첫 아이디어 돌려보기

섹션 제목: “첫 아이디어 돌려보기”

Chorus가 실행되고 에이전트가 연결되었다면 실제로 일을 시켜 봅시다. 전체 흐름을 가장 빠르게 확인하는 방법은 작은 아이디어 하나를 처음부터 끝까지 돌려 보는 것입니다.

  1. 작업을 담을 프로젝트를 생성합니다.
  2. 아이디어를 기록합니다. 작고 실제적인 것이면 됩니다(예: “이 저장소에 README를 추가한다”). 그리고 에이전트의 요구사항 구체화 질문에 답합니다.
  3. 에이전트가 초안을 작성한 제안을 검토하고 승인합니다.
  4. 에이전트에게 작업을 실행하게 한 뒤 결과를 검증하고 완료합니다.

요청이 아이디어에서 완료까지 어떻게 흘러가고 어디에서 사용자가 결정을 내리는지 전체 그림을 보려면 AI-DLC 워크플로를 읽으세요. 단계마다 자세한 가이드로 안내해 줍니다.