/effort 深度核查 v2.1.179 · 已交叉核查 · Claude Code

本页目录19

Slash 命令看官方文档

设置模型工作难度级别从低到最高

Syntax

/effort [level|auto]

深度使用指南

最近核查 2026-06-25

· 来源 3 个

code.claude.comModel configuration — Adjust effort level
code.claude.comEnvironment variables — CLAUDE_CODE_EFFORT_LEVEL
code.claude.comCommands — Claude Code Docs

· 含官方文档· v2.1.179已交叉核查

它到底是什么

/effort 是 Claude Code 的会话内 slash 命令，用于控制自适应推理（adaptive reasoning）的深度。它决定模型在每个步骤上是否需要深度思考、以及思考多久——级别越低速度越快、成本越低；级别越高推理越深入、token 消耗越多。

/effort 本质上是 effortLevel 配置项和 CLAUDE_CODE_EFFORT_LEVEL 环境变量的会话内快捷入口。不支持 effort 的模型（如 Haiku）忽略此命令。

怎么触发 / 怎么使用

1. 打开交互式滑块

/effort

不带参数时打开图形滑块，用方向键或鼠标选择级别后确认。

2. 直接指定级别

/effort low
/effort medium
/effort high
/effort xhigh
/effort max

3. 重置为模型默认值

/effort auto

4. 启用 ultracode 模式

在 /effort 菜单中还可以选择 ultracode。它不是模型层面的 effort 级别，而是 Claude Code 自身的设置：向模型发送 xhigh，同时为每个实质性任务编排 dynamic workflow。ultracode 仅限当前会话，不属于 effortLevel 设置、--effort flag 或 CLAUDE_CODE_EFFORT_LEVEL 环境变量（即无法通过任何持久化途径保留）。除 /effort 菜单外，也可通过 --settings 传 "ultracode": true 或 Agent SDK control request 启用。

5. 单次深度推理（无需改变会话设置）

在任意 prompt 中包含 ultrathink 关键词，可为该轮请求触发更深推理，而不改变当前会话的 effort 设置。注意 think、think hard、think more 等短语不被识别为关键词，会作为普通文本处理。

各级别说明

级别	适用场景
`low`	短小、对延迟敏感、对智能要求低的任务
`medium`	对成本敏感、可接受轻微智能损失的场景
`high`	平衡 token 消耗与推理质量；Fable 5、Opus 4.8、Opus 4.6、Sonnet 4.6 的默认值
`xhigh`	更深推理，token 消耗更高；Opus 4.7 的默认值
`max`	对最复杂任务可能提升表现，但有边际递减风险，可能过度思考；仅当前会话有效
`ultracode`	Claude Code 设置（非模型 effort），额外编排 dynamic workflow；仅当前会话有效

effort 刻度是按模型单独校准的，同一级别名称在不同模型上不代表相同的计算量。

模型兼容性

模型	支持的级别
Fable 5	`low` `medium` `high` `xhigh` `max`
Opus 4.8 / Opus 4.7	`low` `medium` `high` `xhigh` `max`
Opus 4.6 / Sonnet 4.6	`low` `medium` `high` `max`

若设置的级别不受当前模型支持，Claude Code 自动降至该模型支持的最接近低档。例如，在 Opus 4.6 上设置 xhigh 实际执行为 high。

保存 / 配置 / 集成

优先级顺序（从高到低）

环境变量 CLAUDE_CODE_EFFORT_LEVEL
已配置的级别（effortLevel 设置或 /effort 命令）
模型默认值

skill / subagent frontmatter 中的 effort 字段在该 skill 或 subagent 运行期间覆盖会话级别，但不能覆盖环境变量。

多种配置方式

# 启动时指定（仅当次会话有效）
claude --effort high

# 环境变量（最高优先级，覆盖所有其他来源）
export CLAUDE_CODE_EFFORT_LEVEL=high
claude

// settings.json —— 跨会话持久化（仅支持 low/medium/high/xhigh）
{
  "effortLevel": "high"
}

# skill 或 subagent frontmatter
effort: medium

注意：max 和 ultracode 是纯会话级别选项，不接受写入 effortLevel 设置。要让 max 持久化，只能使用 CLAUDE_CODE_EFFORT_LEVEL=max。

