Claude Code 的 agent teams 怎麼打開？

它是實驗功能，預設關閉。在終端機設環境變數 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1，或寫進 settings.json 的 env 區塊，再打開 Claude Code。之後直接用中文描述工作和你要幾個隊員、各自負責什麼，它就會開團隊。如果它改用子代理，就明講要 agent team。

Agent teams 和 subagent 子代理差在哪？

子代理是主對話派出去做一件事、做完把結果交回來，彼此不太溝通；agent teams 的隊員各自是完整的 Claude Code，會直接互傳訊息、共用待辦清單、自己認領工作。只要結果的事用子代理；需要討論、互相挑戰的複雜工作才用 agent teams。

Agent teams 很耗用量嗎？

會。官方文件寫它用的 token 比一般對話多很多，每個隊員有自己的上下文，用量大致跟隊員人數成正比。官方的省法是：隊員用 Sonnet、團隊小一點、開隊員時的指示寫精簡。用 Pro 或 Max 訂閱的人，要注意額度會消耗得比平常快。

可以分割畫面同時看每個隊員嗎？

可以，但要 tmux 或裝了 it2 工具的 iTerm2。預設是全部在同一個畫面裡，用方向鍵選隊員看。官方文件寫分割畫面不支援 VS Code 內建的終端機、Windows Terminal 和 Ghostty。

Claude Code Agent Teams 是什麼？跟子代理差在哪、怎麼開、為什麼特別耗用量

你可能看過這種示範：在 Claude Code 裡講一句話，它就開出三四個「隊員」，一個查資料、一個寫程式、一個專門挑毛病，大家各做各的，最後隊長把結果整理給你。這就是 agent teams。聽起來很強，但官方文件第一段就提醒：它很耗用量，而且不是每種工作都適合。

這篇照 Claude Code 官方文件整理，日期是 2026 年 10 月 15 日。我在自己的 Mac 上確認了 Claude Code 2.1.280 的 claude --help 裡完全沒有 teammate 或 agent team 的字樣，跟官方文件說的一樣（相關參數還是實驗性的，不列在說明裡）。因為一個團隊同時跑好幾個 Claude，我沒有拿自己的訂閱實際組一隊來跑。

Agent teams 是什麼

一個 agent team 裡有一個隊長和幾個隊員。隊長就是你正在用的那個 Claude Code 對話；隊員是隊長另外開的 Claude Code，每個都有自己的上下文（記憶範圍），各做各的事。

它們之間有兩個協作工具：隊員可以直接互傳訊息，也有一份共用的待辦清單，隊長把工作拆成一項一項，隊員自己認領、做完標記完成。官方文件的說法是，隊員會分享發現、互相挑戰、自己協調。

跟子代理差在哪

Claude Code 另外有一個「子代理」（subagent）功能，也是開別的 Claude 去做事，兩個很容易搞混。官方文件的比較表大意是這樣：

	子代理	Agent teams
上下文	有自己的，做完把結果交回主對話	有自己的，完全獨立
溝通	把結果交給叫它的人	隊員之間直接傳訊息
協調	主對話管全部的工作	隊員自己協調，加上共用的待辦清單
適合	只要結果的單一任務	需要討論、合作的複雜工作
用量	比較少，結果摘要後才交回	比較多，每個隊員是一個完整的 Claude

一句話分：只要它幫你查完、做完交回來，用子代理；需要幾個角度互相討論、互相挑錯，才用 agent teams。子代理怎麼建、怎麼叫，在 Claude Code Subagent 子代理教學。

什麼工作值得用

官方文件列了四種最適合的：

研究和審查：幾個隊員同時看一個問題的不同面向，再互相挑戰彼此的結論。
新的模組或功能：每個隊員負責一塊，互不干擾。
查 bug：每個隊員驗證一個不同的假設，比一個一個試快。
跨層的修改：前端、後端、測試各給一個隊員。

不適合的也寫了：步驟有先後順序的工作、要改同一個檔案的工作、彼此依賴很多的工作。這些用單一對話或子代理比較好，因為團隊本身就有協調的成本，用量也多很多。

怎麼打開

它是實驗功能，預設關閉。打開的方法是設一個環境變數，可以在終端機設，也可以寫進 Claude Code 的設定檔 settings.json：

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

設定檔有全域的 ~/.claude/settings.json 和專案裡的 .claude/settings.json，差別在 Claude Code Hooks 教學有寫。打開之後，直接用自然語言描述工作和你要的隊員。官方的範例大意是：

