claud-code源码分析(六) --------- swarm多agent协作

Swarm（多 Agent 协作编排）实现原理与架构

本文档总结 ClaudeCode 中的多 agent 协作编排能力（Swarm / Agent Teams / Teammates）：它如何被启用、如何创建团队与成员、如何在不同 backend（tmux/iTerm2/in-process）下运行、如何进行权限提示的跨 agent 协调、以及常见 workflow 与注意事项。

1. 总览：Swarm 解决什么问题

Swarm 的目标是让一个“团队”里的多个 ClaudeCode 实例（或同进程 worker）并行工作，同时保持：

• 可见性：leader 能看到/管理每个 teammate 的运行状态与输出。
• 一致的权限体验：worker 触发ask权限时能转交给 leader 统一批准/拒绝。
• 可恢复与可清理：团队信息与 inbox 在磁盘上可恢复；团队结束时可清理目录与任务列表。
• 后端无关：同样的“spawn / sendMessage / terminate / kill”接口可跑在 tmux/iTerm2 以及 in-process 模式。

Swarm 的关键设计点是：协作通道与执行后端解耦。

• 执行后端：决定“teammate