
## 一、什么是 Agent Teams？

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

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

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

## 二、前置准备

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

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

### 安装 tmux（推荐）

```bash
# macOS
brew install tmux

# Ubuntu/Debian
sudo apt install tmux
```

![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-11859176/7311f78c67c6312de833f23d60fe7458.png)

## 三、启用 Agent Teams

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

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

```json
{
  "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 只能向调用者汇报。


![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-11859176/95c4da95409f4597f5c098f2261d0f36.png)

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

### 示例 1：并行代码审查

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

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

### 示例 2：前后端并行开发

```text
创建一个 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。

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

 ## 八、总结

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

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

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

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

最新用AI写了自己的博客网站：https://golangai.site/ 大家也可以进入这个网站查看文章。

手把手教你设置和使用 Claude Code Agent Teams：高效协作开发实战指南

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

编程语言

ClaudeCode AgentTeams是AI智能体协作开发功能，支持创建多智能体团队并行处理复杂任务。每个智能体拥有独立上下文，可同时编辑不同文件、相互通信、共享任务列表。适合代码审查、多模块开发等场景，需合理拆分任务避免冲突。使用前需安装tmux并配置实验性标志，多智能体会增加token消耗。

智能体

Ubuntu

Debian

Agent

JSON

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云AI代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

功能1上新10个字符

功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符。

功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符。

功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符

功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符

功能4上新

文章&问答评论现已支持表情

全新交互，全新视觉，新增快捷键、悬浮工具栏、高亮块等功能并同时优化现有功能，全面提升创作效率和体验

社区富文本编辑器全新改版！诚邀体验～ 

精选全网热门MCP server，让你的AI更好用 🚀

💥开发者 MCP广场重磅上线！

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

手把手教你设置和使用 Claude Code Agent Teams：高效协作开发实战指南-腾讯云开发者社区-腾讯云

手把手教你设置和使用 Claude Code Agent Teams：高效协作开发实战指南

手把手教你设置和使用 Claude Code Agent Teams：高效协作开发实战指南

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