主题
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 |
ultracode | xhigh + 动态多智能体编排,仅当前会话有效 |
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。
优先级顺序
从高到低,前者盖后者:
CLAUDE_CODE_EFFORT_LEVEL环境变量- 本次会话里执行的
/effort - 启动参数
--effort settings.json里的effortLevel- 模型自身的默认档
如果发现 /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 客户端配置。

