这简直是绝了

Anthropic 刚刚分享了 Claude Code 最实用的技巧之一

核心思路：让 Opus 5.5 担任主导，同时并行调度一群廉价的 Haiku 5.5 队友

每个任务都拥有 Opus 级别的架构质量，却不必在日常轮次中消耗 Opus 的上下文

启动方式如下：

export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
claude --model opus --teammate-mode auto

分工如下：

→ Opus 5.5 领导团队，将任务拆解为有向无环图（DAG），并最终审核签字 → Haiku 5.5 以自治队友身份成群行动，各自在独立的上下文窗口中工作 → Sonnet 5.5 执行重型多文件重构，且不会阻塞其他队友 → 你不必再让 Opus 的上下文被上百份 agent 记录白白吃掉

Opus 只在三个关键时刻介入：

→ 开跑前，把你的目标拆解为依赖关系 DAG → 队友修改文件前，审核 diff 方案 → 任何东西上线前，对验证过的结果签字确认

Opus 统领 · Haiku 蜂群 · Sonnet 交付

JEV 的工程思路就是同一招的下一层版本：那些不需要思考者介入的分叉（该选哪个文件、该调用哪个工具、是重试还是停止）在毫秒级路由给 JEV，大模型只处理真正产生分支的节点

完整的树形结构：

Opus 5.5 运行主领队会话，协调任务 DAG security 在 Haiku 5.5 上审计认证和 JWT 处理 perf-scout 在 Haiku 5.5 上剖析 p99 延迟瓶颈 qa-engine 在 Haiku 5.5 上执行完整测试套件 patcher 在 Sonnet 5.5 上重构复杂的多文件逻辑 Opus 5.5 只读取经过验证的 PR diff JEV 在毫秒级路由微分叉

把这棵树和下面的提示词粘贴到 Claude Code ↓

“围绕这棵树重建我的 Claude Code 配置：

1. 启用 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 并使用 –teammate-mode auto
2. 在 Opus 5.5 上运行主领队会话，将任务拆解为依赖关系 DAG
3. 在 Haiku 5.5 上并行启动三个队友，分别负责安全、性能和 QA
4. 让队友自行认领无阻塞依赖的任务，通过 P2P 邮箱协调发现，并在修改代码前先草拟方案
5. 将重型多文件补丁路由到 Sonnet 5.5，将快速确定性分叉路由到 JEV 先以 diff 形式展示所有改动，我说 go 之前不要执行编辑“

↳ http://code.claude.com/docs/en/agent-teams…

收藏起来，你以后在每个正经代码库上都会用到它

编排多个 Claude Code 会话组成的团队 - Claude Code 文档

来源：https://code.claude.com/docs/en/agent-teams

Agent teams 让你能够协调多个协同工作的 Claude Code 实例。其中一个会话充当团队领队，负责协调工作、分配任务和汇总结果。队友各自独立工作，每个都在自己的上下文窗口中，并且可以直接相互通信。你也可以直接与任何队友对话，无需通过领队。

在搭建团队之前，请先确认更轻量的方案是否已经够用： 子代理（Subagents） 在单个会话内工作；配合跨会话消息传递，Claude 可以在你自己运行的多个会话之间传递发现。

何时使用 Agent Teams

Agent Teams 在并行探索能带来真实价值的任务中最为有效。完整的场景请参见用例示例。最强的用例包括：

• 调研与评审：多个队友可以同时调查问题的不同方面，然后共享并互相质疑彼此的发现
• 新模块或新功能：每个队友各负责一块，互不干扰
• 多假设并行调试：队友并行验证不同的假设，更快地收敛到答案
• 跨层协调：改动横跨前端、后端和测试，由不同的队友各自负责

Agent Teams 会带来协调开销，且消耗的 token 明显多于单个会话。它们在队友能够独立运作时效果最佳。对于顺序执行的任务、同文件编辑或依赖关系很多的工作，单个会话或子代理更为高效。

与子代理的对比

Agent Teams 和子代理都可以让你并行化工作，但运作方式不同。关于无需团队、但可以互相传递消息的独立会话，请参见跨会话消息传递。

子代理与 Agent Team 架构对比图。子代理由主 agent 生成，完成工作后向主 agent 汇报结果。Agent Teams 通过共享任务列表协调，队友之间可以直接通信。

