Claude Code 新手指南：Effort与Ultrathink模式用法

30 秒答疑：先把结论拿走

一句话总结：Claude Code 的思考深度，当前由 effort 档位主控。ultrathink 是面向单次提问的临时加深开关。扩展思考（extended thinking，即 Claude 回答前那段隐藏的推理过程）默认开启。你要做的不是纠结「开不开」，而是判断「这个任务值不值得它想得更深」。

按身份对号入座：

最常见的新手错误是：把「想久一点」等同于质量保证，简单任务也硬上最高档。结果只是更慢更贵，质量几乎没差别。下面把机制和判断讲透。

一、先看思考模式解决什么问题

思考模式解决的是「这件事需要 Claude 思考多深」的判断问题，不是替你把需求说清楚。

你用 Claude Code 时多半遇到过两种别扭。一种是它回答太快，跨多个文件的改动它三两下就动手，漏掉了取舍和风险；另一种是它想得太久，明明只是改个文案的小事，它也铺开一大段分析，让你等待。这两种别扭的根源，都在于思考深度和任务难度没对上。

思考模式就是用来对齐这对关系的旋钮。明确的小改动不需要深想；多方案比较需要认真权衡；跨文件架构和风险取舍才需要更高强度。把这条对应关系建立起来，比记住每个档位的英文名重要得多。

要注意它的边界：思考模式提高的是「判断质量的机会」，不替你补清楚需求。需求模糊时，想得再久也只是更认真地猜。先写清目标、材料、限制和验收，再决定要不要加深思考，顺序不能反。新手常犯的一个错是将目标说得含糊，再指望靠加深思考来弥补——这条路走不通，模型只会沿着模糊的方向想得更细，离你真正想要的更远。

二、思考模式的真实机制：effort 档位 + 自适应推理

当前控制思考深浅的主控是 effort（推理力度）档位，配合自适应推理（adaptive reasoning）让模型按需分配。

这是全网旧教程最容易讲错的一节，必须讲清楚。扩展思考是 Claude 回答前生成的那段推理，默认开启，按输出 token 计费。它的深浅完全由 effort 档位决定。

effort 档位随模型不同：能力更强的 Opus 系新模型一般提供 low / medium / high / xhigh / max 五档；其余支持 effort 的模型通常少一档（没有 xhigh）。默认档多数停在 high，部分模型出厂默认更高。你不用记哪个模型是几档——打开 /effort，机器会把当前模型支持的档位和默认值直接列给你看，logo 和加载提示旁边也会标出当前生效的档位（如「with low effort」）。

每一档怎么选，官方给出了对应场景：

还有一个容易混淆的 ultracode：它在 /effort 菜单里，但不是模型档位，而是 Claude Code 的设置——按 xhigh 推理，同时让 Claude 为较重的任务编排动态工作流，只对当前会话生效。换句话说，ultracode = 高推理力度 + 自动拆解任务，比单纯把档位拉到 xhigh 多了一层「先规划再执行」，适合一上来就很重的活。

这里有两个细节值得点出。其一，档位的刻度是按模型校准的，同一个档位名在不同模型上不代表同一个底层值——同样设 high，换一个模型后实际思考力度并不等价。所以换模型后别假设「档位没变就一样」，必要时重新感受一下。其二，如果你设了当前模型不支持的档（比如在少一档的模型上设 xhigh），Claude Code 会自动落到它支持的、不超过你所设值的最高档——不会报错，但也不会真按 xhigh 跑。

自适应推理是这套机制的另一半：它让思考在每一步变成可选，常规提问快速回答、值得深想的步骤才多想，由模型自己判断。较新的模型统一使用自适应推理。换句话说，你设的 effort 档是「上限和倾向」，模型在档内自己决定每一步要不要动用深度思考——你不用再像旧时代那样手动猜测一个固定的 token 预算。

三、ultrathink 关键词：现在到底还有没有用

ultrathink 关键词仍然有效，但它只给当前这一轮加深推理，不改会话的 effort 档位。而 think、think hard、think more 这些短语，现在已经不再是触发关键词了。

这一节专门破除旧教程的误解。过去流传一套说法：think 是标准档、think hard 是中档、think harder 接近 ultrathink、ultrathink 给到约三万思考 token，像四级油门一样逐级加深。这套说法已经不成立。官方现在的机制是：

