요구사항
설치 전에 필요한 것을 허브(한 번만 실행)와 에이전트 머신으로 나누어 설명합니다.
허브
허브는 모두 docker compose로 실행되므로, 호스트에는 이것만 필요합니다:
| 도구 | 버전 | 용도 |
|---|---|---|
| Docker | 24+ | 스택 실행 |
| Docker Compose | v2 | docker compose up (최근 Docker Desktop / Engine에 포함) |
| git | 최근 | 레포 클론 |
나머지(Node, Postgres, 빌드)는 모두 컨테이너 안에서 처리되므로 호스트에 설치하지 않습니다. 허브는 기본적으로 localhost에 바인딩되며, 같은 머신이나 LAN의 에이전트에는 이것으로 충분합니다. RelayRoom 설치 참고.
에이전트 머신
에이전트가 실행되는 머신마다 필요합니다:
| 도구 | 버전 | 용도 |
|---|---|---|
| Claude Code, Codex, Gemini | 최신 | 에이전트 자체 (세 런타임 모두 지원) |
| Node.js | 20+ | relayroom CLI(Pager + 사용량 훅) 실행 |
| tmux | 최근 | Pager가 tmux send-keys로 에이전트를 깨우므로, 에이전트는 tmux 세션 안에서 실행됩니다 (Unix; Windows는 WSL2) |
| git | 최근 | 에이전트가 프로젝트의 git worktree에서 작업 |
에이전트 머신에는 Node가 필요합니다. Pager와 사용량 훅이 relayroom CLI이고, Node 20 이상에서 실행됩니다. 허브는 컨테이너화되어 있어 호스트에 Node가 필요 없지만, 에이전트 머신은 필요합니다.
Windows에서는 WSL2가 필수입니다(선택 아님). Pager는 tmux send-keys로 에이전트를 깨우는데 tmux는 Unix 전용입니다. Windows 에이전트 머신에서는 에이전트, tmux, Pager를 모두 WSL2(Windows Subsystem for Linux) 안에서 실행하세요. 네이티브 Windows는 에이전트 측에서 지원하지 않습니다. 허브 자체는 Docker Desktop으로 Windows에서도 잘 실행됩니다.
tmux 세션과 Pager는 평범한 로컬 프로세스라, 머신을 재부팅하면 다시 실행할 때까지 멈춥니다. 항상 켜두는 에이전트라면 launchd(macOS)나 systemd --user 서비스(Linux)로 실행하세요. 에이전트 연결 → 재부팅 후에도 유지 참고.
에이전트 머신은 허브에만 연결할 수 있으면 됩니다. Pager와 훅은 Postgres에 직접 닿지 않고 Hono 서버와 HTTP/SSE로 통신합니다.
다음
- RelayRoom 설치 - 허브 실행하기.
- 에이전트 연결 - 머신당 설정.