子代理向主 agent 汇报结果。在 Agent Teams 中，队友共享一个任务列表，认领工作，并直接相互通信。

当你需要快速、专注的执行者并向你汇报时，使用子代理。当队友需要共享发现、互相质疑并自主协调时，使用 Agent Teams。

启用 Agent Teams

Agent Teams 默认是禁用的。通过在 shell 环境或 settings.json 中将 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS 环境变量设为 1 来启用：

启用 Agent Teams 还会改变普通的委派行为。Claude 可能会自行命名一个子代理，而在 Agent Teams 启用期间，Claude 命名的子代理会以队友身份启动，因此即使你没有主动要求，团队也可能自动形成。更多信息请参见 Claude 如何启动 Agent Teams；要关闭此行为，请参见 Claude 生成队友而非子代理。

生成队友还需要一个交互式会话。在使用 -p 标志的非交互模式（包括 Agent SDK 会话）中，Claude 不会生成队友，即使 Agent Teams 已启用，Claude 命名的子代理也会作为普通的子代理运行。

启动你的第一个 Agent Team

启用 Agent Teams 之后，用自然语言描述任务以及你想要的队友角色。Claude 会根据你的提示生成队友并协调工作。

这个示例效果很好，因为三个角色彼此独立，可以在不等待对方的情况下探索问题：

接下来，Claude 会在拥有 Task 工具的会话中填充共享任务列表，为每个视角生成队友，让他们探索问题，并在完成后汇总发现。

Claude 有时可能会使用子代理而非创建团队。子代理和队友会出现在同一个 agent 面板中，因此仅凭面板无法确认是否形成了团队。如果 Claude 生成的是子代理，请再次提出请求并明确要求一个 Agent Team。

领队的终端会在提示输入框下方的 agent 面板中列出队友。通过该面板：

• 上下方向键：选择队友
• Enter：打开所选队友的记录并直接给它发消息
• Escape：清除选择。当你正在查看某个队友的记录时，按 Escape 会中断该队友当前的轮次

只要有队友或子代理仍在工作，空闲队友的行就会一直保留在面板中，你可以随时选中它来查看记录或分配更多工作。当面板中所有 agent 都处于空闲状态后，空闲行会在 30 秒后隐藏，队友的下一轮开始时会重新出现；隐藏期间队友仍在运行且可被寻址。

当同时有超过三个队友空闲时，前三个之后的行会折叠为一行，并显示被折叠的队友数量，例如五个空闲时显示 2 idle agents。选中并按 Enter 可以展开折叠的行，再按 Esc 可以重新折叠。正在工作的队友、失败的队友以及你正在查看的队友始终保留自己的行。

如果你想让每个队友拥有独立的分屏窗格，请参见选择显示模式。

控制你的 Agent Team

用自然语言告诉领队你想要什么。它会根据你的指令处理团队协调、任务分配和委派。

选择显示模式

Agent Teams 支持两种显示模式：

• 进程内（In-process）：所有队友都在你的主终端内运行。在 agent 面板中使用上下方向键选择队友，然后按 Enter 查看并直接输入消息。适用于任何终端，无需额外配置。
• 分屏窗格（Split panes）：每个队友拥有独立的窗格。你可以同时看到所有人的输出，并点击窗格直接交互。需要 tmux 或 iTerm2。

默认值为 "in-process"。设置为 "auto" 时，当你已在 tmux 会话内运行，或终端为 iTerm2 且已安装 it2 CLI 时会启用分屏模式，否则回退到进程内模式。"tmux" 设置启用分屏模式，并根据你的终端自动检测使用 tmux 还是 iTerm2。"iterm2" 明确使用 iTerm2 原生分屏模式。该模式需要 it2 CLI，如果 it2 缺失会显示包含安装命令的错误提示。

提供安装 it2 或切换到 tmux 的设置提示会在终端为 iTerm2 且 tmux 作为备选可用时，在 "auto" 或 "tmux" 模式下出现。

要覆盖默认值，在 ~/.claude/settings.json 中设置 teammateMode：

要为单次会话设置模式，通过标志传递：

--teammate-mode 标志是实验性的，不会出现在 claude --help 中。

分屏模式需要 tmux 或安装了 it2 CLI 的 iTerm2。手动安装方式：

