Claude Code Agent Teams - 從設定到快捷鍵完整指南

Claude Code Agent Teams 隨著 Opus 4.6 版本一同發布。坦白說，我認為這項功能在現階段的效率並不理想, , token 消耗量偏高，協調所帶來的額外開銷也確實存在。

但在讀了 Tom (@tomcrawshaw01) 的教學之後，我意識到這個架構本身就值得深入理解。趁著預覽階段先熟悉它的運作方式，等到正式發布時就能搶先一步。

單一代理現在可以組建團隊

一個主導代理負責拆解工作，並將任務分配給多個平行運作的隊友。

與子代理的關鍵差異在於：隊友之間可以直接互相傳訊。他們不只是把結果回報給主導代理，還能分享各自的發現，甚至質疑彼此的成果。

設定只需 30 秒

這項功能仍處於實驗階段，因此預設為關閉。只需一行設定即可啟用。

在 settings.json 的 env 區塊中加入 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS，值設為 "1"。你也可以透過 shell 環境變數來設定，但 settings.json 會在各個工作階段之間持續生效，使用上更為方便。

你只需要記住這些快捷鍵

團隊運作後，你會需要在主導代理和各個隊友之間切換來監控進度。需要記的東西並不多。

• Shift+Up / Shift+Down - 切換不同隊友（行程內模式, , 這是你最常使用的方式）
• Enter - 檢視所選隊友的工作階段詳情
• Escape - 中斷所選隊友目前的回合
• Ctrl+T - 切換共享任務清單的顯示
• Shift+Tab - 切換委派模式，將主導代理鎖定為僅負責協調（不寫程式）
• 分割面板模式 - 點擊隊友面板即可直接互動

委派模式非常重要。如果不啟用，主導代理有時候會自己開始寫程式，而不是將工作委派給隊友。

終端機相容性因工具而異

分割面板模式僅支援 tmux 和 iTerm2。VS Code 內建終端機、Windows Terminal 以及 Ghostty 目前均不在官方支援範圍內。

如果你使用 Ghostty，將會採用預設的行程內模式，透過 Shift+Up/Down 在隊友之間切換。

若想並排檢視各隊友的輸出，可以在 tmux 工作階段中執行 Claude Code。預設的 teammateMode 為 "auto"，因此偵測到 tmux 時會自動切換為分割面板模式。

我目前的做法是先在 iTerm 中執行 tmux new -s {my-project}，再以 claude --teammate-mode tmux 啟動。這樣就能以全螢幕檢視所有團隊活動。

任務的運作流程

工作圍繞著任務清單進行組織。主導代理建立任務，隊友負責認領執行。

• 當主導代理建立任務清單後，隊友會自動認領下一個未指派的任務
• 支援任務之間的相依性設定, , 後續任務只有在前置任務完成後才會解鎖
• 你可以透過告知主導代理的方式，將特定任務指派給特定隊友
• 隊友的關閉遵循一套協定：主導代理發送關閉請求，隊友確認後才會退出
• 完整清理流程：確認所有隊友已關閉後，再指示主導代理進行清理

一個提到「team」的簡單提示就能自動觸發此功能。但若需要更精確的控制，可以定義隊友總數、為每位隊友指定名稱與角色、設定委派範圍，並提供一份外部檔案來定義任務之間的相依規則。

Token 消耗速度超乎預期

每位隊友都是一個獨立的 Claude Code 工作階段。平行運作會讓成本快速攀升。以下幾個做法有助於控制開支。

• 為隊友撰寫具體的啟動提示。主導代理的對話記錄不會自動帶入, , 只有 CLAUDE.md 和 MCP 伺服器的上下文會自動載入
• 兩個隊友同時編輯同一個檔案會導致覆寫。請在檔案層級劃分工作範圍
• 先從研究或程式碼審查開始，而非直接進行程式碼生成。協調的複雜度會比較低
• 保持任務單元小而具體, , 單一函式或單一測試檔案是很好的粒度

踩坑之前值得先了解的限制

這是預覽版本，粗糙的地方在所難免。事先了解這些限制能省去不少挫折。

• 使用 /resume 或 /rewind 會終止行程內的隊友。你需要告知主導代理重新產生新的隊友
• 任務狀態可能會有延遲。如果隊友完成了工作卻沒有將任務標記為完成，後續任務就會持續被封鎖。請手動檢查並要求主導代理更新狀態
• 每個工作階段只能有一個團隊。隊友無法建立子團隊
• 建立團隊的工作階段會維持主導代理的身分。你無法在工作階段中途更換主導代理或將隊友升級為主導代理

這個預覽版本還很粗糙，成本效益的問題也尚無定論。但如果你想了解多代理工作流程的發展方向，最快的方法就是直接啟用並親自嘗試。工具的好壞，終究需要實際上手才能做出真正的評估。