SSD Nodes Learn Hosting plans →
指南 Matt Connor作者: Matt Connor

Claude Code 工作階段如何互傳訊息?

了解同一台 VPS 上的 Claude Code 工作階段如何使用 ListAgents 與 SendMessage 互傳文字、何時值得開第二個工作階段,以及訊息為何會暫時擱置。

Claude Code 工作階段彼此傳送訊息的意義

兩個 Claude Code 工作階段在同一台機器上,且由同一個作業系統使用者執行時,就能彼此傳送訊息。訊息是某個 Claude 撰寫給另一個 Claude 的一段純文字。不包含對話歷程,也不包含檔案。Claude 會使用 ListAgents 工具尋找另一個工作階段,再使用 SendMessage 傳送文字,因此你不需要手動呼叫任一工具。你只要說明另一個工作階段需要知道的內容,Claude 就會自行撰寫訊息。

這項功能稱為跨工作階段訊息傳遞。截至 2026 年 11 月,在 macOS 和 Linux 上(包括 WSL 2 內的 Linux)需要 Claude Code v2.1.224 或更新版本;在原生 Windows 上則需要 v2.1.234 或更新版本。同一台機器上的工作階段可在所有 provider 上互相傳訊,包括 Amazon Bedrock、AWS 上的 Claude Platform、Google Cloud's Agent Platform 及 Microsoft Foundry;在 Microsoft Foundry 上需要 v2.1.248 或更新版本。若要連線到其他機器或雲端中的工作階段,限制較多:這會透過 Remote Control 傳送,需要登入 claude.ai,因此無法搭配 API key,或在上述四個 provider 上使用。工作階段符合這些條件後,訊息傳遞功能即已啟用,不需要進行任何設定。以下行為取自 Anthropic 的跨工作階段訊息傳遞文件。

VPS 是這項功能特別實用的環境,因為工作階段會在 VPS 上持續執行,值得彼此傳送訊息。在筆記型電腦上,你會闔上螢幕。在 tmux 中執行的伺服器上,星期一啟動的工作階段到了星期四仍可能持續執行,並保留某個 repository 的上下文。當你有兩個這樣的工作階段後,它們如何互相溝通就不再只是理論問題。如果你尚未完成設定,請先從 在 VPS 上搭配 tmux 執行 Claude Code 開始;其中涵蓋本指南所假設的工作階段基礎設定。

何時值得使用第二個工作階段

先從成本考量。每個工作階段都是具有獨立內容視窗的 Claude 實例,因此在相同期間內,使用兩個工作階段的成本約為一個工作階段的 2 倍。傳送的訊息會和你輸入的提示一樣計入用量。協調並非免費;如果工作實際上是一連串依序執行的步驟,拆分到多個工作階段反而會讓處理速度變慢、成本提高。

值得使用第二個工作階段的情況通常具有相同特徵:兩項工作可同時執行,彼此無須等待,而其中一項工作在執行期間取得了另一項工作所需的資訊。

  • 一個工作階段發現 breaking change,而另一個工作階段正在以受影響的程式碼為基礎進行建置。Claude 會摘要這項變更並傳送出去,無須你在另一個終端機重新輸入。
  • 兩個工作階段在同一個 repository 的不同 git worktree 中工作,其中一個需要知道哪些變更已經合併。
  • 長時間執行的 migration 或測試會將結果回傳給你正在監看的工作階段。
  • 一個 builder 工作階段搭配一個 reviewer 工作階段;reviewer 會讀取 builder 產出的內容,並回傳檢查結果。

如果工作是依序執行,或兩個工作階段都會編輯相同檔案,請使用一個工作階段。如果你想要 Claude 在單一工作中建立並監督一個協調式工作群組,那就是 agent teams,這是另一項仍在實驗階段的功能。如果你只是想在另一個終端機中繼續相同的對話,請改用 resume the session。Cross-session messaging 適用於由你自行啟動與引導的獨立工作階段。

