Claude Code Agent Teams 实战：并行分工与 Worktree 隔离

Agent Teams 中每位 teammate 都有独立上下文窗口。lead 创建共享任务、分配工作并综合结果；成员可以通过 mailbox 相互发送信息和认领任务。这适合不同方向需要中途协调、挑战彼此结论或共享发现的复杂工作。

如果只是并行搜索三份资料、运行三个测试组并向主会话返回结果，子 Agent 更轻量。Teams 会消耗更多令牌，也需要处理成员状态、任务依赖和最终清理，不应成为默认模式。

按照当前官方说明，需要通过环境变量 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 启用。实验功能的行为和界面可能变化，因此团队规则中要记录版本、启用方式和回退到单会话的方案。

第一次使用控制在两到三名成员：例如 lead 负责方案与合并，成员 A 负责后端调用链，成员 B 负责测试和回归。角色按可交付问题定义，不要只写“高级工程师”这类无法验收的身份。

Task 1：梳理 API 调用链，只读，无依赖
Task 2：运行与分类测试，只读，无依赖
Task 3：设计修改方案，依赖 Task 1 和 Task 2
Task 4：实施 auth/service.py，唯一写入负责人
Task 5：复核与完整测试，依赖 Task 4
消息：只发送阻塞、接口变化、冲突证据和交接说明

成员完成任务时应附带证据、改动位置、测试和未验证项。避免把每个小进度都广播给所有成员；过度通信会浪费上下文，却不能代替共享任务状态。

Teams 不会自动解决 Git 合并冲突。最简单的办法是按文件或模块分配所有权；多个成员需要独立实现方案时，使用不同 worktree 和分支，最后由 lead 选择或合并。

Worktree 会隔离检出，但不会隔离数据库、端口、缓存和外部服务。并行运行测试前，为端口、测试库和临时目录设置独立值。合并完成后在最终分支重新运行完整测试与构建。

• lead 解决成员间矛盾，说明最终方案与舍弃原因。
• 每项修改能映射到任务和负责人，diff 中没有重叠冲突。
• 最终分支运行统一测试、构建和必要的页面验证。
• 关闭无用成员，检查未完成任务，清理不再需要的 worktree。
• 比较总令牌、总耗时和返工；收益不明显就改回子 Agent 或单会话。