在 `/model` 中同步调整

选择模型时，支持 effort 的模型旁边会显示左右方向键的 effort 滑块，可在同一操作中切换模型并调整 effort。

确认当前生效值

当前 effort 级别会显示在会话界面的 logo 和 spinner 旁边，例如 with low effort，无需打开 /model 即可确认。

运行约束 / 限制

约束	说明
`max` 仅限当前会话，但可持久化	`max` 不写 `effortLevel`，但可通过 `CLAUDE_CODE_EFFORT_LEVEL=max` 环境变量跨会话保留
`ultracode` 完全无法持久化	官方原文：ultracode「is not part of the `effortLevel` setting, the `--effort` flag, or `CLAUDE_CODE_EFFORT_LEVEL`」，只能在当前会话通过 `/effort` 或 `--settings` 传 `"ultracode": true` 启用
`effortLevel` 设置不接受 `max` / `ultracode`	只有环境变量可以持久化 `max`
模型切换时 effort 可能被重置	首次运行 Fable 5、Opus 4.8、Opus 4.7 时，Claude Code 应用该模型的默认 effort，忽略你之前为其他模型设置的值，需重新运行 `/effort`
不支持 effort 的模型无效	Haiku 等模型不支持 effort；自定义/第三方部署的模型需通过 `ANTHROPIC_DEFAULT_{OPUS,SONNET,HAIKU,FABLE,CUSTOM}_MODEL_SUPPORTED_CAPABILITIES` 系列环境变量声明能力
环境变量优先级最高	如果设置了 `CLAUDE_CODE_EFFORT_LEVEL`，`/effort` 命令在该会话内无法覆盖它

跟同类"调强度"原语对比

容易和 /effort 混淆的是 /model(换模型)与 /effort ultracode(开 workflow)。三者调的是不同维度:

维度	`/effort <level>`	`/model <name>`	`/effort ultracode`
调什么	同一模型的推理深度	切换底层模型	Claude Code 编排层(开 dynamic workflow)
是否换模型	否	是	否(在当前模型上加编排)
持久化	`low/medium/high/xhigh` 可写 settings;`max` 仅 env var	可写 settings	仅当前会话
token 影响	随级别上升而增加	取决于目标模型定价	显著增加(数十到上千 agent)
典型动机	简单任务降档省钱、难题升档	换更强/更快的模型	把实质任务自动拆成 workflow

记忆法:同模型调深浅用 /effort,换模型用 /model,把任务变成大编排用 /effort ultracode。注意 effort 刻度按模型单独校准,同一级名在不同模型不代表相同计算量。

经典使用场景

临时降速省成本：对话中途发现后续任务简单，用 /effort low 快速切换，无需重启会话。
遭遇复杂 bug 时临时提升：在调试难以复现的问题时用 /effort xhigh 或 max，解决后再 /effort auto 恢复默认。
单次深度推理：在 prompt 里加 ultrathink 关键词，仅对该轮加强推理，不影响后续消息的 effort 设置。
CI / 自动化管道：通过 CLAUDE_CODE_EFFORT_LEVEL=medium 环境变量为所有自动化任务统一限定成本，同时避免手动操作。

常见坑

切换模型后 effort 被静默重置：首次切到 Fable 5、Opus 4.8、Opus 4.7 时，Claude Code 强制使用该模型的默认 effort（分别为 high / high / xhigh）。需主动再次执行 /effort <level> 恢复。
xhigh 在旧模型上静默降档：Opus 4.6 / Sonnet 4.6 不支持 xhigh，会自动降为 high，界面不会明显提示降档发生。
环境变量设置后 /effort 失效：CLAUDE_CODE_EFFORT_LEVEL 优先级最高，会话内无法用 /effort 覆盖。若发现 /effort 不生效，先检查环境变量是否有残留设置。
max 设置未持久化：忘记通过环境变量固定 max，重启后恢复默认，导致效果前后不一致。

来源

Model configuration — Adjust effort level — 官方文档，包含完整的级别表、模型兼容性、ultracode 说明
Environment variables — CLAUDE_CODE_EFFORT_LEVEL — 官方文档，确认环境变量优先级与合法值
Commands — Claude Code Docs — 官方命令总览，确认 /effort 在典型工作流中的定位

