用途：指导在 Claude Code 中编排和控制多智能体团队，用于需要多视角并行协作的任务。
启用：Agent Teams 为实验性功能，需通过环境变量开启，例如在配置中设置 {"env": {"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"}}，或在运行 Claude Code 前于 shell 中设置该变量。
创建团队：用自然语言描述适合多视角的并行工作即可，例如让一名队友负责 UX、一名负责技术架构、一名扮演反方。Claude 会创建团队负责人（主会话）、队友（独立的 Claude Code 实例）和共享任务列表。
显示模式：默认 in-process 模式，所有队友在主终端运行，用 Shift+Up/Down 选择队友并直接输入消息；split-pane 模式为每个队友分配独立窗格，需要 tmux 或 iTerm2，可通过 settings.json 的 teammateMode 设置，或用 claude --teammate-mode in-process 按会话覆盖。
控制队友：任务可由负责人显式分配，也可由队友自动认领未分配且未阻塞的任务。in-process 下选中队友输入消息、回车查看、Escape 中断；split-pane 下点击窗格直接交互。启动团队后按 Shift+Tab 进入 delegate 模式，使负责人专注协调而不亲自实现任务。复杂任务可要求计划审批，例如让架构师队友重构认证模块并在改动前先获批。
最佳实践：队友不继承负责人的对话历史，需在生成提示中提供充分上下文；任务粒度要适中，过小则协调开销大于收益，过大则长时间无检查点；避免文件冲突，让每个队友负责不同文件；持续监控与引导，及时检查进度、调整方向并汇总结果。完成后由负责人执行清理团队，释放共享资源。
适用场景：研究与评审（多视角同时进行）、新模块或新功能（相互独立的部分）、用竞争性假设调试（并行调查）、跨层协调（前端、后端、测试）。不适合顺序任务、同一文件编辑和依赖较多的工作。
常见模式：并行代码评审（如针对 PR #142 生成安全、性能、测试覆盖三名评审者）；用竞争性假设调查问题（生成 5 名队友分别验证不同假设并相互反驳）。
限制：in-process 队友不支持会话恢复；任务状态可能滞后于实际完成；关闭可能较慢（队友先完成当前请求）；每个会话仅一个团队；不支持嵌套团队（队友不能再生成团队）；负责人在团队生命周期内固定；split-pane 需要 tmux 或 iTerm2，不支持 VS Code 终端、Windows Terminal、Ghostty。
故障排查：队友不可见时按 Shift+Down 循环切换并确认任务是否值得组队；权限提示过多时在权限设置中预批准操作；队友因错误停止时检查输出、补充指令或生成替代队友；负责人过早关闭时告知其继续等待队友；出现孤立 tmux 会话时用 tmux ls 查看，再用 tmux kill-session -t <name> 结束。