2026 年 2 月,Anthropic 在发布 Claude Opus 4.6 时同步推出了 Agent Teams——一个把 Claude Code 从单 Agent 工具升级为协作开发团队的实验性功能。它不只是更快的并行,而是引入了 Agent 之间的点对点通信,让团队成员能直接对话,而不是所有信息都经过一个中心节点。
Agent Teams vs Subagents:架构上的本质差异
这是理解 Agent Teams 的关键:
Subagents(传统模式):
Team Lead
↓ 派发任务
Subagent A(完成后报告 Team Lead)
Subagent B(完成后报告 Team Lead)
Subagent C(完成后报告 Team Lead)
所有信息都经过 Team Lead。Agent B 的发现无法直接告诉 Agent C。
Agent Teams(新模式):
Team Lead
├── Frontend Agent ←──Mailbox──→ Backend Agent
│ ←──Mailbox──→ QA Agent
└── QA Agent ←──Mailbox──→ Backend Agent
↕
Shared Task List(所有 Agent 可见)
Frontend Agent 发现 API 需要新增字段,可以直接通过 Mailbox 告诉 Backend Agent,不需要先经过 Team Lead。
核心架构组件
Team Lead(主会话)
你直接交互的主 Claude Code 实例。职责:
- 接收你的任务描述
- 分解为子任务并分配给 Teammates
- 监控整体进展
- 在 Teammate 遇到阻塞时重新调度
Teammates(独立 Agent 实例)
由 Team Lead 生成,每个 Teammate 有:
- 独立的上下文窗口
- 完整的工具访问权限(读文件/写文件/执行命令/网络搜索)
- 分配的工作范围
- 自己的 Mailbox(可接收任意其他 Agent 的消息)
Mailbox 系统(点对点通信)
每个 Agent 有独立 Mailbox,任意 Agent(包括同级 Teammate)都可以发消息:
// 真实场景:Frontend 发现 API 需要变更
Frontend Agent → Backend Agent Mailbox:
"UserProfile 组件需要 /api/user 返回 lastLogin 字段"
// Backend 知道后通知 QA
Backend Agent → QA Agent Mailbox:
"GET /api/user 新增了 lastLogin 字段(ISO 8601 格式),
请增加集成测试覆盖"
// QA 更新共享任务列表
QA Agent → Shared Task List:
"✓ 14/16 测试通过,2 个因 lastLogin 新需求而等待"
Shared Task List
所有 Agent 都能看到的任务看板:
- Team Lead 初始化任务列表
- Teammates 可以更新任务状态、添加子任务、标记依赖
- 作为所有 Agent 的单一信息源
如何启用 Agent Teams
Agent Teams 目前是实验性功能,需要手动开启:
# 方式 1:临时启用(单次运行)
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 claude
# 方式 2:持久化到 Shell 配置
echo 'export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1' >> ~/.zshrc
source ~/.zshrc
# 方式 3:项目级别(.env 文件)
echo "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1" >> .env启用后,Claude Code 欢迎界面会显示"Agent Teams: enabled"。
使用要求:
- Claude Code 最新版本
- Opus 4.6 或更新的模型
- Pro($20/月)、Max($100-200/月)、Team 或 Enterprise 计划
5 种最实用的 Team 模式
模式 1:全栈开发三人组(最常用)
用 Agent Teams 实现用户通知功能:
Frontend Agent 负责:
- 通知中心组件(NotificationCenter, NotificationItem)
- 实时更新 UI(WebSocket 或 polling)
- 通知偏好设置页
Backend Agent 负责:
- 通知 API(GET/POST/PUT 通知状态)
- 通知触发服务(邮件/推送/站内)
- 数据库 Schema(notifications 表)
QA Agent 负责:
- 所有新组件的单元测试
- API 端点集成测试
- 端到端场景测试(从触发到展示)
Frontend 和 Backend Agent 发现 API 合约差异时直接沟通。
模式 2:大迁移团队
迁移项目从 JavaScript 到 TypeScript:
Migration Agent 1:迁移 src/api/ 目录(所有 API handler)
Migration Agent 2:迁移 src/services/ 目录(业务逻辑)
Migration Agent 3:迁移 src/models/ 目录(数据模型)
Test Agent:同步更新测试文件的类型注解
Config Agent:更新 tsconfig.json, package.json 和构建配置
遇到共享类型定义时,通过 Mailbox 协调,避免重复定义。
模式 3:安全审查团队
对这个 PR 做多角度安全审查:
Injection Specialist:专门查注入漏洞
- SQL 注入(包括 ORM 的不安全使用)
- 命令注入
- XSS(前端渲染和存储型)
Auth Specialist:专门查认证和授权
- Session 管理
- 权限检查遗漏
- Token 存储和传输安全
Dependency Auditor:专门查依赖
- 新增依赖的已知 CVE
- 依赖版本是否 pin 住
- 许可证合规
每个专家独立审查,最后汇总报告,避免互相影响判断。
模式 4:微服务跨服务变更
支付服务添加退款功能,影响多个服务:
Payment Service Agent:实现退款 API 和业务逻辑
Order Service Agent:更新订单状态机(处理退款中状态)
Notification Service Agent:实现退款通知(邮件+站内信)
Accounting Service Agent:实现退款的会计分录
各 Service Agent 通过 Mailbox 协调 API 合约变更,
确保 breaking changes 在推送前就被发现和处理。
模式 5:测试覆盖冲刺
补充测试覆盖率,目标从 42% 提升到 80%:
Unit Test Agent:专注 src/utils/ 和 src/helpers/
Integration Test Agent:专注 src/services/ 的服务层测试
API Test Agent:专注 src/api/ 的端点测试
E2E Test Agent:补充关键用户路径的端到端测试
各 Agent 完成一个模块后报告覆盖率数字到 Shared Task List,
避免重复覆盖同一文件。
Agent Teams 实际效果数据
Anthropic 在 2026 年 3 月 9 日推出的 Claude Code Review(基于 Agent Teams),用于 PR 审查:
- 覆盖率提升:内部代码审查覆盖率从 16% 提升到 54%
- 并行专业化:正确性 Agent + 安全 Agent + 性能 Agent 分别专注不同维度
- 发现更多问题:专业化 Agent 比通用 Agent 在各自领域发现更多问题
成本与 Token 使用
Agent Teams 的成本会高于单 Agent,因为多个 Agent 同时运行:
| 使用方式 | 成本 | 速度 | 质量 |
|---|---|---|---|
| 单 Agent 串行 | 最低 | 最慢 | 受单上下文限制 |
| Subagents | 中 | 较快 | 上下文隔离好 |
| Agent Teams(2-3 人) | 中高 | 快 | Mailbox 协调好 |
| Agent Teams(5+ 人) | 高 | 最快 | 需要注意协调开销 |
成本控制建议:
- 从 2-3 个 Teammate 开始,熟悉后再扩大
- 探索任务(只读)用轻量模型(Haiku),实现任务用 Sonnet
- 每个 Teammate 的范围要明确,避免大量重叠工作
当前限制
- 实验性:功能还在演进,行为可能变化
- 可观测性有限:Team Lead 看不到 Teammate 的实时活动,只能看完成后的结果
- 文件冲突:需要在任务设计时通过明确的范围边界避免
- 成本较高:多 Agent 并行意味着更多 Token 消耗
来源:lushbinary.com Claude Code Agent Teams 指南 | popularaitools.ai 多 Agent 教程 | 整理:ClaudeEagle