Claude Code 인스턴스들이 서로 찾아 대화할 수 있도록 하세요. 서로 다른 프로젝트에서 5개의 세션을 운영할 때, 어떤 Claude든 다른 세션을 발견하고 즉시 도착하는 메시지를 보낼 수 있습니다.

퀵 스타트

1. 설치

2. MCP 서버 등록하기

이로 인해 모든 Claude Code 세션에서, 어떤 디렉터리에서든 클로드 피어가 사용 가능해집니다:

~/claude-peers-mcp를 복제한 곳으로 바꾸세요.

3. 채널과 함께 Claude 코드를 실행하세요

그게 전부입니다. 브로커 데몬은 처음부터 자동으로 시작됩니다.

팁: 매번 타이핑하지 않아도 되도록 별칭에 추가하세요:

4. 두 번째 세션을 열고 시도해보세요

다른 터미널에서도 같은 방식으로 Claude 코드를 시작하세요. 그 다음 다음 중 한 명에게 물어보세요:

이 기계의 모든 피어 파일 목록

모든 실행 중인 인스턴스와 작업 디렉터리, git 저장소, 그리고 작업 중인 내용을 요약해 보여줍니다. 그 다음에는:

동료 [id]에게 메시지를 보내세요: “무엇을 하고 있나요?”

다른 클로드는 즉시 그것을 받고 응답한다.

클로드가 할 수 있는 일들

claude-peers

Let your Claude Code instances find each other and talk. When you’re running 5 sessions across different projects, any Claude can discover the others and send messages that arrive instantly.

  Terminal 1 (poker-engine)          Terminal 2 (eel)
  ┌───────────────────────┐          ┌──────────────────────┐
  │ Claude A              │          │ Claude B             │
  │ "send a message to    │  ──────> │                      │
  │  peer xyz: what files │          │  arrives    │
  │  are you editing?"    │  <────── │  instantly, Claude B │
  │                       │          │  responds            │
  └───────────────────────┘          └──────────────────────┘

Quick start

1. Install

git clone https://github.com/louislva/claude-peers-mcp.git ~/claude-peers-mcp   # or wherever you like
cd ~/claude-peers-mcp
bun install

2. Register the MCP server

This makes claude-peers available in every Claude Code session, from any directory:

claude mcp add --scope user --transport stdio claude-peers -- bun ~/claude-peers-mcp/server.ts

Replace ~/claude-peers-mcp with wherever you cloned it.

3. Run Claude Code with the channel

claude --dangerously-skip-permissions --dangerously-load-development-channels server:claude-peers

That’s it. The broker daemon starts automatically the first time.

Tip: Add it to an alias so you don’t have to type it every time:

alias claudepeers='claude --dangerously-load-development-channels server:claude-peers'

4. Open a second session and try it

In another terminal, start Claude Code the same way. Then ask either one:

List all peers on this machine

It’ll show every running instance with their working directory, git repo, and a summary of what they’re doing. Then:

Send a message to peer [id]: “what are you working on?”

The other Claude receives it immediately and responds.

What Claude can do

How it works

A broker daemon runs on localhost:7899 with a SQLite database. Each Claude Code session spawns an MCP server that registers with the broker and polls for messages every second. Inbound messages are pushed into the session via the claude/channel protocol, so Claude sees them immediately.