Claude Code 如何用 /effort 与 --effort 调整思考强度?claude-howto 的各模型 effort 级别说明
【免费下载链接】claude-howtoA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-howto
在 Claude Code 里跑复杂任务时,你可能会想控制模型"想多久、想多深":任务简单时降低思考强度以加快速度,做架构评审这类复杂任务时拉高思考强度。claude-howto 仓库的 CLI 参考、斜杠命令参考和高级功能文档给出了完整的做法:effort 级别从低到高为low(○)、medium(◐)、high(●)、xhigh、max,可通过命令行参数--effort、会话内斜杠命令/effort、环境变量CLAUDE_CODE_EFFORT_LEVEL三种方式设置,且不同模型支持的级别和默认值并不相同。
以下内容基于 10-cli/README.md、01-slash-commands/README.md 与 09-advanced-features/README.md 三篇文档。
effort 级别与各模型的支持情况
Opus 5、Sonnet 5、Opus 4.8 和 Opus 4.7 支持自适应推理(adaptive reasoning),即按上面五级 effort 级别调整思考强度。各模型的支持范围和默认值如下(引自 10-cli/README.md 的 "Effort Levels" 一节):
| 模型 | 模型 ID | 可用级别 | 默认 effort | 文档说明 |
|---|---|---|---|---|
| Opus 5 | claude-opus-5 | low→max | high | 自适应 effort 级别low → max(v2.1.219 起) |
| Sonnet 5 | claude-sonnet-5 | low→max | high | 1M tokens 上下文 |
| Opus 4.8 | claude-opus-4-8 | low→max | high(v2.1.154 起) | 上一代旗舰 Opus,仍可选择 |
| Opus 4.7 | — | 含xhigh | xhigh | 默认 effort 为xhigh |
| Opus 4.6 / Sonnet 4.6 | claude-sonnet-4-6等 | low–max | high | Pro/Max 订阅用户的默认值从medium提升到high(v2.1.117);xhigh不可用时会回退到high |
| Haiku 4.5 | claude-haiku-4-5 | 无 | — | 最快、适合快速任务;没有任何 effort 级别 |
几条需要记住的边界:
xhigh仅 Opus 5、Sonnet 5、Opus 4.8、Opus 4.7 可用,v2.1.111 引入,位于high与max之间;在 Opus 4.6 / Sonnet 4.6 上请求xhigh会回退到high(09-advanced-features/README.md 的说明)。max在 Opus 5、Sonnet 5、Opus 4.8/4.7/4.6 和 Sonnet 4.6 上可用,文档标注为 session-only(仅当前会话)。- 默认值随版本变化:Opus 5(v2.1.219)与 Opus 4.8(v2.1.154)默认
high,Opus 4.7 默认xhigh。 - 一个需要注意的文档差异:09-advanced-features/README.md 的 "Effort level" 小节列出的支持模型为 "Opus 5, Opus 4.8, Opus 4.7, Opus 4.6, and Sonnet 4.6",未提及 Sonnet 5;10-cli/README.md 的矩阵则把 Sonnet 5 列入
low → max支持范围。以你实际使用版本的 CLI 输出为准。
三种设置方式
方式一:命令行参数--effort
在启动 Claude Code 时用--effort固定本次会话的思考强度:
# Set effort level via CLI flag claude --effort high "complex review"--effort取值范围为low/medium/high/xhigh/max(见 10-cli/README.md 的参数表)。如果你通过 Agent View(claude agents)派生后台会话,派生参数里同样支持--effort <level>来固定 effort 级别(v2.1.142 起)。
方式二:会话内斜杠命令/effort
已经在会话中时,直接在输入框输入:
/effort high/effort [low|medium|high|xhigh|max|auto]会以交互式方向键滑块选择级别(见 01-slash-commands/README.md 的命令表),滑块顺序为low→medium→high→xhigh→max,菜单还提供auto。
方式三:环境变量CLAUDE_CODE_EFFORT_LEVEL
在 shell 中导出环境变量,对后续启动的会话生效:
export CLAUDE_CODE_EFFORT_LEVEL=high # low, medium, high, xhigh (Opus 5, Sonnet 5, Opus 4.8/4.7), or max10-cli/README.md 的环境变量表对该变量的说明:取值low/medium/high/xhigh/max;默认在 Opus 5、Sonnet 5、Opus 4.8 上为high(Opus 4.7 上为xhigh);xhigh需要 Opus 5、Sonnet 5 或 Opus 4.8/4.7;max在 Opus 5、Sonnet 5、Opus 4.8/4.7/4.6 和 Sonnet 4.6 上可用。
如何确认当前级别与查看思考过程
/effort菜单本身:打开/effort会看到当前级别所在的滑块位置,这是文档给出的直接确认方式。/model选择器:01-slash-commands/README.md 说明/model支持用左右方向键调整 effort("Select model with left/right arrows for effort"),v2.1.153 起选择会保存为新会话默认,按s则仅对当前会话生效。- 状态栏字段:09-advanced-features/README.md 的状态栏字段表中,Model 分组可展示
model.id、output_style.name、effort.level、fast_mode、thinking.enabled,即状态栏可以把effort.level显示出来。 - 查看推理过程:09-advanced-features/README.md 的 Extended Thinking 一节给出
Ctrl+O(verbose mode)用于查看推理,Alt+T/Option+T切换扩展思考。
另外两个与 effort 相关的行为,文档特别提醒过:
- 提示词中出现关键词
ultrathink会激活深度推理模式。 /effort菜单中的ultracode不是模型 effort 级别——它向模型发送xhigh并让 Claude 编排动态工作流(dynamic workflows),仅对当前会话生效(session-only),不写入设置文件。
默认值的保持行为与其他限制
- Opus 4.8 与 Opus 4.7 在首次运行时固定(pin)其默认 effort;Opus 5 没有这种 hold——你之前设置的级别会沿用过来(见 09-advanced-features/README.md 的 Note)。
- 扩展思考对所有模型默认启用;除自适应 effort 的模型外,其他模型使用固定 token 预算,上限 31,999 tokens,可用
export MAX_THINKING_TOKENS=1024这类方式设置自定义预算(同一文档)。 - Haiku 4.5 没有任何 effort 级别,针对它设置 effort 没有意义。
/code-review、/review等命令也接受同样的 effort 级别参数([low|medium|high|xhigh|max|ultra]),省略级别时会复用你上次输入的级别(v2.1.223,见 01-slash-commands/README.md)——如果你已经在用这些命令,本文的级别选择同样适用。
以上路径均可在当前仓库中直接查阅:模型与级别矩阵见 10-cli/README.md 的 "Models" 与 "Effort Levels" 小节,/effort命令行为见 01-slash-commands/README.md 的命令表,Extended Thinking 与配置方法见 09-advanced-features/README.md 的 "Activating Extended Thinking" 小节。
【免费下载链接】claude-howtoA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-howto
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考