安裝與使用 Claude Code Agent Teams（代理團隊） 的完整指南

Anthropic 正式將原本由 OpenClaw 社群開發的多代理協作功能納入原生支援。以下是關於如何設置並在今天開始使用的詳細介紹。

---

核心概念：從「單兵作業」進化到「團隊協作」

早期的 Claude Code 運作模式就像一位單一員工：給它一個任務，它從第一步做到最後一步，一次只能處理一件事。

Agent Teams 則完全改變了遊戲規則。現在，當你描述一個大型任務時，會有一位 「首席代理（Lead Agent）」 出現。它會將任務拆解，並同時開啟多個 「隊友（Teammates）」 平行作業：

• 一位隊友研究程式碼庫。

• 另一位正在除錯某個函式。

• 第三位則在撰寫測試案例。

他們擁有各自的內容視窗（Context Window），甚至能彼此傳送訊息、分享發現，並透過共享的「任務清單（Task List）」自我協調。

---

區分：子代理 (Sub-agents) vs. 代理團隊 (Agent Teams)

你可能會問：「這跟之前的子代理有什麼不同？」

• 子代理： 像是一個去幫你跑腿買咖啡的助理，做完專屬的小任務後回報結果，成本較低。

• 代理團隊： 每個隊友都是一個「完整的 Claude Code 階段」。他們不只是回報，還能互相討論、質疑彼此的工作。這就像把一群專家關在房間裡，讓他們共同解決複雜問題。

---

什麼時候該用「代理團隊」？

這項功能會消耗大量 Token，且有一定的協調成本，因此不要濫用。

• 適用場景：

  • 平行研發： 同時處理前端、後端與測試。

  • 競爭性除錯： 讓多個代理同時測試不同的錯誤假說，誰先找到答案誰就贏。

  • 深度審查： 從不同角度（例如安全性、性能、易讀性）同時審核程式碼。

• 不適用場景：

  • 循序漸進的任務： 如果第二步必須等第一步完成，則不需要團隊。

  • 編輯同一檔案： 兩個代理同時改同一個檔案會導致覆蓋衝突。

  • 簡單任務： 單一代理能搞定的事，開團只會浪費錢。

---

安裝與設定（只需 30 秒）

這項功能目前處於「研究預覽版（Research Preview）」，預設是關閉的。

1. 修改設定檔

在你的 settings.json 中加入以下環境變數：

JSON

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

2. 或者直接在終端機設定

如果你想在當前工作階段開啟，可輸入：

• macOS/Linux: export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1

• Windows (PowerShell): $env:CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS="1"

---

如何下指令啟動團隊？

你不需要學習特殊語法，只需用白話文告訴 Claude 你的需求：

範例提示詞：

「我正在設計一個追蹤程式碼 TODO 註釋的工具。請建立一個代理團隊，從不同角度切換：一個負責 UX 使用者體驗，一個負責技術架構，另一個扮演反方（Devil's Advocate）來質疑設計缺陷。」

顯示模式

• 處理中模式（In-process）： 預設模式，所有隊友都在同一個終端機運作。使用 Shift + Up/Down 來切換不同隊友的畫面。

• 分欄模式（Split-pane）： 如果你使用 tmux 或 iTerm2，每個隊友會有獨立的視窗面板，讓你同時監控所有人。

---

如何操控運行中的團隊

1. 直接溝通： 你可以隨時切換到某位隊友的視窗直接對話，不一定要透過首席代理。

2. 委派模式（Delegate Mode）： 按下 Shift + Tab 開啟。這會強制首席代理只負責「協調與分配」，防止它自己跑去寫程式碼而忘了管理隊友。

3. 任務領取： 隊友完成目前工作後，會自動從清單領取下一個任務。

4. 關閉隊友： 任務完成後，叫首席代理關閉特定的隊友，最後再執行 /cleanup 清理資源。

---

專家建議：避免浪費 Token

• 詳細的啟動提示： 雖然隊友會讀取 CLAUDE.md，但他們不會繼承首席代理的對話歷史。啟動時給予明確的背景資訊。

• 切割任務粒度： 任務太小則協調成本太高；太大則容易跑偏。最好的單位是：一個函式、一個測試檔、或是一次代碼審查。

• 檔案分工： 確保每個隊友負責不同的檔案路徑。

---

目前的侷限（請注意）

• 不支援階段恢復： 如果你使用 /resume 或 /rewind，目前的隊友可能會消失，必須重新生成。

• 狀態延遲： 有時隊友做完了卻沒更新工作清單，這時需要你或首席代理去「推」它一下。

• 終端機限制： VS Code 內建終端機目前不支援「分欄顯示模式」。

---