Claude Code 智能體團隊（agent teams）怎麼開、怎麼用：實驗功能，和子智能體的區別、費用與限制

本文根據 Claude Code 官方文檔《Orchestrate teams of Claude Code sessions》《Manage costs effectively》整理，資料核對於 2026-11-05。配圖為本站整理的示意圖，不是介面截圖。本站（bigolab.com）不是 Anthropic 官方網站。

適用於誰

• 搜「claude code 智能體團隊」「claude code 團隊模式」的人；
• 用過子智能體（subagents），想知道多個 Claude 實例互相協作是怎麼回事的人；
• 擔心多開會燒掉大量額度的人。

結論先說

1. 智能體團隊是實驗功能，預設關閉。 官方要求設定環境變量 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1（放在環境裏或 settings.json 的 env）。不設的話，不會建團隊，Claude 也不會生成或建議隊友。
2. 結構：一個會話當組長（team lead），協調、分配任務、彙總結果；隊友（teammates）各自有獨立的上下文窗口，彼此可以直接發消息，你也可以直接和任何隊友說話。
3. 和子智能體不同：子智能體在單個會話內工作，把結果交還調用方；團隊成員共享任務列表、能互相通信。
4. 很費 token：官方說它增加協調開銷，用的 token 明顯多於單個會話；順序性任務、改同一個文件、依賴很多的工作，用單會話或子智能體更合適。
5. 非交互模式不生成隊友：用 -p 參數（包括 Agent SDK 會話）時，Claude 不會生成隊友。

圖：本站根據 Claude Code 官方文檔：Agent teams 整理的示意圖

一、什麼時候值得用

官方列出的強場景：

• 研究與評審：多個隊友同時調查問題的不同方面，再互相分享和質疑；
• 新模組或新功能：每人負責一塊，互不踩腳；
• 多假設排錯：隊友並行驗證不同的猜測；
• 跨層協調：前端、後端、測試各由一個隊友負責。

官方的原話大意是：開團隊前先想想有沒有更輕的辦法。子智能體只在單個會話內工作，詳見 /guides/claude-code-subagents；官方另有「跨會話消息」功能，讓你自己開的多個會話互相傳遞結果。

二、怎麼開啟

在 settings.json 裏寫：

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

配置文件的位置和優先級見 /guides/claude-code-settings-json。官方特別提醒一件事：開啟之後普通委派也會變化，Claude 自己給子智能體起名時，被命名的子智能體會以隊友的身份啟動，所以你沒要求時也可能形成團隊。

三、啟動第一個團隊

圖：本站根據 Claude Code 官方文檔：Agent teams 整理的示意圖

開啟後，用自然語言描述任務和你要的隊友。官方示例（翻譯大意）：

text
我在設計一個幫開發者追蹤代碼庫裏 TODO 註釋的命令行工具。
請生成三個隊友，從不同角度探索：一個管用戶體驗，一個管技術架構，一個扮演唱反調的人。

Claude 會建立共享任務列表、生成隊友、讓他們各自探索，最後彙總。官方也提醒：Claude 有時會用子智能體而不是建團隊，兩者都顯示在同一個面板裏，所以光看面板不能確認團隊是否形成；如果它用了子智能體，再說一次並明確要求「agent team」。

組長終端的輸入框下面有智能體面板：上下箭頭選隊友，Enter 打開其記錄並直接發消息，Esc 清除選擇；在查看某個隊友時按 Esc 會打斷它當前這一輪。

指定數量和模型也可以直接寫在提示裏，例如官方示例的意思是：生成 4 個隊友並行重構這些模組，每個用 Sonnet。官方給出模型選擇的優先級：提示詞裏指定的模型、子智能體定義裏的 model、環境變量 CLAUDE_CODE_SUBAGENT_MODEL、組長當前使用的模型。模型選擇的一般知識見 /guides/claude-code-switch-model。

四、顯示模式

