Claude Code Ultracode 与 Effort 等级全解：/effort 指南
Effort 决定 Claude 思考多深——也决定你的额度烧多快。本攻略讲透五个 effort 等级、各模型默认值、/effort auto 的真实语义，以及 ultracode：v2.1.284 把它改成了可以叠加在任意等级上的独立开关。
太长不看：effort 与 ultracode 四句话
- 五个等级：low、medium、high、xhigh、max——按模型分别标定。大多数模型默认 high，但 Opus 5.5 和 Sonnet 5.5 默认 medium，Opus 4.7 默认 xhigh。
- 用 /effort（滑杆）或 /effort <等级> 修改；/effort auto 清除已保存的等级、回到该模型默认值。滑杆里 Enter 保存为默认，s 只对当前会话生效。
- Ultracode 是 Claude Code 的设置项而非模型等级：让 Claude 为复杂任务编排动态工作流。v2.1.284 起它是独立开关——/effort 里按 Tab，或 /effort ultracode on|off——不再强制 xhigh。
- Ultracode vs max 一句话：max 是最深的裸推理等级（容易过度思考）；ultracode 在你选定的任意等级之上叠加工作流编排。一个管「深度」，一个管「调度」。
Model configuration & effort — Claude Code documentation
文档:code.claude.com
Claude Code CHANGELOG — v2.1.284 (Ultracode becomes its own toggle)
更新日志:github.com/anthropics/claude-code
How to Use Claude Effort Levels (Full Guide)
频道:Ryan & Matt Data Science13:24
本页事实来自官方 effort 文档与 v2.1.284 更新日志；配图为本攻略原创图示。所列视频在 Claude 的 co-work 应用中实测了同样的五个 effort 等级——真实 token 消耗数据有参考价值，但其界面并非 Claude Code，本页未使用它的任何截图。
Effort 等级与 ultracode 逐步走
1 · 认识这把尺子
- 1
先搞清 effort 到底控制什么
Effort 是 Claude Code 的思考旋钮：设定模型在你的请求上投入多少思考，直接影响回答质量、延迟和额度消耗速度。官方文档说得很直白：这把尺子按模型分别标定——同一个等级名在不同模型上不是同一个值。
/effort 刻度一览：五个等级加 ultracode 开关（本攻略自绘图示）。 - 2
记住五个等级各自什么时候值回 token
low 给你自己把关的快速交互——头脑风暴、初稿、重命名。medium 承担目标明确的日常工作。high 用于需要验证、边界情况多的任务。xhigh 用更高 token 换更深的推理，适合长跑型 agent 任务。max 留给要让 Claude 独自啃硬骨头的场景——文档明说它可能收益递减、想太多。
- 3
先查模型默认值，再怪模型不行
默认值并不统一：支持 effort 的模型默认 high，唯独 Opus 5.5 和 Sonnet 5.5 默认 medium，Opus 4.7 默认 xhigh。如果回答变慢或额度掉得快，先看 effort 再下结论——另外 v2.1.284 起 Sonnet 5.5 成为默认 Sonnet 模型（1M 上下文，$2/$10 每百万 token）。
2 · 按你的意思改
- 4
会话里用 /effort 实时改
会话中输入 /effort 会打开滑杆——方向键在等级间移动，Tab 跳到 ultracode 开关。/model 选择器里左右键调的是同一控件。一次性任务可以用 --effort 参数指定，自动化场景用 CLAUDE_CODE_EFFORT_LEVEL 环境变量。
- 5
直接设等级——并搞懂 auto 的含义
/effort <等级> 不开滑杆直接设定。最有用的是 /effort auto：清除当前模型已保存的等级，回落到该模型的默认值。环境变量同样接受 auto。折腾完实验发现会话行为不对劲时，auto 就是复位键。
- 6
把选择固化下来（用对方法）
/effort 滑杆里，Enter 把等级存为默认，s 只应用到当前会话。settings 里可以用 modelSettings 按模型设置，或用顶层 effortLevel 兜底——有一个坑：max 在这两个键里都不被接受，而且不通过环境变量设置的话，max 只对当前会话生效。技能和子代理可以在 frontmatter 里自带 effort，受 maxEffortLevel 上限约束。
3 · 新开关 ultracode
- 7
理解 ultracode 是什么
Ultracode 是 Claude Code 的设置项，不是模型 effort 等级：按官方文档的说法，它让 Claude 为复杂任务编排动态工作流——把大工程拆成相互协调的步骤，而不是一条道推理到底。这也解释了它为什么曾和 xhigh 绑在一起：深推理之上的编排。
- 8
补上 v2.1.284 的变化
v2.1.284 之前，ultracode 是 /effort 滑杆顶端的档位，开启它会强制 xhigh。2026 年 9 月的更新日志改写了这一点：ultracode 现在是独立开关——/effort 里按 Tab，或 /effort ultracode on|off——不再强制 xhigh，在任何等级上都保持开启。VS Code 扩展用滑杆下方的开/关取代了原来的 ultracode 档位（模型徽章显示「· Ultracode」），新增的 effortSlider 键位动作覆盖 decreaseEffort、increaseEffort 和 toggleUltracode。
- 9
在 ultracode 和 max 之间做选择
它们是两个坐标轴。max 回答「这个问题给我往死里想」——最深的裸推理、不设 token 上限，文档同时警告它容易过度思考。Ultracode 回答「把活调度好」——在你选定的任意等级之上叠加工作流编排，v2.1.284 之后包括 max。经验法则：一个棘手问题 → max；多步骤、讲顺序和分工的工程 → ultracode；两者都要 → max 等级 + ultracode 开。
- 10
依赖它之前先知道边界
文档列出了 ultracode 不可用的三种情况：workflows 被关闭、模型不支持 xhigh、存在低于 xhigh 的等级上限。托管设置 maxEffortLevel 和企业角色上限会按模型收缩可用等级，切换模型可能改变可用等级，超出上限的等级会回落到最高受支持等级——比如 xhigh 在 Opus 4.6 上按 high 跑。若 CLAUDE_CODE_EFFORT_LEVEL 固定为非 xhigh 等级，请求按该等级执行且编排保持关闭。不改任何设置、只想某一轮想深一点，用 ultrathink 关键词即可。
各模型默认值与可用等级
四条事实，省下最多的排查时间：
- 1大多数模型默认 high；medium 是例外不是常态——它只是 Opus 5.5 和 Sonnet 5.5 的默认值。
- 2Opus 4.7 默认 xhigh。Opus 4.6 和 Sonnet 4.6 完全没有 xhigh——超出天花板的等级会回落到最高受支持等级。
- 3文档 effort 表之外的模型不支持 effort；Sonnet 5.5 在 v2.1.284 加入该表并成为默认 Sonnet 模型（1M 上下文，$2/$10 每百万 token，缓存读取 $0.20）。
- 4刻度按模型标定：「同一个等级名在不同模型上不代表同一个底层值」。文档的迁移建议很直白——Opus 5.5 用 medium 不输 Opus 5 的 high。
没有任何保存设置时的解析顺序：显式指定（环境变量、--effort 参数、会话内 /effort）优先，其次是已保存设置（按模型的 modelSettings，或顶层 effortLevel 兜底），最后是模型默认值。