Skip to content

Claude Code 思考强度调节 ​

Claude Code 2.1 之后,思考深度不再靠往提示词里塞「think / think harder」来控制,而是有了正式的 effort 档位。本页讲清四件事:档位怎么调、优先级谁盖谁、思考总开关在哪、以及用 max 分组时要注意什么。

先确认版本

shell
claude --version

低于 2.1.0 的版本没有 /effort 命令,先升级:

shell
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com/

档位一览 ​

档位大致定位
low快速、直给的实现,几乎不展开推理
medium均衡档,日常改代码够用
high推荐常用档,会认真分析再动手
xhigh深度推理,适合排障、架构设计、疑难 Bug
ultracodexhigh + 动态多智能体编排,仅当前会话有效
auto回到当前模型的默认档

越高档位思考越充分,但更慢、更贵——思考本身按输出 Token 计费,xhigh 的一轮消耗可能是 medium 的数倍。别全程挂着最高档。

会话内即时调(最常用) ​

shell
/effort              # 查看当前档位
/effort high
/effort xhigh
/effort ultracode    # xhigh + 动态编排,只作用于本次会话
/effort auto         # 回到模型默认

尽量开局就定好

Claude Code 会提示「Changing thinking mode mid-conversation will increase latency and may reduce quality」。中途改档会让整段上下文缓存失效、重新计费读一遍历史,长会话里代价很明显。 需要高强度时在会话一开始就 /effort xhigh,而不是聊到一半再切。

启动时指定 ​

shell
claude --effort high

或用环境变量(优先级最高,会盖掉会话内的 /effort):

shell
# mac / Linux
CLAUDE_CODE_EFFORT_LEVEL=xhigh claude

# Windows PowerShell
$env:CLAUDE_CODE_EFFORT_LEVEL="xhigh"; claude

写进配置文件(持久默认值) ​

编辑 ~/.claude/settings.json,和已有的 env 段合并:

json
{
  "effortLevel": "high",
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的key",
    "ANTHROPIC_BASE_URL": "https://api.wow3.top"
  }
}

这样每个新会话默认就是 high,遇到难题再临时 /effort xhigh。

优先级顺序 ​

从高到低,前者盖后者:

  1. CLAUDE_CODE_EFFORT_LEVEL 环境变量
  2. 本次会话里执行的 /effort
  3. 启动参数 --effort
  4. settings.json 里的 effortLevel
  5. 模型自身的默认档

如果发现 /effort 设了没反应,先查是不是环境变量还挂着——这是最常见的原因:

shell
# mac / Linux
echo $CLAUDE_CODE_EFFORT_LEVEL

思考总开关与预算上限 ​

除了档位,还有两个更底层的旋钮。

开关:Thinking mode ​

shell
/config

在列表里找到 Thinking mode,可以整体开/关扩展思考。对应配置项是 alwaysThinkingEnabled:

json
{ "alwaysThinkingEnabled": false }

关掉之后再设档位会报错:

Effort 'high' isn't available with thinking turned off on this model

想恢复就把这项删掉,或在 /config 里重新打开。

预算:MAX_THINKING_TOKENS ​

直接限制单轮思考能烧多少 Token,比档位更硬:

json
{
  "env": {
    "MAX_THINKING_TOKENS": "8000"
  }
}

设成 0 等于关思考。省钱场景下这一项比降档更立竿见影——档位只是倾向,预算是硬上限。

单轮加强:ultrathink ​

不想改全局配置,只想让这一个问题想得更深,在提示词里带上 ultrathink 这个词:

ultrathink 这段流式响应偶发截断,帮我定位根因

只影响当轮,下一条消息自动回到原档位。适合「大部分时候 medium,偶尔来个难题」的用法。

用本站 max 分组时的注意事项 ​

结论先说

本站会把客户端设置的思考参数原样透传给上游,不做降级改写。你在 Claude Code 里设 xhigh, 上游收到的就是 xhigh。

几个实际会遇到的情况:

1. 设了 xhigh 但感觉思考很短

先在操练场用同一个分组、同一个模型跑一条复杂提问,对比 思考长度:

  • 操练场思考正常 → 问题在本地配置,回头查上面的优先级顺序,大概率是 MAX_THINKING_TOKENS 设小了或环境变量盖住了;
  • 操练场也短 → 换个渠道再试,可以在站点右侧的渠道监控里看当前可用渠道,或直接提交工单, 带上使用日志里那条请求的 request id。

2. 新旧模型的思考参数格式不同

新一代模型(claude-opus-5、claude-sonnet-5、claude-fable-5 等)用 effort 档位表达思考强度; 老一代模型(claude-opus-4-6 及更早)用的是思考 Token 预算。本站两种格式都做了适配并自动换算, 你只管在客户端设档位就行,不需要按模型改配置。

但也意味着:用老模型时真正生效的是预算值,low 和 medium 的差异可能没有新模型上那么明显。 这时候直接调 MAX_THINKING_TOKENS 更直观。

3. 高档位更容易触发限流

xhigh / ultracode 单轮输出 Token 多、耗时长,在渠道压力大的时段更容易撞上 429 或超时。 遇到连续失败先降到 high 再试,别一路往上加。

推荐配置 ​

日常写代码,~/.claude/settings.json 这样配就够了:

json
{
  "effortLevel": "high",
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的key",
    "ANTHROPIC_BASE_URL": "https://api.wow3.top",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}
  • 平时 high,够用且不浪费;
  • 排查疑难问题时开局就 /effort xhigh,不要中途切;
  • 只想让某一轮想深点,用 ultrathink 关键词;
  • 预算紧就压 MAX_THINKING_TOKENS,效果比降档更直接。

更多省 Token 技巧见进阶配置与省 Token,Claude Code 的安装与接入见 Claude Code 客户端配置。