官方有兩種：

• in-process（預設）：所有隊友都在主終端裏，不需要額外設定，任何終端都能用；
• 分屏（split panes）：每個隊友一個窗格，需要 tmux 或 iTerm2。

用 settings.json 的 teammateMode 切換，取值有 "in-process"、"auto"、"tmux"、"iterm2"；單次會話可以用 claude --teammate-mode auto。官方提醒 tmux 在某些操作系統上有已知限制，通常在 macOS 上最好用。

五、權限

• 隊友啟動時沿用組長的權限模式，不能在生成時單獨設定；包括組長開着 bypassPermissions（即 --dangerously-skip-permissions）時，隊友也是；
• 隊友的權限提示會出現在組長會話裏，需要你在那裏批准；
• 官方還強調：隊友之間發的消息會被標明來自另一個 Claude 會話，不是你，隊友不能替你批准權限請求；
• 想讓隊友先出方案再動手：先讓組長進入計劃模式再要求生成隊友，官方說隊友會一直處在計劃模式直到方案就緒。計劃模式見 /guides/claude-code-plan-mode，權限模式詳解見 /guides/claude-code-permission-modes。

六、費用怎麼控制

官方在費用頁給出的建議：

• 隊友用 Sonnet，在能力和成本之間平衡；
• 團隊保持小規模，token 用量大致隨成員數增長；官方在最佳實踐裏說大多數工作流從 3–5 個隊友開始；
• 生成提示保持聚焦，因為提示裏的所有內容從一開始就進入隊友的上下文；
• 工作完成就讓隊友關閉，活躍的隊友會一直消耗 token；
• 關閉隊友：直接對組長說「讓 researcher 隊友關閉」，隊友可以同意退出，也可以拒絕並說明原因。

訂閱用戶要關注額度，Claude Code 的額度與限額說明見 /guides/claude-usage-limits；需要更大額度可以了解 /chongzhi/claude-code 或 /chongzhi/claude-max。

七、官方列出的限制

• /resume、/rewind 不會恢復 in-process 隊友，恢復後組長可能給已不存在的隊友發消息，這時讓組長重新生成；
• 任務狀態可能滯後：隊友有時不把任務標記完成，導致後續任務被阻塞；
• 關閉可能很慢：隊友會先做完當前請求或工具調用；
• 一個會話只有一個團隊，不能創建多個命名團隊，也不能跨會話共享；
• 不能嵌套：隊友不能再生成自己的隊友，只有組長能管理團隊；
• in-process 隊友的子智能體只能在前台運行。

官方還提供了鉤子來設質素關卡：TeammateIdle、TaskCreated、TaskCompleted，用退出碼 2 可以給反饋並讓隊友繼續工作或阻止創建 / 完成任務。鉤子的基本用法見 /guides/claude-code-hooks。

常見問題

Q：我沒設環境變量，為什麼說「生成三個隊友」沒反應？

官方說不設定變量時 Claude 不會生成隊友。先確認開關，並在交互模式下使用。

Q：兩個隊友會不會改同一個文件？

官方的「避免文件衝突」一節說：兩個隊友編輯同一個文件會導致覆蓋，所以要把工作拆開，讓每個隊友負責不同的文件集合。分支隔離的做法見 /guides/claude-code-worktree（那是另一個功能，官方這頁沒有把它和團隊綁在一起說）。

Q：是所有套餐都能用嗎？

官方這頁沒有寫套餐限制；功能是否可用請以官方 feature availability 頁面為準。

相關教學

• /guides/claude-code-subagents：子智能體
• /guides/claude-code-plan-mode：計劃模式
• /guides/claude-code-hooks：鉤子

參考資料

• Claude Code 官方文檔：Orchestrate teams of Claude Code sessions — https://code.claude.com/docs/en/agent-teams
• Claude Code 官方文檔：Manage costs effectively — https://code.claude.com/docs/en/costs