全网调研整理

典型场景

简单查询、语法修复、快速重命名等低价值任务时用 low 节省 token 和延迟
日常编码、常规 bug 修复、写测试等大多数工作用 medium/high 作为平衡基线
复杂调试、架构决策、多文件重构、安全审查等需要深度推理时用 xhigh（Opus 4.7 推荐默认）
算法攻关、竞态条件、难以复现的故障等极端复杂问题时用 max 获得最高能力
不确定任务复杂度时用 /effort auto 让 Claude Code 按模型默认值自适应

实用技巧

输入 /effort 不带参数可打开交互式滑动条，在 /model 选择界面也可用左右方向键同步调整 effort
在 prompt 或 CLAUDE.md 里加入 ultrathink 关键词，可在不改变 session effort 设置的前提下对单次请求触发更深推理
low/medium/high/xhigh 跨 session 持久化，max 仅当前 session 有效（settings 文件不接受 max）
Skill 或 subagent 的 frontmatter 可设 effort 字段，覆盖 session 级别但不覆盖环境变量 CLAUDE_CODE_EFFORT_LEVEL
当前生效的 effort 级别会实时显示在 UI logo/spinner 旁（如 with low effort），可随时确认无需开 /model

常见坑

切换到 Opus 4.7 后 Claude Code 会自动重置为 xhigh，即使之前已为 Opus 4.6 设置了其他级别，需重新 /effort 调整
Opus 4.6 不支持 xhigh，若设置该级别会自动降级为 high，且同名 level 在不同模型间 token 消耗量不等
max 在简单任务上会 overthinking 并产生冗长输出，token 消耗可达 low 的 10 倍却收益极小

来源

最早记录ⓘ

≤v2.1.72

变化时间线(按版本倒序)

修复v2.1.181· 2026/06/18 · 22 天前

修复相对符号链接设置文件下配置变更失败的问题

改进v2.1.162· 2026/06/04 · 2026/06/04

现在确认所选级别将作为新会话的默认值持久化

修复v2.1.161· 2026/06/03 · 2026/06/03

修复对话框、工作流动画和提示关键词闪烁不遵守「Reduce motion」设置的问题

修复v2.1.160· 2026/06/02 · 2026/06/02

修复 `/effort ultracode` 在模型不支持时错误指责 dynamic workflows 设置

改进v2.1.154· 2026/05/29 · 2026/05/29

默认值改为 xhigh，标签从 Speed/Intelligence 改为 Faster/Smarter

修复v2.1.149· 2026/05/23 · 2026/05/23

修复状态栏显示错误 effort level 的问题

修复v2.1.147· 2026/05/22 · 2026/05/22

修复 effort 滑块初始位置错误的问题

修复v2.1.133· 2026/05/08 · 2026/05/08

修复一个会话改变 effort 级别意外影响其他并发会话

修复v2.1.132· 2026/05/07 · 2026/05/07

修复 picker 未反映 CLAUDE_CODE_EFFORT_LEVEL 环境变量覆盖

修复v2.1.113· 2026/04/18 · 2026/04/18

修复 auto 模式的确认提示标签

改进v2.1.111· 2026/04/16 · 2026/04/16

新增 xhigh 级别,支持交互式滑块调节

修复v2.1.98· 2026/04/10 · 2026/04/10

修复 `/effort max` 对未知或未来 model ID 的拒绝问题

改进v2.1.94· 2026/04/08 · 2026/04/08

改变默认 effort 级别从中到高（对于 API key、Bedrock/Vertex/Foundry、Team 和 Enterprise 用户）

改进v2.1.80· 2026/03/20 · 2026/03/20

改进了显示auto当前解析结果，匹配状态栏指示符

新增v2.1.76· 2026/03/14 · 2026/03/14

新增命令用于设置model effort level

改进v2.1.73· 2026/03/12 · 2026/03/12

改进了在Claude响应时也能工作，匹配/model行为

改进v2.1.72· 2026/03/10 · 2026/03/10

