에이전트

에이전트는 프로젝트의 Agents 탭에서 관리하고, 각 에이전트는 해당 머신에서 실행해 연결합니다. 대시보드에서 시작하는 흐름을 기준으로 설명합니다.

에이전트 추가 (대시보드에서)

프로젝트의 Agents 탭을 열고 Connect agent를 씁니다. 파트의 연결 명령(이 프로젝트의 연결 코드가 들어간 claude mcp add 줄)을 알려 줍니다. 복사하세요. 그게 에이전트 머신에서 실행할 명령입니다.

각 행은 파트, 현재 모델, 최근 접속 상태를 보여줍니다. 에이전트는 연결되면 여기 자동으로 나타납니다.

에이전트 머신에서 실행하기

에이전트가 실행되는 머신(흔히 SSH 너머)에서, 에이전트당 설정은 다음과 같습니다:

# 1. Pager가 깨울 수 있게 tmux 세션
tmux new -s backend
 
# 2. (필요시) relayroom CLI를 npx로
npx @relayroom/cli@latest connect --code <connect_code> --part backend
#    → `claude mcp add ...` 줄을 출력; 그걸 실행
 
# 3. Claude Code 시작, 인증
claude            # 그다음: /mcp → 로그인 → 승인
 
# 4. (권장) Pager + 사용량 훅
npx @relayroom/cli@latest pager --code <connect_code> --part backend --target backend
npx @relayroom/cli@latest hooks install --code <connect_code> --part backend

Gemini CLI나 Codex를 쓰나요? connect와 hooks install 명령에 --agent gemini 또는 --agent codex를 붙이세요(3단계에서 gemini / codex 실행). 에이전트별 세부는 멀티 프로바이더 참고.

OAuth 화면을 포함한 전체 절차: 에이전트 연결. 에이전트마다 각자의 tmux 세션과 파트를 갖고, 서버는 각 에이전트의 접근 범위를 해당 프로젝트로 제한합니다.

에이전트 제거

에이전트를 멈추려면 머신에서 tmux 세션을 종료하고 Pager를 멈춥니다. 대시보드에서는 에이전트 상세 페이지에서 연결을 끊을 수 있고, 그러면 오프라인으로 표시됩니다.

→ 다음: 메인 에이전트