Claude Code 子代理、Agent Teams 與多工作樹並行怎麼選:三種並行機制區別與搭配

Claude Code 裏想「多開幹活」有三條官方路徑:子代理(Subagents)、智能體團隊(Agent Teams)和多工作樹(git worktree)。本文按官方文檔從調度方、文件衝突、相互通信、非交互兼容與額度開銷五個維度講清怎麼選、怎麼組合用。

NNathaniel bigo··原創首發·AI 輔助撰寫
10 分鐘讀完
資料核對於 2026-11-18 · 依據官方文檔與公開資料整理 Pro 帳號

結論先說

  1. 九成日常開發場景,「主會話 + 子代理(Subagents)」和「多工作樹(claude --worktree)」這兩招就已經夠用且最穩。
  2. 在同一個需求裏想「隔離翻日誌、搜代碼的上下文噪聲」,選子代理:它幹完活只把精簡結論還給主會話,還能單獨綁 haiku 省額度。
  3. 手裏同時推進兩個互不相干的需求(比如一邊寫新頁面、一邊修線上報錯),選 worktree 多會話並行:每個終端擁有獨立的分支和物理目錄,改文件絕不打架。
  4. 同一個複雜大問題需要多個角色分頭驗證假設、且角色之間必須互相發消息辯論協調時,才開實驗性的 Agent Teams。
  5. 盯緊兩個硬限制:寫腳本跑 claude -p 非交互模式時 Agent Teams 不會生成隊友;凡是多個實例要同時動手改同一批文件的順序任務,強行上團隊模式只會增加衝突和雙倍返工。

子代理、智能體團隊與多工作樹對比

圖:本站根據 Claude Code 官方文檔:Subagents 與 Agent teams 整理的示意圖

本文根據 Claude Code 官方文檔《Create custom subagents》《Orchestrate teams of Claude Code sessions》《Common workflows》整理,核對日期 2026-11-18。配圖為本站整理的示意圖,不是介面截圖。本站(bigolab.com)不是 Anthropic 官方網站。

適用於誰

  • 聽說 Claude Code 支持子代理、Agent Teams 和 worktree 多開,但每次接新需求都拿不準該開哪一種的人;
  • 開過並行任務後遇到「兩個代理同時改壞同一個文件」或者「一下午就把周額度燒光」的開發者;
  • 想知道這三種機制能不能疊在一起配合使用的人。

三種功能的具體命令細節可分別查閱 /guides/claude-code-subagents、/guides/claude-code-agent-teams 與 /guides/claude-code-worktree;本文專門解決「遇到具體活兒到底選哪個」的決策問題。

一、五維硬核拆解:它們在底層差在哪

很多人把這三者都叫「並行」,其實它們切分的東西完全不同:

1. 誰當大腦做調度

  • 子代理(Subagents):當前這一個主會話裏的 Claude 當大腦。它把子代理當成「帶獨立上下文的工具」派出去,子代理不能自己跟別的平級子代理聊天,做完必須原路彙報給調用者;
  • 智能體團隊(Agent Teams):一個會話當組長(Team Lead),拉起若干獨立隊友(Teammates)。隊友們共享同一份任務面板,隊友之間可以直接點對點發消息同步接口約定或互相挑錯,你本人也能隨時切過去單獨跟某個隊友對話;
  • 多工作樹(Multi-session Worktree):你本人當調度大腦。你在終端 A 跑功能甲,在終端 B 跑缺陷乙,兩個 Claude 會話彼此毫無關係。

2. 磁盤工作區會不會互相踩腳

這是實戰裏最容易翻車的地方:

  • 普通子代理和 Agent Teams 預設操作的是同一個項目目錄。如果兩個隊友同時編輯同一個路由註冊文件,後寫入的一方就會覆蓋前一方的改動;
  • 而 claude --worktree <名稱>(底層基於 git worktree)會在獨立目錄下檢出一個全新的工作副本和分支。你在工作樹 A 裏刪文件、跑構建,完全不會干擾工作樹 B 正在跑的單測。同時,同一倉庫的不同工作樹仍可共用本機的項目自動記憶,邊界說明見 /guides/claude-code-shared-memory-team-project。

Claude Code 三種並行方式怎麼選

圖:本站根據 Claude Code 官方文檔:Agent teams 與 Workflows 整理的示意圖

二、按真實研發場景對號入座

場景 A:正在改一個需求,要先查清 30 個關聯文件和跑測試報錯

  • 選子代理(Subagents)。如果在主會話裏直接讀 30 個文件,上下文瞬間塞滿一半;派內置的搜尋子代理或自定義測試子代理去查,主會話只收到十幾行定位摘要,上下文乾乾淨淨。

