Claude Code源码解析:为何需要6个Agent而非1个
在使用Coding Agent时,用户常会遇到模型“过度执行”的问题:修改一个bug时顺手重构半个文件,添加一行功能却引入三层抽象。Claude Code的源码揭示,这一现象并非单纯由模型能力不足导致,而是架构设计问题。Anthropic认为,单一的通用Agent在处理复杂任务时,因角色冲突会导致行为边界模糊,因此在其系统中内建了6个角色完全不同的Agent,通过职能拆分与硬约束来解决上述痛点。
01六大Agent角色职能划分
六大Agent核心职能
通用任务Agent
负责日常的编码执行与落地
Explore Agent
纯只读的代码探索专家
Plan Agent
仅负责规划,不执行任何操作
Verification Agent
进行对抗性验证,主动查找代码问题
Guide Agent
负责提供使用指导
Status Line Setup Agent
负责状态栏配置
这种设计基于“分而治之”的理念。若让同一个Agent既做需求分析又做实现,它会不自觉地将需求向容易实现的方向解读;既写代码又做审查,则难以发现自己存在的问题。通过将研究、规划、实现、验证等环节拆分给不同的Agent,系统能够确保每个阶段的职责清晰,避免角色冲突带来的系统性偏差。
02三重隔离设计原理
- 工具级隔离
Explore Agent仅配备Glob、Grab和File Read等只读工具,被严格禁止执行创建、修改、删除文件或运行改变系统状态的命令。这种权限隔离确保了探索阶段的安全性,防止因误操作影响后续实现。 - Prompt隔离
每个Agent拥有独立的System Prompt,明确界定其行为边界。其中,Verification Agent的Prompt长达130行,核心指令是“主动构造错误场景”,像QA工程师一样进行对抗性测试,而非仅做温和的检查。 - 模型级隔离
根据任务需求分配算力,如Explore Agent在外部场景下默认使用成本更低的Hiku模型,而需要强推理的实现和验证阶段则调用更大的模型。这符合“推理三明治”策略,将算力精准投入关键环节。
03行为规范与硬约束
- 禁止添加用户未要求的功能
- 避免过度抽象,三行重复代码优于不成熟的抽象
- 不为未修改的代码添加注释或文档字符串
- 不做不必要的错误处理和兜底逻辑
- 不设计面向未来的抽象,遵循先读代码再修改的原则
Claude Code通过将上述规则写入“getSimpleDoingTaskSection”函数,将行为规范制度化。这种多Agent架构的核心设计哲学在于“不信任模型的自觉性”。凡是能用硬约束解决的(如工具权限限制),绝不依赖软约束(如Prompt提示);只有在无法代码拦截的行为上,才退而求其次使用明确的规则。通过硬约束兜底、软约束补缝,该系统有效避免了单一Agent因角色冲突导致的过度执行和偏差,为工业级Agent系统的设计提供了标准参考。
当前文章无评论,是时候发表评论了