多 Agent 编码如何分配推理预算
文章介绍 Claude Code 子 Agent 的默认推理强度配置、配置优先级及 frontmatter 写法。提出主会话高强度规划、常规子任务低强度执行、审查任务单独提高强度的分层方案。
原文暂未完整获取,基于公开信息的快读
据提供的原文节选,Claude Code 2.1.316 新增 CLAUDE_CODE_SUBAGENT_EFFORT,让未单独指定推理强度的子 Agent 使用独立默认档位。作者据此提出一套分工:主会话高强度规划,检索和执行任务降低档位,审查任务再单独提高。
目前能确认什么
effort 用来调节模型的推理投入。在多 Agent 编码中,主会话负责拆解任务,子 Agent 分别承担搜索、读代码、测试和审查,各角色需要的推理深度可能不同。
按节选描述,新变量提供的是子 Agent 的兜底档位;具体 Agent 还可以在配置文件头部的 frontmatter 中写入 effort: low 或 effort: xhigh。
配置覆盖关系尤其关键。作者指出,全局变量 CLAUDE_CODE_EFFORT_LEVEL 会覆盖子 Agent frontmatter 中的 effort;组织设置的上限也会限制最终档位。想让不同角色使用不同强度,不能只给每个 Agent 填一个值,还要检查全局配置。
我的判断
这项配置最有价值的地方,是让主会话的规划预算与常规子任务的执行预算分开。
定位函数、收集调用位置这类边界清楚的任务,可以作为降低 effort 的候选;涉及并发、安全和跨模块影响的审查,则有理由保留更高投入。但「搜索」也可能包含复杂的调用链分析,不能仅凭角色名称定档。
节选没有给出可核验的成本、耗时和任务成功率对照,因此还不能判断具体收益。它对启动参数优先级的说明也不完整,准确顺序仍需官方文档确认。
另外,作者提出用输出 token 差异验证网关透传,这只能提供线索。输出长度本身有波动,确认 effort 是否生效,还需要查看请求字段或网关日志。