Agent Teams 與通訊

你將學到什麼

Agent Teams 是 Claude Code 用來讓多個獨立 session 持續協作的實驗功能。本課只聚焦公開的操作模型：

• 一位 lead 負責協調團隊；
• 多位 teammates 在各自的上下文視窗工作；
• 共享任務清單追蹤負責人與依賴關係；
• **信箱（mailbox）**傳遞代理之間的直接訊息。

Agent Teams 仍是實驗功能，預設關閉。以下流程已於 2026 年 7 月 20 日依官方文件驗證。

公開的團隊模型

元件	責任
Team lead	產生 teammates、協調工作、分派任務並整合結果
Teammates	各自獨立的 Claude Code session，負責界線清楚的調查或實作
共享任務清單	保存 pending、in progress、completed 狀態與任務依賴
Mailbox	在 lead 與 teammates 之間，或 teammates 彼此之間傳遞訊息

Teammate 啟動時會載入一般專案上下文，例如 CLAUDE.md、skills、MCP servers，以及 lead 給它的 spawn prompt；但它不會繼承 lead 的對話歷史。成功所需的任務事實，必須寫進 spawn prompt 或後續訊息。

Agent Teams 與 Subagents 的差異

若工作者只要完成一個聚焦任務並回報呼叫者，使用 subagent。若工作者需要互相交換發現、挑戰假設、自行認領任務，或持續可被單獨操作，使用 Agent Team。

	Subagent	Agent Team teammate
上下文	獨立上下文	獨立 session
通訊	只回報呼叫者	可直接傳訊給 lead 與其他 teammates
協調	主代理分派	透過共享任務清單自行協調
成本	較低	較高；每位 teammate 都有自己的上下文消耗

啟用 Agent Teams

在環境或設定中開啟實驗旗標：

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

接著用自然語言描述團隊與工作界線：

建立一個包含三位 teammates 的 agent team：
- researcher：整理目前的驗證流程
- reviewer：檢查安全性與權限風險
- tester：找出缺少的測試

為每位 teammate 建立獨立任務，要求他們互相分享證據，
並等所有任務完成後再整合結果。

第一位 teammate 被產生時，團隊即成立，目前的 session 成為 lead。現行版本沒有可供腳本依賴的公開 TeamCreate 或 TeamDelete 工具。

用任務與訊息協調

Lead 可以明確指派任務；閒置 teammate 也可以認領尚未指派且未被依賴阻擋的任務。前置工作完成前，依賴會讓後續任務保持 pending。

會改變其他代理工作的資訊，應直接傳訊：

告訴 reviewer：researcher 在 src/auth/token.ts 找到 token 解析邏輯。
請 tester 驗證同一個邊界，並回報失敗的指令。

訊息會自動送達。任務清單只記錄工作狀態，不能取代驗收條件、檔案所有權或證據的說明。

可靠的操作模式

1. 將工作切成可獨立交付、檔案所有權不重疊的單位。
2. 為每位 teammate 提供相關路徑、限制與完成定義。
3. 把依賴寫進共享任務清單，不要靠時間順序猜測。
4. 要求 teammates 回傳證據，而不只是結論。
5. 等所有進行中的工作完成，再由 lead 解決衝突並驗證整體結果。

只有在平行化值得協調成本與 token 成本時，才從三到五位 teammates 開始。循序工作、高度耦合任務與同檔案編輯，通常更適合單一 session。

生命週期與限制

• 你可以從 in-process agent panel 或 split pane 直接引導 teammate。
• 權限請求仍需要使用者授權；代理不能替另一個被拒絕的代理繞過權限。
• 工作完成後，請 lead 要求 teammate 正常關閉。
• 團隊執行狀態由 Claude Code 管理，session 結束時會清理。不要讓工作流程依賴私有檔案或未公開 schema。
• Session 恢復、任務協調與關閉行為仍有官方列出的實驗限制。

可依賴的契約是 lead、teammates、共享任務與訊息行為。除非官方參考明確保證，內部檔名與儲存配置都只是實作細節。

官方來源

• 協調 Claude Code Agent Teams
• 建立自訂 Subagents

下一課

下一課會把協作變成明確協議：所有權、證據、交接與完成規則。