【AIGC】Claude Code的 Agent Teams 模式使用指南和样例

Claude Code Agent Teams 是实验性多智能体协作功能，可让多个独立 Claude 实例并行工作、互相通信、共享任务列表，适合并行代码审查、前后端协同开发、多维度问题排查等场景。

一、启用 Agent Teams（必须先做）

Agent Teams 默认关闭，需手动开启：

编辑配置文件

bash 复制代码

# 打开配置文件（不存在则自动创建）
nano ~/.claude/settings.json

添加实验性开关

json 复制代码

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

保存并重启 Claude Code

bash 复制代码

# 保存退出 nano：Ctrl+O → Enter → Ctrl+X
claude code start

验证是否启用

bash 复制代码

# 在 Claude Code 中执行
/config
# 看到 Agent Teammate mode 选项即成功

二、可选：安装 tmux（分屏监控）

安装 tmux 可在终端分屏显示所有队友实时输出，不安装则默认用进程内模式：

bash 复制代码

# macOS
brew install tmux
# Linux
sudo apt install tmux
# Windows 无需安装

三、核心概念

Lead（团队领导）：主会话，负责分配任务、协调团队、汇总结果
Teammates（团队成员）：独立 Claude 实例，并行执行任务，有独立上下文窗口
共享任务列表：团队成员可创建、认领、完成任务，支持依赖关系
邮箱系统：成员间直接通信，无需 Lead 中转

四、使用方法（3种方式）

1. 自然语言创建（最常用）

直接用自然语言描述团队和任务，Claude 自动创建团队并分配工作：

bash 复制代码

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

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

2. 命令行创建（精确控制）

bash 复制代码

# 创建团队（指定领导）
/team create --lead "代码审查负责人"

# 添加队友（指定角色）
/team add --name "安全专家" --role "security"
/team add --name "性能专家" --role "performance"
/team add --name "测试专家" --role "testing"

# 分配任务
/team assign --name "安全专家" --task "审查代码安全漏洞"
/team assign --name "性能专家" --task "检查代码性能瓶颈"
/team assign --name "测试专家" --task "分析测试覆盖率"

# 启动团队
/team start

# 查看团队状态
/team status

# 结束团队
/team end

3. 团队定义文件（批量复用）

在 .claude/agent-teams/ 目录创建团队定义文件（如 code-review-team.json）：

json 复制代码

{
  "name": "代码审查团队",
  "lead": "审查负责人",
  "teammates": [
    {
      "name": "安全专家",
      "role": "security",
      "prompt": "专注审查代码中的安全漏洞，包括SQL注入、XSS、权限问题等"
    },
    {
      "name": "性能专家",
      "role": "performance",
      "prompt": "专注检查代码性能瓶颈，包括N+1查询、内存泄漏、循环优化等"
    },
    {
      "name": "测试专家",
      "role": "testing",
      "prompt": "专注分析测试覆盖率缺口，找出未测试的代码路径"
    }
  ],
  "tasks": [
    {
      "name": "安全审查",
      "assignee": "安全专家",
      "description": "审查代码安全漏洞"
    },
    {
      "name": "性能审查",
      "assignee": "性能专家",
      "description": "检查代码性能瓶颈"
    },
    {
      "name": "测试分析",
      "assignee": "测试专家",
      "description": "分析测试覆盖率缺口"
    }
  ]
}

加载团队定义：

bash 复制代码

/team load --file .claude/agent-teams/code-review-team.json
/team start

五、实战场景示例

场景1：并行代码审查（3人团队）

bash 复制代码

# 指令
请创建一个3人团队审查当前代码库：
- 安全专家：检查所有API端点的身份验证和授权
- 性能专家：分析数据库查询效率，找出慢查询
- 架构专家：评估代码结构和可维护性
所有队友完成后，由Lead汇总成一份完整的审查报告。

场景2：前后端协同开发（2人团队）

bash 复制代码

# 指令
创建一个2人团队实现用户管理功能：
- 后端工程师：在src/server/routes/users.ts实现CRUD API
- 前端工程师：在src/client/components/UserList.tsx实现用户列表组件
要求：
1. 后端先定义API接口规范
2. 前端根据规范实现UI
3. 两人通过消息系统协调数据格式
4. 完成后进行联调测试

六、最佳实践

任务独立性：尽量让每个队友的任务独立，减少依赖，最大化并行效率
明确指令：给每个队友清晰、完整的任务描述，包含所有必要上下文
返回格式：指定统一的返回格式（如JSON），方便Lead汇总
团队规模：建议3-5人，超过5人协调成本会显著增加
成本控制：每个队友都是独立实例，token消耗会成倍增加，仅在需要并行时使用
适用场景 ：
- ✅ 适合：并行代码审查、多维度问题排查、前后端协同、大规模重构
- ❌ 不适合：顺序任务、同一文件编辑、依赖关系复杂的任务

