一、什么是 Agent Teams？

Claude Code Agent Teams 是 Claude Code 的最近新推出的功能，允许你创建多个 AI 智能体组成“开发团队”，并行处理复杂任务。每个智能体拥有独立的上下文窗口，可以：

• 同时编辑不同文件
• 相互发送消息协调工作
• 共享带依赖关系的任务列表
• 自动认领未阻塞的任务

💡 适合场景：代码审查、多模块开发、并行调试
❌ 不适合场景：重命名变量、单文件简单修改

二、前置准备

开始前，请确保已满足以下条件：

项目	说明
Claude Code	已安装并正常运行
终端复用器	推荐安装 tmux（用于分屏监控各智能体工作状态）
API 权限	Anthropic API Key 或 Claude Pro/Max 订阅（多智能体会消耗更多 token）
任务类型	确保任务可并行拆分，避免文件冲突

安装 tmux（推荐）

# macOS
brew install tmux

# Ubuntu/Debian
sudo apt install tmux

三、启用 Agent Teams

该功能默认关闭，需手动开启实验性标志：

1. 打开配置文件 ~/.claude/settings.json
2. 添加以下内容：

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

3. 重启 Claude Code，即可使用团队协作命令。

四、架构解析：团队如何协作？

理解内部机制，才能用好它：

┌─────────────────────────────────────────────┐
│          Team Lead（团队负责人）             │
│  - 创建团队、分配任务、汇总结果              │
│  - 相当于技术主管，专注协调而非编码          │
└──────────────┬──────────────────────────────┘
               │ 消息通信 + 任务分发
    ┌──────────┴──────────┬──────────┐
    ▼                     ▼          ▼
┌─────────┐         ┌─────────┐ ┌─────────┐
│Teammate1│         │Teammate2│ │Teammate3│
│独立上下文│         │独立上下文│ │独立上下文│
│可读写文件│         │可读写文件│ │可读写文件│
└─────────┘         └─────────┘ └─────────┘

核心组件

组件	作用	存储位置
Team Lead	主会话，负责创建团队、分配任务、汇总结果	当前终端
Teammates	独立智能体实例，拥有自己的上下文窗口	~/.claude/teams/{团队名}/
共享任务列表	带依赖关系的任务队列，自动阻塞/解阻塞	~/.claude/tasks/{团队名}/
消息系统	智能体间可直接通信（区别于传统子代理）	内存中实时传递

🔑 关键区别：Teammates 可以互相发消息，而传统 sub-agent 只能向调用者汇报。

五、实战：创建你的第一个 Agent Team

示例 1：并行代码审查

请审查这个代码库的问题。安排：
- 一名队友专注安全漏洞（如注入、权限问题）
- 一名队友检查性能瓶颈（如 N+1 查询、内存泄漏）
- 一名队友分析测试覆盖率缺口
最后将结果汇总成一份报告。

Claude 会自动：

1. 创建 3 人团队
2. 为每人分配专注领域
3. 各自并行审查
4. 汇总成统一报告

示例 2：前后端并行开发

创建一个 2 人团队：
- 队友 "backend"：在 src/routes/ 实现 /api/users 接口
- 队友 "frontend"：在 src/components/ 构建用户资料组件
要求他们就 API 协议进行协调。

💡 重要提示：Teammates 不继承主会话的历史记录！务必在创建时提供充足上下文（项目结构、编码规范、目标描述），否则队友会“从零开始”提问。

六、提升效果的 7 个最佳实践

根据实际项目经验，以下技巧能显著提升产出质量：

✅ 1. 提供丰富的初始上下文

队友启动时对话历史为空。务必在 spawn prompt 中说明：

• 项目目标与架构
• 关键文件路径
• 编码规范与技术栈
• 具体任务边界

✅ 2. 合理拆分任务粒度

• 推荐：每名队友负责 5~6 个任务
• 太细 → 协调开销大
• 太粗 → 失去并行优势

✅ 3. 避免文件冲突

尽量分配不同文件给不同队友。同时编辑同一文件极易产生合并冲突。

✅ 4. 先研究再实现

让队友先探索方案、设计接口，再开始编码。可提前发现架构不匹配问题。

✅ 5. 启用 Delegate 模式

当发现 Team Lead 一直在写代码而非协调时，按 Shift+Tab 切换到 delegate 模式，强制其专注管理。

✅ 6. 预批准常见操作

多智能体会频繁请求文件写入/命令执行权限。在设置中预批准可信操作，减少手动确认次数。

✅ 7. 主动监控（强烈推荐分屏）

使用 tmux 分屏实时观察各队友进度，及时纠正偏离方向的行为，避免浪费 token。

# 启动 tmux 会话后再运行 claude
tmux new -s my-project
claude

八、总结

Claude Code Agent Teams 不是“魔法按钮”，而是需要精心设计的协作框架。用好它的关键在于：

1. ✅ 选择真正适合并行的任务
2. ✅ 为队友提供充足上下文
3. ✅ 合理拆分任务避免冲突
4. ✅ 通过分屏主动监控进度
5. ✅ 利用消息系统促进智能体间协作

当你掌握这些技巧后，Agent Teams 能将复杂任务的处理效率提升数倍——不再是“一个 AI 干活”，而是“一支 AI 团队协同作战”。

📌 最后提醒：多智能体会显著增加 token 消耗，建议在复杂任务中使用，日常简单编辑仍用单会话更经济。