• 在提示词里任意位置写上 ultrathink，Claude Code 识别这个关键词，给这一次回答加一条「请更深推理」的上下文指令；但发给接口的 effort 档位本身不变，只影响当前这一轮。
• think、think hard、think more 等其他短语，现在只当普通提示词文本处理，不被当成关键词——你写「think harder about this」，它只是字面意思，不会触发额外推理力度。

那 ultrathink 和 effort 档位是什么关系？可以这样理解：effort 档位是你给整段会话定的基准油门，ultrathink 是某道难题时临时踩一脚的瞬时加深。两者并存、各管一段。

具体怎么写？ultrathink 放提示词哪个位置都行，被识别即可，比如：

ultrathink 一下：这个鉴权模块要从 session 迁到 JWT，帮我先列出涉及哪些文件、迁移顺序、以及回滚点，先别改代码。

你不用记复杂语法，把 ultrathink 当成一句普通中文里的提示词混进去即可。下一节讲怎么用 /effort 把基准油门定好。

四、怎么开始用：先按任务难度选档

第一次动手，别碰复杂配置，先学会两个动作——临时难题加 ultrathink，整段会话定档用 /effort。

建议按这个顺序操作：

1. 先写清任务目标和验收标准（这一步比调档更重要）。
2. 判断这件事是简单执行，还是涉及多方案、有风险取舍。
3. 简单任务直接让 Claude Code 执行，用默认档位。
4. 临时遇到一道难题，在提示词里加 ultrathink，只加深这一轮。
5. 整段会话都在做难活，跑 /effort high（或更高）定调；都在做简单活，跑 /effort low 省 token。
6. 执行后看结果是否真的比默认更稳，不稳就回头补需求，而不是继续加档。

/effort 的几种设置方式，挑顺手的用：

• 命令 /effort：不带参数打开滑块，带档位名直接设（如 /effort high），/effort auto 回到模型默认。
• 在 /model 里：选模型时用左右方向键调 effort 滑块。
• 启动参数 --effort：启动 Claude Code 时给单次会话设。
• 环境变量 CLAUDE_CODE_EFFORT_LEVEL：设档位名或 auto，优先级最高。
• 设置文件 effortLevel 字段：设 low/medium/high/xhigh（max 和 ultracode 只能临时设、不写进设置文件）。

这个顺序看着慢，但能避开新手最常见的「什么都 ultrathink」的误区。思考强度应该跟任务风险匹配，而不是跟焦虑程度匹配。

五、扩展思考的开关与显示：你能控制什么

扩展思考默认开着，你能控制三件事——临时开关、全局默认、以及是否查看推理过程。

新手容易把「调档」和「开关思考」混为一谈，其实是两层。effort 档位调的是深浅，下面这几个开关管的是开关和显示：

这里要指出一个容易误用的变量：MAX_THINKING_TOKENS。它是早一代的固定思考预算开关。在走自适应推理的较新模型上，思考改为模型按需分配，固定预算模式不生效，设具体数值没有意义。它现在只剩两个有效用法：一是 MAX_THINKING_TOKENS=0 强制关闭扩展思考；二是在仍支持固定预算的旧模型上，先设 CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1 回到固定预算模式，这时具体数值（比如 8000）才会按设定生效。哪些模型走自适应推理、哪些还能切回固定预算，以官方当前文档为准。

要不要把推理过程显示出来？新手值得开一次 Ctrl+O 看看 Claude 是怎么思考的，对建立信任有帮助；看明白了再收起来，省得刷屏。注意：所有思考 token 都要计费，即使你折叠不看。

六、常见配置和关键词的对照表

这一节把前面分散讲的机制收成一张对照表，方便你扫一眼就知道某个东西归哪类、管什么。

记住一条主线就不会乱：深浅看 effort 档位，单次加深看 ultrathink，开关看 /config 和快捷键。其他都是这三类的不同设置方法。

七、什么场景该用高档思考，什么时候别用

难、错了代价高、有多方案取舍的活值得调高；明确机械的活用默认或低档。

下面两组场景按官方对档位的定位 + 实际编程经验整理，照着对号即可。

值得调高（xhigh 或临时 ultrathink）的五类活：

不值得调高（默认或 low）的五类活：

给新手一个朴素判断标准：这件事你自己想五分钟也能干，就用默认或低档；想三十分钟才有方向，才值得上 xhigh 或 ultrathink。把这条记住，你就不用纠结具体档位名，按「我自己要想多久」来选，八成不会错。

