RESEARCH · 2026-05-29

Claude Subagents vs Agent Teams：什麼時候用委派，什麼時候用團隊

Claude Subagents 適合「單一主線 + 專注委派」：把搜尋、分析、code review、測試等容易污染主 context 的工作丟到獨立 context，最後只拿摘要回來。Agent Teams 適合「多角色協作」：多個 Claude Code session 各自工作，由 team lead 協調……

日期2026-05-29
對象Claude Subagents, Agent Teams
來源4 篇
01

TL;DR

摘要
TL;DR
Claude Subagents 適合「單一主線 + 專注委派」：把搜尋、分析、code review、測試等容易污染主 context 的工作丟到獨立 context，最後只拿摘要回來。Agent Teams 適合「多角色協作」：多個 Claude Code session 各自工作，透過共享 task list 與 mailbox 溝通，由 team lead 協調、分派、綜合結果。實務上，日常開發先用 Subagents；只有當任務真的需要跨角色討論、跨層分工、競爭假設或多工作流同步時，才升級到 Agent Teams。
02

架構圖解

委派 · 協作 · 選型

運作模式差異

Subagents 像是主 agent 派出去的專案助理；Agent Teams 則是由 team lead 帶多個完整 Claude Code session 一起協作。

← 左右滑動檢視完整架構圖 →
Subagents Agent Teams Main Agent Subagent Subagent Subagent Result Result Result Spawn Spawn Spawn Work Work Work Report back Main Agent (Team Lead) Spawn team & assign tasks Shared Task List Teammate Teammate Teammate Communicate Communicate Communicate & claim tasks & claim tasks & claim tasks mailbox mailbox Work Work Work

選型決策流程

用成本最低、協調最少的工具先解題；只有任務本身需要協作時，才升級成團隊。

1. 只是探索 / review / 測試？ 先用 Subagent，把雜訊留在獨立 context，只讓結論回主線。
2. 角色需要互相 challenge？ 例如 FE、BE、QA 要互相驗證，或 debugging 有多個競爭假設，考慮 Agent Teams。
3. 會不會改同一批檔案？ 如果 ownership 切不乾淨，Agent Teams 會增加衝突；先拆清楚再開團隊。
4. 平行收益大於 token 成本？ 是：Agent Teams。否：維持單 session 或 Subagents。
03

對比表

Claude Subagents · Agent Teams
← 左右滑動檢視完整表格 →
面向Claude SubagentsAgent Teams
核心定位單一 Claude Code session 內的委派工作者多個 Claude Code sessions 組成的協作團隊
協調方式主 agent 產生任務，subagent 完成後回報摘要team lead 分派工作，teammates 共享 task list 並互相傳訊
Context每個 subagent 有自己的 context window，結果回主 context每個 teammate 是完整獨立 session，有自己的 context window
溝通模型subagent 主要向呼叫者回報，彼此不直接協作teammates 可透過 mailbox 直接溝通，也可被使用者直接介入
成本較低，因為只把摘要帶回主 session較高，每個 teammate 都是獨立 Claude instance，token 隨人數增加
最適合codebase 探索、研究摘要、review、測試、單點分析跨前後端與測試、平行研究、競爭假設除錯、新模組多角色設計
風險回報摘要可能漏細節；不適合需要多 agent 互相挑戰的工作協調成本、檔案衝突、session 清理與 task coordination 限制
成熟度Claude Code 核心能力，支援自訂 .claude/agents/Experimental，預設關閉，需要 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
04

詳細分析

逐項拆解

Claude Subagents

Subagents 是 Claude Code 裡的專門化工作者。官方文件把它定位為「specific workflows and improved context management」：當某個 side task 會塞滿主對話，例如大量搜尋結果、log、檔案內容或探索紀錄，就讓 subagent 在自己的 context 中完成，只把結論帶回主 session。

