Claude 自适应思考与 effort 参数逐型号指南

Opus 5.5、Fable 5.1 与 Fable 5 不能关。官方写明这些型号拒收 thinking type disabled，原句是「Thinking can't be turned off on these models」。Sonnet 5.5 也拒收 disabled，但可以用 between_tools 关掉预先思考；Opus 5 与 Haiku 5.5 只在 effort 为 high 及以下接受 disabled；Sonnet 5 可以直接关。请求前可读 Models API 的 capabilities.thinking.types.disabled 确认。

五档：low、medium、high、xhigh、max。官方写明多数型号默认 high，Opus 5.5 与 Haiku 5.5 默认 medium，Sonnet 5.5 在 Claude API 上默认 high。官方对各档的描述：max 是不限 token 花费的最大能力，xhigh 面向长时程工作，high 按任务需要花足 token，medium 是适度节省的平衡档，low 最省、能力有所下降。

官方没有给出倍数。官方说法是 effort 是行为信号、不是严格的 token 预算，作用于所有输出 token（正文、工具调用和思考），low 能显著节省 token、能力有所下降。思考 token 按输出 token 计费，即使思考文本没有返回也照样计费；实际花在推理上的量看响应里的 usage.output_tokens_details.thinking_tokens。要硬性封顶只能靠 max_tokens。

在 Claude 4.7 及之后的型号上不能，发 type enabled 加 budget_tokens 返回 400；Claude 4.6 型号上仍能成功但已弃用；Sonnet 4.5、Opus 4.5、Haiku 4.5 等只支持手动扩展思考的型号继续用 budget_tokens，其中 Opus 4.5 是唯一同时支持 effort 的，两者叠加生效。迁移方法：删掉 budget_tokens、改为 adaptive、用 effort 控制深浅。

按官方配置表，5.5 代三款里只有 Haiku 5.5 接受 thinking disabled：在 high 及以下 effort 可以关掉思考，到 xhigh 或 max 返回 400。它和 Opus 5.5 一样默认 effort 为 medium、默认开思考；思考文本默认不返回，而 Haiku 4.5 默认返回摘要。官方仍建议优先用 effort 而不是关思考来权衡质量、速度和成本。

用 /effort（不带参数打开滑块，带档位名直接设定，/effort auto 清除当前型号的保存值）、启动参数 --effort、环境变量 CLAUDE_CODE_EFFORT_LEVEL，或在 /model 里用左右键调。Claude Code 里 Opus 5.5、Sonnet 5.5、Haiku 5.5 默认 medium；设置文件不接受 max，除非用环境变量设置，max 只作用于当前会话。官方写明在 Claude Code 里 Opus 5.5、Sonnet 5.5、Haiku 5.5 与 Fable 系列关不掉思考，MAX_THINKING_TOKENS=0 对它们无效；提示里写 ultrathink 只加一条上下文指令，发给 API 的 effort 不变。