場景 B:下午要同時交付「導出報表新接口」和「登入頁樣式修復」

  • 選多工作樹(claude --worktree)。這是兩件毫無交集的事,完全沒必要讓一個組長 Agent 在中間傳話浪費額度。直接開兩個終端,各自進獨立 worktree 會話推進,誰先寫完誰先提 PR。

場景 C:排查一個詭異的偶發線上死鎖,有三種嫌疑方向需要同步深挖對質

  • 選智能體團隊(Agent Teams)。按官方文檔推薦的「競爭假設排錯」用法,讓組長派出三個隊友各查一條鏈路,並要求它們互相推翻對方的證據,比單個會話順着第一印象一條道走到黑更容易逼近真因。

場景 D:在 CI 流水線或定時腳本里用 claude -p 批處理

  • 只能選子代理或多進程腳本,不能選 Agent Teams。官方文檔明確說明:在 -p 非交互模式下不會生成團隊隊友。

三、進階用法:把它們兩兩組合起來

這三種機制並不是互斥的,最順手的高效搭配是「外層用 Worktree 隔離不同需求,內層用 Subagents 隔離上下文噪聲」:

  1. 終端 1 運行 claude --worktree feat-billing 開發帳單模組,會話內部調用只讀子代理查舊錶結構和跑單測;
  2. 終端 2 運行 claude --worktree fix-export 修導出問題,互不阻塞等待;
  3. 各自改完準備提交前,在各自終端再喚起一個只讀代碼審查子代理把關。

需要注意額度規劃:無論開多個 Worktree 終端還是拉起 Agent Teams,活躍會話數翻倍都意味着單位時間內的訂閱配額消耗同步加快。經常多窗口並行開發的重度用戶若發現 Pro 套餐的滾動窗口經常觸發限流,可以到 /chongzhi/claude-max 對照 Max 各倍率檔位的官方額度規則。

常見問題

Q:我已經開了 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1,平時普通子代理還能用嗎?

能用,但要注意官方文檔提到的一個行為變化:開啟該實驗變量後,如果 Claude 在委派任務時主動給子代理起了名字,這個被命名的代理會以「團隊隊友」身份啟動而不是普通輕量調用。平時不需要團隊模式時,建議不在全局常駐開啟,只在需要的項目或終端臨時注入環境變量。

Q:自定義子代理也能單獨跑在隔離的 worktree 裏嗎?

新版 Claude Code 支持為需要寫文件的子代理配置工作樹隔離選項,避免後台代理改動當前主會話正在編輯的文件;具體字段寫法以本機版本的官方 Subagents 文檔為準。

Q:前端隊友和後端隊友一起改接口時,怎麼防止它們把公共配置文件改衝突?

在組長分配任務時,明確按目錄或文件劃定所有權邊界(例如前端隊友只改 src/web/、後端隊友只改 src/api/,公共類型定義先由一方定稿鎖死後再並行寫實現)。

相關教學

參考資料

  • Claude Code 官方文檔:Create custom subagents — https://code.claude.com/docs/en/sub-agents
  • Claude Code 官方文檔:Orchestrate teams of Claude Code sessions — https://code.claude.com/docs/en/agent-teams
  • Claude Code 官方文檔:Common workflows — https://code.claude.com/docs/en/common-workflows
  • Claude Code 官方文檔:Manage costs effectively — https://code.claude.com/docs/en/costs

