설치

relay는 Claude Code 플러그인입니다. 설치하면 Claude Code가 다음을 자동으로 설정합니다:

슬래시 커맨드 2개: /relay:relay, /relay:agent
에이전트 활동을 실시간 대시보드로 스트리밍하는 PostToolUse 훅
에이전트 간 통신을 담당하는 MCP 서버

사전 요구사항

Node.js v18 이상
Claude Code v1.0.33 이상 (claude --version으로 확인)

1단계 — relay 마켓플레이스 추가

Claude Code는 마켓플레이스를 통해 플러그인을 설치합니다. GitHub 저장소에서 relay 마켓플레이스를 추가하세요:

/plugin marketplace add custardcream98/relay

이 명령은 카탈로그만 등록합니다. 아직 플러그인이 설치된 건 아닙니다.

2단계 — 플러그인 설치

relay 플러그인을 user 스코프로 설치하면 모든 프로젝트에서 사용할 수 있습니다:

/plugin install relay@relay

현재 프로젝트에만 설치하려면 --scope project를 붙이세요 (저장소를 공유하는 팀원에게도 적용됩니다):

/plugin install relay@relay --scope project

설치 후 /reload-plugins를 실행하거나 Claude Code를 재시작하세요. 슬래시 커맨드 목록에 /relay:relay와 /relay:agent가 나타나면 됩니다.

3단계 — 에이전트 풀 구성 (선택사항)

relay는 첫 실행 시 프로젝트에 맞는 에이전트 풀을 자동 생성합니다. 이 단계를 건너뛰고 바로 4단계로 가도 됩니다.

직접 팀을 구성하려면 프로젝트 루트의 .relay/agents.pool.yml에 정의합니다. 예시 풀을 복사해서 시작하세요:

curl -O https://raw.githubusercontent.com/custardcream98/relay/main/agents.pool.example.yml
mv agents.pool.example.yml .relay/agents.pool.yml

또는 .relay/agents.pool.yml을 직접 작성합니다. 최소 2인 팀 예시:

agents:
  pm:
    name: Project Manager
    emoji: "📋"
    tags: [planning, coordination]
    tools: [create_task, get_all_tasks, send_message, get_messages, broadcast_thinking]
    systemPrompt: |
      You are the project manager. Break down the user's request into
      concrete tasks and assign them to the team via create_task.

  fe:
    name: Frontend Engineer
    emoji: "🎨"
    tags: [frontend, react, css]
    tools: [claim_task, update_task, post_artifact, send_message, broadcast_thinking]
    systemPrompt: |
      You are a frontend engineer. Claim frontend tasks and implement them.

전체 스키마, 멀티 인스턴스 에이전트(extends), 12인 팀 예시는 에이전트 커스터마이즈를 참고하세요.

4단계 — 설치 확인

간단한 테스트로 설정이 제대로 됐는지 확인합니다:

/relay:relay "hello"

relay가 프로젝트에 맞는 에이전트 풀을 자동 생성하고 세션을 시작합니다. 에이전트가 정상적으로 시작되고 대시보드 URL이 출력에 나타나면 설치 완료입니다.