• tmux：通过系统包管理器安装。请参见 tmux wiki 获取平台相关的说明。
• iTerm2：安装 it2 CLI，然后在 iTerm2 → Settings → General → Magic → Enable Python API 中启用 Python API。

指定队友和模型

Claude 会根据任务自行决定生成队友的数量，你也可以精确指定：

Claude Code 按以下优先级选择每个队友的模型（取第一个适用的来源）：

1. 你在生成提示中为该队友指定的模型。
2. 如果队友是从子代理定义生成的，则使用定义中的 model，其中 inherit 表示继承领队的模型。
3. CLAUDE_CODE_SUBAGENT_MODEL（环境变量），当其设为非 inherit 的值时。
4. 领队当前使用的模型。

如果已安装的 mod 在其 agent.spawn 钩子中设置了模型，Claude Code 会使用该模型替代第一个来源。

如果你设置了 CLAUDE_CODE_SUBAGENT_MODEL_FORCE=1（文档），前两个来源不再适用。Claude Code 会从 CLAUDE_CODE_SUBAGENT_MODEL 中选择模型（当其设为非 inherit 的值时），否则使用领队当前的模型。需要 Claude Code v2.1.257 或更高版本。在 v2.1.251 之前，CLAUDE_CODE_SUBAGENT_MODEL 在此优先级中排在最前面。

Claude Code 会检查为队友选择的模型是否在你组织的 availableModels（文档）白名单中。当白名单阻止某个值时，Claude Code 会替换为另一个模型：

• 如 opus 这样的系列别名：在 Anthropic API 和 AWS 上的 Claude Platform 上，Claude Code 会使用白名单允许的该系列最新版本运行队友。在使用提供商特定模型 ID 的提供商上（该替换机制不生效），被阻止的别名会按照下一条规则处理。
• 任何其他被阻止的值（包括在替换机制不生效的提供商上的系列别名，或其系列中没有被允许版本的别名）：Claude Code 会改用领队的模型运行队友。如果你设置了 CLAUDE_CODE_SUBAGENT_MODEL，Claude Code 会优先尝试该模型，遵循相同的规则。

默认情况下，队友继承领队的思考力度级别。在分屏模式下，此行为从 v2.1.186 开始生效；更早的版本不会将会话的思考力度传递给分屏队友。

让队友先规划再实施

对于复杂或高风险的任务，你可以让队友先规划再实施。当领队处于规划模式时 Claude 生成的队友，会以只读规划模式工作，直到方案就绪。先把领队切换到规划模式，然后再要求生成队友：

当队友完成规划后，它会向领队发送方案审批请求。Claude Code 会在请求到达时自动在领队会话中批准方案，无需领队审核。队友的编辑和命令仍然需要经过权限中描述的权限确认流程。批准后，队友退出规划模式并开始实施。

直接与队友对话

每个队友都是一个完整、独立的 Claude Code 会话。你可以直接给任何队友发消息，提供额外指令、追问问题或调整它们的方向。

• 进程内模式：在 agent 面板中使用上下方向键选择队友，然后按 Enter 查看其会话并输入消息。对选中的队友按 x 可以停止它。按 Ctrl+T 切换任务列表。
• 分屏模式：点击进入队友的窗格即可直接与其会话交互。每个队友拥有自己终端的完整视图。

当你正在查看进程内队友时，纯文本和技能会发送给该队友，内置命令则发送给领队的会话，并有以下安全保护：

• /compact、/clear 和 /rewind 作用于领队的对话，因此 Claude Code 会在从该视图中执行它们之前请求你确认。
• /model 和 /fast 设置的是领队的模型和快速模式，而非队友的，因此它们不会从该视图中执行。系统会通知你原因。

队友的模型和快速模式在生成时即固定。

分配和认领任务

共享任务列表用于协调整个团队的工作。领队创建任务，队友逐一完成。任务有三种状态：待处理、进行中和已完成。任务还可以依赖其他任务：带有未解决依赖的待处理任务在依赖项完成之前不能被认领。

没有 Task 工具的 agent 通过消息而非共享任务列表来协调。

领队可以显式分配任务，队友也可以自行认领：

• 领队分配：告诉领队把哪个任务分配给哪个队友
• 自动认领：完成一个任务后，队友自行接手下一个未分配且无阻塞依赖的任务

任务认领使用文件锁来防止竞态……