七、常见问题

功能未启用 ：检查 settings.json 格式是否正确，确保 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS 值为 "1"
队友不工作：确保任务描述清晰，包含所有必要上下文和文件路径
通信问题 ：使用 /team message 命令在队友间发送消息
性能问题：减少团队规模，简化任务，避免同时处理过多文件

需要我给你一份可直接复制的 Agent Teams 常用命令速查表 ，并附上一个完整的 前后端协同开发实战模板 吗？

Claude Code Agent Teams 常用命令速查表 + 前后端协同开发实战模板

一、Agent Teams 常用命令速查表（可直接复制执行）

说明：所有命令均在 Claude Code 终端执行，无需额外配置；带【可选】标识的命令可根据需求选择，核心命令必用。

1. 基础配置与启用（必用）

命令用途	具体命令	备注
开启Agent Teams功能	nano ~/.claude/settings.json	添加{"env":{"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS":"1"}}
重启Claude Code	claude code start	启用后必须重启生效
验证功能是否启用	/config	看到Agent Teammate mode即为成功

2. 团队管理核心命令（必用）

命令用途	具体命令	备注
创建团队（指定领导）	/team create --lead "前端+后端协同负责人"	领导负责分配任务、汇总结果
添加队友（指定角色）	/team add --name "后端工程师" --role "backend"	name自定义，role建议与职责对应
分配任务给队友	/team assign --name "后端工程师" --task "实现用户CRUD API"	task描述需清晰，包含核心要求
启动团队（开始工作）	/team start	启动后所有队友并行执行任务
查看团队状态	/team status	查看各队友任务进度、执行状态
结束团队（任务完成）	/team end	结束后自动汇总所有队友成果

3. 进阶命令（可选）

命令用途	具体命令	备注
队友间发送消息	/team message --from "前端工程师" --to "后端工程师" --content "API接口格式请确认"	无需领导中转，直接沟通
加载预定义团队模板	/team load --file .claude/agent-teams/frontend-backend-team.json	需提前创建团队定义文件
删除指定队友	/team remove --name "后端工程师"	适用于任务调整、队友冗余场景
查看团队历史记录	/team history	查看任务分配、执行结果、沟通记录

二、前后端协同开发实战模板（可直接复制使用）

场景：实现「用户管理模块」（含用户列表、新增、编辑、删除功能），2人团队（前端工程师+后端工程师），并行开发+联调，适配Claude Code Agent Teams操作。

模板1：自然语言指令（快速创建，最常用）

直接复制到Claude Code终端，自动创建团队、分配任务并启动：

bash 复制代码

请创建一个2人前后端协同团队，实现用户管理模块，具体要求如下：
- 团队名称：用户管理前后端协同团队
- Lead（负责人）：前后端协同负责人，负责协调接口规范、汇总成果、组织联调
- 队友1：前端工程师，角色frontend，任务如下：
  1. 在src/client/components/目录下，创建UserList.tsx（用户列表组件）、UserForm.tsx（新增/编辑用户表单）
  2. 列表需包含用户ID、姓名、手机号、创建时间，支持分页、搜索
  3. 表单支持新增用户（姓名、手机号、密码）和编辑用户（姓名、手机号），做基础表单校验
  4. 调用后端API接口，实现数据渲染和交互（新增、编辑、删除）
  5. 页面样式简洁规范，适配PC端
- 队友2：后端工程师，角色backend，任务如下：
  1. 在src/server/routes/users.ts目录下，实现用户CRUD API接口
  2. 接口规范：
     - 查所有用户（分页）：GET /api/users?page=1&size=10
     - 查单个用户：GET /api/users/:id
     - 新增用户：POST /api/users（参数：name、phone、password）
     - 编辑用户：PUT /api/users/:id（参数：name、phone）
     - 删除用户：DELETE /api/users/:id
  3. 做基础参数校验（手机号格式、密码长度≥6位）
  4. 返回统一JSON格式：{code: 200, message: "success", data: ...}（错误时code≠200）
  5. 完成后，将接口文档（接口地址、请求方式、参数、返回示例）告知前端工程师
- 协同要求：
  1. 后端先定义接口规范，10分钟内同步给前端
  2. 前端根据接口规范开发UI，后端并行开发接口
  3. 遇到接口格式、参数问题，通过团队消息直接沟通
  4. 各自完成开发后，由Lead组织联调，解决交互问题
  5. 最终提交完整代码（前端组件+后端接口），并由Lead汇总开发报告

