Claude Code + Agent Teams，並行任務的最佳實踐
整理版優先睇
Agent Teams：Claude Code 並行開發嘅最佳實踐——由開團到上手指南
呢篇文章係由魯工寫㗎，佢係一位有九年經驗嘅AI算法老兵兼全棧開發者，專注AI編程賽道。佢想解決嘅問題係點樣用好Claude Code嘅Agent Teams功能，令到多智能體並行任務嘅效率最大化，同時避免高token成本嘅陷阱。整體結論係：Agent Teams適合需要隊友之間直接溝通同協調嘅複雜任務，但唔係萬能，得閒就開團反而會嘥錢。
文章先講清楚Agent Teams同Subagents嘅分別：Subagents係單向彙報，似實習生交作業；Agent Teams係雙向溝通，隊友之間可以直接收發消息，仲有共享任務列表同計劃審批機制。然後詳細講咗適用場景（研究審查、新功能開發、Bug調試、跨層協調）同埋唔適合嘅情況（順序依賴強、文件衝突）。啟用方面，要喺settings.json加環境變量，prompt入面要顯式用「agent team」呢類關鍵詞，Claude先會行Agent Teams分支。
控制團隊方面，可以用In-process或Split panes模式監控，用Ctrl+T睇共享任務列表，仲可以用hooks強制質量門。最後俾咗兩個實測玩法（一句話調研開團同tmux分窗並行），同埋五條最佳實踐：俾夠context、團隊規模3-5個、任務粒度要啱、主動監控、避免文件衝突。新手建議由研究審查類任務開始，慢慢上手。
- 結論：Agent Teams適合需要隊友之間直接溝通同協調嘅複雜任務，但token成本高，唔係所有任務都值得開團。
- 方法：啟用需要喺~/.claude/settings.json加環境變量CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1，prompt要用「agent team」等關鍵詞。
- 差異：Subagents係單向彙報，Agent Teams係雙向溝通；後者支援共享任務列表、計劃審批同hooks硬約束。
- 啟發：團隊規模3-5人最慳水慳力，任務要拆到自包含單元，避免文件衝突；新手由研究審查入手。
- 可行動點：用Ctrl+T監控進度，Shift+Down切換隊友，必要時用hooks強制質量門（如「任務完成前必須跑測試」）。
標準開團 prompt 範例
I'm designing a CLI tool that helps developers track TODO comments across their codebase. Create an agent team to explore this from different angles: one teammate on UX, one on technical architecture, one playing devil's advocate.
啟用 Agent Teams 嘅環境配置
喺 ~/.claude/settings.json 加入：{"env": {"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"}}
Agent Teams vs Subagents：點解要開團？
Claude Code 入面做多任務並行，之前主要靠 Subagents 或者 git worktrees。Subagents 有獨立 context window、專用系統提示，可以揀唔同工具同模型，但佢哋只可以向主代理彙報結果，彼此之間冇直接對話通道。Agent Teams 就打破咗呢個限制，隊友之間可以直接收發消息，仲有共享任務列表做協調。
Subagents 係實習生各自俾領導交作業，Agent Teams 係小組同事坐埋一齊可以互相討論
三個維度睇差別：
- 通信：Subagents 只向主代理彙報；Agent Teams 隊友之間直接收發消息
- 協調：Subagents 由主代理統一管理；Agent Teams 共享任務列表 + 自協調
- Context：Subagents 自己窗口，結果回主會話；Agent Teams 自己窗口，完全獨立
- Token成本：Subagents 較低（結果彙總）；Agent Teams 較高（每個隊友係獨立 Claude 實例）
- 適用場景：Subagents 適合結果導向嘅專注任務；Agent Teams 適合需要討論同質疑嘅複雜工作
幾時開團？點樣啟用？
唔係所有任務都適合開團，因為 token 成本真係好高，一個三人團隊嘅 token 消耗大約係單會話嘅 3 到 4 倍。官方文檔列咗幾個最強用例：
- 1 研究同審查類任務：多個隊友可以同時調查問題嘅唔同方面，然後互相分享同質疑彼此嘅發現。
- 2 新模塊或功能開發：每個隊友擁有一個獨立嘅部分，唔會相互幹擾，前提係任務可拆，文件唔衝突。
- 3 帶競爭假設嘅 Bug 調試：多個隊友各拎一個理論並行測試，更快收斂到根因，對抗錨定偏見。
- 4 跨層協調：前端、後端、測試改動同時進行，每個隊友負責一個方面。
反過嚟，順序依賴強嘅任務（B 必須等 A 完成）、同一個文件多人編輯、依賴關係特別多嘅工作，就唔適合開團。呢啲情況用單會話順序處理或者 Subagents 就得，強行開團反而係負擔。
順序依賴強嘅任務、文件衝突場景、依賴關係特別多嘅工作，開團反而係負擔
啟用 Agent Teams 有兩個前置條件：Claude Code v2.1.32 以上，同埋喺 ~/.claude/settings.json 加環境變量。設定如下：
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
}
}啟動方式好簡單：直接用自然語言話俾 Claude 知你想要乜團隊、做乜任務。Claude 會自己創建 team lead、生成 teammates、協調工作。官方例子：
I'm designing a CLI tool that helps developers track TODO comments across their codebase. Create an agent team to explore this from different angles: one teammate on UX, one on technical architecture, one playing devil's advocate.呢條 prompt 入面嘅角色獨立、唔需要互相等待，開團效果最好。
prompt 必須顯式用到「agent team」「teammate」「team lead」「shared task list」呢類詞，Claude 先會行 Agent Teams 分支
管好你嘅 Agent Teams
團隊跑起之後，你唔係只能等結果，成個過程都可以介入。首先係顯示模式，支援 In-process 同 Split panes 兩種。In-process 所有隊友都跑喺主終端，用 Shift+Down 循環切換；Split panes 每個隊友一個獨立窗格，輸出全程可見，需要 tmux 或 iTerm2 支持。
Split panes 模式：每個隊友一個獨立窗格，點擊直接進入對方會話
每個隊友都係完整獨立嘅 Claude Code 會話，你可以直接同佢哋溝通。In-process 模式用 Shift+Down 切到目標隊友輸入消息，Enter 進入會話，Escape 中斷；Ctrl+T 叫出共享任務列表。Split-pane 直接點擊窗格就得。
- 共享任務列表有三種狀態：pending、in progress、completed，仲可以 set 依賴關係
- 任務分配方式：lead 顯式指派，或者隊友完成自己任務後自動認領下一個
- 複雜或高風險任務可以要求隊友先做 planning，lead 審過至準動手，拒絕嘅隊友會留喺 plan 模式修訂再交
- 關閉團隊：叫 lead 執行「Clean up the team」，如果仲有隊友未停會失敗，要先關閉佢哋
另外，你可以指定唔同隊友用唔同模型，例如 lead 用 Opus、teammate 用 Sonnet 控制成本。Claude 亦會主動提議開團，但唔會未經你同意就創建。判斷係咪真係開咗團嘅硬標準：睇 ~/.claude/teams/ 目錄下有冇新嘅 team 目錄（帶 config.json）。
~/.claude/teams/ 下有新目錄先係真開團，冇嘅話就行緊 Subagents
實測玩法同最佳實踐
下面俾兩個 Agent Teams 嘅玩法，一個係常規啓用，一個係 tmux 啓用。
- 1 案例一：一句話調研開團。俾一個調研任務加大致角色分工，例如「幫我調研 Claude Code 中 MCP、Skills、Plugins、Hooks、Agent teams 嘅核心區別與聯繫」。Claude 會自動創建 team lead 加 5 個 teammates，各跑各嘅方向，最後 lead 綜合輸出。
- 2 案例二：使用 tmux 體驗分窗並行。將上述常規方法喺 tmux 下重複一次，感受 tmux 對多個 teammates 嘅自動分窗並行效果。
跑過幾個團隊之後，總結咗幾條經驗，結合官方建議：
- 俾夠 context：隊友自動加載項目級嘅 CLAUDE.md、MCP servers 同 skills，但唔會繼承 lead 嘅對話歷史，要喺生成 prompt 入面寫清楚任務相關關鍵資訊，特別係文件路徑、模塊約定、技術棧細節。
- 團隊規模 3 到 5 個最合適：再多協調開銷同 token 成本就指數上升，3 到 5 個隊友做 5 到 6 個任務每條係經過驗證嘅甜蜜點。
- 任務粒度要恰到好處：太細協調開銷超過收益；太大型隊友長時間唔 check 浪費風險高。理想係一個自包含嘅可交付單元（一個函數、一個測試文件、一份審查）。
- 等隊友完成先繼續：lead 有時會自己開始幹活而唔等隊友，發現呢種情況直接話佢「wait for your teammates to complete their tasks before proceeding」。
- 從研究同審查類任務入手：新手第一次開團，建議由唔需要寫 code 嘅任務開始，邊界清楚，唔涉及並行實施嘅協調挑戰，能直觀感受 Agent Teams 嘅價值。
- 避免文件衝突：兩個隊友編輯同一個文件會互相覆蓋，任務拆分時保證每個隊友擁有獨立嘅文件集。
- 主動監控同指導：唔好俾團隊無人值守跑太耐，中途用 Ctrl+T 睇任務列表，發現方向跑偏直接 Shift+Down 過去重定向。
最後提提你，Agent Teams 本質上係 Claude Code 工具層在多智能體協作上嘅一套工程化實現。3 到 5 人小團隊、開發者睇得明每一步嘅透明度、本地直接跑唔依賴雲端，係佢嘅核心定位。如果你嘅任務去到幾百個 sub-agent 併發嗰種量級，可以考慮 Kimi K2.6 嘅 Agent Swarm，走嘅係另一條雲端大規模分解嘅路。兩者定位唔重合，按場景揀就得。
Agent Teams 定位：3-5 人小團隊、透明度高、本地直接跑；大規模併發可以睇 Kimi Agent Swarm
大家好，我係魯工。
Agent Teams唔算係咩新功能，我好早喺Claude Code裏面就用過。之前有Agent swarm、Agent group呢啲叫法，但本質上都係並行驅動多個Agent嚟完成任務，其實就係開團。
我上個週末將Claude Code入面關於Agent teams嘅文檔仔細睇咗下，發現呢個嘢可以挖嘅嘢好多。
呢篇文章跟官方文檔嘅邏輯順序串埋嚟寫：先講清楚同subagents嘅分別、咩場景適合用、點樣啟動、點樣控制、點樣先算最佳實踐，再用三個我自己跑過嘅實測案例落返具體場景。睇完呢篇基本上可以從零上手。
Agent Teams vs. Subagents
Claude Code入面做多任務並行，之前主要靠Subagents（子智能體）或者git worktrees。呢方面我之前寫過一啲文章，具體可以參考：
Claude Code + Git Worktrees，並行開發最正確嘅打開方式
Subagents可以有獨立嘅context window、專用嘅系統提示、揀唔同嘅工具同模型。但係佢有個天花板：只能夠向主代理彙報結果，彼此之間冇直接對話嘅通道。
Agent Teams將呢個限制打甩咗。
三個維度睇差別：
總結下就係，Subagents係實習生各自交功課俾老細，Agent Teams係小組同事坐埋一齊可以互相討論。
Agent Teams幾時啟用
唔係所有任務都適合開團。因為開團嘅token成本真係好高，一個3人團隊嘅token消耗大約係單會話嘅3到4倍，亂咁濫用會好痛。
官方文檔列出咗幾個最強用例：
研究同審查類任務。多個隊友可以同時調查問題嘅唔同方面，然後互相分享同質疑彼此嘅發現。例如審一個PR，三個隊友分別負責安全、性能、測試覆蓋三個角度。
新模組或功能開發。每個隊友擁有一個獨立嘅部分，唔會互相干擾。前提係任務可拆，檔案唔衝突。
帶競爭假設嘅Bug除錯。多個隊友各自拎一個理論並行測試，可以更快收窄到根因。呢個對抗「揾到一個睇落合理嘅解釋就停低」嘅錨定偏見特別有用。
跨層協調。前端、後端、測試改動同時進行，每個隊友負責一個方面。
反過嚟唔適合嘅場景都好明確：
順序依賴強嘅任務（B一定要等A完成）、同一個檔案多人編輯（好易覆蓋）、依賴關係特別多嘅工作。呢幾種場景下，一係用單會話順序處理，一係用subagents就得，夾硬開團反而係負擔。
點樣啟用Agent Teams
Agent Teams功能喺Claude Code入面唔係預設開啟嘅，開團有兩個前置條件。
一係Claude Code v2.1.32以上（呢個大家都滿足，Native安裝方法會自動更新Claude Code版本）。
二是在 ~/.claude/settings.json 度加一個環境變數：
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
}
}啟動方式好簡單：直接用自然語言話畀Claude知你想要咩團隊、做咩任務。Claude自己負責創建team lead、生成teammates、協調工作。
官方文檔畀嘅標準例子：
I'm designing a CLI tool that helps developers track TODO comments across their codebase. Create an agent team to explore this from different angles: one teammate on UX, one on technical architecture, one playing devil's advocate.
呢條prompt官方原話係「This example works well」，三個角色獨立、唔需要互相等，開團效果最好。
觸發關鍵詞好關鍵。prompt入面一定要明顯出現agent team / teammate / team lead / shared task list呢類詞，Claude先會行Agent Teams分支。中文口語講嘅「開兩個agent並行」、「派兩個子代理」呢啲寫法有機會被識別成subagents，可能唔會創建team。
指定隊友數量同模型。Claude會根據任務自己決定開幾個隊友，但你都可以直接指定：
Create a team with 4 teammates to refactor these modules in parallel. Use Sonnet for each teammate.
亦可以叫唔同隊友用唔同模型，例如lead用 Opus、teammate用Sonnet控制成本。
Claude主動提議團隊。如果你畀嘅任務真係得益於並行，Claude會主動建議開團，但唔會未經你同意就創建。最終決定權喺你手。
判斷team係咪真係被創建有一個硬標準：執行完之後睇 ~/.claude/teams/ 目錄下有冇新生成嘅team目錄（帶config.json）。有目錄先係真係開咗團；冇就係行咗subagents。
點樣控制Teammates
團隊跑起之後，你唔係淨係等結果，成個過程都可以插手。先睇顯示模式，Agent Teams功能支援in-process同split panes兩種顯示模式：
In-process：所有隊友都喺主終端度跑，用Shift+Down循環切換。任何終端都用得，唔使額外裝嘢。
Split panes：每個隊友一個獨立窗格，輸出全程睇到，撳邊個窗格就直接入去對應隊友嘅會話。需要tmux或iTerm2支援。
啟用方式有三種，由大到細：
全局config，喺 ~/.claude.json 裏設：
{
"teammateMode": "tmux"
}單次啓動flag：
claude --teammate-mode tmux默認auto模式：我哋已經喺tmux session度開咗Claude Code，Claude會自動切split panes，否則返去in-process。
split panes嘅兩個入口：tmux（macOS下最穩定）；iTerm2，需要安裝it2 CLI，並喺Settings → General → Magic開Enable Python API）。
每個隊友都係完整獨立嘅Claude Code會話，可以直接send訊息畀佢哋：
In-process模式：Shift+Down切到目標隊友，輸入訊息直接send；Enter入去隊友會話睇詳情，Escape中斷當前輪次；Ctrl+T叫出共享任務列表。
Split-pane模式：直接㩒窗格就可以入去對應隊友嘅會話，每個隊友有完整終端視圖。
共享任務列表協調成個團隊嘅工作。任務有三種狀態：pending、in progress、completed，仲可以設定依賴關係（一個任務blocked by另一個時，依賴任務唔解除就唔可以認領）。
兩種分配方式：lead明確指派（「將呢個任務畀researcher隊友」），或者隊友完成自己嘅任務之後自動認領下一個未分配嘅。
複雜或者風險高嘅任務可以叫隊友先做planning，lead審過先鬱手：
Spawn an architect teammate to add structured logging middleware. Require plan approval before any changes. Reject any plan that does not include rollback strategy and test coverage.
關鍵：喺prompt度同lead寫清楚批准準則（「一定要包含測試覆蓋」、「一定要有回滾方案」），如果唔係lead會跟佢自己嘅判斷批。被拒絕嘅隊友會留喺plan模式，跟反饋修訂再提交。
關閉同清理方面，可以揀關閉單個隊友以及任務完成後清理團隊。關閉單個隊友：
Ask the researcher teammate to shut down
隊友收到關閉請求可以批准或者拒絕。
成個團隊跑完，同lead講一句：
Clean up the team
咁會刪除共享團隊資源。如果仲有隊友喺度跑，清理會失敗，先關閉佢哋再清。呢一步一定要由lead執行，隊友自己行clean會出問題。
另外仲可以用hooks強制質量門。Agent Teams配套咗三個新嘅hook事件：TeammateIdle（隊友空閒時）、TaskCreated（任務創建時）、TaskCompleted（任務完成時）。喺hook度以exit 2退出可以阻斷對應行為，stderr內容會作為反饋傳俾teammate。
適合將團隊規範硬編碼入去，例如「任務標記完成前一定要跑過測試」、「唔準創建修改數據庫schema嘅任務」。比prompt度重複提點可靠得多，prompt係軟約束模型可能唔記得，hook係硬約束直接攔住。
兩個實測玩法
下面畀兩個Agent Teams嘅玩法，一個係常規啟用玩法，一個係tmux啟用玩法。
案例一：一句話調研開團
最常規嘅玩法，畀一個調研任務加大致角色分工，餘下嘅交畀Claude。
比如：啟用Agent Teams幫我調研Claude Code入面MCP、Skills、Plugins、Hooks、Agent teams嘅核心區別同聯繫。
跑下來Claude會自動創建team lead加5個teammates，各跑各的方向，最後lead綜合輸出。
案例二：用tmux體驗分窗並行
我哋可以將上面嘅常規Agent teams啟用方法喺tmux下重試一次，感受下tmux對多個teammates嘅自動分窗並行效果。
並行工作嘅最佳實踐
跑過幾個團隊之後總結嘅幾條經驗，結合官方建議。
畀隊友充足嘅context。隊友自動加載項目級嘅CLAUDE.md、MCP servers同skills，但唔會繼承lead嘅對話歷史。喺生成prompt度要將任務相關嘅關鍵信息寫清楚，特別係檔案路徑、模組約定、技術棧細節。
團隊規模3到5個最合適。再多協調開銷同token成本就會指數上升，3到5個隊友做5到6個任務每人係經過驗證嘅甜蜜點。如果有15個獨立小任務，3個隊友係一個好嘅起點，等隊友各自輪轉處理。teammates多咗，即使係Max 20x訂閲，都好易觸發五小時限額：
任務粒度要啱啱好。太細協調開銷大過收益；太大隊友長時間唔check in浪費風險高。理想粒度係一個自包含嘅可交付單元（一個函數、一個測試檔案、一份審查）。
等隊友完成先繼續。lead有時會自己開工而唔等隊友。如果發現呢種情況，直接話畀佢知「wait for your teammates to complete their tasks before proceeding」。
由研究同審查類任務入手。新手第一次開團，建議由唔需要寫代碼嘅任務開始（PR審查、Library調研、Bug調查），呢類任務邊界清楚、唔涉及並行實施嘅協調挑戰，可以直觀感受到Agent Teams嘅價值。
避免檔案衝突。兩個隊友編輯同一個檔案會互相覆蓋。任務拆分時確保每個隊友擁有獨立嘅檔案集。
主動監控同指導。等團隊冇人睇住跑太耐會浪費成本。中途用 Ctrl+T 睇任務列表，發現方向偏咗直接Shift+Down過去redirect。
最易遇到嘅問題：team點都開唔起。prompt行落去仍然係Running N agents...呢種subagents形態。咁請跟以下順序自查：
prompt度有冇明顯用 agent team/teammate關鍵詞（啟動章節強調過嘅）echo $CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS確認下輸出係咪 1改完settings.json有冇完全退出Claude Code重啟 行完prompt後 ls ~/.claude/teams/睇下目錄有冇生成新team。有目錄先係真觸發，呢個係判斷嘅最硬標準
Agent Teams本質上係Claude Code工具層喺多智能體協作上嘅一套工程化實現。3到5人嘅小團隊規模、開發者睇得明每一步嘅透明度、本地直接跑唔使靠雲端，呢啲係佢嘅核心定位。
如果你嘅任務去到幾百個sub-agent併發嗰個量級（例如一次性生成30個落地頁、批量匹配100個崗位生成CV），可以去睇睇Kimi K2.6最新出嘅Agent Swarm，行嘅係另一條雲端大規模分解嘅路。兩者定位唔重疊，跟場景揀就得。
如果覺得有用，按個讚或者「在看」，等更多朋友睇到。
我係魯工，九年AI算法老手，AI全棧開發者，深耕AI編程賽道。歡迎關注，有興趣嘅朋友亦可以加我微信（louwill26_）交個朋友。
大家好，我是魯工。
Agent Teams不算啥新功能了，我很早就在Claude Code裏面用上了。之前有Agent swarm、Agent group等叫法，但本質上都是並行驅動多個Agent來完成任務，其實就是開團。
我上週末把Claude Code中有關Agent teams的文檔仔細研讀了下，發現這個東西能挖的東西挺多。
這篇文章按官方文檔的邏輯順序串起來寫一下：先講清楚和subagents的區別、什麼場景該用、怎麼啓動、怎麼控制、怎麼算才算最佳實踐，再用三個我自己跑過的實測案例落到具體場景。看完這篇基本能從零上手。
Agent Teams vs. Subagents
Claude Code裏做多任務並行，之前主要靠Subagents（子智能體）或者git worktrees。這塊我之前寫過一些文章，具體可參考：
Claude Code + Git Worktrees，並行開發最正確的打開方式
Subagents能有獨立的context window、配專用的系統提示、選不同的工具和模型。但它有個天花板：只能向主代理彙報結果，彼此之間沒有直接對話的通道。
Agent Teams把這個限制打掉了。
三個維度看差別：
總結下就是，Subagents是實習生各自給領導交作業，Agent Teams是小組同事坐一起能互相討論。
Agent Teams什麼時候啓用
不是所有任務都適合開團。因為開團的token成本是真的高，一個3人團隊的token消耗大概是單會話的3到4倍，盲目濫用會很疼。
官方文檔列了幾個最強用例：
研究和審查類任務。多個隊友可以同時調查問題的不同方面，然後互相分享和質疑彼此的發現。比如審一個PR，三個隊友分別負責安全、性能、測試覆蓋三個角度。
新模塊或功能開發。每個隊友擁有一個獨立的部分，不會相互干擾。前提是任務可拆，文件不衝突。
帶競爭假設的Bug調試。多個隊友各拿一個理論並行測試，能更快收斂到根因。這個對抗"找到一個看似合理的解釋就停下來"的錨定偏見特別有用。
跨層協調。前端、後端、測試改動同時進行，每個隊友負責一個方面。
反過來不適合的場景也很明確：
順序依賴強的任務（B必須等A完成）、同一個文件多人編輯（容易覆蓋）、依賴關係特別多的工作。這幾種場景下要麼用單會話順序處理，要麼用subagents就行，強行開團反而是負擔。
如何啓用Agent Teams
Agent Teams功能在Claude Code中並不是默認開啓的，開團有兩個前置條件。
一是Claude Code v2.1.32以上（這個大家基本都滿足，Native安裝方法會自動更新Claude Code版本）。
二是在 ~/.claude/settings.json 里加一個環境變量：
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
}
}啓動方式很簡單：直接用自然語言告訴Claude你想要什麼團隊、做什麼任務。Claude自己負責創建team lead、生成teammates、協調工作。
官方文檔裏給的標準例子：
I'm designing a CLI tool that helps developers track TODO comments across their codebase. Create an agent team to explore this from different angles: one teammate on UX, one on technical architecture, one playing devil's advocate.
這條prompt官方原話是"This example works well"，三個角色獨立、不需要互相等待，開團效果最好。
觸發關鍵詞很關鍵。prompt裏必須顯式出現agent team / teammate / team lead / shared task list這類詞，Claude才會走Agent Teams分支。中文口語裏說的"開兩個agent並行"、"派兩個子代理"這種寫法有概率會被識別成subagents，可能不會創建team。
指定隊友數和模型。Claude會根據任務自己決定開幾個隊友，但你也可以直接指定：
Create a team with 4 teammates to refactor these modules in parallel. Use Sonnet for each teammate.
也可以讓不同隊友用不同模型，比如lead用 Opus、teammate用Sonnet控制成本。
Claude主動提議團隊。如果你給的任務確實受益於並行，Claude會主動建議開團，但不會未經你同意就創建。最終決定權在你手裏。
判斷team是否真的被創建有個硬標準：執行後看 ~/.claude/teams/ 目錄下有沒有新生成的team目錄（帶config.json）。有目錄才是真的開團了；沒有就是走的subagents。
如何控制Teammates
團隊跑起來之後，你不是隻能等結果，整個過程都可以介入。先看顯示模式，Agent Teams功能支持in-process和split panes兩種顯示模式：
In-process：所有隊友都跑在主終端裏，用Shift+Down循環切換。任何終端都能用，不用額外裝東西。
Split panes：每個隊友一個獨立窗格，輸出全程可見，點擊哪個窗格就直接進到對應隊友的會話。需要tmux或iTerm2支持。
啓用方式三種，從大到小：
全局config，在 ~/.claude.json 裏設：
{
"teammateMode": "tmux"
}單次啓動flag：
claude --teammate-mode tmux默認auto模式：我們已經在tmux session裏打開Claude Code，Claude會自動切split panes，否則回到in-process。
split panes的兩種入口：tmux（macOS下最穩定）；iTerm2，需要安裝it2 CLI，並在Settings → General → Magic開Enable Python API）。
每個隊友都是完整獨立的Claude Code會話，可以直接給它們發消息：
In-process模式：Shift+Down切到目標隊友，輸入消息直接發；Enter進入隊友會話查看詳情，Escape中斷當前輪次；Ctrl+T調出共享任務列表。
Split-pane模式：直接點擊窗格就能進對應隊友的會話，每個隊友有完整終端視圖。
共享任務列表協調整個團隊的工作。任務有三種狀態：pending、in progress、completed，還可以設置依賴關係（一個任務blocked by另一個時，依賴任務不解除就不能認領）。
兩種分配方式：lead顯式指派（"把這個任務給researcher隊友"），或者隊友完成自己的任務後自動認領下一個未分配的。
複雜或風險高的任務可以要求隊友先做planning，lead審過才動手：
Spawn an architect teammate to add structured logging middleware. Require plan approval before any changes. Reject any plan that does not include rollback strategy and test coverage.
關鍵：在prompt裏給lead寫清楚批准準則（"必須包含測試覆蓋"、"必須有回滾方案"），不然lead會按自己的判斷批。被拒絕的隊友會留在plan模式，按反饋修訂重新提交。
關閉和清理方面，可以選擇關閉單個隊友以及任務完成後清理團隊。關閉單個隊友：
Ask the researcher teammate to shut down
隊友收到關閉請求可以批准或拒絕。
整個團隊跑完，跟lead說一句：
Clean up the team
這會刪除共享團隊資源。如果還有隊友在跑，清理會失敗，先關閉它們再清。這一步必須由lead執行，隊友自己跑clean會出問題。
另外還可以使用hooks強制質量門。Agent Teams配套了三個新的hook事件：TeammateIdle（隊友空閒時）、TaskCreated（任務創建時）、TaskCompleted（任務完成時）。在hook裏以exit 2退出可以阻斷對應行為，stderr內容會作為反饋傳給teammate。
適合把團隊規範硬編碼進去，比如"任務標記完成前必須跑過測試"、"不允許創建修改數據庫schema的任務"。比prompt裏反覆叮囑可靠得多，prompt是軟約束模型可能忘，hook是硬約束直接攔住。
兩個實測玩法
下面給兩個Agent Teams的玩法，一個是常規啓用玩法，一個是tmux啓用玩法。
案例一：一句話調研開團
最常規的玩法，給一個調研任務+大致角色分工，剩下交給Claude。
比如：啓用Agent Teams幫我調研Claude Code中MCP、Skills、Plugins、Hooks、Agent teams的核心區別與聯繫。
跑下來Claude會自動創建team lead加5個teammates，各跑各的方向，最後lead綜合輸出。
案例二：使用tmux體驗分窗並行
我們可以把上述常規的Agent teams啓用方法在tmux下重試一遍，感受下tmux對多個teammates的自動分窗並行效果。
並行工作的最佳實踐
跑過幾個團隊之後總結的幾條經驗，結合官方建議。
給隊友足夠的context。隊友自動加載項目級的CLAUDE.md、MCP servers和skills，但不會繼承lead的對話歷史。在生成prompt裏要把任務相關的關鍵信息寫清楚，特別是文件路徑、模塊約定、技術棧細節。
團隊規模3到5個最合適。再多協調開銷和token成本就指數上升，3到5個隊友做5到6個任務每人是經過驗證的甜蜜點。如果有15個獨立小任務，3個隊友是一個好起點，讓隊友各自輪轉處理。teammates多了，即使是Max 20x訂閲，也很容易觸發五小時限額：
任務粒度要恰到好處。太小協調開銷超過收益；太大隊友長時間不check浪費風險高。理想粒度是一個自包含的可交付單元（一個函數、一個測試文件、一份審查）。
等隊友完成再繼續。lead有時會自己開始幹活而不是等隊友。如果發現這種情況，直接告訴它 "wait for your teammates to complete their tasks before proceeding"。
從研究和審查類任務入手。新手第一次開團，建議從不需要寫代碼的任務開始（PR審查、庫調研、Bug調查），這種任務邊界清楚、不涉及並行實施的協調挑戰，能直觀感受到Agent Teams的價值。
避免文件衝突。兩個隊友編輯同一個文件會互相覆蓋。任務拆分時保證每個隊友擁有獨立的文件集。
主動監控和指導。讓團隊無人值守跑太久會浪費成本。中途用 Ctrl+T 看任務列表，發現方向跑偏直接Shift+Down過去重定向。
最容易碰上的問題：team怎麼都開不起來。prompt跑下去仍然是Running N agents...這種subagents形態。那麼請按下列順序自查：
prompt裏有沒有顯式用 agent team/teammate關鍵詞（啓動章節強調過的）echo $CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS確認下輸出是不是 1改完settings.json有沒有完全退出Claude Code重啓 跑完prompt後 ls ~/.claude/teams/看下目錄有沒有生成新team。有目錄才是真觸發了，這是判斷的最硬標準
Agent Teams本質上是Claude Code工具層在多智能體協作上的一套工程化實現。3到5人的小團隊規模、開發者能看懂每一步的透明度、本地直接跑不依賴雲端，這些是它的核心定位。
如果你的任務到了幾百個sub-agent併發那種量級（比如一次性生成30個落地頁、批量匹配100個崗位生成簡歷），可以去看看Kimi K2.6剛發的Agent Swarm，走的是另一條雲端大規模分解的路。兩者定位不重合，按場景選就是了。
如果覺得有用，點個贊或者在看，也方便更多朋友看到。
我是魯工，九年AI算法老兵，AI全棧開發者，深耕AI編程賽道。歡迎關注，感興趣的朋友也可以加我微信（louwill26_）交個朋友。