多代理并行:Agent Teams 与工作流编排
让几个 Claude 同时干活、彼此对话。这一节也说清楚它为什么默认是关着的,以及什么时候不该用。
上一节讲的子代理是「派出去、拿结果回来」。这一节讲的是另一种形态:几个 Claude 同时在场,彼此能说话。
先说清楚:它是实验功能,默认关闭
官方的措辞是:Agent teams 是实验性的,默认禁用。
要开的话,在 settings.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。 该功能标注为实验性,行为可能变化。