判断原则就一句：思考强度跟任务风险匹配，不跟焦虑匹配。简单任务硬上最高档，质量几乎没差，只是更慢更贵。

八、思考模式怎么帮你省 token

思考 token 按输出 token 计费、默认预算可能上万，所以它是成本大头。省钱的核心就是「常规活降档、关键活才放开」。

很多新手只关心「想得深不深」，却忽略了它直接影响账单。官方给出的省钱办法有三条，按好上手程度排列：

1. 用 /effort 或 /model 降档：让简单任务别深想，这是最直接的一条。整段会话都是常规活，跑 /effort low 或 /effort medium。
2. 在 /config 里关掉思考：纯机械批量任务，不需要推理时整体关掉。
3. 用较小的 MAX_THINKING_TOKENS 值压预算：比如 MAX_THINKING_TOKENS=8000，但记住这只在固定预算模式（旧模型或显式关掉自适应推理）下生效。

团队场景可以更进一步：统一一个较低的默认档来控住整体成本，只在难任务专属的环境或会话里放开高档。落到具体做法，团队可以在设置文件里把 effortLevel 定为 medium 作为统一基线，约定「日常改动用基线、架构和迁移类任务才临时升 xhigh 或加 ultrathink」。管理员还能限制可选模型、统一默认，避免有人一直挂着最贵的组合。想知道思考到底吃掉多少成本，可以在会话里跑 /usage 看本次的 token 用量和成本估算，心里有数后再决定是否降档。这样既不会让简单活拖慢拖贵，也不会在关键活上省过头。省 token 的本质是分配，不是节流。

九、翔宇会怎么定这套档位

说明一下，这是个人路由，不是让你照抄——你的项目类型和我的不一定一样。但这套节奏对大多数新手适用。

翔宇自己面对一个新项目，思考档不会一开始就拧到底，大致按三步走：

• 默认就停在 high（多数模型的出厂默认），日常编码、问代码、小改动都用它，不另设。
• 遇到真正的难题，单次加 ultrathink，比如要重构一个模块、追一个跨文件的 bug，只给那一轮加深，不动会话设置。
• 整段会话都是难活时，才跑 /effort xhigh 定调，比如一整个下午都在做架构迁移；做完切回默认，不让高档一直挂着。

判断「该用单次 ultrathink 还是整段 /effort xhigh」有个简单依据：难题是孤立一道，还是会接连出现一串。修一个跨文件 bug，难的就是定位那一下，定完后面都是机械改动，用单次 ultrathink 即可；而做一次架构迁移，从拆依赖、排顺序到逐个文件改，每一步都要权衡，这种「连续难」才值得用 /effort 把整段会话定到 xhigh，省得每条提示词都补关键词。

一条实战经验：max 和 ultracode 这种最高档，一年也用不了几次，多数所谓「难题」用 high 加一次 ultrathink 就够了。还有一个反直觉的体感——档位调太高，有时反而更难用，因为模型会在一个本来不复杂的点上反复权衡、给出一堆你不需要的备选，读起来更累。这正是官方所说 max 容易「过度思考」的实际表现。更要警惕一种心态——为了「看起来认真」给每个任务都加深思考，短期觉得稳，长期就是更慢更贵。能让你少犯一个真实错误的档位，才值得调高。

这套节奏跑顺以后，你对「该深还是该浅」会有体感，不用每次都查表。在那之前，先按「默认 + 单次 ultrathink + 难活整段 xhigh」三档走，足够覆盖绝大多数场景。

十、五个常见坑

思考模式用错，多半不是机制太难，而是判断没对上。把这五个坑记住，能避开大多数误用。

这五个坑里，前两个是认知没更新（还停在旧教程），后三个是把工具当魔法。两类都靠一句话破解：思考模式让该慢的地方慢下来，不让你跳过自己的判断和验收。

十一、进阶路径：跑两周后再看什么

新手前两周只要把「默认 + ultrathink + /effort」三件事用顺，再往后才看团队统一、成本统计和跨工具对比。

可以按三个阶段给自己定节奏：

• 第一周：能为一个真实任务选对档——简单活默认、难活加 ultrathink。先把这个反射建立起来。
• 第二周：开始用 /effort 给整段会话定调，并观察账单变化，感受不同档的成本差异。
• 一个月后：如果你在团队里，把思考档写进协作约定（如普通文案默认档、架构迁移必须 xhigh），用 /usage 查看思考占用的成本占比。

