is not supported when thinking is disabled
xhigh / max 配关闭 thinking 会 400;2.1.251 起客户端改送 high
Claude Code 2.1.251(2026-08-28)修复了 Opus 5 在 effort 为 xhigh/max 且 thinking 关闭时失败的请求,原文是 effort … is not supported when thinking is disabled。客户端在这种组合里改为发送 effort high。API 文档仍写:Opus 5 在 high 及以下可以关 thinking;xhigh 或 max 再关 thinking 会 400。
四个可单独引用的点
错误原文子串
完整句常见为 output_config.effort 'xhigh' is not supported when thinking is disabled on this model. 搜索时用这半句就能对上 changelog 与 issue。
不能和 thinking disabled 叠在一起的档
platform.claude.com 的 thinking 文档:Opus 5 在 effort high 及以下允许 thinking: {type: "disabled"}。xhigh 或 max 再关 thinking 返回 400。
Claude Code 修复版本
2026-08-28 changelog:Fixed Opus 5 requests failing with that literal when effort was xhigh/max and thinking was turned off; effort is now sent as high in that case.
不是额度 429
这是参数组合被拒绝,不是 weekly limit,也不是 Credit balance is too low。重试同一组参数会一直 400。
effort 和 thinking 是两套旋钮
Anthropic 帮助中心写:effort 管每一步有多彻底;thinking 管要不要在可展开区域里先推理。两者可组合,但不是任意组合。Opus 5 默认可思考,API 上 high 及以下允许关掉;再往上关就会被接口拒绝。Fable 5 / Mythos 一类则根本不允许 thinking disabled。
为什么客户端会自己发出这组非法参数
GitHub issue 从 Opus 4.8 起就有:settings 里 alwaysThinkingEnabled: true 且 effortLevel: xhigh,请求仍偶发省略 thinking,同时带上 xhigh,于是 400。2.1.251 的修复是客户端侧降档:这种情况下改送 high,而不是教你改 HTTP 头去骗过校验。校验本身还在 API 上。
时间线
anthropics/claude-code#76689 等记录 400 原文 output_config.effort 'xhigh' is not supported when thinking is disabled on this model.
thinking 文档:Opus 5 在 high 及以下可关 thinking;xhigh/max 再关则 400。Fable 5 / Mythos 5 拒绝 thinking disabled。
Claude Code changelog 把上述失败定为 bug 并修复:该组合改为发送 effort high。同版本还加了 PreModelSwitch。升级客户端不等于 API 开始接受 xhigh+disabled。
已确认 vs 误解
已确认
原文子串、400、xhigh/max 与 thinking disabled 互斥、2.1.251 客户端改送 high、Opus 5 在 high 及以下可关 thinking——分别来自 changelog 与 platform 文档(2026-08-30 核对)。
常见误解
「这是额度用完」——状态是 400,文案谈 effort/thinking。「升级 2.1.251 就能在关 thinking 时用 max」——修复是降到 high,不是放开互斥。「改请求头就能过」——本页只陈述官方组合规则,不描述绕过参数校验的做法。
关 thinking 还是保 effort
必须关 thinking:把 effort 降到 high 及以下
文档允许的组合是 thinking disabled + high/medium/low。2.1.251 的 Claude Code 在你选了 xhigh/max 却关掉 thinking 时,会自己改送 high。API 直连则要自己改 output_config.effort。
必须保 xhigh / max:打开 thinking
xhigh/max 需要 thinking 开着(Opus 5 及更新、带这条限制的型号)。Fable 5 一类本来就不能关 thinking,这条 400 在那些型号上按文档不该出现。
处理步骤(官方组合,不换平台)
先看原文是否含 is not supported when thinking is disabled。再看 effort 是不是 xhigh/max、thinking 是否 disabled。二选一:降 effort,或打开 thinking。Claude Code 请升到 2.1.251 或更新,让客户端不要再发非法组合。本页不描述伪造 thinking 字段或绕过模型能力校验的做法。
这条 400 跟 QCode 余额无关
is not supported when thinking is disabled 是上游对参数组合的拒绝。QCode 按官方价 × 服务费率转发在售模型,不会把非法 effort/thinking 组合变成合法。Opus 5 在用量表里有真实调用;要修的是请求体,不是换一张没有这条校验的「隐藏开关」。
常见问题
完整错误原文长什么样?
常见是 API Error: 400 output_config.effort 'xhigh' is not supported when thinking is disabled on this model. Use effort 'high' or below, or enable thinking. 判别用子串 is not supported when thinking is disabled。
2.1.251 之后还用升级吗?
要。旧客户端仍可能发出 xhigh + thinking off。升级后客户端改送 high;若你直连 API,仍要自己避开互斥组合。
Sonnet 5 也会这样吗?
文档按型号列能否关 thinking。Opus 5 明确写了 high 及以下可关、之上 400。其他型号看 thinking 文档的表,不要把 Opus 5 的句子抄到所有 id。
alwaysThinkingEnabled: true 为什么还会中招?
issue 描述客户端有时省略 thinking 块却仍带 xhigh。这是客户端 bug 轨迹,2.1.251 用降档修补。不要假设设置项等于每个请求都带了 thinking。
这和月封顶 / credits 有关吗?
无关。那两条是 429 无 retry-after 或预付积分为 0。这条是 400 参数拒绝。
QCode 会不会自动把 xhigh 改成 high?
本页不声称网关会改写你的 effort。合法组合以 Anthropic 文档为准。Claude Code 2.1.251 的改写发生在官方客户端,不是转售层的承诺。
信息来源
Claude Code changelog 2.1.251(2026-08-28)修复句与原文。thinking 文档 https://docs.claude.com/en/docs/build-with-claude/thinking.md 与 platform.claude.com 的 effort / thinking 说明(2026-08-30 核对)。错误原文样本见 anthropics/claude-code#76689。帮助中心 Change the model, effort, and thinking settings。
相关阅读
Claude Opus 5 指南
这条 400 最常出现的型号;先看它允不允许关 thinking。
529 vs 429 vs weekly
另一组常被当成「额度」的状态码,和这条 400 不是一类。
enforced_spend_limit_reached
月封顶 429,不要和 effort/thinking 的 400 混检索。
整理自 Claude Code changelog 与 Anthropic 公开文档,不代表 Anthropic 对某个客户端版本的承诺。具体以你收到的 400 正文和当前文档为准。QCode 不绕过模型参数校验。