Claude Agent Teams 是 Claude Code(Anthropic 官方 AI 编码助手)在 2026 年 3 月正式推出的实验性多智能体协作功能。它允许你一次性启动多个 Claude 实例(Agent),让他们像真实软件开发团队一样分工协作、实时沟通、并行执行子任务,最终由队长(Team Lead)汇总结果并交付。

简单来说:以前是一个 Claude 自己单干,现在你可以让 3~15 个 Claude 同时开工,相互审查、辩论、迭代,极大提升复杂项目的效率。这项功能基于 Claude Opus 4.6 / Sonnet 4.6,已集成到 Claude Code 主程序中,是目前最接近“真实 AI 团队”的实现。

一、Claude Agent Teams 核心架构详解

Agent Teams 采用分层架构:

  • Team Lead(队长):主会话,负责任务分解、资源分配、进度监控、冲突解决和最终结果合成
  • Teammates(队员):多个子 Agent,每个负责一个具体领域(如 Frontend、Backend、Testing、Security 等)
  • Communication Bus(通信总线):所有 Agent 通过 sendMessage 工具实时对话,支持 @提到某个 Agent 或广播
  • Shared Workspace:所有 Agent 共享同一个 git 仓库、CLAUDE.md 和 memory 文件夹

与普通 Sub-Agent 的最大区别在于「并行 + 实时协作」:普通 Sub-Agent 是队长依次调用,而 Agent Teams 是所有成员同时开工、互相监督。

二、如何开启 Claude Agent Teams(详细步骤)

步骤 1:确保 Claude Code 是最新版本

claude update --force

步骤 2:开启实验功能(两种永久方式)

方式一:全局环境变量(推荐新手)

export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
export CLAUDE_CODE_AGENT_MAX_CONCURRENT=8   # 可选:最大并行 Agent 数量

把这两行加入 ~/.zshrc 或 ~/.bash_profile 并执行 source ~/.zshrc

方式二:修改 settings.json(永久配置)

  1. 打开配置文件:
code ~/.claude/settings.json
  1. 添加以下完整内容:
{
  "experimental": {
    "agentTeams": true,
    "maxConcurrentAgents": 8,
    "enableRealTimeChat": true,
    "autoSummarizeAfterTask": true
  }
}
  1. 保存后重启 Claude Code 终端

步骤 3:验证是否成功开启

/features agent-teams

如果显示 “Agent Teams: ENABLED (v1.2)” 就说明已成功。

三、如何创建第一个 Agent Team(完整实战)

在 Claude Code 终端中直接输入自然语言指令即可创建团队:

创建一个 5 人 Agent Team 来帮我开发一个完整的用户认证系统。

团队结构如下:
- Team Lead:整体协调、代码审查、最终合并 PR
- Auth Backend Agent:负责 JWT、Redis Session、数据库 schema
- Frontend Agent:负责登录页面、React Hook、表单验证
- Security Agent:负责漏洞扫描、OWASP 检查、加密方案
- Testing Agent:编写单元测试、集成测试、E2E 测试

要求:
1. 所有 Agent 必须实时通过 sendMessage 相互沟通
2. 每完成一个子任务自动向我汇报进度
3. 使用同一个 git 仓库,自动 commit 并 push 分支
4. 最终由 Team Lead 发起 Pull Request

Claude 会自动:

  1. 在 .claude/teams/auth-system/ 目录下创建团队文件夹
  2. 为每个 Agent 生成专属角色 Prompt
  3. 启动多个子会话(在 tmux 中自动分屏)
  4. 所有 Agent 开始并行工作

四、高级配置与管理命令

常用管理命令(直接在 Team Lead 会话中输入):

命令 作用
/team create 手动创建新团队
/team list 查看当前所有活跃团队
/team pause <team-name> 暂停整个团队
/team resume <team-name> 恢复团队
/team add-agent Security 动态添加新 Agent
/team broadcast 进度如何? 向所有 Agent 广播消息

在 tmux 分屏模式下,你可以点击任意 pane 直接和单个 Agent 对话,极大提升控制感。

五、推荐实战场景与 Prompt 示例

示例 1:完整项目重构

创建一个 Agent Team 来重构整个 monorepo 项目。

团队:
- Lead:架构师
- Migration Agent:负责从 Redux 迁移到 Zustand
- UI Agent:重写所有组件为 Server Components
- Performance Agent:优化 bundle 大小和加载速度
- Docs Agent:同步更新所有文档

示例 2:产品功能开发

创建一个 6 人 Agent Team 实现“AI 智能代码审查”功能

六、注意事项与最佳实践

  • Opus 4.6 权限才能获得最佳效果(Pro / Team 计划)
  • token 消耗较高,建议先在小项目测试
  • 推荐使用 tmux + iTerm2 分屏观看所有 Agent 实时输出
  • 定期使用 /team summarize 让队长生成进度报告
  • 开启 Auto Memory 功能让所有 Agent 共享长期记忆

七、常见问题解答

  • Agent 之间不沟通? 检查是否开启了 enableRealTimeChat
  • 内存占用过高? 降低 maxConcurrentAgents 到 4~6
  • 想删除某个 Agent? 使用 /team remove-agent <name>

总结

Claude Agent Teams 是目前最强大的多 Agent 实现之一。通过简单的自然语言描述 + 实验功能开启,你就能让多个 Claude 像真实团队一样并行工作、实时协作。

强烈建议搭配 tmux 使用,体验会直接起飞。现在就去试试创建一个 5 人团队吧!你会立刻感受到“AI 团队”带来的效率飞跃。

你最想用 Agent Teams 完成什么复杂任务?欢迎在评论区分享,我可以帮你写最优启动 Prompt。

官方参考链接:
Agent Teams 官方文档:https://code.claude.com/docs/en/agent-teams
Claude Code 官网:https://code.claude.com
Anthropic 文档:https://docs.anthropic.com