Claude Code ultrathink 怎么用？2.1.311 改成 xhigh，思考等级和 effort 设置一次说清
ultrathink 今年 1 月被社区说“没用了”，3 月在 2.1.68 重新加回，2.1.311 起在终端里能把这一轮提到 xhigh。各模型思考等级和默认值、xhigh 和 max 的区别、怎么设置、额度消耗，全部对照官方 changelog 和文档核对。
buffer关于作者约 9 分钟阅读
Claude Code ultrathink 怎么用？现在很简单：在终端里输入的提示词中带上 ultrathink 这个词，这一轮就会用 xhigh 思考等级来跑。这是 10 月 27 日凌晨 3:47（北京时间）发布的 Claude Code 2.1.311 改的，适用于 Opus 5.5、Sonnet 5.5、Haiku 5.5 和 Fable 5.1。英文社区里还有人说“ultrathink 已经没用了”，那是今年 1 月的情况，3 月就改回来了。下面的内容我在 10 月 27 日对照官方 changelog 和 Claude Code 文档核对过，只来自 Reddit 或第三方网站的说法，我会单独标成“社区说法”。
先说结论：ultrathink 现在是什么效果
Claude Code ultrathink 怎么用、现在有什么效果，我整理成四条。
ultrathink现在是有用的。它让这一轮多想一些，但不会改你整个会话的思考等级。- 在 2.1.311 及以后的交互式终端里，它还能把这一轮提到
xhigh。生效的时候，这个词会显示成彩虹色。 - 默认思考等级不是
max。Opus 5.5、Sonnet 5.5、Haiku 5.5 默认是medium，大部分其他模型默认是high，Opus 4.7 默认是xhigh。 max比xhigh再高一档。除非用环境变量设置，否则它只对当前会话有效。
只记一句的话，就是 ultrathink 现在给你的是一轮 xhigh，不是 max。
Claude Code ultrathink 怎么用：先看 2.1.311 的原文
这两句来自Claude Code 官方 changelog 的 2.1.311 条目，我原样贴出来，后面附上我的翻译。
- “Changed
ultrathinkin the interactive terminal to run its turn at xhigh effort on Opus 5.5, Sonnet 5.5, Haiku 5.5 and Fable 5.1 through Anthropic’s API; typed while Claude is working, it raises the rest of that turn” - “Changed the
ultrathinkrainbow to appear only where the keyword can raise effort, and not when the word is quoted or part of a file path”
第一句的意思是，在交互式终端里，ultrathink 会让这一轮在上面四个模型上以 xhigh 运行，前提是走 Anthropic 的 API。如果 Claude 正在干活的时候你输入这个词，这一轮剩下的部分也会提到 xhigh。
第二句的意思是，只有这个词真的能提高思考等级时才会显示彩虹色。放在引号里或者文件路径里，就不会变色。
还有一点要注意。2.1.311 在 npm 上的 latest 已经是它了，但我查的时候 stable 还停在 2.1.308。如果你把 autoUpdatesChannel 设成了 "stable"，大概率还没有这个改动，可以先跑 claude --version 看一下版本。
为什么有人说 ultrathink 已经废了
两边说的都不算错，因为 ultrathink 前后改过好几次。下面是按 changelog 整理的时间线，时间都换成了北京时间。
| 日期（北京时间） | 版本 | 发生了什么 | 来源 |
|---|---|---|---|
| 2025 年 3 月 15 日 | 0.2.44 | 思考模式可以说 think、think harder，甚至 ultrathink | 官方 changelog |
| 2025 年 12 月 12 日 | 2.0.67 | Opus 4.5 默认开启思考模式 | 官方 changelog |
| 2026 年 1 月 15 日 | 2.1.8 | 应用内提示“Ultrathink no longer does anything. Thinking budget is now max by default.” | 社区说法 |
| 2026 年 3 月 4 日 | 2.1.68 | “Re-introduced the “ultrathink” keyword to enable high effort for the next turn” | 官方 changelog |
| 2026 年 4 月 16 日 | 2.1.111 | 新增 xhigh 等级，位于 high 和 max 之间 | 官方 changelog |
| 2026 年 10 月 27 日 | 2.1.311 | ultrathink 这一轮改用 xhigh | 官方 changelog |
1 月那一行我要说清楚。官方 changelog 里根本没有 2.1.8 的条目。那句提示来自一个从 Claude Code 安装包里提取字符串的非官方网站，还有 Reddit 上“RIP to ultrathink”之类的帖子，我在 Anthropic 自己的页面上找不到原文。不过官方 changelog 在 2.1.68 写的是“Re-introduced”，也就是“重新加回来”。能重新加回来，说明之前确实被拿掉过，所以社区的说法和官方记录是对得上的。
所以看到“ultrathink 已经没用”的帖子，基本是在说 1 月的情况。现在的行为以 2.1.311 为准。
Claude Code 思考等级有哪些，默认是不是 max
思考等级（effort）决定 Claude 每一步做多少工作，包括想多少、读多少文件、检查多少遍。Claude Code 模型配置文档按模型列出了可用的等级。
| 模型 | 可用等级 | 默认等级 |
|---|---|---|
| Opus 5.5、Sonnet 5.5、Haiku 5.5 | low、medium、high、xhigh、max | medium |
| Fable 5.1、Fable 5、Opus 5、Sonnet 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 | high |
如果你选了模型不支持的等级，Claude Code 会自动降到下面最近的一档。文档里的例子是，xhigh 在 Opus 4.6 上会按 high 来跑。
所以默认不是 max。“默认就是 max”是 1 月那条提示里的说法。现在文档对 Opus 5.5 的描述是，在 Anthropic 的测试中，Opus 5.5 用 medium 在编程和知识类评测上能达到或超过 Opus 5 用 high 的水平。
xhigh 和 max 有什么区别，ultracode 又是什么
xhigh 就是 ultrathink 现在给你的那一档，max 比它高一档。文档对两者的描述不一样。
xhigh：思考更深，token 花得也更多。Opus 4.7 的默认等级就是它。max：适合让 Claude 自己长时间处理的难题，比如找安全漏洞。文档还提醒，max可能收益递减，也容易想太多，建议先测试再大范围使用。
max 的保存方式也不一样。文档写的是，除非通过 CLAUDE_CODE_EFFORT_LEVEL 设置，否则 max 只对当前会话有效。effortLevel 设置项也不接受 max。2.1.295 还修过一个问题，就是 /model 会错误地提示 Max 已经保存成默认值。
很多人会把 xhigh 和 ultracode 搞混。ultracode 不是思考等级，它是一个单独的设置，打开以后 Claude 会对较大的任务编排动态工作流。在 /effort 里开关 ultracode 不会改变思考等级。只有用 --effort ultracode 启动时，才会同时打开 ultracode 并把等级设成 xhigh。
我自己的用法是，任务难但我还在旁边看着，就用 xhigh。只有要让 Claude 自己跑很久的时候，我才开 max，跑完就关掉。
Claude Code effort level 怎么设置
文档里列出的方法有下面这些，选一个用就行。
- 输入
/effort会打开一个滑块。/effort high直接设置，/effort auto清掉保存的等级，/effort status查看当前生效的等级。 - 在
/model选择模型时，用左右方向键调整思考等级。 - 在滑块里按
Enter会保存为默认值，按s只对这次会话生效（需要 v2.1.257 及以上）。 - 启动时加
claude --effort xhigh，只对这一次会话生效。 - 设置环境变量
CLAUDE_CODE_EFFORT_LEVEL，可选low、medium、high、xhigh、max或auto。 - 在
settings.json里，用modelSettings给单个模型设等级，或者用effortLevel给没有单独设置的模型设默认值。 - skill 和 subagent 可以在 frontmatter 里写
effort。
下面是设置文档里的例子，作用是让 Opus 5.5 固定用 high。
{
"modelSettings": {
"claude-opus-5-5": {
"effortLevel": "high"
}
}
}生效顺序也要知道。环境变量、--effort 和 /effort 优先，其次是 settings 里的设置，最后才是模型默认值。环境变量又比 --effort 和 /effort 优先。如果设置了 maxEffortLevel 上限，不管用哪种方式，都不会超过这个上限。还有一个坑，Opus 5.5 不认用户设置里顶层的 effortLevel，要给它保存等级，请用 /effort 或 /model。
ultrathink 没变彩虹色怎么办
Claude Code ultrathink 怎么用都没反应时，先看这个词有没有变色。没变色，说明这一轮没有提到 xhigh。文档给的排查方法有这几条。
- 不要放在引号、括号、文件路径或命令里，提示词也不要以
/开头。 - 如果
CLAUDE_CODE_EFFORT_LEVEL设得比xhigh低，先取消它，或者把maxEffortLevel调到xhigh以上。 - 用
/model切到 Opus 5.5、Sonnet 5.5、Haiku 5.5 或 Fable 5.1。 - 在 Amazon Bedrock 上这个词不能提高等级，直接设置思考等级就行。
“think hard”“think more”这类说法不是关键词。文档写明 Claude Code 会把它们当成普通文字发给模型。
思考等级越高，用量消耗越多吗
会更多，但 Anthropic 没有公布每一档具体是几倍。官方文档里能确认的是这几点。
- 思考 token 按输出 token 计费，根据模型不同，默认预算可能是每次请求几万个 token。
- 思考内容就算被折叠或隐藏，生成的思考 token 也照样计费。
- Opus 5.5、Sonnet 5.5、Haiku 5.5 和 Fable 不能关闭思考，想省用量只能降低思考等级。
如果你用的是 Pro 或 Max 订阅，不会按 token 看到账单，但等级越高，额度用得越快。从 2.1.299 开始，/usage 会对 max 等级给出提醒。文档里的示例建议是“Switch from max to high effort · /effort high”，也就是从 max 降到 high。经常撞到额度上限的话，我会先试这一步。两个套餐各有多少额度，可以看我写的 Claude Pro 和 Max 怎么选。
什么任务用什么等级
文档里的建议我整理成了下面这张图。至于 Claude Code ultrathink 怎么用最划算，我自己的习惯是保持默认等级，遇到某一轮特别难，就在那一轮里加 ultrathink，不去改整个会话。
| 任务 | 等级 |
|---|---|
| 改个变量名、问个小问题 | low |
| Opus 5.5 上的日常开发 | medium（默认） |
| 在现有代码里修 bug | high |
| 需要你自己审核的复杂重构或设计 | xhigh，或者那一轮加 ultrathink |
| 让 Claude 长时间独立跑，比如安全审计 | max，只开这一个会话 |
常见问题
Claude Code ultrathink 怎么用才会生效？
在终端里正常输入一句话，比如“ultrathink 帮我看看这个死锁”，看到这个词变成彩虹色就说明生效了。前提是 2.1.311 及以上，模型是 Opus 5.5、Sonnet 5.5、Haiku 5.5 或 Fable 5.1，并且走 Anthropic 的 API。
claude -p 或 VS Code 插件里能用吗？
2.1.311 这条改动写的是交互式终端。在其他地方，这个词还是会加一段让模型多想的指令，但不要指望它会提到 xhigh。
Codex 的推理等级是一回事吗？
思路类似，但名字和默认值都不一样。两个工具的区别我写在 Claude Code 和 Codex 该买哪个里。想让终端更好用，可以看看我整理的 Claude Code 插件推荐。