Subagents 的強項不是「組織管理」，而是「隔離與重用」：

  • 隔離 context：探索大型 codebase、跑大量檔案閱讀、整理錯誤 log，不會污染主對話。
  • 限制工具權限：可把 reviewer / researcher 設成 read-only，降低誤改檔案風險。
  • 角色可重用：用 .claude/agents/*.md 或 SDK agents parameter 定義 code reviewer、debugger、data scientist 等角色。
  • 模型與成本控制：特定任務可用更快或更便宜的模型，例如探索型任務不一定要用最高階模型。
  • 使用方式輕量：可以讓 Claude 自動委派，也可以明確要求「use the code-reviewer subagent」或 @agent-name。

Subagents 的限制也很清楚：它們通常是「工作完回報」的模式。當問題需要多個角色互相 challenge、共享任務狀態，或你想直接跟每個 worker 對話，subagents 就會開始不夠用。

Agent Teams

Agent Teams 是 Claude Code 的 experimental 多 session 協作機制。官方文件描述為「multiple Claude Code instances working together as a team, with shared tasks, inter-agent messaging, and centralized management」。架構上包含 team lead、teammates、shared task list、mailbox。

Agent Teams 的價值在於「協作本身」：

  • team lead 協調：主 session 充當主管，建立團隊、分配任務、整合結果。
  • teammates 獨立運作：每個 teammate 是完整 Claude Code session，有自己的 context window。
  • 共享 task list：任務可 pending / in progress / completed，也支援依賴關係與認領機制。
  • mailbox 溝通：teammates 可以互相傳訊，不只能回報給 lead。
  • 使用者可介入單一 teammate：可直接對特定 teammate 補指令、改方向、追問細節。
  • 可重用 subagent 定義：teammate 可以使用既有 subagent role，例如 security-reviewer、qa、fe-dev。

Agent Teams 最適合「平行探索真的會增加價值」的情境：研究與 review、各自獨立的新模組、跨 frontend/backend/test 的變更、用競爭假設除錯。官方也提醒，Agent Teams 會增加協調成本並使用顯著更多 tokens；如果是順序任務、同檔案密集修改、強依賴工作，單一 session 或 subagents 反而更有效。

與 Dynamic Workflows 的邊界

官方 parallel agents overview 也把 Dynamic Workflows 放在相鄰位置。簡化來看：

  • Subagents：主 agent 即時委派幾個 side tasks。
  • Agent Teams：Claude 組一個可互相溝通的團隊，由 lead 協調。
  • Dynamic Workflows：用 workflow/script 承載計畫，跑大量 subagents 並交叉驗證，適合 500-file migration、codebase-wide audit、跨角度研究等超大任務。

所以 Agent Teams 不是 Subagents 的全面替代品，而是「當協調與互相溝通成為任務本體」時的升級選項。

05

優缺點

取捨對照

Claude Subagents

優點
  • 啟動成本低，適合日常開發。
  • 可保持主 context 乾淨，降低長任務 context 污染。
  • 容易做 read-only 探索、review、測試與研究。
  • 可用 .claude/agents/ 或 SDK 重用角色定義。
  • token 成本通常比 Agent Teams 可控。
缺點
  • subagent 之間不會形成真正協作網路。
  • 結果回主 session 時可能被摘要壓縮，細節需要追問。
  • 對跨層、多角色、需要互相 challenge 的任務較弱。
  • 如果任務拆分不清，主 agent 仍要承擔大部分協調負擔。

Agent Teams

優點
  • 適合多角色平行工作：架構、FE、BE、QA、review 可各自持有工作流。
  • teammates 能直接溝通、共享 task list、處理依賴關係。
  • 使用者可直接介入單一 teammate，不必所有溝通都經過 lead。
  • 適合競爭假設與互相質疑的研究 / debugging 模式。
  • 可把既有 subagent 定義升級成 teammate role。
缺點
  • Experimental，預設關閉，需 Claude Code v2.1.32+ 並設定 feature flag。
  • token 使用量顯著增加；teammate 越多，成本越高。
  • 不適合同檔案密集編輯，容易產生檔案衝突。
  • 有 session resumption、task coordination、shutdown behavior 等已知限制。
  • 需要更明確的 ownership、完成定義與品質閘門，否則協作成本會吃掉平行收益。
06

結論

建議

建議採用「Subagents first, Agent Teams when coordination is the product」的策略。若任務只是探索、整理、review、測試或單點修復，優先使用 Subagents，因為它便宜、快、低干擾，而且能把主 context 保持乾淨。

當任務符合三個條件時再升級 Agent Teams：第一，工作可以拆成相對獨立的 ownership；第二，角色之間需要直接溝通或互相 challenge；第三，平行化節省的時間足以抵消額外 token 與協調成本。典型例子是前後端加測試同時開發、競爭假設除錯、跨模組 review、或大型規格到實作的 SDLC pipeline。

對 Merchant Portal 這類有 FE / BE / QA / spec designer 明確角色的專案，較穩的做法是：日常需求釐清與探索用 Subagents；進入跨層實作或 PR 退件迭代時，用 Agent Teams，並強制每個 teammate 有清楚檔案責任、完成標準、測試要求與回報格式。

07

參考來源

4 篇

MERCHANT PORTAL · RESEARCH · 2026-05-29 · 回首頁