Claude Code Agent Teams：多智能体协作开发完全指南

副标题：从单兵作战到团队协作，AI 编程的下一个进化

问题：当你的项目复杂到一个人搞不定

想象这个场景：你要重构一个复杂系统，涉及 API 层、数据库迁移、测试覆盖和文档更新。单会话的 Claude Code 只能一件一件处理。子代理（Subagents）可以并行，但它们各自为战，无法共享发现、质疑假设或直接协调。

Agent Teams 就是来解决这个问题的。

Agent Teams 架构

什么是 Agent Teams？

Agent Teams 是 Claude Code 的实验性功能，让你能编排多个 Claude 会话协同工作。核心架构：

组件	职责
Team Lead	你的主会话，创建团队、分配任务、整合结果
Teammates	独立的 Claude 实例，各自拥有完整上下文窗口
Shared Task List	中央任务队列，所有代理可见，支持依赖关系
Mailbox	代理间直接通信系统

关键区别：通信模式。

Subagents：只能向主代理汇报（星型拓扑）
Agent Teams：代理间可直接对话（网状拓扑）

类比：Subagents 是外包给不同 freelancer 各自干活；Agent Teams 是一个项目组坐在同一间会议室，边干边同步。

Subagents vs Agent Teams 对比

什么时候用 Agent Teams？

✅ 强适用场景

研究与审查：多个代理同时调查问题不同方面，相互挑战发现
新模块开发：各代理负责独立组件，互不踩脚
调试竞争假设：并行测试不同理论，主动证伪对方
跨层协调：前端、后端、测试各由不同代理负责
架构辩论：多个代理争论不同方案，收敛到最优解
大规模分类：代理分片处理大数据集

❌ 什么时候不用

顺序依赖强的任务
同一文件的频繁编辑
代理间不需要通信的纯并行任务（用 /batch 更简单）

决策标准：你的工作者需要相互通信吗？

适用场景

Subagents vs Agent Teams 对比

特性	Subagents	Agent Teams
上下文	独立窗口，结果汇总回主会话	完全独立，各自完整上下文
通信	仅向主代理汇报	代理间直接通信
协调	主代理管理所有工作	共享任务列表，自协调
Token 成本	较低	较高（每个队友是独立实例）
最佳场景	只需结果的专注任务	需要讨论协作的复杂工作
设置	开箱即用	需环境变量启用

快速开始

步骤 1：启用功能

1

export ANTHROPIC_AGENT_TEAMS=1

或添加到 settings.json 持久化：

1
2
3
4
5


{
  "env": {
    "ANTHROPIC_AGENT_TEAMS": "1"
  }
}

步骤 2：描述任务和团队结构

用自然语言告诉 Claude：

“创建一个 3 人团队来重构我们的认证系统：

代理 A：处理 API 层变更

代理 B：负责数据库迁移

代理 C：更新测试和文档
每个代理完成后相互审查对方的工作。”

步骤 3：观察团队组建

Claude 会自动：

创建 Team Lead（你的主会话）
生成 3 个独立队友会话
通过共享任务列表分发工作

快捷键监控：

Shift+↑/↓：选择队友
Ctrl+T：查看任务列表
Enter：进入某个会话
Escape：中断

步骤 4：清理

/teardown

注意：始终通过 Lead 清理，先关闭所有队友再清理 Lead。

工作流程

实战：一个典型的工作流程

场景：实现一个全栈功能（用户仪表盘）

你: 创建一个团队实现用户仪表盘功能
    ├─ 前端代理：React 组件
    ├─ 后端代理：API 端点
    ├─ 测试代理：集成测试
    └─ 文档代理：更新 README

Claude: 正在创建团队...
    ├─ Team Lead 初始化
    ├─ 生成 4 个队友会话
    └─ 分配初始任务

[并行执行]
    ├─ 前端代理 → 完成组件 → 通知后端代理接口需求
    ├─ 后端代理 → 完成 API → 通知测试代理契约
    ├─ 测试代理 → 等待契约 → 编写测试
    └─ 文档代理 → 收集各方变更 → 更新文档

[协作审查]
    ├─ 各代理相互 review
    ├─ 发现问题 → 直接沟通修复
    └─ Lead 整合最终成果

你: /teardown

性能与成本

启动时间：队友通常在 20-30 秒内生成，1 分钟内产出结果
Token 成本：3 人团队约是单会话顺序执行的 3-4 倍
时间收益：复杂任务的并行时间节省远超成本增加

规模化最佳实践

1. 标准化 Prompt 模板

为常见团队配置创建可复用模板：

审查团队（Review Team）
实现团队（Implementation Team）
研究团队（Research Team）

每个模板定义：角色、文件边界、成功标准。

2. 预配置权限

在生成队友前，在权限设置中预批准常用操作，避免权限提示淹没团队。

3. 优化 CLAUDE.md

清晰的模块边界、验证命令、操作上下文能显著降低每个队友的探索成本。三个队友读一份清晰的 CLAUDE.md，比各自探索代码库便宜得多。

局限与注意事项

实验性功能：仍在迭代，可能遇到 edge case
Token 消耗：团队规模越大，成本越高
协调开销：简单任务可能"杀鸡用牛刀"
清理责任：忘记 /teardown 会留下僵尸会话

总结：Agent Teams 在 Claude Code 生态中的位置

方法	通信模式	适用场景
单会话	N/A	顺序、专注的任务
Subagents	仅结果回传	并行专注工作
Builder-Validator	结构化交接	质量门禁实现
Agent Teams	全网状直接通信	协作探索

建议组合策略：用 Agent Teams 做协作探索阶段，切换到 Builder-Validator 模式做实现阶段。

下一步

这周就试一个审查任务。开销很低，但能力会改变你对复杂开发工作的认知。

Agent Teams 不是未来概念，是现在就能用的生产工具。掌握它的人，正在建立下一代 AI 辅助开发的肌肉记忆。

参考：Claude Code Agent Teams: The Complete Guide 2026 - claudefa.st