在規劃使用前,先確認功能是否存在

先查看版本:

claude --version

將版本號碼與 2.1.224 比較。接著在工作階段中輸入 /list-agents;此指令也可使用 /peers。它會列出此工作階段可連線到的所有 agent,以及各 agent 回應的名稱。如果完全無法辨識此指令,表示此工作階段不支援跨工作階段訊息傳遞,任何 crossSessionInbound 值都無法改變這點。輸入 /status,並尋找 Peer address 列;該列包含此工作階段自己的收件匣位址,前綴為 uds:。

較舊版本會讓 VPS 使用者遇到一個陷阱。在 v2.1.248 之前,同一台機器上的訊息傳遞依賴功能旗標擷取,而數個隱私變數會停用該擷取功能,使此功能維持預設的停用狀態。DO_NOT_TRACK、DISABLE_TELEMETRY、CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 和 DISABLE_GROWTHBOOK 都會造成這種情況。使用者通常會將這些值貼入 ~/.bashrc 來強化新伺服器,之後卻發現 /list-agents 不存在。從 v2.1.248 起,即使停用擷取功能,同一台機器上不同工作階段之間仍可傳遞訊息,因此更新版本是較妥善的修正方式。這些變數對機器外部的工作階段仍然有影響:停用擷取功能時,Claude 只有在 Remote Control 可用時才能連線到這些工作階段,而 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 和 DISABLE_GROWTHBOOK 會使 Remote Control 無法使用。相同值也可能來自設定檔中的 env map,或來自 managed settings,因此請先檢查 shell。

env | grep -E 'DO_NOT_TRACK|DISABLE_TELEMETRY|DISABLE_GROWTHBOOK|NONESSENTIAL'

在較舊版本中,取消設定輸出內容中的相關變數。對 DISABLE_TELEMETRY 和 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 而言,任何非空值都會啟用此行為,包括字串 0,因此 DISABLE_TELEMETRY=0 的作用並不像表面看起來那樣。若要停用,請取消設定該變數,或將其設為空字串。

為工作階段命名,方便區分

Claude 會依名稱將訊息傳送至工作階段,但不一定要設定名稱。未設定時,Claude Code 會自行為工作階段命名;Claude 仍可使用 ListAgents 找到該工作階段,並使用 SendMessage 傳送訊息。對於互動式工作階段,自動名稱會將工作目錄名稱與 2 個字元的尾碼組合,例如 myapp-3f。只有 1 個工作階段時這樣即可;有 4 個工作階段時就難以區分,而且 2 個工作階段可能取得相同名稱。若要自行選擇名稱,請在啟動工作階段時設定:

claude --name builder-api

您也可以在執行中的工作階段內使用 /rename 設定名稱。除非工作階段已連線至 Remote Control,否則 /list-agents 輸出會顯示每個本機工作階段的工作目錄,可用來區分同名工作階段;如果名稱重複,Claude 自己的清單也會在位址中加入簡短識別碼。工作階段連線至 Remote Control 時,/list-agents 不會顯示工作目錄,也不會顯示無法歸屬於特定使用者的工作階段名稱,因此該列會顯示為 (unnamed session)。Claude 尋找目標時所看到的資訊不會改變。自行命名比閱讀識別碼更省事。自行選擇的名稱也能讓 @ 預先輸入功能發揮作用:從 v2.1.232 起,在提示中輸入 @builder 並選擇工作階段後,Claude 就能確切知道您所指的是哪個工作階段。

可重現的雙工作階段 tmux 配置

這是一個在同一個儲存庫中使用的建置工作階段與審查工作階段。審查者在獨立的 git worktree 中工作,因此兩者不會寫入同一個檔案。git worktree add 搭配 HEAD 會建立分離的 checkout,適合只讀取而不提交變更的工作階段。由於兩個工作階段的任務不同,值得為審查者設定專屬的輸出樣式。這會變更該工作階段的 system prompt,因此每一輪都會保留,不像只輸入一次的指示會逐漸失效。