模板2：团队定义文件（可复用，适合频繁开发同类模块）

先创建团队定义文件：在 .claude/agent-teams/ 目录下，新建 frontend-backend-user-team.json

json 复制代码

{
  "name": "用户管理前后端协同团队",
  "lead": "前后端协同负责人",
  "teammates": [
    {
      "name": "前端工程师",
      "role": "frontend",
      "prompt": "专注前端组件开发和交互实现，严格按照后端提供的API接口规范开发，做好表单校验和页面渲染，遇到接口问题及时与后端工程师沟通，确保联调顺利"
    },
    {
      "name": "后端工程师",
      "role": "backend",
      "prompt": "专注后端API接口开发，先定义清晰的接口规范并同步给前端，做好参数校验和错误处理，返回统一格式的JSON数据，配合前端完成联调，提供接口文档"
    }
  ],
  "tasks": [
    {
      "name": "前端用户管理组件开发",
      "assignee": "前端工程师",
      "description": "1. 在src/client/components/创建UserList.tsx（用户列表，含分页、搜索）、UserForm.tsx（新增/编辑表单，含校验）；2. 调用后端API实现数据交互（新增、编辑、删除）；3. 适配PC端样式，保证交互流畅；4. 配合后端完成联调"
    },
    {
      "name": "后端用户CRUD API开发",
      "assignee": "后端工程师",
      "description": "1. 在src/server/routes/users.ts实现5个接口（GET/POST/PUT/DELETE）；2. 接口规范：GET /api/users?page=1&size=10（分页查）、GET /api/users/:id（单查）、POST /api/users（新增）、PUT /api/users/:id（编辑）、DELETE /api/users/:id（删除）；3. 参数校验（手机号格式、密码≥6位）；4. 返回统一JSON：{code, message, data}；5. 提供接口文档并同步给前端；6. 配合前端联调"
    },
    {
      "name": "协同联调与成果汇总",
      "assignee": "前后端协同负责人",
      "description": "1. 协调后端先同步接口规范；2. 跟踪两人开发进度；3. 组织联调，解决交互问题；4. 汇总前端组件代码、后端接口代码，生成开发报告"
    }
  ]
}

加载并启动团队（复制到Claude Code终端执行）：

bash 复制代码

# 加载预定义团队模板
/team load --file .claude/agent-teams/frontend-backend-user-team.json
# 启动团队，开始开发
/team start
# 查看开发进度
/team status

模板3：联调补充指令（开发完成后，复制执行）

bash 复制代码

请团队执行以下联调任务：
1. 后端工程师检查接口是否正常运行，提供测试用例（正确参数、错误参数）
2. 前端工程师调用接口，测试所有功能（列表渲染、新增、编辑、删除、分页、搜索）
3. 遇到接口报错、数据渲染异常，前端、后端直接沟通排查，Lead跟踪进度
4. 联调完成后，各自优化代码（注释、格式规范）
5. Lead汇总所有代码和测试结果，生成最终报告，内容包括：开发完成情况、联调问题及解决方法、接口文档、前端组件说明

使用说明

所有模板可直接复制到Claude Code终端，无需修改，也可根据实际项目路径、功能需求调整细节（如文件路径、接口参数）。
命令速查表可单独复制保存，开发时快速查阅，避免记混命令。
团队定义文件可重复使用，后续开发其他模块（如订单管理），只需修改tasks和teammates的prompt即可。

【AIGC】Claude Code的 Agent Teams 模式 使用指南 和样例

一、启用 Agent Teams（必须先做）

二、可选：安装 tmux（分屏监控）

三、核心概念

四、使用方法（3种方式）

1. 自然语言创建（最常用）

2. 命令行创建（精确控制）

3. 团队定义文件（批量复用）

五、实战场景示例

场景1：并行代码审查（3人团队）

场景2：前后端协同开发（2人团队）

六、最佳实践

七、常见问题

Claude Code Agent Teams 常用命令速查表 + 前后端协同开发实战模板

一、Agent Teams 常用命令速查表（可直接复制执行）

1. 基础配置与启用（必用）

2. 团队管理核心命令（必用）

3. 进阶命令（可选）

二、前后端协同开发实战模板（可直接复制使用）

模板1：自然语言指令（快速创建，最常用）

模板2：团队定义文件（可复用，适合频繁开发同类模块）

模板3：联调补充指令（开发完成后，复制执行）

使用说明

【AIGC】Claude Code的 Agent Teams 模式使用指南和样例