简化了 effort level 为 low/medium/high，添加了 `/effort auto` 选项来重置默认值。

本页目录19

Slash 命令看官方文档

设置模型工作难度级别从低到最高

Syntax

/effort [level|auto]

深度使用指南

最近核查 2026-06-25

· 来源 3 个

code.claude.comModel configuration — Adjust effort level
code.claude.comEnvironment variables — CLAUDE_CODE_EFFORT_LEVEL
code.claude.comCommands — Claude Code Docs

· 含官方文档· v2.1.179已交叉核查

它到底是什么

/effort 本质上是 effortLevel 配置项和 CLAUDE_CODE_EFFORT_LEVEL 环境变量的会话内快捷入口。不支持 effort 的模型（如 Haiku）忽略此命令。

怎么触发 / 怎么使用

1. 打开交互式滑块

/effort

不带参数时打开图形滑块，用方向键或鼠标选择级别后确认。

2. 直接指定级别

/effort low
/effort medium
/effort high
/effort xhigh
/effort max

3. 重置为模型默认值

/effort auto

4. 启用 ultracode 模式

5. 单次深度推理（无需改变会话设置）

各级别说明

级别	适用场景
`low`	短小、对延迟敏感、对智能要求低的任务
`medium`	对成本敏感、可接受轻微智能损失的场景
`high`	平衡 token 消耗与推理质量；Fable 5、Opus 4.8、Opus 4.6、Sonnet 4.6 的默认值
`xhigh`	更深推理，token 消耗更高；Opus 4.7 的默认值
`max`	对最复杂任务可能提升表现，但有边际递减风险，可能过度思考；仅当前会话有效
`ultracode`	Claude Code 设置（非模型 effort），额外编排 dynamic workflow；仅当前会话有效

effort 刻度是按模型单独校准的，同一级别名称在不同模型上不代表相同的计算量。

模型兼容性

模型	支持的级别
Fable 5	`low` `medium` `high` `xhigh` `max`
Opus 4.8 / Opus 4.7	`low` `medium` `high` `xhigh` `max`
Opus 4.6 / Sonnet 4.6	`low` `medium` `high` `max`

若设置的级别不受当前模型支持，Claude Code 自动降至该模型支持的最接近低档。例如，在 Opus 4.6 上设置 xhigh 实际执行为 high。

保存 / 配置 / 集成

优先级顺序（从高到低）

环境变量 CLAUDE_CODE_EFFORT_LEVEL
已配置的级别（effortLevel 设置或 /effort 命令）
模型默认值

skill / subagent frontmatter 中的 effort 字段在该 skill 或 subagent 运行期间覆盖会话级别，但不能覆盖环境变量。

多种配置方式

# 启动时指定（仅当次会话有效）
claude --effort high

# 环境变量（最高优先级，覆盖所有其他来源）
export CLAUDE_CODE_EFFORT_LEVEL=high
claude

// settings.json —— 跨会话持久化（仅支持 low/medium/high/xhigh）
{
  "effortLevel": "high"
}

# skill 或 subagent frontmatter
effort: medium

注意：max 和 ultracode 是纯会话级别选项，不接受写入 effortLevel 设置。要让 max 持久化，只能使用 CLAUDE_CODE_EFFORT_LEVEL=max。

在 `/model` 中同步调整

选择模型时，支持 effort 的模型旁边会显示左右方向键的 effort 滑块，可在同一操作中切换模型并调整 effort。

确认当前生效值

当前 effort 级别会显示在会话界面的 logo 和 spinner 旁边，例如 with low effort，无需打开 /model 即可确认。

运行约束 / 限制

