Claude Code subagent vs.Agent Teams vs. worktree

Claude Code支持多Agent协作，但里面的sugagent、Agent Teams、git worktree 概念容易混淆，好像都能并行协作开发。大多数开发者的错误做法是：把所有多Agent任务都用Agent Teams，或者把简单的工作也劲头十足地搞worktree，结果代码复杂度爆炸。

1. Claude Code官方文档现在把它分成三个清晰的层级：

层级1：Subagent（会话内辅助）
适用场景：在当前编码会话内部创建临时任务
特点：轻量级、快速、无需通信开销
例子：「帮我写单元测试」「重构这个函数」「生成API文档」
本质：一个主Agent指挥多个临时小助手，完成当前任务
成本：低，通信延迟小

层级2：Agent Teams（需要Agent间通信的并行任务）
适用场景：多个Agent需要真正协作、信息交互
特点：Agent有各自的记忆、上下文、角色定位
例子：前端Agent + 后端Agent + DevOps Agent 协同开发一个微服务架构
本质：真正的「团队」，每个Agent有独立决策权
成本：高，需要复杂的通信协议和状态管理

层级3：Git Worktree（轻量并行选项）
适用场景：传统多分支开发，手动协调
特点：完全依靠Git，不需要Agent间通信
例子：同时开发feature1和feature2，用两个worktree分离代码树
本质：操作系统级别的并行，Agent各自独立运行
成本：中等，但需要手动协调merge

2. 实战建议：
1）刚开始用Claude Code？用Subagent。让一个主Agent指挥，足够了。
2）小团队开发微服务？用Agent Teams，但不要超过3个Agent（通信成本会爆炸）。
3）大型项目长期并行？用Worktree，保持简单，让人类开发者协调。

大多数人的错误是高估了自己的需求，直接跳到Agent Teams。结果是Agent间通信变成性能瓶颈，不如一个聪明的Subagent快。

3. 背后的工程思想

这个三层设计反映了一个深层原则：越高级的能力，越要谨慎使用。

Subagent看似简单（一个主Agent内部）但足以解决90%的任务。Agent Teams强大但需要精细的通信协议。Worktree原始但极其稳定。

官方的建议其实是在说：从最简单的方案开始，只在确实需要的时候才升级。这叫做「渐进式能力提升」。

很多开发者喜欢一上来就用最强的功能，结果代码难以维护、Agent间延迟高、调试成本爆表。明确边界后，选择变得简单了。

官方文档：code.claude.com/docs/en/agent-teams

#HOW I AI# #程序员#