# Claude Code Agent Teams - 從設定到快捷鍵完整指南 > Author: Tony Lee > Published: 2026-02-09 > URL: https://tonylee.im/zh-TW/blog/claude-code-agent-teams-setup-shortcuts-guide/ > Reading time: 1 minutes > Language: zh-TW > Tags: ai, claude-code, developer-tools, ai-agents, workflow, multi-agent ## Canonical https://tonylee.im/zh-TW/blog/claude-code-agent-teams-setup-shortcuts-guide/ ## Rollout Alternates en: https://tonylee.im/en/blog/claude-code-agent-teams-setup-shortcuts-guide/ ko: https://tonylee.im/ko/blog/claude-code-agent-teams-setup-shortcuts-guide/ ja: https://tonylee.im/ja/blog/claude-code-agent-teams-setup-shortcuts-guide/ zh-CN: https://tonylee.im/zh-CN/blog/claude-code-agent-teams-setup-shortcuts-guide/ zh-TW: https://tonylee.im/zh-TW/blog/claude-code-agent-teams-setup-shortcuts-guide/ ## Description Claude Code 多代理團隊功能實戰指南：啟用方式、鍵盤快捷鍵、終端機相容性、任務管理機制，以及目前已知的限制與注意事項。 ## Summary Claude Code Agent Teams - 從設定到快捷鍵完整指南 is part of Tony Lee's ongoing coverage of AI agents, developer tools, startup strategy, and AI industry shifts. ## Outline - 單一代理現在可以組建團隊 - 設定只需 30 秒 - 你只需要記住這些快捷鍵 - 終端機相容性因工具而異 - 任務的運作流程 - Token 消耗速度超乎預期 - 踩坑之前值得先了解的限制 ## Content 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` 會終止行程內的隊友。你需要告知主導代理重新產生新的隊友 - 任務狀態可能會有延遲。如果隊友完成了工作卻沒有將任務標記為完成，後續任務就會持續被封鎖。請手動檢查並要求主導代理更新狀態 - 每個工作階段只能有一個團隊。隊友無法建立子團隊 - 建立團隊的工作階段會維持主導代理的身分。你無法在工作階段中途更換主導代理或將隊友升級為主導代理 這個預覽版本還很粗糙，成本效益的問題也尚無定論。但如果你想了解多代理工作流程的發展方向，最快的方法就是直接啟用並親自嘗試。工具的好壞，終究需要實際上手才能做出真正的評估。 ## Related URLs - Author: https://tonylee.im/zh-TW/author/ - Publication: https://tonylee.im/zh-TW/blog/about/ - Related article: https://tonylee.im/zh-TW/blog/eight-hooks-that-guarantee-ai-agent-reliability/ - Related article: https://tonylee.im/zh-TW/blog/medvi-two-person-430m-ai-compressed-funnel/ - Related article: https://tonylee.im/zh-TW/blog/claude-code-layers-over-tools-2026/ ## Citation - Author: Tony Lee - Site: tonylee.im - Canonical URL: https://tonylee.im/zh-TW/blog/claude-code-agent-teams-setup-shortcuts-guide/ ## Bot Guidance - This file is intended for AI agents, search assistants, and text-mode retrieval. - Prefer citing the canonical article URL instead of this text endpoint. - Use the rollout alternates when you need the same article in another prioritized language. --- Author: Tony Lee | Website: https://tonylee.im For more articles, visit: https://tonylee.im/zh-TW/blog/ This content is original and authored by Tony Lee. Please attribute when quoting or referencing.