智能体团队

智能体团队是实验性功能，默认关闭。在 settings.json 或环境里设置 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 才能启用；没有这个变量，会话开始时不会建立任何团队。

智能体团队让你协调多个一起工作的 Claude Code 实例。一个会话充当团队负责人（lead），协调工作、分配任务并综合结果；队友各自独立工作，各有自己的上下文窗口，并且直接互相通信。

在搭团队之前，先看看更轻量的方案够不够用：子智能体在单个会话内工作；用跨会话消息，Claude 可以在你自己运行的会话之间传递发现。

何时使用

智能体团队在并行探索真能增加价值的任务上最有效：

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

智能体团队会增加协调开销，并比单个会话多消耗大量 token，当队友能独立工作时效果最好。对顺序任务、同文件编辑或依赖很多的工作，单个会话或子智能体更合适。

与子智能体对比：

需要快速、聚焦、汇报结果的工作者时用子智能体；队友需要分享发现、互相质疑并自行协调时用智能体团队。

启用

在环境里或通过 settings.json 把 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS 设为 1：

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

启用智能体团队也会改变普通的委派：Claude 可能自己给子智能体命名，而在智能体团队启用期间，Claude 命名的子智能体会作为队友启动，所以即使你没有要求，也可能形成团队。派生队友需要交互式会话；在用 -p 的非交互模式（包括 Agent SDK 会话）里，Claude 不会派生队友，它命名的子智能体作为普通子智能体运行。

开始你的第一个团队

启用后，用自然语言描述任务和你想要的队友，Claude 会派生它们并按你的提示协调工作。下面的例子之所以好，是因为三个角色相互独立，可以不等对方就探索问题：

I'm designing a CLI tool that helps developers track TODO comments across
their codebase. Spawn three teammates to explore this from different angles:
one on UX, one on technical architecture, one playing devil's advocate.

之后 Claude 会在有任务工具的会话里填充共享任务清单、为每个视角派生队友、让它们探索问题并综合发现。注意 Claude 有时会用子智能体而不是创建团队，而子智能体和队友出现在同一个智能体面板里，所以单看面板无法确认团队是否形成；如果 Claude 派生了子智能体，再问一次并明确要求队友。

负责人的终端在提示输入下方的智能体面板里列出队友：上下箭头选择队友；Enter 打开所选队友的转录并直接给它发消息；Escape 清除选择（在查看队友转录时，Escape 会打断该队友当前的回合）。同时空闲的队友超过三个时，超出的行会折叠成一行计数，如五个空闲时显示 2 idle agents。

控制你的团队

用自然语言告诉负责人你想要什么，它处理团队协调、任务分配和委派。

选择显示模式：智能体团队支持两种显示模式：

• in-process（进程内）：所有队友都在你的主终端里运行。在智能体面板里用上下箭头选队友，按 Enter 查看它并输入来直接给它发消息。在任何终端里都能用，无需额外设置
• split panes（分栏）：每个队友有自己的窗格，你可以同时看到所有人的输出并点进窗格直接交互。需要 tmux 或 iTerm2

默认是 "in-process"。设为 "auto" 时，如果你已经在 tmux 会话里、或终端是装了 it2 CLI 的 iTerm2，就启用分栏，否则回退到 in-process；"tmux" 显式使用 tmux 分栏；"iterm2" 显式使用 iTerm2 原生分栏（需要 it2 CLI）。想覆盖默认值，在 ~/.claude/settings.json 里设置 teammateMode。

官方原文还涵盖要求队友在动手前先出计划、指定队友和模型、避免文件冲突（把工作划分好让每个队友负责不同的文件）、使用子智能体定义作为队友、用例示例和限制。