第 11 章 · 多智能体协调
Claude Code 不仅是一个单一的 AI 助手,它还内置了一套完整的多智能体协调系统,允许主智能体(协调器)将复杂任务分解并分发给多个并行运行的子智能体(工作者),从而大幅提 升处理复杂工程任务的效率。
本章将深入解析这套系统的核心组件:AgentTool(子智能体生成)、TeamCreateTool / TeamDeleteTool(团队管理)、SendMessageTool(智能体间通信)以及 coordinatorMode(协调器编排逻辑)。
系统架构概览
多智能体系统由以下几个核心模块构成:
src/coordinator/coordinatorMode.ts # 协调器模式逻辑
src/tools/AgentTool/ # 子智能体生成工具
src/tools/TeamCreateTool/ # 团队创建工具
src/tools/TeamDeleteTool/ # 团队解散工具
src/tools/SendMessageTool/ # 智能体间消息工具
智能体协调流程图
下图展示了从任务分配到结果汇总的完整协作流程:
协调器模式(Coordinator Mode)
什么是协调器模式
协调器模式是一种特殊的运行模式,通过环境变量 CLAUDE_CODE_COORDINATOR_MODE 启用。在此模式下,主智能体扮演"协调器"角色,不直接执行具体任务,而是将工作分发给工作者智能体并汇总结果。
src/coordinator/coordinatorMode.ts
export function isCoordinatorMode(): boolean {
if (feature('COORDINATOR_MODE')) {
return isEnvTruthy(process.env.CLAUDE_CODE_COORDINATOR_MODE)
}
return false
}
协调器模式通过 bun:bundle 特性标志 COORDINATOR_MODE 进行死代码消除控制——在不支持该特性的构建中,整个协调器逻辑会被完全剔除。
协调器的系统提示
协调器拥有专属的系统提示,明确定义了其角色和工作方式:
src/coordinator/coordinatorMode.ts
export function getCoordinatorSystemPrompt(): string {
return `You are Claude Code, an AI assistant that orchestrates software
engineering tasks across multiple workers.
## 1. Your Role
You are a **coordinator**. Your job is to:
- Help the user achieve their goal
- Direct workers to research, implement and verify code changes
- Synthesize results and communicate with the user
- Answer questions directly when possible — don't delegate work
that you can handle without tools
...`
}
协调器的核心工作流分为四个阶段:
| 阶段 | 执行者 | 目的 |
|---|---|---|
| 研究 | 工作者(并行) | 调查代码库、理解问题 |
| 综合 | 协调器 | 分析研究结果、制定实施规范 |
| 实施 |