跨session通訊框架

開發者Louis Villeneuve推出了「claude-peers」，一套讓同機器上的多個Claude Code實例相互發現並即時通訊的系統。當使用者同時運行5個不同項目的session時，任何一個Claude都能透過該工具與其他實例互動，詢問澄清問題或建立非正式的協作關係。

核心功能與工具集

該系統提供四項主要操作工具：

• list_peers：發現同機器上的其他Claude Code實例，可按機器、目錄或儲存庫範圍篩選，並顯示各實例的工作目錄、git儲存庫與任務摘要
• send_message：按ID向另一實例發送訊息，透過channel push協議實現即時傳遞
• set_summary：讓使用者手動描述當前工作內容，供其他peer查看
• check_messages：手動檢查訊息的備用機制（非channel模式下使用）

架構與運作機制

系統採用經紀人守護程序（broker daemon）模式運作，監聽localhost:7899並搭配SQLite資料庫。每個Claude Code session啟動時都會生成一個MCP伺服器，向經紀人註冊並每秒輪詢一次訊息。入站訊息透過「claude/channel」協議推送至session，讓Claude立即感知。經紀人會自動清理已停止的peer，且所有通訊限制在localhost範圍內。

自動摘要功能

若設定了OPENAI_API_KEY環境變數，系統會在實例啟動時使用gpt-5.4-nano模型自動生成簡短摘要（成本為分毫級），根據目錄、git分支與最近編輯的檔案推斷使用者的工作內容。其他實例呼叫list_peers時即可看到這份摘要。未設定API金鑰時，使用者可改用set_summary工具手動描述。

安裝與配置

安裝過程包含三步：克隆程式庫、透過claude mcp add指令註冊為MCP伺服器、以特定參數啟動Claude Code。系統支援環境變數配置，包括經紀人監聽埠（預設7899）、SQLite資料庫路徑（預設~/.claude-peers.db）等。開發者建議將啟動指令設為shell alias以簡化重複輸入。

命令列工具與設計選擇

使用者也可透過CLI直接與系統互動，檢查經紀人狀態、列出所有peer、向特定session傳送訊息或停止經紀人。值得注意的是，該專案依賴Bun執行環境、Claude Code v2.1.80以上版本，且需透過claude.ai登入（channel功能不支援API金鑰認證）。設計上採用輪詢加push混合架構，確保既能及時通知又能容錯降級，展現出對實際多session開發場景的理解。