到这一步，思考模式就从「一个旋钮」变成了「一套和成本、质量挂钩的工作习惯」。

再往深走，可以了解交错思考（interleaved thinking）这个能力。它指 Claude 不只在回答前思考，在一次次工具调用之间也能停下来想一想——读完一个文件、跑完一条命令后，先想想下一步再动手，而不是机械地按计划走完。这对多步骤任务很关键：跨文件调试、按计划逐步迁移这类活，中途往往要根据上一步的结果调整方向，交错思考让模型能边做边纠偏。对新手来说，你不需要专门配置它，知道「高档思考 + 多步任务时，模型会在工具调用之间也动脑」就够了——这解释了为什么难任务用高档时，它的每一步看起来更有章法。真正要细抠这些能力的开关，等你把前面三件事用顺再说。

十二、自检清单

动手前后，拿这张清单过一遍，能避开大多数误用：

• [ ] 这件事是简单执行，还是涉及多方案 / 风险取舍？
• [ ] 简单活我用了默认或低档，没硬上最高档？
• [ ] 临时难题我用的是 ultrathink，而不是已失效的 think hard？
• [ ] 整段难活我用 /effort 定了调，而不是每条提示词都加关键词？
• [ ] 我先把需求写清了，而不是用「想久一点」掩盖目标模糊？
• [ ] 高档思考出结果后，我跑了测试、看了 diff 做验证？
• [ ] 成本敏感时，常规活我降档省 token 了吗？

十三、常见问题（FAQ）

我设了 xhigh，可机器好像没按 xhigh 跑，为什么？

多半是当前模型不支持这一档。遇到不支持的档，Claude Code 不会报错，而是自动落到它支持的、不超过你所设值的最高档。想确认实际生效的档，看 logo 和加载提示旁边的标注（如「with low effort」），或重开一次 /effort。

/effort auto 和直接设一个档有什么不一样？

/effort auto 是把档位重置回当前模型的出厂默认，等于「不手动指定，交给模型默认」；直接设档位名（如 /effort low）则是你显式压一个值。换模型后想回到那个模型该有的默认体验，用 auto 最省事。

能不能给某个 Skill 或子智能体单独设一个思考档？

可以。在 Skill 或子智能体（subagent）的 markdown frontmatter 里写 effort 字段，它运行时就按这个档跑，覆盖会话级设置——但仍盖不过环境变量 CLAUDE_CODE_EFFORT_LEVEL。适合让某个固定干重活的子智能体常驻高档，而主会话保持低档省钱。

几种设 effort 的方式同时存在时，谁说了算？

优先级从高到低：环境变量 CLAUDE_CODE_EFFORT_LEVEL ＞ 你配置的档（设置文件 / /effort / --effort）＞ 模型默认。Skill 或子智能体 frontmatter 的 effort 在它们运行期间覆盖会话档，但同样盖不过环境变量。记不住就一句：环境变量最大。

折叠不看推理过程，是不是就不花思考的钱了？

不是。所有思考 token 都计费，哪怕你用 Ctrl+O 把它折叠起来不看、或接口把它做了删节。省钱要靠降 effort 档或关思考，靠「不看」省不了。

下一步学什么

你现在只要带走三句话：

1. 深浅看 effort 档位。/effort 定调，默认 high 多数够用，难活才上 xhigh。
2. 单次加深认 ultrathink 一个词。其他 think hard 之类已失效，别再堆。
3. 思考模式不替你验收。想得深只提高判断质量的机会，测试、diff、边界仍要自己看。

如果要继续学，建议先把 Claude Code 的整体能力地图补上，再回头看思考模式怎么和别的功能配合：

同系列下一步：

• Claude Code 是什么？新手完整指南
• Claude Code 完整能力总览
• Claude Code 桌面端、命令行与 IDE 怎么选
• Claude Code 子智能体与多 Agent 协作指南
• Claude Code 100 万 token 上下文窗口指南

机制和参数的细节，以官方文档为准：

• 模型与 effort 配置：https://code.claude.com/docs/en/model-config
• 成本与扩展思考设置：https://code.claude.com/docs/en/costs

最后提醒一句：思考模式的价值不在于让回答显得复杂，而在于让该慢的地方慢下来、该快的地方保持快。先判断任务难度，再选档，比记住每个档位名重要得多。

来源：互联网