cd ~/src/api
git worktree add ../api-review HEAD
tmux new-session -d -s agents -n builder -c ~/src/api
tmux new-window -t agents -n reviewer -c ~/src/api-review
tmux send-keys -t agents:builder 'claude --name builder-api' C-m
tmux send-keys -t agents:reviewer 'claude --name reviewer-api' C-m
tmux attach -t agents

接著,Ctrl+b 搭配 w 會依名稱列出視窗,讓你選取其中一個。在建置視窗中執行 /list-agents。你應該會看到 reviewer-api,其工作目錄為 ~/src/api-review。如果看不到,表示審查工作階段尚未完成啟動,或下一節所述的兩個問題之一正在發生。接著以一般文字交接內容:

Tell reviewer-api which files I changed for the rate limiter and what to look at first.

Claude 會撰寫摘要並傳送。你不需要撰寫訊息內容,而且 Claude 傳送的內容會有所不同。在審查視窗中,訊息會顯示為較淡的單行預覽,其中包含傳送者名稱與文字的第一行,例如 › Message from @builder-api: …。如果該工作階段處於閒置狀態,Claude 會立即在其中開始新的一輪。如果正在執行一輪工作,訊息會等到工具呼叫之間才會送入,因此不會中斷正在執行的命令。Ctrl+O 會開啟逐字稿檢視器並顯示完整文字;無論你是否展開訊息,Claude 都會讀取完整內容。兩者搭配使用時,建置者應維持較小的變更,因為較窄的差異會產生較短的交接內容,也能讓另一個工作階段在一輪內完成審查。這正是懶惰資深開發者技能要強制建立的習慣。

同一台 VPS 上誰能看見誰

同一台機器上的訊息傳遞不會經過 Anthropic 伺服器。每個工作階段都會綁定自己的收件匣 socket,也就是在該機器檔案系統中具有路徑的 Unix domain socket。只有在工作階段綁定 socket 時,該工作階段才會出現在其他工作階段的清單中。這會造成兩項影響,而且在伺服器上都可能導致問題。

socket 受到作業系統使用者限制。以 root 身分啟動的工作階段,與以 deploy 身分啟動的工作階段無法互相看見。即使兩者位於同一個 tmux server 中也是如此,因為一名使用者的工作階段無法存取另一名使用者的 socket。請以相同使用者執行兩個工作階段。

容器擁有自己的檔案系統。Docker 內的工作階段與主機上的工作階段無法互相連線。同一個容器內的兩個工作階段則可正常互傳訊息。如果你為了隔離而將 agents 保留在容器中,例如 在一次性 VM 中執行 coding agents,請預期訊息只能在容器內傳遞,無法跨越容器邊界。

你在其他機器上的工作階段,以及 cloud 工作階段,只有在本工作階段連線至 Remote Control 時,才會出現在清單中;其他機器上的工作階段會標示為 Remote Control。自 v2.1.225 起,Claude 可以與你其他機器上的工作階段開始對話,不只能回覆訊息。這些訊息會經過 Anthropic 伺服器,傳送至 cloud 工作階段的訊息也一樣。即使訊息包含回覆位址,cloud 工作階段也無法使用 SendMessage 回覆;訊息仍會送達,而你可以在 claude.ai/code 的該 cloud 工作階段 transcript 中讀取回應。如果 Claude 向機器外傳送訊息時,本工作階段未連線至 Remote Control,訊息仍會送出,但不會包含回覆位址,因此另一端無法回覆。

為什麼訊息始終沒有送達

通常原因與網路無關。接收工作階段決定了如何處理訊息,而決定結果不是送達。每則抵達的訊息最後都會有以下 3 種結果之一:已送達、暫存(先擱置且不送達,直到你核准),或拒絕(直接丟棄,不送達)。

