Skip to content

子代理也能指定 effort 了:Agent 工具新增 effort 参数 ​

Claude Code 干大活时,经常会派出子代理(subagent):一个去翻代码找调用点,一个去跑测试看报错,一个去读文档。以前这些子代理用什么努力程度(effort),你基本管不了。

CLI 2.1.292 给 Agent 工具加了 effort 参数:Claude 可以按你要求的 effort 档位来运行子代理。

effort 是什么 ​

effort 决定模型在一个问题上愿意花多少推理、多少轮工具调用。档位越高,越仔细,也越慢、越贵;档位越低,越快、越省,但可能浅尝辄止。

主对话的 effort 你一直能调。问题出在子代理上:

  • 找文件、列目录这种简单检索,用高 effort 是浪费;
  • 排查并发 bug、审查安全逻辑这种难题,交给低 effort 又可能查不透。

现在子代理也能按任务难度分档了。

怎么用 ​

Agent 工具是 Claude 自己调用的,你不需要写参数,在提示里说清楚就行:

text
派两个子代理并行做:
1. 用低 effort 快速列出所有调用 parseConfig 的文件;
2. 用高 effort 仔细分析 parseConfig 在并发读写时会不会出问题。
汇总后告诉我结论。

Claude 会在调用 Agent 工具时带上对应的 effort,两个子代理各按各的档位跑。

几个实用的分档思路:

子任务类型建议档位
搜索文件、统计、列清单低
写常规代码、改测试中 / 默认
疑难 bug、架构评审、安全审查高

和管理员上限的关系 ​

团队如果用 maxEffortLevel 给 effort 设了天花板,子代理指定的档位同样不会越过这个上限,只能在允许范围内往下调。上限怎么设,见站内 maxEffortLevel 限制 effort。

顺带修掉的一个子代理问题 ​

同一版本还修复了:子代理定义里写了 permissionMode: auto,但当前环境里 auto mode 其实不可用(被设置禁用、触发了熔断,或者模型不支持)时,子代理仍会进入 auto mode。现在这种情况下不会再进入 auto mode。auto mode 的配置可以参考 Auto mode 配置。

小结 ​

  • 2.1.292 起,Agent 工具支持 effort,子代理可以按指定档位运行。
  • 在提示里说明「哪个子任务用什么档」即可,Claude 会自己传参。
  • 简单检索用低档省时间和额度,难题用高档;团队上限依然生效。

子代理用得多的人,把「按难度分档」写进常用提示或 CLAUDE.md,能明显省下一部分额度。

Claude-cn.org,专注于 Claude Code 中文教程