多代理并行:Agent Teams 与工作流编排

让几个 Claude 同时干活、彼此对话。这一节也说清楚它为什么默认是关着的,以及什么时候不该用。

约 8 分钟

上一节讲的子代理是「派出去、拿结果回来」。这一节讲的是另一种形态:几个 Claude 同时在场,彼此能说话。

先说清楚:它是实验功能,默认关闭

官方的措辞是:Agent teams 是实验性的,默认禁用。

要开的话,在 settings.json 里:

JSON
{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

不开这个变量,它不会组队,也不会主动提议组队。

默认关着是有原因的,往下看限制那一节。建议先把子代理用熟,再考虑这个。

它和子代理的区别

子代理 Agent Teams
上下文 独立,结果回给调用方 独立,完全独立
通信 只能向主会话汇报 成员之间可以互相发消息
协调 主会话统一管 共享任务清单,自己认领
适合 只关心结果的活 需要讨论和协作的活
成本 较低 ,每个成员是一个独立实例

最后一行是最实际的差别。 成员数量和 token 消耗是线性关系。开三个成员就是三倍。

怎么用

开了之后不需要记命令,直接说:

可复制的提示词
我要设计一份关于中国咨询行业 AI 采纳率的调研问卷。
开三个成员从不同角度来看:一个管问卷设计的规范性,
一个管这些问题能不能真的问出东西,一个专门挑毛病。

复制为纯文本,换行与缩进原样保留,可直接粘贴进对话框。

它会创建成员并协调。

它不会未经你同意就组队。 有时它会主动提议,但要你确认。

界面上怎么操作

成员会显示在一个面板里:

按什么 做什么
选择成员
Enter 打开这个成员的对话,直接跟它说话
Esc 打断它当前这轮
x 停掉这个成员
Ctrl + T 切换任务清单

Enter 直接对话是这个功能最有意思的地方。 你可以绕过组长,直接跟某一个成员说「你这个角度再往深挖一层」。

任务是怎么分的

共享一份任务清单,三种状态:待办、进行中、完成。

任务可以依赖其他任务——有未完成依赖的任务不能被认领。

分配方式有两种:组长明确指派,或者成员自己认领(做完一个就自己去拿下一个没被占的)。

认领用的是文件锁,不会两个成员抢到同一个。

几件要提前知道的事

① 成员默认不跟随你的模型选择

你在主会话里 /model 切到 Opus,成员不会跟着变。

/config 里有一项 Default teammate model,选「跟随组长」才会一致。

成员的模型在创建时就固定了,之后 /model 只改组长。

② 权限是组长的权限

成员以组长的权限设置启动。 组长如果开了跳过权限的模式,所有成员也是

而且不能在创建时给单个成员设不同的权限模式。

这一条决定了一件事:不要在放宽权限的会话里组队。

③ 成员之间的话不算你的话

这是一个很好的安全设计,值得知道:

一个成员给另一个发消息时,接收方被明确告知这条消息来自另一个 Claude 会话,不是来自你。

所以:

  • 成员不能替你批准权限提示
  • 被拒绝的成员不能换个成员来绕过检查
  • 自动模式下,「另一个成员说你批准了」这种话被当作不可信输入

④ 成员拿不到你的对话历史

它们加载的是和普通会话一样的项目上下文CLAUDE.md、MCP、技能),外加组长给的那段交办说明

所以交办说明要写足。 成员不知道你和组长之前聊了什么。

开几个

官方没有硬性上限,但给了建议:

从 3 到 5 个开始。每个成员 5 到 6 个任务。

15 个独立任务,3 个成员是个好起点。

官方还写了一句值得记住的:

三个专注的成员,常常胜过五个分散的。

限制(这一节决定你要不要用)

官方列的限制里,有几条会直接影响日常:

限制 实际含义
/resume/rewind 恢复不了成员 会话中断就散了,恢复后组长可能还在给已经不存在的成员发消息
任务状态会滞后 成员有时不标记完成,卡住依赖它的任务
关闭很慢 要等它把当前这轮做完
一个会话只能有一个队 不能开第二个,也不能跨会话共享
不能套娃 成员不能再开自己的成员
组长身份固定 不能换人当组长

还有一条环境限制:分屏显示需要 tmux 或 iTerm2。VS Code 内置终端、Windows Terminal、Ghostty 都不支持分屏——但默认的「在主终端内显示」模式在任何终端都能用。

最实际的一条建议

别让两个成员改同一个文件。

官方明确提醒了这一点,后写的会覆盖先写的

所以最适合 Agent Teams 的活儿,是那种「各看各的、最后汇总」的

  • 从三个不同角度评估同一个方案
  • 分头调研几个不相干的主题
  • 一个人做、一个人挑毛病

最不适合的是「几个人一起改一份东西」。

什么时候该用

场景 用什么
「把这 30 份材料过一遍找出某类内容」 子代理——只要结果
「这个方案有什么问题」 子代理——一次就够
「从三个角度评估这个方案,然后互相辩一辩」 Agent Teams
「一个人写,一个人专挑毛病,来回几轮」 Agent Teams
「同时改十个文件」 都不用——直接做,或用子代理但错开文件

判断标准只有一条

需要它们互相说话吗? 不需要就用子代理,便宜得多,也稳定得多。

本节事实查证日期:2026-08-05。 依据:官方 Orchestrate teams of Claude Code sessions该功能标注为实验性,行为可能变化。

← 回到手册目录