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 条评论

登录 后参与评论

还没有评论,来抢沙发~