适合你这种做全栈项目的人：前端、后端、测试、架构、代码审查可以让多个 Claude Code 实例并行协作。
1. 先说结论：Agent Team 是什么？
Claude Code Agent Team 模式可以理解为：
让 Claude Code 模拟一个开发团队：一个主 Claude 当「技术负责人 / Team Lead」，多个 Claude 当「队友」，分别负责前端、后端、测试、架构、代码审查等任务。
官方文档说明，Agent teams 会协调多个 Claude Code 实例一起工作，其中一个会话作为 team lead，负责分配任务、协调工作和汇总结果；其他 teammates 独立工作，各自拥有自己的上下文窗口，并且可以互相通信。该功能目前是实验性功能，默认关闭，需要手动启用，并要求 Claude Code v2.1.32 或更高版本。(Claude)
2. Agent Team 和 Subagent 的核心区别
2.1 一句话区别
模式通俗理解Subagent主 Claude 临时叫一个「小助手」去做专项任务，做完回来汇报Agent Team主 Claude 组建一个「开发团队」，多个成员并行工作，还能互相沟通
2.2 官方级对比
对比项SubagentAgent Team运行方式在单个 Claude Code 会话内运行多个独立 Claude Code 会话组成团队上下文有自己的上下文，但最终结果返回主会话每个 teammate 都是独立上下文沟通方式只能向主 agent 汇报队友之间可以直接通信协作方式主 agent 统一调度共享任务列表，队友可自协调适合场景代码搜索、审查、调研、专项任务多模块开发、复杂重构、并行排查、跨端协作Token 成本较低较高复杂度简单更复杂是否适合小任务适合不太适合
官方文档也明确建议：如果只是快速、聚焦的任务，用 subagents；如果需要多个成员共享发现、互相挑战结论、自行协调，则用 agent teams。(Claude)
3. Agent Team 的优势
3.1 并行开发能力更强
比如你要开发一个完整功能：
用户登录 + 权限系统 + 管理后台页面 + API 接口 + 单元测试 + 文档
传统 Claude Code 可能按顺序做：
分析需求 → 看代码 → 改后端 → 改前端 → 写测试 → 修 bug → 写文档
Agent Team 可以拆成：
Lead：拆任务、定规范、最后整合
Backend Agent：负责接口和权限逻辑
Frontend Agent：负责页面和交互
Test Agent：负责测试用例
Reviewer Agent：负责代码审查
这就更像真实开发团队。
3.2 上下文污染更少
Claude Code 最大的问题之一是：
会话越长，读的文件越多，输出越多，上下文越容易混乱。
Anthropic 官方最佳实践也提到，Claude 的上下文窗口会随着对话、文件读取、命令输出快速填满，性能可能随上下文填充而下降，因此需要积极管理上下文。(Claude)
Agent Team 中，每个队友都有自己的上下文窗口，可以把复杂任务拆开，避免所有信息都塞进一个 Claude 会话里。
3.3 适合复杂项目
特别适合这些场景：
1. 前后端同时开发
2. 大型重构
3. 多模块并行实现
4. Bug 多假设并行排查
5. 代码审查 + 测试 + 修复同步进行
6. 技术方案评审
7. 老项目梳理
8. 大型 PR 修改
官方也建议 Agent teams 适合研究和审查、新模块或新功能、调试中的竞争假设、跨层协调等任务；但对于顺序型任务、同文件频繁编辑、强依赖任务，单会话或 subagents 往往更合适。(Claude)
4. 使用前准备
4.1 检查 Claude Code 版本
claude --version
Agent Team 需要：
Claude Code v2.1.32 或更高版本
如果版本太低，先升级 Claude Code。
4.2 开启 Agent Team 实验功能
在 ~/.claude/settings.json 中加入：
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
}
}
官方文档说明，Agent teams 默认关闭，需要通过 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS 环境变量或 settings.json 启用。(Claude)
4.3 Windows 用户注意
如果你在 Windows 上用 Claude Code，推荐环境：
Windows Terminal
PowerShell 7+
Git Bash / WSL2 二选一
Node.js
Git
Claude Code CLI
如果要使用分屏模式，tmux 在 Windows 原生环境可能体验一般，更推荐：
方案一：WSL2 + Ubuntu + tmux
方案二：直接使用默认 in-process 模式
Agent Team 支持两种显示模式：一种是在当前终端中运行，通过 Shift + Down 切换成员；另一种是 split panes，每个 teammate 一个分屏，通常需要 tmux 或 iTerm2。(Claude)
5. 第一个 Agent Team 示例
进入你的项目目录：
cd your-project
claude
然后输入：
请创建一个 agent team 来分析当前项目。
团队角色如下：
1. Team Lead：负责整体协调、任务拆分、最终汇总。
2. Backend Agent：分析后端架构、接口设计、鉴权逻辑。
3. Frontend Agent：分析前端页面结构、组件复用、交互问题。
4. Database Agent：分析数据库表结构、索引、潜在性能问题。
5. Reviewer Agent：负责最终代码质量和风险审查。
当前任务：
请完整分析当前项目的架构、主要模块、潜在问题，并输出一份适合后续重构的技术分析报告。
要求：
- 先不要修改代码
- 只做分析
- 每个 agent 给出自己的结论
- Team Lead 最后汇总成一份完整报告6. Agent Team 的推荐角色设计
6.1 常见开发团队配置
Team Lead
Backend Agent
Frontend Agent
Database Agent
Test Agent
Reviewer Agent
DevOps Agent
Product Agent
Security Agent6.2 Java 后端项目推荐团队
适合 Spring Boot / Spring Cloud 项目：
请创建一个 agent team，角色如下：
1. Architect Agent
负责整体架构、模块边界、分层设计、领域模型分析。
2. Backend Agent
负责 Java/Spring Boot 代码实现、接口逻辑、Service 层、Controller 层。
3. Database Agent
负责 MySQL 表结构、索引、SQL 性能、事务边界。
4. Redis Agent
负责缓存设计、Key 设计、过期策略、缓存一致性。
5. Security Agent
负责鉴权、权限、接口安全、敏感信息泄露风险。
6. Test Agent
负责单元测试、集成测试、边界用例。
7. Reviewer Agent
负责最终代码审查、风险汇总、重构建议。
任务：
请分析当前项目，并输出一份完整的技术评审报告。6.3 前后端功能开发团队
请创建一个 agent team 帮我开发一个后台用户管理模块。
角色如下：
1. Team Lead
负责拆分任务、协调前后端接口、最终验收。
2. Backend Agent
负责实现用户管理 API，包括列表、详情、新增、编辑、删除、启用禁用。
3. Frontend Agent
负责实现 Vue/React 管理后台页面，包括列表、搜索、弹窗表单、状态切换。
4. Database Agent
负责检查用户表结构、字段设计、索引设计。
5. Test Agent
负责编写接口测试和核心逻辑测试。
6. Reviewer Agent
负责代码审查和风险检查。
要求：
- 先阅读项目结构
- 先给出开发计划
- 等我确认后再修改代码
- 修改完成后运行测试
- 输出改动文件列表和验证结果7. Agent Team 的工作流程
7.1 标准流程
第一步：描述目标
第二步：指定团队角色
第三步：要求先分析，不要直接改代码
第四步：让 Team Lead 输出开发计划
第五步：确认计划
第六步：开始并行开发
第七步：运行测试
第八步：Reviewer 审查
第九步：Team Lead 汇总结果7.2 推荐工作口令
分析项目
请创建 agent team 分析当前项目架构。先不要修改代码，只输出分析报告和改造建议。开发功能
请创建 agent team 开发这个功能。先让 Team Lead 拆任务并给出计划，我确认后再执行。修复 Bug
请创建 agent team 排查这个 bug。让不同 agent 从不同假设出发并行分析，最后汇总结论。代码审查
请创建 agent team 对当前改动进行代码审查。重点检查安全、性能、可维护性、测试覆盖率。重构项目
请创建 agent team 制定重构方案。先分析现有问题，再输出分阶段重构计划，不要直接改代码。8. Agent Team vs Subagent：怎么选？
8.1 用 Subagent 的场景
适合：
1. 查找某段代码在哪里
2. 分析一个 bug 日志
3. 审查一个文件
4. 生成测试用例
5. 搜索项目结构
6. 做一次性调研
7. 不需要多个 agent 互相沟通例如：
请使用 subagent 帮我搜索当前项目中所有 JWT 鉴权相关代码，并总结调用链。Subagents 的核心价值是保持主对话干净、限制工具权限、复用配置、专门化任务、控制成本。(Claude)
8.2 用 Agent Team 的场景
适合：
1. 一个功能涉及多个模块
2. 多个方向需要并行研究
3. 前后端需要同步开发
4. 需要多个 agent 互相讨论
5. 需要模拟真实开发团队
6. 任务复杂且长期
7. 需要架构、开发、测试、审查协同
例如：
请创建 agent team，分别从前端、后端、数据库、测试、安全五个角度开发并审查这个订单模块。9. Agent Team 的缺点和坑
9.1 Token 消耗更高
因为每个 teammate 都是独立 Claude Code 实例，所以消耗会明显更高。官方文档也说明，Agent teams 的 token 成本高于 subagents，因为每个 teammate 都是单独的 Claude 实例。(Claude)
9.2 不适合小任务
比如：
改一个按钮颜色
修一个 typo
加一个字段
写一个简单 SQL这种直接用普通 Claude Code 或 subagent 就行。
9.3 容易文件冲突
多个 agent 同时改同一个文件，可能会互相覆盖。
解决方式：
1. 明确每个 agent 负责的目录
2. 让 Team Lead 统一合并
3. 要求修改前先声明改动文件
4. 复杂任务使用 Git 分支或 worktree9.4 需要更强的任务拆分能力
不要这样说：
帮我优化项目。应该这样说：
请创建 agent team 优化当前 Spring Boot 项目。
角色：
- Architect Agent：分析架构问题
- Backend Agent：分析业务代码问题
- Database Agent：分析 SQL 和索引问题
- Security Agent：分析安全问题
- Reviewer Agent：汇总风险
要求：
- 只分析，不修改代码
- 输出问题清单、影响范围、优先级、建议方案10. 高质量 Agent Team 提示词模板
10.1 通用开发模板
请创建一个 Claude Code agent team 来完成以下任务。
【任务目标】
实现/分析/重构：{这里写你的目标}
【团队角色】
1. Team Lead
- 负责拆分任务
- 协调所有 teammates
- 控制修改范围
- 最终汇总结果
2. Backend Agent
- 负责后端接口、业务逻辑、权限、异常处理
3. Frontend Agent
- 负责前端页面、组件、交互、接口联调
4. Database Agent
- 负责表结构、SQL、索引、事务、性能
5. Test Agent
- 负责编写和运行测试用例
6. Reviewer Agent
- 负责代码审查、安全风险、可维护性检查
【工作要求】
1. 先阅读项目结构
2. 先输出任务拆分和执行计划
3. 未经确认不要修改代码
4. 每个 agent 只负责自己的范围
5. 修改前说明会改哪些文件
6. 修改后运行测试或构建命令
7. 最后输出：
- 完成了什么
- 修改了哪些文件
- 如何验证
- 是否还有风险
- 后续建议
【限制条件】
- 不要引入不必要的新依赖
- 不要破坏现有接口兼容性
- 不要大范围重构无关代码
- 保持代码风格与当前项目一致10.2 Spring Boot 项目模板
请创建一个 agent team，帮我开发 Spring Boot 项目的 {功能名称} 功能。
【技术栈】
- Java
- Spring Boot / Spring Cloud
- MyBatis / JPA
- MySQL
- Redis
- Vue / React 前端
【团队角色】
1. Team Lead：负责拆分任务和最终验收
2. Backend Agent：负责 Controller、Service、DTO、VO、异常处理
3. Database Agent：负责表结构、索引、SQL 性能
4. Redis Agent：负责缓存设计和一致性
5. Frontend Agent：负责管理后台页面和接口调用
6. Test Agent：负责测试和验证
7. Reviewer Agent：负责代码审查
【开发要求】
- 先分析当前项目结构
- 遵循现有代码风格
- 接口设计保持 RESTful
- 返回结构使用项目已有统一响应格式
- 参数校验要完整
- 异常处理要统一
- 敏感操作要检查权限
- 最后运行测试和构建
【输出要求】
- 开发计划
- 改动文件列表
- 接口说明
- 数据库变更说明
- 测试结果
- 风险说明10.3 Bug 排查模板
请创建一个 agent team 帮我排查以下 bug：
【Bug 描述】
{粘贴 bug 现象}
【错误日志】
{粘贴日志}
【复现步骤】
{写复现步骤}
【团队角色】
1. Team Lead：负责协调排查方向和最终结论
2. Backend Agent：从业务逻辑和接口调用链排查
3. Database Agent：从数据、SQL、事务角度排查
4. Cache Agent：从 Redis 缓存和一致性角度排查
5. Test Agent：尝试构造复现用例
6. Reviewer Agent：检查修复方案是否有副作用
【要求】
- 不要一上来就改代码
- 每个 agent 从不同假设分析
- 先输出最可能的原因排序
- 再给出修复方案
- 我确认后再修改代码11. 从入门到精通的学习路线
阶段一：入门
目标：会启动、会创建简单团队。
练习：
创建一个 agent team，分析当前项目结构，不修改代码。你要掌握：
1. 如何开启 Agent Team
2. 如何指定角色
3. 如何要求只分析不修改
4. 如何让 Team Lead 汇总阶段二：进阶
目标：让多个 agent 分工开发。
练习：
创建一个 agent team，开发一个用户管理模块。
后端负责 API，前端负责页面，测试 agent 负责验证。你要掌握：
1. 明确模块边界
2. 防止多个 agent 修改同一文件
3. 让 Team Lead 统一验收
4. 要求输出改动文件列表阶段三：高级
目标：用于复杂项目重构。
练习：
创建一个 agent team，分析当前项目是否适合从单体拆分为模块化架构。你要掌握：
1. 架构分析
2. 风险评估
3. 分阶段重构
4. 测试保护
5. 代码审查阶段四：精通
目标：形成自己的 AI 开发团队工作流。
你可以固定一套团队：
Architect Agent
Backend Agent
Frontend Agent
Database Agent
Security Agent
Test Agent
Reviewer Agent
Docs Agent然后每次开发新功能都这样用：
1. 需求分析
2. 技术方案
3. 任务拆分
4. 并行开发
5. 自动测试
6. 代码审查
7. 文档输出
8. 最终验收12. 最佳实践总结
12.1 提示词要具体
差的写法：
帮我开发一个订单功能。好的写法：
请创建 agent team 开发订单管理功能，包括订单列表、详情、状态流转、后台管理页面、接口测试。先输出计划，我确认后再修改代码。12.2 一定要先计划，再执行
建议固定加上：
先不要修改代码，先输出分析和计划，等我确认后再执行。12.3 每个 agent 负责独立范围
好的拆法：
Backend Agent：只改 backend/src
Frontend Agent：只改 frontend/src
Test Agent：只写 tests
Reviewer Agent：只审查，不直接修改12.4 让 Claude 自己验证
官方最佳实践强调，要给 Claude 明确的验证方式，比如测试、截图、预期输出等，这会显著提升结果可靠性。(Claude)
你可以写：
修改完成后，请运行：
npm run build
npm run test
mvn test
如果失败，请先分析原因，再修复。13. 我的推荐用法
小任务
用普通 Claude Code：
帮我修复这个方法的空指针问题。中等任务
用 subagent：
请使用 subagent 搜索当前项目中所有权限校验逻辑，并总结调用链。大任务
用 Agent Team：
请创建 agent team，帮我完成后台权限系统重构，包含架构分析、接口调整、前端菜单权限、测试和代码审查。14. 最终总结
Claude Code 的三种使用层级可以这样理解：
普通 Claude Code = 一个高级程序员
Subagent = 高级程序员临时叫几个专项助手
Agent Team = 组建一个小型 AI 开发团队Subagent 的优势：
简单、便宜、快、适合专项任务。Agent Team 的优势：
并行能力强、协作能力强、上下文隔离更好、适合复杂项目。最佳选择：
小任务：普通 Claude Code
专项分析：Subagent
复杂项目：Agent Team如果你要做 Spring Boot + Vue/React + MySQL + Redis 这种全栈项目，Agent Team 最适合用在：
1. 新模块开发
2. 老项目重构
3. Bug 并行排查
4. 前后端联调
5. 代码质量审查
6. 架构方案评估