约束	说明
`max` 仅限当前会话，但可持久化	`max` 不写 `effortLevel`，但可通过 `CLAUDE_CODE_EFFORT_LEVEL=max` 环境变量跨会话保留
`ultracode` 完全无法持久化	官方原文：ultracode「is not part of the `effortLevel` setting, the `--effort` flag, or `CLAUDE_CODE_EFFORT_LEVEL`」，只能在当前会话通过 `/effort` 或 `--settings` 传 `"ultracode": true` 启用
`effortLevel` 设置不接受 `max` / `ultracode`	只有环境变量可以持久化 `max`
模型切换时 effort 可能被重置	首次运行 Fable 5、Opus 4.8、Opus 4.7 时，Claude Code 应用该模型的默认 effort，忽略你之前为其他模型设置的值，需重新运行 `/effort`
不支持 effort 的模型无效	Haiku 等模型不支持 effort；自定义/第三方部署的模型需通过 `ANTHROPIC_DEFAULT_{OPUS,SONNET,HAIKU,FABLE,CUSTOM}_MODEL_SUPPORTED_CAPABILITIES` 系列环境变量声明能力
环境变量优先级最高	如果设置了 `CLAUDE_CODE_EFFORT_LEVEL`，`/effort` 命令在该会话内无法覆盖它

跟同类"调强度"原语对比

容易和 /effort 混淆的是 /model(换模型)与 /effort ultracode(开 workflow)。三者调的是不同维度:

维度	`/effort <level>`	`/model <name>`	`/effort ultracode`
调什么	同一模型的推理深度	切换底层模型	Claude Code 编排层(开 dynamic workflow)
是否换模型	否	是	否(在当前模型上加编排)
持久化	`low/medium/high/xhigh` 可写 settings;`max` 仅 env var	可写 settings	仅当前会话
token 影响	随级别上升而增加	取决于目标模型定价	显著增加(数十到上千 agent)
典型动机	简单任务降档省钱、难题升档	换更强/更快的模型	把实质任务自动拆成 workflow

经典使用场景

临时降速省成本：对话中途发现后续任务简单，用 /effort low 快速切换，无需重启会话。
遭遇复杂 bug 时临时提升：在调试难以复现的问题时用 /effort xhigh 或 max，解决后再 /effort auto 恢复默认。
单次深度推理：在 prompt 里加 ultrathink 关键词，仅对该轮加强推理，不影响后续消息的 effort 设置。
CI / 自动化管道：通过 CLAUDE_CODE_EFFORT_LEVEL=medium 环境变量为所有自动化任务统一限定成本，同时避免手动操作。

常见坑

切换模型后 effort 被静默重置：首次切到 Fable 5、Opus 4.8、Opus 4.7 时，Claude Code 强制使用该模型的默认 effort（分别为 high / high / xhigh）。需主动再次执行 /effort <level> 恢复。
xhigh 在旧模型上静默降档：Opus 4.6 / Sonnet 4.6 不支持 xhigh，会自动降为 high，界面不会明显提示降档发生。
环境变量设置后 /effort 失效：CLAUDE_CODE_EFFORT_LEVEL 优先级最高，会话内无法用 /effort 覆盖。若发现 /effort 不生效，先检查环境变量是否有残留设置。
max 设置未持久化：忘记通过环境变量固定 max，重启后恢复默认，导致效果前后不一致。

来源

Model configuration — Adjust effort level — 官方文档，包含完整的级别表、模型兼容性、ultracode 说明
Environment variables — CLAUDE_CODE_EFFORT_LEVEL — 官方文档，确认环境变量优先级与合法值
Commands — Claude Code Docs — 官方命令总览，确认 /effort 在典型工作流中的定位

全网调研整理

典型场景

简单查询、语法修复、快速重命名等低价值任务时用 low 节省 token 和延迟
日常编码、常规 bug 修复、写测试等大多数工作用 medium/high 作为平衡基线
复杂调试、架构决策、多文件重构、安全审查等需要深度推理时用 xhigh（Opus 4.7 推荐默认）
算法攻关、竞态条件、难以复现的故障等极端复杂问题时用 max 获得最高能力
不确定任务复杂度时用 /effort auto 让 Claude Code 按模型默认值自适应

实用技巧

输入 /effort 不带参数可打开交互式滑动条，在 /model 选择界面也可用左右方向键同步调整 effort
在 prompt 或 CLAUDE.md 里加入 ultrathink 关键词，可在不改变 session effort 设置的前提下对单次请求触发更深推理
low/medium/high/xhigh 跨 session 持久化，max 仅当前 session 有效（settings 文件不接受 max）
Skill 或 subagent 的 frontmatter 可设 effort 字段，覆盖 session 级别但不覆盖环境变量 CLAUDE_CODE_EFFORT_LEVEL
当前生效的 effort 级别会实时显示在 UI logo/spinner 旁（如 with low effort），可随时确认无需开 /model

