Claude Code Agent Teams：由設定到快捷鍵完整指南

Claude Code Agent Teams 係跟住 Opus 4.6 一齊推出嘅新功能。老實講，我覺得呢個功能喺現階段效率唔算高 — token 消耗大，協調開銷亦係實實在在嘅問題。

不過睇完 Tom（@tomcrawshaw01）嘅教學之後，我意識到呢個架構本身係值得了解嘅。趁住預覽階段熟悉佢，等到正式推出嘅時候就會有優勢。

單一智能體而家可以組建團隊

一個主導智能體（lead agent）會拆解工作，然後分配俾多個隊友同時並行執行。

同 sub-agent 最大嘅分別係：隊友之間可以直接互傳訊息。佢哋唔只係將結果報返俾主導智能體，仲會分享發現，甚至互相質疑對方嘅工作。

設定只需要30秒

呢個功能仲係實驗性質，所以預設係關閉嘅。一行設定就可以啟用。

喺你嘅 settings.json 入面嘅 env 區塊加入 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS，值設為 "1"。你亦可以用 shell 環境變數嚟設定，但 settings.json 會跨 session 保留，用起嚟更加方便。

你需要記住嘅快捷鍵

當團隊運行緊嘅時候，你會需要喺主導智能體同隊友之間切換嚟監控進度。要記嘅嘢唔多。

• Shift+Up / Shift+Down — 切換隊友（in-process 模式 — 大部分時間你會用呢個）
• Enter — 查看所選隊友嘅 session 詳情
• Escape — 中斷所選隊友當前嘅操作
• Ctrl+T — 開關共享任務列表
• Shift+Tab — 開關 Delegate 模式，鎖定主導智能體只做協調（唔寫 code）
• 分割面板模式 — 點擊隊友面板直接互動

Delegate 模式好重要。唔開嘅話，主導智能體有時會自己開始寫 code，而唔係將工作交俾隊友。

終端機相容性參差

分割面板模式只支援 tmux 同 iTerm2。VS Code 內建終端機、Windows Terminal 同 Ghostty 官方都唔支援。

如果你用緊 Ghostty，就要用預設嘅 in-process 模式，用 Shift+Up/Down 喺隊友之間切換。

想並排睇到隊友嘅輸出，可以喺 tmux session 入面執行 Claude Code。預設嘅 teammateMode 係 "auto"，偵測到 tmux 就會自動切換到分割面板模式。

我自己嘅做法係喺 iTerm 入面開 tmux new -s {my-project}，然後用 claude --teammate-mode tmux 啟動。呢樣可以全螢幕睇到所有團隊活動。

任務點樣流轉

工作圍繞住一個任務列表嚟組織。主導智能體建立任務，隊友負責認領執行。

• 當主導智能體建立任務列表之後，隊友會自動認領下一個未分配嘅任務
• 任務之間支援依賴關係 — 後續任務要等前置任務完成先會解鎖
• 你可以話俾主導智能體聽，將特定任務指派俾特定隊友
• 隊友關閉有一套流程：主導智能體發送關閉請求，隊友確認，然後退出
• 完整清理：確認所有隊友都已經關閉，然後指示主導智能體進行清理

一個簡單提到「team」嘅提示詞就會自動啟用呢個功能。但如果你想更精確咁控制，可以定義隊友總數、為每個隊友指定名稱同角色、設定委派範圍，以及提供一個外部檔案列明任務之間嘅依賴規則。

Token 消耗比你預期快好多

每個隊友都係一個獨立嘅 Claude Code session。並行運行會令成本急速攀升。以下幾個做法可以幫到手。

• 為隊友寫具體嘅 spawn 提示詞。主導智能體嘅對話歷史唔會帶過去 — 只有 CLAUDE.md 同 MCP server context 會自動載入
• 兩個隊友同時編輯同一個檔案會導致覆寫。將工作以檔案為單位嚟劃分
• 由研究或 code review 開始，唔好一開始就做 code generation。協調複雜度會低好多
• 保持任務單元細粒度而且具體 — 單一函數或者單一測試檔案嘅規模就啱

值得預先知道嘅限制

呢個仲係預覽版。有粗糙嘅地方係預期之內。提前了解可以慳返唔少時間同煩惱。

• 用 /resume 或者 /rewind 會終止 in-process 隊友。你需要叫主導智能體重新 spawn 新嘅隊友
• 任務狀態可能有延遲。如果隊友完成咗工作但冇標記任務為完成，後續任務就會一直被阻塞。記得手動檢查，然後叫主導智能體更新
• 每個 session 只支援一個團隊。隊友唔可以再建立子團隊
• 建立團隊嘅 session 會一直做主導。你冇辦法中途換主導或者將隊友升級做主導

預覽版仲比較粗糙，成本效益嘅問題亦未有定論。但如果你想了解多智能體工作流嘅發展方向，最快嘅方法就係開咗佢自己試。工具呢樣嘢，始終要親手用過先識得評價。