子代理也能指定 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,能明显省下一部分额度。