常见坑

切换到 Opus 4.7 后 Claude Code 会自动重置为 xhigh，即使之前已为 Opus 4.6 设置了其他级别，需重新 /effort 调整
Opus 4.6 不支持 xhigh，若设置该级别会自动降级为 high，且同名 level 在不同模型间 token 消耗量不等
max 在简单任务上会 overthinking 并产生冗长输出，token 消耗可达 low 的 10 倍却收益极小

来源

最早记录ⓘ

≤v2.1.72

变化时间线(按版本倒序)

修复v2.1.181· 2026/06/18 · 22 天前

修复相对符号链接设置文件下配置变更失败的问题

改进v2.1.162· 2026/06/04 · 2026/06/04

现在确认所选级别将作为新会话的默认值持久化

修复v2.1.161· 2026/06/03 · 2026/06/03

修复对话框、工作流动画和提示关键词闪烁不遵守「Reduce motion」设置的问题

修复v2.1.160· 2026/06/02 · 2026/06/02

修复 `/effort ultracode` 在模型不支持时错误指责 dynamic workflows 设置

改进v2.1.154· 2026/05/29 · 2026/05/29

默认值改为 xhigh，标签从 Speed/Intelligence 改为 Faster/Smarter

修复v2.1.149· 2026/05/23 · 2026/05/23

修复状态栏显示错误 effort level 的问题

修复v2.1.147· 2026/05/22 · 2026/05/22

修复 effort 滑块初始位置错误的问题

修复v2.1.133· 2026/05/08 · 2026/05/08

修复一个会话改变 effort 级别意外影响其他并发会话

修复v2.1.132· 2026/05/07 · 2026/05/07

修复 picker 未反映 CLAUDE_CODE_EFFORT_LEVEL 环境变量覆盖

修复v2.1.113· 2026/04/18 · 2026/04/18

修复 auto 模式的确认提示标签

改进v2.1.111· 2026/04/16 · 2026/04/16

新增 xhigh 级别,支持交互式滑块调节

修复v2.1.98· 2026/04/10 · 2026/04/10

修复 `/effort max` 对未知或未来 model ID 的拒绝问题

改进v2.1.94· 2026/04/08 · 2026/04/08

改变默认 effort 级别从中到高（对于 API key、Bedrock/Vertex/Foundry、Team 和 Enterprise 用户）

改进v2.1.80· 2026/03/20 · 2026/03/20

改进了显示auto当前解析结果，匹配状态栏指示符

新增v2.1.76· 2026/03/14 · 2026/03/14

新增命令用于设置model effort level

改进v2.1.73· 2026/03/12 · 2026/03/12

改进了在Claude响应时也能工作，匹配/model行为

改进v2.1.72· 2026/03/10 · 2026/03/10

简化了 effort level 为 low/medium/high，添加了 `/effort auto` 选项来重置默认值。

深度使用指南

它到底是什么

怎么触发 / 怎么使用

1. 打开交互式滑块

2. 直接指定级别

3. 重置为模型默认值

4. 启用 ultracode 模式

5. 单次深度推理（无需改变会话设置）

各级别说明

模型兼容性

保存 / 配置 / 集成

优先级顺序（从高到低）

多种配置方式

在 /model 中同步调整

确认当前生效值

运行约束 / 限制

跟同类"调强度"原语对比

经典使用场景

常见坑

来源

全网调研整理

变化时间线(按版本倒序)

深度使用指南

它到底是什么

怎么触发 / 怎么使用

1. 打开交互式滑块

2. 直接指定级别

3. 重置为模型默认值

4. 启用 ultracode 模式

5. 单次深度推理（无需改变会话设置）

各级别说明

模型兼容性

保存 / 配置 / 集成

优先级顺序（从高到低）

多种配置方式

在 /model 中同步调整

确认当前生效值

运行约束 / 限制

跟同类"调强度"原语对比

经典使用场景

常见坑

来源

全网调研整理

变化时间线(按版本倒序)

在 `/model` 中同步调整

在 `/model` 中同步调整