Agent Teams 是 Opus 4.6 发布时随 Claude Code 同步推出的重磅功能—— 一个编排 Agent(Orchestrator)协调多个工作 Agent(Worker)并行执行, 让原本需要数小时的复杂工程任务缩短到数十分钟。
什么是 Agent Teams?
传统模式(单 Agent 顺序执行):
任务:重构 5 个模块 + 写测试 + 更新文档
→ Agent 顺序处理:模块1 → 模块2 → 模块3 → 模块4 → 模块5 → 测试 → 文档
→ 总耗时:所有步骤之和
Agent Teams 模式(并行执行):
任务:重构 5 个模块 + 写测试 + 更新文档
→ 编排 Agent 拆解任务
→ Worker 1:重构模块1 + 模块2
Worker 2:重构模块3 + 模块4
Worker 3:重构模块5
Worker 4:写测试(基于已完成模块)
Worker 5:更新文档
→ 总耗时:最长子任务的时间(大幅缩短)
启用 Agent Teams
Agent Teams 在 claude.ai 的 Claude Code 中默认可用(Opus 4.6):
bash
# 方式一:直接描述需要并行的任务
claude
> 我需要同时重构 auth 模块和 payment 模块,
并为两者分别补充单元测试,可以并行处理吗?
# Claude Code 会:
# 1. 识别任务可并行性
# 2. 自动拆分为子任务
# 3. 生成并行 Agent 团队
# 4. 汇总结果bash
# 方式二:API 层面配置(参考官方文档)
# 详见 code.claude.com/docs/en/agent-teams适合 Agent Teams 的任务类型
高价值场景
1. 多模块并行重构
→ 每个模块独立,无强依赖
→ 最典型的并行场景
2. 全项目测试生成
→ 各文件的测试互相独立
→ 10个文件同时写测试 vs 顺序写,速度差10倍
3. 多语言文档翻译
→ 把中文文档并行翻译为英文/日文/韩文
4. 代码库安全审计
→ 不同 Worker 负责不同的安全漏洞类型
→ SQL注入/XSS/权限绕过 同时扫描
5. 多端同步开发
→ Web 前端 + 移动端 + API 文档同步更新
不适合的场景
❌ 强依赖链:步骤B必须在步骤A完成后才能开始
❌ 共享状态修改:多个 Worker 同时修改同一文件(有冲突风险)
❌ 简单小任务:开销大于收益
实战案例:全项目测试补充
你:我的项目 src/ 目录下有 23 个 Python 文件,
没有任何测试。帮我用 Agent Teams
为所有文件生成 pytest 测试,
要求覆盖率 > 80%。
编排 Agent 的拆解策略:
扫描 src/ 目录,识别模块依赖关系
→ 分组:无依赖模块(可完全并行)
有轻度依赖的模块(小组并行)
→ 分配 Workers:
Worker 1: utils.py, helpers.py, config.py(无依赖)
Worker 2: models/user.py, models/product.py(无依赖)
Worker 3: services/auth.py, services/payment.py
Worker 4: api/routes.py, api/middleware.py
...(共 6 个 Worker 并行)
→ 汇总:编排 Agent 检查覆盖率,补漏
实战案例:大型代码库安全审计
你:对这个 Node.js 项目进行全面安全审计,
检查 OWASP Top 10 漏洞,
生成修复建议报告。
Agent Teams 分工:
Worker 1:SQL 注入 & NoSQL 注入扫描
Worker 2:XSS(跨站脚本)漏洞
Worker 3:身份验证 & 授权漏洞
Worker 4:敏感数据暴露(硬编码密钥/明文密码)
Worker 5:依赖包已知 CVE 漏洞(npm audit 增强版)
编排 Agent:汇总所有 Worker 报告 → 按严重程度排序 → 生成修复计划
与 Context Compaction 配合使用
长时间运行的 Agent Teams 任务,结合 Compaction 避免上下文溢出:
任务:重构整个 50 万行代码库
挑战:超长任务中 Agent 的上下文会被耗尽
解决:Claude Opus 4.6 的 Context Compaction 功能
→ 在上下文接近上限时自动压缩历史
→ 保留关键信息(已完成的工作、待处理项)
→ 继续执行而不中断
注意事项
模型要求:Agent Teams 主要由 Opus 4.6 驱动
→ 编排 Agent 使用 Opus
→ Worker 可以使用 Sonnet(降低成本)
成本预估:
N 个并行 Worker × 各自的 Token 消耗
总成本比顺序执行略高(因为每个 Worker 都有上下文开销)
但时间节省通常值得
文件冲突:
避免让不同 Worker 同时修改同一个文件
编排 Agent 会尝试避免这种情况,
但在任务描述中明确说明依赖关系更安全
来源:Anthropic Claude Code 文档 - code.claude.com/docs/en/agent-teams