當沒有適用的 crossSessionInbound 值時,Claude Code 會比較兩個工作階段的權限模式,逐則決定處理方式。它會將略過權限提示的工作階段歸為一類,其餘工作階段歸為另一類。auto、acceptEdits 和 dontAsk 都算作會提示。對於具備略過權限功能的互動式終端機工作階段,Plan mode 算作略過提示。如果不確定某個工作階段屬於哪一類,建議先閱讀各權限模式的實際行為,因為目前多數工作階段從 auto 開始,而 auto 屬於會提示的一側。規則具有對稱性:

  • 會提示權限的接收工作階段會送達每則訊息。只有在傳送工作階段表明自己會略過提示時,才會暫存訊息。
  • 略過權限提示的接收工作階段會暫存所有訊息,等待你核准。只有在傳送端也略過提示時,才會送達訊息。

因此,多數人建立的第一種工作流程,正好是無法運作的流程。你使用 --permission-mode bypassPermissions 啟動 builder,讓它能在無人值守的情況下執行;reviewer 則維持預設設定。結果 builder 傳送的每則訊息,都會停留在沒有人查看的核准對話框中。該對話框會在 dialogExpiry 期限後關閉,預設值為 5m,訊息也會隨之丟棄。在判定 socket 有問題前,先查看接收工作階段的畫面,確認是否有待處理的核准對話框。

若要讓工作階段在無人值守的情況下接收訊息,請將 crossSessionInbound 設為 accept。設定位置會決定適用範圍。Claude Code 會先讀取 managed settings,再讀取 --settings 旗標,最後讀取 user settings,並套用找到的第一個值。project 或 local settings 中的值,只有在梯度 accept < hold < refuse 上更嚴格時才會套用。.claude/settings.json 中的 accept 比任何值都寬鬆,因此只要 trusted source 已設定值,就會被忽略。請將它放在 ~/.claude/settings.json,或針對單一工作階段傳入。從 v2.1.232 開始,/config 列 來自其他工作階段的訊息 會替你寫入相同的 user setting。

claude --name runner --settings '{"crossSessionInbound":"accept"}'

無頭模式的 claude -p worker 會像互動式工作階段一樣繫結 inbox socket,並出現在清單中,但無法顯示核准對話框。Claude Code 會在相同的 dialogExpiry 期限內暫存其中的訊息,預設為 5 分鐘;如果這段期間內模式或設定變更,使訊息符合接收條件,就會送達,否則會丟棄訊息,並將其回報為已過期給仍可連線的傳送端。上方的 --settings 行可讓這類 worker 接收訊息。以 bare mode 啟動的工作階段完全不會繫結 socket,因此既無法接收訊息,也不會出現在清單中。

交接卡住的情況

訊息迴圈會由系統處理。Claude Code 會依寄件者對重複訊息進行速率限制,捨棄在短時間內收到的相同重複訊息,並將每個工作階段等待讀取的已接受訊息上限設為 50 則,因此兩個工作階段之間的迴圈會自行停止。暫存訊息上限為 100 則,超過後會捨棄最舊的訊息。從 v2.1.238 起,當某個工作階段因速率限制或佇列已滿而捨棄你傳送的訊息時,系統會通知你的工作階段。

實際發生的故障更不明顯,而且是交接問題,不是迴圈。工作階段 A 向工作階段 B 詢問一個必須先取得答案才能繼續的問題,然後進入閒置狀態。B 暫存了訊息,或 B 正在處理耗時的長工作階段,或 B 回答了 A 實際上沒有提出的問題。A 持續等待。你一小時後回來,看到兩個閒置的工作階段,卻沒有完成任何工作。

