目录
Claude Code 中模型名称旁边那个滑块——也就是从 “Faster” 到 “Smarter” 的 “Effort” 控件——决定的是 AI 在每次回复上投入多少工作量（思考量与 token）。向左滑则更快更省，向右滑则更深更聪明。
先看整体。effort 设置本身（API 的 effort 等级）共有 5 档：从 low 到 max，Claude Code 的 /effort 滑块就是在这 5 档之间选择。Ultracode 不是第 6 档，而是一个独立的开关，在任何档位都能开启或关闭（v2.1.284 及以后）。所以可以理解为 “5 档滑块 + Ultracode 开关”。记住这一点，其余内容就都能理顺了。
一个旋钮，从 “Faster” 到 “Smarter”
—— 它会同时调整思考深度与工具调用次数
= 5 个 API effort 等级（low–max）
滑块显示为 Low · Medium · High · Extra · Max。
因此 “Extra” = xhigh，最高的 effort 是 “Max”。Ultracode 不是一个档位，而是在任何档位都能使用的独立开关。
1. 什么是 “effort”（投入度）
effort 是控制 Claude 在单次回复上花多少 token 的设置。越低就越短、越快、越省；越高就越深入、越周全、越聪明。如果你搜索过 “Claude Code effort”，或好奇 “Faster / Smarter” 旋钮到底在干什么，答案就是它。
关键在于，effort 影响的是你的整个回复，而不仅仅是思考部分。具体来说，它会同时作用于以下三个方面（来源：Anthropic 官方 “Effort” 文档——扩展思考 / 工具调用与函数参数 / 文本回复与说明）。
思考深度
在回答前推理的程度。effort 越高，越允许进行多步分析和回溯。
工具调用
读取、搜索或编辑的次数。effort 越低，越会合并并减少调用次数。
回复文本的篇幅
说明、摘要、注释等。effort 越低，前言越少、输出越精简。
💡 一句话概括：effort 是一种行为信号，而不是固定的 token 预算。即便在低 effort 下，遇到真正困难的问题时 Claude 仍会思考——只是相比同一问题在更高 effort 下思考得少一些。
2. 滑块的 5 个档位与标签
作为 API 设置，effort 共有 5 个等级：low → medium → high → xhigh → max。默认值因模型而异：多数模型为 high，Opus 5.5 等为 medium（见第 3 节）。Claude Code 的 /effort 滑块就是在这 5 档之间进行选择的旋钮。
有一点容易让人犯错：“Extra” 并不是最高档。滑块显示为 Low · Medium · High · Extra · Max，其中 “Extra” = xhigh，“Max” = max。所以 “Extra” 是倒数第二档，而非最高档。而 Ultracode 根本就不是一个 effort 档位——它是一个行为不同的独立开关（见第 6 节）。在 v2.1.284 之前，Ultracode 作为第 6 个位置排在滑块最右端；现在它是一个独立开关，在 /effort 中按 Tab 键切换（在 VS Code 扩展中是滑块下方的开关）。
📝 提示：Claude Code 的界面尚未本地化为中文，因此 effort 滑块对中文用户显示为英文标签（Effort / Low / Medium / High / Extra / Max / Ultracode）——截至 2026 年 6 月为止。
token 最少、延迟最低
适合短小、范围明确的任务、格式化、样板代码、子智能体。速度与成本优先。
兼顾成本的中间档
在保持不错质量的同时控制 token 用量，适合日常工作。
质量与成本的最佳平衡点
复杂推理与高难度编码的标准档。对大多数工作来说“刚刚好”。
长时间运行的代理式工作
适合需要反复调用工具、深入搜索的编码任务。token 用量远多于 high。
最大思考量、无上限
最深入的推理，不设 token 上限。仅用于真正困难的问题；可能会过度思考。
⚠️ 哪些会保留、哪些不会：low、medium、high 和 xhigh 在滑块中按 Enter 确认后，会按模型分别保存并延续到下一个会话（按 s 确认则只作用于当前会话）。“Max” 仅限当前会话（只有在通过 CLAUDE_CODE_EFFORT_LEVEL 环境变量设置时才会保留）。Ultracode 用 /effort ultracode 开启时仅在当前会话有效，但只要在设置文件中写入 "ultracode": true，每个会话启动时都会开启（见第 6 节）。
3. 模型支持与自动降级
你能选择的等级取决于模型。xhigh（“Extra”）仅限较新的模型使用。当前的 Fable 5.1、Opus 5.5、Sonnet 5.5 和 Haiku 5.5 可以使用全部等级，而 旧款的 Haiku 4.5 完全不支持 effort（Haiku 系列从 2026 年 10 月 7 日发布的 Haiku 5.5 起才支持 effort）。关于如何为 Haiku 5.5 选择 effort 等级，见Claude Haiku 5.5 详解的第 6 章。
需要留意的是默认值。Claude Code 的默认模型 Opus 5.5 从 medium 起步，比 Opus 5 的默认值 high 低一档。
| 模型 | effort 等级（low–max） | Claude Code 默认 | API 默认 |
|---|---|---|---|
| Fable 5.1 | low · medium · high · xhigh · max | high | high |
| Opus 5.5 | low · medium · high · xhigh · max | medium | medium |
| Sonnet 5.5 | low · medium · high · xhigh · max | medium | high |
| Haiku 5.5 | low · medium · high · xhigh · max | medium | medium |
| 旧款（Legacy）：Fable 5 / Opus 5 / Sonnet 5 / Opus 4.8 | low · medium · high · xhigh · max | high | high |
| 旧款（Legacy）：Opus 4.7 | low · medium · high · xhigh · max | xhigh | high |
| 旧款（Legacy）：Opus 4.6 / Sonnet 4.6 | low · medium · high · max（无 xhigh） | high | high |
| 旧款（Legacy）：Haiku 4.5 | 不支持（无法调节 effort） | — | — |
* 截至 2026 年 10 月 12 日。“旧款（Legacy）”指 Anthropic 归入 Legacy（仍可使用）的模型。来源：Claude Code 模型配置（等级与 Claude Code 默认值），以及 API 的 Effort 文档、模型概览（API 默认值）。
* Sonnet 5.5 和 Opus 4.7 在 Claude Code 与 API 中的默认值不同。在 Claude Code 中不设置 effort 时，按“Claude Code 默认”一列运行。
* 在 Claude Code 中使用 Haiku 5.5 需要 v2.1.293 或更高版本。haiku 别名在 Anthropic API 上指向 Haiku 5.5，在 Amazon Bedrock、Google Cloud、Microsoft Foundry 等其他平台上仍指向 Haiku 4.5。
* Ultracode（与 effort 分开的开关）仅在支持 xhigh 的模型（Fable 5.1 / Opus 5.5 / Sonnet 5.5 等）上可用——在 Opus 4.6 和 Sonnet 4.6 上，/effort 中不会出现这个开关。
如果你选了模型不支持的等级，它不会报错——而是会自动降级到不高于该等级的、最接近的受支持等级。例如，在 Opus 4.6 上选 xhigh（“Extra”）会按 high 运行（这两个模型从 high 直接跳到 max，中间没有 xhigh）。另外要注意，同一个等级名称在不同模型上代表的程度并不相同——effort 标度是按每个模型分别校准的。
4. 如何设置（/effort 及其他方式）
从这里开始：/effort 命令。不带任何参数运行它，就会打开一个交互式滑块（即截图中的旋钮），用方向键操作即可。对大多数人来说，仅靠这一点就够了。
# 打开滑块（用方向键调整，然后按 Enter）
/effort
# 直接设置某个等级
/effort low
/effort xhigh
# 清除已保存的等级，恢复为模型的默认值
/effort auto
# 开启 / 关闭 Ultracode（effort 不变）
/effort ultracode
/effort ultracode off视需求而定，还有其他方式（后面几项面向高级用户）：
/model内的滑块：在模型选择器里，用左右方向键调整 effort 旋钮。--effort参数：用claude --effort medium启动（仅对该次会话生效）。CLAUDE_CODE_EFFORT_LEVEL环境变量：填入等级名称或auto。具有最高优先级。- 设置中的
modelSettings/effortLevel：在/effort或/model中确认的low/medium/high/xhigh等级，会按模型保存到用户设置的modelSettings下（v2.1.251 及以后；此前只写入一个effortLevel）。手动编辑时，可在modelSettings中为每个模型设置等级，或用effortLevel指定“没有已保存等级的模型”的默认值（但用户设置~/.claude/settings.json中的effortLevel对 Opus 5.5 及之后的模型不起作用）。两个键都不接受max，Ultracode 则有自己的"ultracode": true键。 - skill / 子智能体的 frontmatter：在该 skill 或子智能体运行期间覆盖 effort。
如果想一次性修改 Claude Code Desktop 中多个已打开会话的 effort 和模型，直接交给助手去改即可，具体做法和检查要点见《一次性修改 Claude Code 与 Codex 所有会话的模型和 effort》。
💡 优先级：环境变量 ＞ frontmatter（仅在该 skill/子智能体运行期间生效；永远不会盖过环境变量）＞ 你配置的/会话中的值 ＞ 模型默认值。当前等级会显示在徽标和加载指示器旁边，例如 “with low effort”，方便你确认正在生效的设置。
5. 速查：什么时候用哪个等级
官方建议很简单。模型的默认值足以应付大多数编码工作（Opus 5.5 和 Sonnet 5.5 为 medium，Fable 5.1 为 high）。需要验证时调到 high，耗时较长、需要更深入思考的工作用 xhigh（“Extra”），快速来回的交流降到 low，把 max 留给真正困难的问题。只有当你想一次性推进一个庞大的多步骤任务时，才动用 Ultracode。
| 选项（显示名） | 何时使用 |
|---|---|
| low | 短小、范围明确、对延迟敏感、不太需要智能的任务 |
| medium | 范围明确的日常实现（Opus 5.5、Sonnet 5.5 和 Haiku 5.5 的默认）。在其他模型上，适合对成本敏感、可以牺牲一点智能的工作 |
| high | 需要验证或容易出现边界情况的工作，例如修复现有代码中的 bug（Fable 5.1 等的默认） |
| xhigh (Extra) | 需要反复调用工具、深入搜索的长时间编码/代理式任务 |
| max (Max) | 仅限最难的问题。收益会趋于平缓且存在过度思考的风险——请先测试 |
| Ultracode | 庞大的多步骤任务（大规模重构、审计），希望拆分到多个代理上完成。与 effort 档位分开开启/关闭；不适合日常使用（→ §6） |
当你为繁重工作调高 effort 时，请设置一个充裕的 max_tokens（约 64k 以上），让模型有足够空间在多次工具调用中思考和行动。
6. Ultracode 是什么？与 effort 的 Max 有何不同（深入了解）
Ultracode 是一项 Claude Code 设置——一个开/关开关，在 /effort 中按 Tab 键切换。关键之处在于：它并不是一个 API effort 等级（low–max）。需要掌握以下两点。
effort 保持不变
开启后 effort 等级不会改变，仍按你当前所在的档位（Low 到 Max）运行。唯一的例外是用 claude --effort ultracode 启动，此时还会同时设为 xhigh（“Extra”）。
它会自动启动动态工作流
对于每个实质性任务，Claude 会自行规划并启动一个多代理工作流，并行运行若干子智能体。
“动态工作流”（要点 2）的意思是 Claude 会即时编写一段脚本，在后台并行运行许多子智能体。中间结果留在脚本中，只有最终结果会返回到 Claude 的上下文。单个请求可以扇出成多个工作流（例如“理解代码 → 修改代码 → 验证”）。默认最多同时运行 16 个代理（CPU 较少的机器上会更少；可用环境变量 CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS 修改），单次运行最多可达 1000 个代理。
🔑 Ultracode 与 xhigh 的区别：xhigh = 思考深度（一个 effort 档位）。Ultracode = 为每个任务自动启动多代理工作流的开关，与 effort 相互独立。因此 “Medium + Ultracode” 这样的组合也可以。在 v2.1.284 之前，开启 Ultracode 会把会话固定在 xhigh，选择其他档位会将其关闭，而 effort 上限低于 xhigh 时则无法使用。
如何开启
/effort ultracode：在本会话剩余时间内开启（每个实质性任务都会被自动转为工作流）。/effort ultracode off将其关闭。两者都不会改变你的 effort 等级。- 在
/effort滑块中按Tab切换 Ultracode 开关，再按Enter应用（在 VS Code 扩展中使用滑块下方的开关）。 - 用
claude --effort ultracode启动：以 Ultracode 开启、effort 为 xhigh（“Extra”）的状态开始。 - 若想每个会话启动时都开启，在设置文件中写入
"ultracode": true（也可以通过--settings或 Agent SDK 的控制请求传入）。 - 若只想用一次，在提示词里加入关键字
ultracode（例如 “ultracode: 审计 src 下的每一个端点”）。你的会话 effort 保持不变。
⚠️ 模型支持与持久化：Ultracode 需要支持 xhigh 的模型（Fable 5.1 / Opus 5.5 / Sonnet 5.5 等）；在 Opus 4.6、Sonnet 4.6 或不支持 effort 的旧款 Haiku 4.5 上，/effort 中不会出现这个开关。/effort ultracode 仅限当前会话；要让它持久生效，只能在设置文件中写入 "ultracode": true（effortLevel 和 CLAUDE_CODE_EFFORT_LEVEL 环境变量都不接受它）。要回到常规工作，运行 /effort ultracode off（在 v2.1.284 之前，选择 /effort high 等其他档位就会将其关闭）。
何时使用
✅ 适合的场景
大规模重构、跨数百个文件的迁移、覆盖整个代码库的 bug 或权限审计、多视角交叉核对——那些庞大到无法在一次对话中掌控的多步骤工作。
⛔ 不适合的场景
短小、范围明确的任务、对延迟敏感的工作、日常小改动。每个请求都会明显消耗更多 token 和时间，在这里属于浪费。
成本提示：由于每个实质性请求都会扇出成工作流，Ultracode 消耗的 token 和时间远超平常，可能会很快吃掉你的套餐用量和速率限额。建议先在一小块范围上试用（一个目录），以衡量规模。动态工作流功能本身也可以关闭，方法是通过 /config、设置 "disableWorkflows": true，或环境变量 CLAUDE_CODE_DISABLE_WORKFLOWS=1——这同时也会把 Ultracode 开关从 /effort 中移除。
* 行为依据 Anthropic 官方文档（Effort / 模型配置 / Workflows / 设置参考）；Ultracode 改为开关以及按模型保存等级，截至 2026 年 9 月 29 日（v2.1.284）。滑块标签是在运行中的 Claude Code 桌面界面里确认的（截至 2026 年 6 月）。effort 与 Ultracode 演进很快——请以官方文档和你的应用为准查看最新信息。
7. 相关功能与常见误区
有几项功能容易与 effort 混淆。下面说明它们的区别。
ultrathink
一个关键字，让 Claude 仅在这一轮更努力地思考；你的会话 effort 不变。自 v2.1.311 起，通过 Anthropic 的 API 使用 Opus 5.5、Sonnet 5.5、Haiku 5.5、Fable 5.1 时，该轮以 xhigh 的 effort 运行（在任务进行中输入，则该轮剩余部分的 effort 会提高；官方更新日志）。自 v2.1.316 起，可通过环境变量 CLAUDE_CODE_DISABLE_ULTRATHINK 关闭这个关键字；在 VS Code 扩展中同样会以 xhigh 运行（v2.1.316 更新日志）。像 “think” 或 “think hard” 这类说法会被当作普通文本，不起任何作用。
/fast（快速模式）
这是另一条独立的轴。它让同一个模型跑得更快（并不会换成更小的模型），代价是成本更高。把它与 low effort 搭配，能让日常工作更敏捷。
Ultracode
不是一个 effort 档位，而是让 Claude 自行搭建多代理工作流的开/关开关。在任何 effort 等级下都能使用。详见第 6 节。
常见的误区是“选了 'Extra' 就是最聪明”。实际上 “Extra” = xhigh，最高的 effort 是它右侧的 “Max”。即便是 Max 也并非总是最佳——在结构化输出或轻量任务上，它可能过度思考、反而损害质量。“编码从 xhigh（Extra）起步”这条官方建议是针对 Opus 4.7 和 4.8 的；当前的 Opus 5.5 应从其默认值 medium 起步。拿不准时，保持模型的默认值通常就够了。如果你的环境卡住了，参见 Claude Code 常见错误与解决方法。
总结
关于 Claude Code 的 effort 设置，有三点要记住。
- 它是什么：每次回复的 token 投入量设置——也就是你的 “Faster ↔ Smarter” 旋钮。它会同时影响思考、工具调用和回复文本。
- 档位与标签：API 有 5 个 effort 等级（low–max）。滑块显示为 Low · Medium · High · Extra · Max，Ultracode 则是独立的开关，不是档位。“Extra” = xhigh；最高的是 “Max”。默认值因模型而异（Opus 5.5、Sonnet 5.5 和 Haiku 5.5 为 medium，Fable 5.1 为 high）；xhigh 需要较新的模型；旧款的 Haiku 4.5 不支持 effort（Haiku 5.5 支持全部等级）；不支持的等级会自动降级。
- 什么时候用：先用模型的默认值，需要验证时用 high，耗时长且需深入思考的工作用 xhigh（“Extra”），快速任务用 low，max 仅用于困难问题。庞大的多步骤任务 → Ultracode（在任何 effort 等级下都能开启的多代理自动化；用
/effort ultracode off关闭）。
一个旋钮，让你在速度与智能之间取得平衡。可与 loop 命令 以及我们的 AI 编码工具对比 一起阅读，以充分发挥 Claude Code 的价值。
紧挨着 effort 旋钮的另一个选择器，是 Claude Code 的权限模式。effort 决定 Claude 思考多深，而权限模式决定它可以自行执行到什么程度——两者搭配设置，日常操作就不再犹豫。
常见问题
Q. 在滑块上选 “Extra” 是最聪明的设置吗？
A. 不是。“Extra” 是 xhigh（倒数第二档），并非最高档。最高的 effort 是它右侧的 “Max”。但 Max 也并非总是最佳——在结构化输出或轻量任务上它可能过度思考。对于当前的 Opus 5.5，官方建议从其默认值 medium 起步。
Q. 我应该用哪个 effort 等级？
A. 拿不准时，保持模型的默认值即可（Opus 5.5 和 Sonnet 5.5 为 medium，Fable 5.1 为 high）。修复现有代码中的 bug 这类需要验证的工作调到 high，耗时长、需要深入思考的工作调到 xhigh（“Extra”）。对于格式化或注重速度的轻量工作，降到 low。
Q. Ultracode 和 Max 有什么区别？
A. Max 是一个 effort 等级（最深入的思考）。Ultracode 不是 effort 档位——它是 Claude Code 的一个开关，会自动启动多代理工作流。由于它与 effort 相互独立，“Max + Ultracode” 和 “Medium + Ultracode” 都可以（v2.1.284 及以后）。它适合庞大的多步骤任务，且仅限支持 xhigh 的模型。
Q. 为什么我选不了 xhigh（“Extra”）或 Ultracode？
A. 两者都需要支持 xhigh 的模型（Fable 5.1、Opus 5.5、Sonnet 5.5 等）。旧款的 Opus 4.6 和 Sonnet 4.6 没有 xhigh（旧款的 Haiku 4.5 完全不支持 effort，而 Haiku 5.5 可以选 xhigh），Ultracode 也不会在它们的 /effort 菜单中出现（xhigh 请求会自动降级为 high）。切换模型即可使用它们。
Q. 如何让我的设置在多个会话间保留？
A. low/medium/high/xhigh 只要在 /effort 滑块中按 Enter 确认（或直接输入，如 /effort high），就会按模型保存到用户设置的 modelSettings 并延续下来。Max 通常仅限当前会话，但若通过 CLAUDE_CODE_EFFORT_LEVEL 环境变量设置则会保留。Ultracode 只要在设置文件中写入 "ultracode": true，每个会话启动时都会开启（effortLevel 和环境变量都不接受它）。
相关文章: Claude Opus 5 发布解析, Claude 自适应思考解析.