我在設計一個追蹤程式碼裡 TODO 註解的指令列工具。
開三個隊員從不同角度研究：一個看使用體驗、一個看技術架構、一個專門唱反調。

官方說這個例子好，是因為三個角色彼此獨立，不用等對方。Claude 會建立待辦清單、開出隊員、讓他們各自研究，最後整理結論。

要注意，Claude 有時候會改用子代理而不是開團隊，而子代理和隊員會出現在同一個面板上，光看面板分不出來。官方的建議是再講一次，明確要它開 agent team。

還有兩件事要先知道。第一，開隊員一定要在互動模式：官方文件寫，用 claude -p 這種非互動模式（包括 Agent SDK）不會開出隊員。我平常實測 Claude Code 多半用 claude -p，這也是這篇沒有實測的原因之一。第二，打開這個功能之後，Claude 在隊長的對話裡派出去的具名子代理，會變成以隊員的身分啟動，即使你沒有要它組團隊。不想這樣，就把環境變數改回 0。

看隊員、跟隊員說話

預設模式下，所有隊員都在同一個終端機畫面裡，隊長的輸入框下面會列出隊員。用上下方向鍵選一個，按 Enter 打開他的對話紀錄，可以直接跟他講話；按 Esc 取消選取，如果正在看某個隊員，Esc 會打斷他目前的工作。所有人都閒下來 30 秒後，閒置的那幾列會自動收起來。

想讓每個隊員各佔一個分割畫面，要用 tmux，或裝了 it2 工具的 iTerm2，啟動時加 --teammate-mode auto。這個參數還是實驗性的，所以不會出現在 claude --help 裡，我的 2.1.280 確實查不到。官方文件寫，分割畫面不支援 VS Code 內建的終端機、Windows Terminal 和 Ghostty，這些環境就用預設的模式。

指定人數和模型

人數可以讓 Claude 自己決定，也可以直接講，例如「開 4 個隊員平行重構這幾個模組，每個隊員都用 Sonnet」。模型的選法，官方文件寫的優先順序是：你在指示裡點名的模型最優先，其次是隊員定義檔裡寫的，再來是 CLAUDE_CODE_SUBAGENT_MODEL 這個環境變數，都沒有就跟隊長用同一個模型。

結束某個隊員，就叫他的名字，例如「請 researcher 隊員結束」。隊長會送出結束的請求，隊員可以同意，也可以說明理由拒絕。整個對話結束時，團隊用的共用資料夾會自動清掉。

為什麼特別耗用量

官方文件講得很直接：agent teams 用的 token 比單一對話多很多。每個隊員都有自己的上下文，用量大致跟隊員人數成正比，跑得越久越多。隊員一開起來，也會自動讀專案的 CLAUDE.md、MCP 伺服器和技能，這些都算在他的用量裡。

官方給的省法有三個：隊員用 Sonnet；團隊小一點；開隊員時的指示寫精簡，因為那段話從一開始就佔用他的上下文。用 Pro 或 Max 訂閱的人，額度會比平常消耗得快，用量怎麼看在 Claude Code 用量怎麼看，方案和費用在 Claude Code 費用。

官方的建議

從 3 到 5 個隊員開始。官方說三個專注的隊員，常常比五個分散的表現好；就算有 15 件獨立的工作，也建議先用 3 個隊員。
每個隊員分 5 到 6 項工作，太小的工作協調成本比效益高，太大的工作隊員會悶著頭做太久。
第一次用，先拿來做研究、審查 PR、查 bug 這類不寫程式的工作。
讓每個隊員負責不同的檔案，兩個隊員改同一個檔案會互相覆蓋。
隊長有時候會自己動手做，可以跟它說「等隊員做完再繼續」。

目前的限制

官方文件列的限制，挑重要的：用 /resume 或 /rewind 回到舊對話時，預設模式下的隊員不會跟著回來；隊員有時忘了把工作標成完成，後面的工作會卡住；結束隊員要等他做完手上的事，可能要一點時間；一個對話只能有一個團隊；隊員不能再開自己的隊員；隊長固定是開團隊的那個對話，不能換人。

社群的 oh-my-claudecode 外掛有一個 /team 指令，背後用的就是這個功能；它裝了什麼、每個對話多吃多少 token，在 oh-my-claudecode 是什麼。

這篇沒有測的

我沒有實際組團隊來跑，所以實際會開幾個隊員、跑一次用掉多少額度、隊員之間怎麼對話，都沒有第一手的資料。分割畫面、tmux 和 iTerm2 的設定也沒有測。