Agent Teams：什么时候该拉队伍，什么时候用子代理就够

一件活拆成互不相干的三块，单会话只能串着干。子代理能把脏活丢到别的窗口，但彼此不知道对方在查什么。Agent Teams 换了一套模型：队友独立上下文，共享任务清单，还能互发消息。

它仍是实验能力。版本要够，还要手动打开。会话恢复、任务状态、关闭行为都有已知限制，关键路径别无人值守全交给它。

已有的子代理介绍讲单向汇报。这篇只讲队伍怎么开、和子代理怎么选、以及容易踩的坑。具体旗标以你机器上的 /help 和官方 Agent Teams 页为准。

先分清要不要互相说话

	子代理	Agent Teams
通信	只向主会话交摘要	队友之间可直接发消息
协调	主会话派活	共享任务清单，可自认领
适合	只要结果的独立子任务	要多视角、要互相质疑的活
Token	相对低	随活跃队友近似线性涨

只要结果、过程不重要，用子代理。要辩论、要并行评审、要前后端同时推进，再开队伍。不要看见「并行」就无脑拉人。

怎么打开

公开说明里的门槛大约是 Claude Code v2.1.32+。先看：

bash

claude --version

再打开实验开关。可写进 settings.json 的 env：

json

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

重启会话后，用自然语言描述队伍即可，例如并行评审一个 PR、各查一个崩溃假设、前后端和测试各管一层。

一支队大致有队长、队友、共享任务清单、信箱。配置和任务会落在本机 ~/.claude/teams/、~/.claude/tasks/ 一带。那些文件带运行时状态，不要手改，也不要指望项目里自造一份 teams.json 当配置。

任务可以设依赖：前置没完，下游领不走。多人抢同一任务靠文件锁。代码文件的写冲突没有自动合并，拆活时让每人管不同文件集。

显示：`auto`、进程内、分屏

默认是 auto：你已经在 tmux 里就分屏，否则队友跑在主终端里。固定写法：

json

{
  "teammateMode": "in-process"
}

只改这一次：

bash

claude --teammate-mode in-process

VS Code 内置终端、Windows Terminal、Ghostty 等环境往往不能分屏，只能进程内。常用键：Shift+Down 在队友间循环，Enter 进入，Escape 打断当前轮，Ctrl+T 看任务清单。进程内模式下队友「没出现」时，先按 Shift+Down 确认是不是已经在跑。

什么活值得开

并行评审：安全、性能、测试各戴一副眼镜看同一份改动，最后由队长汇总。

竞争假设调试：几个队友各押一个原因，并被要求互相拆台，减轻锚定。

跨层开发：接口、界面、测试分开文件集并行。同一文件两人同改，后写覆盖先写。

高级控制里几条常被漏：

计划审批：先出方案，队长批了再改代码。
指定模型：队友默认不跟队长的 /model。简单活在提示里写用 Sonnet，或在配置里设默认队友模型。
复用子代理类型：派队友时可引用已有 agent 定义；团队协作工具仍可用，定义里的部分 MCP / skills 字段当队友时可能不生效，以当前文档为准。
Hooks：TeammateIdle、TaskCreated、TaskCompleted。退出码 2 表示拦住并带反馈，例如测试没过就不许标完成。Hooks 通用结构见 CLAUDE.md 管倾向，Hooks 才是铁律。

成本与避坑

Token 随活跃队友涨，没有固定「三到四倍」。例行串行活用单会话更省。控成本：先评估值不值得并行；简单子任务挂便宜模型；队友数量先从三到五个试；干完就关。

常见坑：

/resume、/rewind 救不回进程内队友，恢复后可能要队长重拉。
任务状态会滞后，卡住时先确认活是否真做完。
一次只带一支队；清理让队长做，别让队友自己清。
不能嵌套队伍；队长身份不能转。
权限模式在生成时跟队长走。队长开了跳过权限，队友一起跳过。之后可单独改某个队友，生成当下不能一人一模式。
队长可能误判「都完了」提前收工，明确告诉它等队友结束。

先拿评审、调研、排障练手，再上并行改代码。和子代理、Hooks、MCP 叠着用时，先问这件事要不要互相说话，再问漏一次会不会出事。

Agent Teams：什么时候该拉队伍，什么时候用子代理就够 ​

先分清要不要互相说话 ​

怎么打开 ​

显示：auto、进程内、分屏 ​

什么活值得开 ​

成本与避坑 ​