Claude Code 如何用 /effort 与 --effort 调整思考强度?claude-howto 的各模型 effort 级别说明
2026/9/10 5:58:58 网站建设 项目流程

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(●)、xhighmax,可通过命令行参数--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 5claude-opus-5lowmaxhigh自适应 effort 级别low → max(v2.1.219 起)
Sonnet 5claude-sonnet-5lowmaxhigh1M tokens 上下文
Opus 4.8claude-opus-4-8lowmaxhigh(v2.1.154 起)上一代旗舰 Opus,仍可选择
Opus 4.7xhighxhigh默认 effort 为xhigh
Opus 4.6 / Sonnet 4.6claude-sonnet-4-6lowmaxhighPro/Max 订阅用户的默认值从medium提升到high(v2.1.117);xhigh不可用时会回退到high
Haiku 4.5claude-haiku-4-5最快、适合快速任务;没有任何 effort 级别

几条需要记住的边界:

  • xhigh仅 Opus 5、Sonnet 5、Opus 4.8、Opus 4.7 可用,v2.1.111 引入,位于highmax之间;在 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 的命令表),滑块顺序为lowmediumhighxhighmax,菜单还提供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 max

10-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.idoutput_style.nameeffort.levelfast_modethinking.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),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询