#智能体团队

Agent teams（智能体团队）适用于需要多个执行者交换发现、共同推进的复杂任务。团队由主会话担任负责人，协调分工并汇总结果；各成员拥有独立的 Claude Code 会话和上下文，可以直接交流。该功能适合独立调查、交叉审查和分模块工作。对于存在较多先后依赖，或需要集中修改同一文件的任务，协调成本可能超过并行收益。

该功能目前为实验功能，默认关闭。使用前，需要通过环境变量或 settings.json 的 env 字段，将 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS 设为 "1"。创建团队成员需要交互式 Claude Code 会话；claude -p 和 Agent SDK 会话不会创建团队成员，即使已设置该变量也不例外。

在项目目录中打开终端后，可使用以下命令启用智能体功能：

macOS、Linux 或 WSL 的 Bash/Zsh

CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 claude

Windows PowerShell

$env:CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS="1"
claude

上述命令不会修改项目配置文件。Bash/Zsh 写法仅为本次启动的 Claude Code 及其子进程设置变量；PowerShell 写法在当前终端会话中持续有效，后续从该窗口启动的 Claude Code 也会继承此设置。如果功能未生效，应检查已有配置是否覆盖了该变量，例如 settings.json 的 env 字段中是否将其设为 "0"。

进入交互会话后，可通过自然语言说明团队规模、成员职责和交付要求。为明确使用该功能，提示词中应直接提出“创建一个 Agent team”，避免仅以“并行处理”或“分工调查”描述任务。团队成员不会自动继承负责人的完整对话历史，因此分配任务时，还应提供必要的背景、资料和约束。

请使用 Claude Code 的 Agent teams 功能，创建一个智能体团队，
由你担任负责人，并生成 3 名团队成员（teammates），
围绕{预约接口偶发超时}开展并行调查。

成员分工：
1. “请求链路”：检查{请求处理流程、外部调用与超时设置}。
2. “数据库”：检查{数据库查询、连接池与连接使用情况}。
3. “复现验证”：检查{测试覆盖、错误日志与复现条件}。

调查要求：
- 向每位成员提供本轮问题背景、相关资料和调查范围。
- 各成员先读取资料并收集证据，本轮不修改代码。
- 发现相关线索或相互矛盾的判断时，由相关成员直接交流并核对证据。
- 区分已经确认的事实与尚待验证的假设。

等待三名成员完成调查后，请由你汇总：
1. 已确认的事实及对应证据；
2. 仍需验证的原因假设；
3. 已完成的复现检查及结果；
4. 尚缺的信息和建议的验证步骤；
5. 一份范围明确的修复计划。

如果实际创建的是子代理，可再次明确要求使用 Agent teams。普通子代理与团队成员会显示在同一个代理面板中，因此不能仅凭面板中出现多个代理，就判断团队已成功创建。

此类任务的重点是独立证据与统一验收标准。增加成员数量并不必然提高质量，应避免多个成员反复读取相同内容或同时修改同一文件。