請撰寫不需要回覆的交接訊息。好的訊息會傳遞事實或決策:說明變更內容及結果。差的訊息會向另一個工作階段請求許可,或要求對方提供寄件者正因等待而無法繼續的答案。Claude 已獲指示,絕不要求另一個工作階段執行其自身權限設定會阻擋的動作,而是將該工作轉回給你。你也應自行延伸這項規則。如果某個工作階段沒有答案就無法繼續,應由你提供答案。如果一個工作階段只需要知道另一個工作階段何時完成長時間工作,請要求通知,而不是回覆:從 v2.1.236 起,兩個工作階段中的 Claude 都能要求你在這台機器上的其中一個工作階段,在下一次進入閒置狀態或結束時傳回一則通知;如果 12 小時內沒有收到通知,Claude Code 會捨棄該要求。這裡的內容管理同樣有幫助,因為失去脈絡的工作階段會撰寫含糊的訊息;管理 Claude Code 中的內容涵蓋這一部分。

將傳入訊息視為不受信任的輸入

Claude Code 會告知接收端的 Claude,該訊息來自另一個工作階段,而不是來自你本人,並限制該訊息可以執行的操作。這項強制機制存在於包裝模型的程式中,而不是取決於模型是否願意遵從;這正是代理程式控制層的實際作用。訊息無法代替你回答待處理的權限提示,因為另一個工作階段的同意不等於你的同意。另一個工作階段要求時,訊息也無法變更權限設定、CLAUDE.md 或其他設定。文字中的斜線指令,例如 /compact,會以純文字形式傳入,永遠不會執行。如果處理訊息需要接收端工作階段沒有的權限,你仍會看到與其他工作相同的提示。傳送端工作階段在自動模式中執行時,其分類器也會在 Claude Code 傳送每則訊息前進行檢查;遭到阻擋的訊息不會送達接收端。這些限制在寬鬆模式中仍然有效,因此繞過限制的工作階段預設會暫停處理傳入訊息,而不是直接信任訊息。

這些限制涵蓋權限,但不涵蓋內容。傳送端工作階段可能讀取過 pull request 說明、網頁、相依套件的 README,或陌生人撰寫的 issue 留言,而讀取到的內容可能影響它寫給另一個工作階段的文字。訊息是資料。你應以處理任何從外部進入工作階段的文字時相同的態度,對它保持懷疑。這就是避免讓 AI 代理程式接觸機密所描述的原則:假設任何跨越信任邊界的內容都可能有誤,絕不要讓它自行授權。

如果你希望減少這類訊息,可以使用兩項控制措施。將 crossSessionInbound 設為 refuse,會直接捨棄傳入的對等工作階段訊息,不予傳送;從 project 或 local 設定中指定時,該值會優先於所有其他來源,因為它在設定層級中最嚴格。若要停止此工作階段傳送或列出訊息,請加入以 SendMessage 和 ListAgents 為名稱的 permission deny 規則;兩者都必須寫成不含 specifier 的純工具名稱。將 isolatePeerMachines 設為 true,會要求你明確核准後,訊息才能送達本機以外的工作階段;即使在 bypassPermissions 模式中,也必須取得這項核准。

{
  "crossSessionInbound": "refuse",
  "isolatePeerMachines": true
}

拒絕 SendMessage 也會停止向子代理程式傳送訊息,因為兩者使用相同的工具。拒絕接收的工作階段不會在自身的 /status 或同一台機器上其他工作階段的清單中顯示任何變化,因此應從該工作階段的設定確認結果,而不是根據畫面判斷。

Bridge 與共用記憶體 MCP 伺服器

同一時期也出現了幾個功能相近的第三方專案:在執行中代理程式之間轉送文字的本機 agent-to-agent bridge,以及讓多個代理程式共用讀寫儲存區的 MCP(model context protocol)伺服器。應將它們視為不同的架構,而不是競品;執行任何安裝指令前,先對照專案自己的 README 進行確認。訊息傳遞是 push,因為傳送端會將文字放入接收端目前的工作回合。共用儲存區是 pull,因為它不會中斷任何工作階段,工作階段下次查看時才會看到這則備註。對於變化緩慢的狀態,pull 較不會造成干擾;但只有在工作階段實際查看時才有效。

