前言¶
如果你同時在多個終端裏開着 Claude Code，大概率遇到過這種場景：A 窗口剛跑完數據庫遷移，B 窗口還在寫依賴新表結構的接口，C 窗口在另一個 worktree 裏改前端——彼此不知道對方進展，只能手動把終端輸出複製到另一個窗口，再讓 Claude 重新理解一遍上下文。
2026 年 8 月 7 日，Anthropic 在 Claude Code v2.1.224 中上線了跨會話消息傳遞（Cross-Session Messaging）功能。macOS 和 Linux 上各自獨立運行的會話，可以通過 ListAgents 發現彼此、用 SendMessage 互發純文本摘要，不再需要你在終端之間來回搬運信息。官方文檔與 MacRumors 等媒體均已報道這一更新。
本文基於 Anthropic 官方文檔覈實功能細節，介紹它的工作原理、適用場景、使用方式與安全邊界。
跨會話消息傳遞是什麼¶
跨會話消息傳遞，指的是你自己啓動的多個 Claude Code 會話之間，由 Claude 代爲傳遞一段文字消息。
需要明確幾點：
- 傳的是摘要，不是上下文。消息是一段 Claude 寫給另一個 Claude 的純文本，不包含對話歷史、文件內容或權限狀態。如果要延續整段對話，應使用會話恢復（resume）功能，而不是跨會話消息。
- 你不需要手動調用工具。
ListAgents和SendMessage是 Claude 在後臺使用的工具，你在終端裏用自然語言告訴 Claude「把這件事通知另一個會話」即可。 - 默認開啓，無需額外配置。只要版本、平臺和提供商滿足要求，功能自動可用。
Anthropic 在 X 上發佈的演示也強調了這一點：Claude 發送的是摘要，接收方在自己的任務中途拾取消息繼續工作。
核心機制：ListAgents 與 SendMessage¶
Claude Code 爲跨會話通信引入了兩個工具：
| 工具 | 作用 |
|---|---|
ListAgents |
發現當前可聯繫的會話，包括本機其他會話、當前會話內的子代理（subagent）等 |
SendMessage |
按名稱向目標會話投遞一段純文本消息 |
同一套 SendMessage 也服務於單會話內的子代理和 Agent Teams 隊友，但跨會話消息針對的是你獨立啓動、各自 steering 的會話，與 Agent Teams（由 Claude 生成並協調的團隊）是不同層級的協作方式。
如何查看可聯繫的會話¶
在任意會話中輸入：
/list-agents
別名是 /peers。輸出會列出每個會話的名稱、工作目錄等信息。會話名稱可通過 /rename 或啓動時的 --name 參數自定義；未設置時，Claude Code 會根據工作目錄文件夾名自動生成，例如 myapp-3f。
如果 /list-agents 命令無法識別，說明當前會話不具備跨會話消息能力，應先檢查 claude --version 是否達到 v2.1.224。
消息如何投遞¶
接收方 Claude 在工具調用間隙讀取消息，不會打斷正在執行的工具。如果接收會話處於空閒狀態，Claude Code 會開啓新一輪對話來處理這條消息。
消息到達後，會話裏會顯示帶發送方標識的卡片；閱讀完畢後摺疊爲一行 Message from，按 Ctrl+O 可展開查看原文。
典型使用場景¶
官方文檔列舉了以下幾類常見用法：
- 傳遞發現與決策：一個會話發現破壞性變更或做出架構決策，Claude 自動把摘要發給正在相關模塊上工作的另一個會話。
- 並行 worktree 協作：多個會話在不同 git worktree 中並行開發，一方合併或提交後，可通知其他會話「main 上已落地某改動，可以 rebase」。
- 長任務狀態回報：遷移、測試套件等耗時任務在後臺會話運行，完成後向主會話彙報結果；你也可以主動詢問「另一個終端裏的遷移跑完了嗎」。
- 跨設備回覆：通過 Remote Control 連接到手機或 Web 端的會話發來消息後，本機終端可以回覆（跨機器場景僅限回覆，不能主動發起）。
Claude 既可以主動在發現需要協調時發送消息，也可以在你提示後發送。例如：
Ask the session running in my other terminal whether the migration finished
或者：
Explain what we just did to the session working on the payments API
Claude 會自行組織消息措辭，你不必逐字指定內容。
消息傳輸路徑與安全邊界¶
本機 vs 跨機器¶
| 對方會話位置 | 傳輸方式 | 本機會話能做什麼 |
|---|---|---|
| 同一臺機器 | 本地 per-session socket，不經過 Anthropic 服務器 | 發新消息 + 回覆 |
| 你的另一臺機器 | 經 Anthropic 服務器，通過 Remote Control 投遞 | 僅回覆 |
| Claude Code on the Web | 經 Anthropic 服務器直達雲端會話 | 僅回覆 |
同機消息走本地 socket，MacRumors 與官方文檔均確認這類流量不會上傳到 Anthropic。跨機器場景則必須經過服務器，且只能回覆對方先發來的消息。
如需對跨機器消息額外把關，可在設置中開啓 isolatePeerMachines: true，每次向外發送前需你明確批准。
接收方的權限限制¶
來自其他會話的消息不能替代你的操作授權，具體限制如下：
- 不能代你批准權限：消息不算你的同意，無法替你點擊 pending 的 permission prompt。
- 不能修改配置：接收方 Claude 被明確禁止因另一條會話的請求而改動權限設置、
CLAUDE.md等配置。 - 命令不會被執行：消息裏的
/compact等文本按純文字處理，Claude Code 不會執行。 - 敏感操作仍需你確認：如果消息引發的工作需要權限，接收會話仍會彈出與你手動操作相同的提示。
此外，可通過 crossSessionInbound 設置控制入站消息：accept（直接投遞）、hold（暫存待審批）、refuse（直接丟棄）。默認策略還會根據雙方 permission mode 分類——例如接收方處於 bypass 模式時，來自普通模式的會話消息會被 hold 等待你批准。
平臺支持與限制¶
版本要求：Claude Code v2.1.224 或更高。
操作系統：macOS、Linux（含 WSL 2）。原生 Windows 暫不支持。
不支持的提供商：Amazon Bedrock、Claude Platform on AWS、Google Cloud Agent Platform、Microsoft Foundry。
可能關閉功能的變量：若設置了 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC、DISABLE_TELEMETRY、DO_NOT_TRACK 或 DISABLE_GROWTHBOOK 中任一導致 feature-flag 評估被關閉，跨會話消息也會不可用。
其他限制：
- 僅支持純文本，不含結構化 Agent Teams 協議消息。
- 防循環：對重複消息有速率限制，相同內容短時間內的重複投遞會被丟棄；每個會話最多排隊 50 條待讀消息。
- 容器與宿主機之間因文件系統隔離，通常無法互發；同一容器內的會話可以。
claude -p無頭會話也可接收消息（bare mode 除外）。
同一版本還包含約 31 項其他改動，例如面向 Team 和 Enterprise 計劃的 claude self-hosted-runner 命令，以及一項 Linux/macOS 沙箱安全修復（denyRead/denyWrite 規則尾部帶斜槓時被靜默忽略的問題）。
與 Agent Teams、子代理的區別¶
Claude Code 有多種「多代理」形態，容易混淆，簡要對照：
| 方式 | 適用場景 |
|---|---|
| 跨會話消息 | 你自己開的多個獨立終端會話之間傳遞摘要 |
| Agent Teams | Claude 生成並協調一組隊友，團隊內有專用消息協議 |
| 子代理（Subagents） | 單會話內 Claude 派生的子任務代理，可用同一 SendMessage 聯繫 |
| Agent View | 從一個界面監控、調度多個並行會話 |
| Remote Control | 用手機或其他設備遙控某個終端會話 |
| Channels | 把 CI 結果、聊天消息等外部事件推入會話 |
跨會話消息解決的是「我自己開了好幾個窗口，怎麼讓它們互通情報」；Agent Teams 解決的是「讓 Claude 自己組隊幹活」。兩者可以並存，但定位不同。
如何關閉或限制¶
若不需要此功能，可以分方向關閉：
停止接收：設置 crossSessionInbound 爲 refuse。
停止發送與發現：在權限規則中 deny SendMessage 和 ListAgents（注意：這會同時禁用對子代理和 Agent Teams 隊友的消息能力）。
組織管理員也可在 managed settings 中統一關閉。
小結¶
Claude Code v2.1.224 的跨會話消息傳遞，把「終端 A 的發現告訴終端 B」這件事從人工複製粘貼，變成了 Claude 之間的自動摘要投遞。ListAgents 負責發現，SendMessage 負責送達；同機走本地 socket，跨機經 Remote Control 且僅支持回覆。
它不會搬運文件和歷史，也不能替你批准敏感操作——安全邊界仍牢牢握在你手裏。對同時在多個 worktree 或終端並行開發的開發者來說，這是一個實用的小升級：少切幾次窗口，少粘貼幾段日誌，協作節奏會順暢不少。
升級後可在終端執行 claude --version 確認版本，再輸入 /list-agents 看看當前有哪些會話在線。如果你已經在 macOS 或 Linux 上跑着多個 Claude Code，不妨讓其中一個會話給另一個發條消息試試。