Nathaniel 的更多內容

  1. 01

    LangGraph 流式輸出(Streaming)詳解:逐字 Token 流、節點進度與自定義事件寫法

    多步智能體如果等全部節點跑完才返回,網頁前端就會白屏乾等十幾秒。本文按 LangGraph 官方文檔講清 updates、messages、custom 與 values 四種 stream_mode 的區別,以及組合訂閱逐字打字機輸出加工具內部實時進度的完整代碼。

    其他 AI 工具0
  2. 02

    LangGraph 持久化與長期記憶怎麼配:Checkpointer、Store 與 PostgreSQL 實戰

    在生產環境跑 LangGraph,單靠 InMemorySaver 一重啟就會丟失全部對話。本文按官方文檔講清線程內短期檢查點(Checkpointer)與跨線程長期記憶(Store)的分工,以及用 langgraph-checkpoint-postgres 對接 PostgreSQL 的完整步驟。

    其他 AI 工具0
  3. 03

    LangGraph 多智能體怎麼寫:Supervisor 主管包與 Subgraph 隔離子圖實戰

    在 LangGraph 裏把單個圖擴展成多智能體協作有兩條官方路線:快速原型用預置包 langgraph-supervisor,大型生產系統用原生子圖(Subgraph)嵌套。本文講清兩種寫法的完整代碼、私有狀態隔離防 Token 膨脹技巧以及檢查點傳播規則。

    其他 AI 工具0
  4. 04

    LangGraph 人工介入審批怎麼寫:interrupt 暫停圖運行與 Command 恢復實戰

    企業之所以選 LangGraph,很大程度看中它能安全掛起等待人工審批(Human-in-the-Loop)。本文按官方最新規範講清 interrupt() 動態暫停、Checkpointer 必備條件、Command(resume=...) 恢復執行,以及防止副作用重複運行的重入規則。

    其他 AI 工具0
  5. 05

    多 Agent 協作平台怎麼選:Dify、釦子(Coze)、n8n 與 LangGraph 多智能體機制對比

    搜「多agent協作平台」時,Dify、釦子、n8n 和 LangGraph 都宣稱支持多智能體,但底層的調度方式完全不同。本文跳過基礎安裝,專門從多 Agent 角色跳轉、子代理工具調用、上下文隔離與私有化部署四個維度幫你一次選準。

    其他 AI 工具0
  6. 06

    企業微信有官方 MCP 和 CLI 嗎:@wecom/cli 安裝初始化、長連接機器人與接入教學

    搜「企業 微信 有 mcp 嗎」不用再東拼西湊民間群機器人腳本了:企業微信官方已推出 @wecom/cli 命令行工具並內置 stdio 模式的 MCP Server。本文按官方開發者文檔講清安裝、智能機器人長連接初始化、業務命令與接入 Claude Code 步驟。

    Claude其他 AI 工具0

同產品的其他教學

  1. 01

    MCP 收費嗎:開源協議免費邊界、第三方 API 帳單與隱形 Token 開銷說明

    搜「mcp 收費 嗎」的人常擔心裝多了插件會被扣費。MCP(模型上下文協議)本身和官方 SDK 採用 MIT 協議完全免費;實際使用中可能產生費用的只有兩處:掛載過多工具佔用的大模型上下文 Token,以及部分外部商業數據源自帶的 API 套餐。

    Claude其他 AI 工具0
  2. 02

    MCP 協議最新版本更新了什麼:無狀態架構、OAuth 2.1、結構化輸出與異步 Tasks 詳解

    搜「mcp 重大 更新」「mcp 協議 更新」想補齊規範演進脈絡?本文對照 modelcontextprotocol.io 官方規範更新日誌,梳理從 Streamable HTTP 到無狀態優先架構、OAuth 2.1 資源伺服器、Elicitation 交互補參與異步 Tasks 擴展的核心變化。

    Claude其他 AI 工具0
  3. 03

    A2A 和 MCP 有什麼區別:工具連接協議與智能體通信協議的邊界和配合

    很多人問「有了 MCP 為什麼還要出 A2A,兩者是不是二選一的競爭關係」。兩份官方規範都明確寫明它們是上下互補關係:MCP 負責給單個智能體掛載工具與數據源,A2A 負責讓多個獨立黑盒智能體跨團隊、跨框架互相派單協作。

    Claude其他 AI 工具0
  4. 04

    LangGraph 怎麼使用 MCP:用 langchain-mcp-adapters 接入本地與遠程工具

    想讓自建的 LangGraph 狀態圖直接調用現成的 MCP 伺服器,官方標準方案是安裝 langchain-mcp-adapters 並使用 MultiServerMCPClient。本文講清 stdio 與 streamable_http 兩種配置寫法、異步圖運行及按節點分工具技巧。

    Claude其他 AI 工具0
  5. 05

    LangGraph 入門教學:Python 安裝、核心概念與跑通第一個狀態圖智能體

    面向搜「python 安裝 langgraph」和「langgraph 中文 文檔」的初學者:本文按 LangChain 官方最新 Graph API 規範,講清安裝步驟、State/Node/Edge 四大概念,並從零寫出第一個帶工具調用循環的 StateGraph。

    Claude其他 AI 工具0
  6. 06

    Claude Agent SDK 子代理怎麼寫:AgentDefinition 配置、權限收斂與 Python/TS 示例

    在 Python 或 TypeScript 裏用 Claude Agent SDK 編排多角色協作,核心是配置 ClaudeAgentOptions 的 agents 字段與 AgentDefinition。本文講清必開的 Agent 委派權限、工具收斂、模型分級與完整代碼示例。

    Claude0

0 條評論

登入 後參與評論

還沒有評論,來搶沙發~