如果採用這種方式,值得詢問的問題應聚焦於執行程序,而不是功能清單。伺服器以哪個使用者身分執行?它能讀取伺服器上的哪些內容?在 VPS 上執行 MCP 伺服器說明這項設定。在不同儲存庫之間共用 agent 技能涵蓋較簡單的情境:如果要在工作階段之間共用的是指示而不是即時狀態,這種方式能減少許多原本需要傳送的訊息。如需了解更完整的架構,請先參閱在 VPS 上執行 coding agent。

FAQ

為什麼我的工作階段無法辨識 /list-agents?

這個工作階段不支援跨工作階段訊息傳遞。先檢查 claude --version:macOS 和 Linux 需要 2.1.224 或更新版本,原生 Windows 需要 2.1.234 或更新版本,而 Amazon Bedrock、Claude Platform on AWS、Google Cloud's Agent Platform 和 Microsoft Foundry 需要 2.1.248 或更新版本。若建置版本早於 2.1.248,也請檢查 shell 是否設有 DO_NOT_TRACK、DISABLE_TELEMETRY、CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 或 DISABLE_GROWTHBOOK,因為這些設定都會關閉較舊版本進行訊息傳遞所需的功能旗標擷取。更新至 2.1.248 或更新版本後,同一台機器上的工作階段便不再依賴這項機制。

為什麼我傳給另一個工作階段的訊息一直沒有送達?

如果 /list-agents 可正常運作,表示訊息傳遞功能已啟用,只有較特定的因素阻止該訊息送達。最常見的原因是權限模式。略過權限提示的工作階段會暫停所有傳入訊息,等待你核准;除非傳送端也略過權限提示。該核准對話框會在 dialogExpiry 期限後失效,預設為 5 分鐘。請檢查接收端工作階段是否有待處理的核准對話框。若要修正,請在 ~/.claude/settings.json 中將 crossSessionInbound 設為 accept,或使用 --settings 傳入該設定,因為專案或本機設定中的 accept 會被忽略,較寬鬆的值不會生效。

Docker 中的 Claude Code 工作階段可以向主機上的工作階段傳送訊息嗎?

不行。每個工作階段的收件匣都是該機器檔案系統上的 socket,而容器具有自己的檔案系統,因此容器內的工作階段無法連線到主機上的工作階段,反之亦然。同一個容器內的兩個工作階段則可以正常互傳訊息。類似的規則也能說明,為什麼以 root 執行的工作階段無法連線到以一般使用者身分執行的工作階段:socket 僅限擁有該 socket 的作業系統使用者使用。

來自其他 Claude Code 工作階段的訊息可以安全執行嗎?

請將訊息內容視為不受信任的輸入,因為傳送端工作階段可能讀取了他人撰寫的網頁、README 或 issue 留言。Claude Code 本身會阻止訊息自行執行操作:它無法核准待處理的權限提示,也無法依要求變更權限設定或 CLAUDE.md;文字中的 slash command 會以純文字形式抵達,且永遠不會執行。這些防護涵蓋權限控管,但不涵蓋判斷,因此請先閱讀收到的內容,再指示接收端工作階段採取行動。

跨工作階段訊息傳遞會將我的程式碼傳送給 Anthropic 嗎?

在同一台機器上的兩個工作階段之間,不會。訊息會透過該機器上每個工作階段專用的 socket 傳送,不會經過 Anthropic 伺服器;傳送的只有 Claude 撰寫的文字,不會傳送對話記錄或檔案。傳送給另一台機器上的工作階段,或傳送給雲端工作階段的訊息,則會經過 Anthropic 伺服器。從 v2.1.225 起,Claude 可以與另一台機器上的工作階段開始對話,不再只能回覆對方。雲端工作階段可以接收訊息,但無法使用 SendMessage 回覆;你可以在 claude.ai/code 的文字記錄中閱讀其回應。將 isolatePeerMachines 設為 true,即可要求你核准任何離開該機器的內容。

這篇文章對您有幫助嗎?