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