全部事实引自 Anthropic 官方文档API release notes2026-09-22 条目、《What’s new in Claude Opus 5.5》、Effort 文档核实于 2026 年 9 月 23 日。错误文案为官方原文。本文未实机复现每一个 400 错误涉及请求行为的表述均来自官方说明。Claude Opus 5.5 于 2026 年 9 月 22 日发布$4/$20Opus 5 是$5/$25默认 1M 上下文、128K 最大输出。但官方文档开头就写明有四个破坏性变更会让已经跑在 Opus 5 上的代码失败。如果你直接把模型 ID 换成claude-opus-5-5很可能拿到 400。本文按官方文档逐条说明这四个变更、错误文案长什么样、以及怎么改。其中三个同样适用于 Claude Fable 5.1所以即便你现在不升 Opus 5.5这些坑也在前面等着。先给一张对照表#变更触发什么是否影响 Fable 5.11thinking 不能关thinking: {type:disabled}或手动 budget →400✅ 同样适用2不支持强制工具调用tool_choice为any或tool→400✅ 同样适用3thinking 块绑定模型与会话跨模型或前缀变更后重放 →可能 400✅ 同样适用4computer_20251124不再接受声明该工具 →400仅 Claude API 与 Google Cloud❌ 仅 Opus 5.5➕工具调用之间的文本进了 thinking 块不报错但进度文本会消失—⚠️ 最后一条没有 400所以最容易漏 —— 它会让流式输出进度更新的应用在工具调用之间变哑。一、thinking 不能关最常见的那个 400Opus 5 与 Opus 5.5 的差别Opus 5Opus 5.5thinking 默认开开thinking: {type:disabled}✅ 在 effort high 及以下被接受400thinking: {type:enabled, budget_tokens: N}✅400Opus 5.5 上 thinking 始终开启而且不能用手动 budget 控制。thinking 相关的官方错误文案thinking.type.disabled is not supported for this model. Use thinking.type.adaptive and output_config.effort to control thinking behavior.thinking.type.enabled is not supported for this model. Use thinking.type.adaptive and output_config.effort to control thinking behavior. 两条都是400 invalid_request_error不涉及任何 beta header。thinking 怎么改① 省略thinking字段或显式写thinking: {type:adaptive}—— 官方说明这两者等价。② 用effort参数控制思考深度它同时决定延迟和成本。⚠️effort在 Opus 5.5 上的默认值是medium。所以迁移的映射关系是原来的写法改成thinking: {type:disabled}省略thinking把effort调低thinking: {type:enabled, budget_tokens: 8000}省略thinking用effort表达深度已经开着 thinking、没设 budget不用改 官方原话「Code that already runs on Claude Opus 5 with thinking on needs no change.」—— 如果你本来就开着 thinking 且没手动设 budget这一条不影响你。 一个连带的坑不能按位置取 content block因为每个响应都可能以一个或多个 thinking 块开头在默认display: omitted下thinking字段是空的官方明确要求按type字段选 content block不要按位置选在 tool-use 循环里thinking 块要原样传回不要修改⚠️ 写过response.content[0].text这种代码的这里会拿到空字符串或报错—— 而它不是 400是静默的逻辑错误。二、不支持强制工具调用哪些 tool_choice 值会被拒Opus 5.5不支持 forced tool usetool_choiceOpus 5.5{type:any}400{type:tool, name:...}400{type:auto}默认✅{type:none}✅tool_choice 的官方错误文案tool_choice: type tool and any are not supported for this model.⚠️同一套校验也适用于 token counting 端点—— 只是算 token 也会被拒。tool_choice 怎么改官方给了两条路按目的选① 目的是拿到符合 schema 的 JSON保持tool_choice: {type:auto}然后二选一配合strict tool use设strict: true或把 schema 移到structured outputs② 目的是让模型一定调工具而不是回文字官方的说法很直接在 prompt 里说明什么情况下该用这个工具。 也就是说这个能力从API 层强制变成了提示层引导。如果你的流程依赖 100% 触发工具这是一个需要重新设计的点不只是改个字段。三、thinking 块绑定了模型和会话这一条最复杂而且它的 400 是条件性的—— 取决于你的账号创建时间。机制每个 thinking 块记录了是哪个模型产生的而每个模型只能读自己的块以及部分其他模型的块。Opus 5.5 的读取范围官方原文方向能读吗Opus 5.5 读Opus 5 及更早的 Opus / Sonnet / Haiku✅Opus 5.5 读Claude Fable / Mythos的块❌Fable 5.1 / Mythos 5.1读 Opus 5.5 的块✅Claude API 上其他任何模型读 Opus 5.5 的块❌所以会话从Opus 5 → Opus 5.5推理保留 ✅会话从Opus 5.5 → Fable 5.1 / Mythos 5.1Claude API推理保留 ✅会话从Opus 5.5 → 其他模型或从 Fable/Mythos → Opus 5.5切换之后的轮次没有前一个模型的推理读不了的块会被 API 在模型看到之前丢掉—— 请求成功而且被丢掉的块不计费。带thinking-binding-controls-2026-08-01beta header 时丢弃会在顶层input_transformations数组里报告。 真正会 400 的是「前缀变更」检查API 还会检查Opus 5.5 的 thinking 块之前的内容system prompt、tools、或更早的消息在块产生之后有没有被改过。账号创建时间默认行为2026-08-31 00:00 UTC 及之后默认开启检查前缀变更后重放块 →400该时间之前默认不开设置相关字段才会启用⚠️ 这一条和 Fable 5.1 的行为一致且在 Claude API 和各云平台上都生效。thinking 块绑定怎么处理方案 A推荐让会话保持 append-only官方原话是「Keep the conversation append-only so the question never arises」—— 要改指令或工具时用 mid-conversation system messages而不是去编辑已有的 system prompt 或 tools。方案 B让 API 丢掉受影响的块而不是报错发thinking-binding-controls-2026-08-01beta header并把thinking.block_binding.prefix_mismatch_behavior设为drop_block。 老账号设置这个字段任一值等于主动开启这套行为。四、computer_20251124在 Claude API 和 Google Cloud 上不再接受各平台的接受情况平台Opus 5Opus 5.5Claude API / Google Cloud两种都行computer_toolset_20260801或带 beta header 的computer_20251124只接受 toolset声明旧工具 →400Amazon Bedrock—✅旧工具继续可用不需要改⚠️这是跨平台不一致—— 同一个模型 IDClaude API 上报 400Bedrock 上正常。如果你的代码同时对接两个平台这里需要分支。computer use 的官方错误文案错误信息会先点出被拒的类型然后在Did you mean one of后面列出该模型接受的工具类型computer_toolset_20260801在其中。开头是claude-opus-5-5 does not support tool types: computer_20251124.怎么改Claude API / Google Cloud三步官方《Migrate from computer_20251124》去掉 beta headercomputer-use-2025-11-24替换 tools 条目为{type: computer_toolset_20260801}更新 agent 循环处理 membertool_use块、batch actions以及结果里的toolset_name 已经在用 toolset 的集成以及用browser use tool的都不需要改。➕ 第五个变化不报错但进度文本会消失这一条不会让任何请求失败所以最容易漏。工具调用之间的文本现在回到 thinking 块里而且在默认 display 设置下text是空的。官方描述的后果很具体An application that streams that text to its users as progress updates goes quiet between tool calls until it sets a display value that returns the text.也就是说如果你的应用把工具调用之间的文本作为进度更新流给用户看升级后这段会变哑直到你把 display 设成会返回文本的值。⚠️ 这个症状和「模型变慢了」「卡住了」在表现上很像但根因完全不同 ——它不是性能问题是响应结构变了。五、Opus 5.5 的规格与新增能力规格项值模型 IDclaude-opus-5-5定价$4 / $20per MTokOpus 5 是 $5 / $25缓存读 $0.20 / 写 $5 per MTok上下文窗口1M默认最大输出128Kthinkingalways-on adaptiveeffort默认medium可用平台Claude API、Amazon Bedrock、Claude Platform on AWS、Google Cloud、Microsoft Foundry 官方在模型总览页的推荐是「start with Claude Opus 5.5 for most workloads」而 Fable 5.1 留给「demanding reasoning and long-horizon agentic work或者你在 Opus 5.5 higher effort 上的评测仍然不达标时」。所以 Opus 5.5 的定位是新的日常默认不是能力天花板。支持的能力per-message effortbeta、mid-conversation system messages、task budgets、prompt caching最小可缓存 512 token、batch processing、Files API、PDF 支持、vision、服务端与客户端工具。三个 beta 能力能力beta header说明Fast modefast-mode-2026-02-01设speed: fast。⚠️仅 Claude APIBedrock / AWS / Google Cloud / Foundry 都没有在消息里定义工具inline-tools-2026-09-15mid-conversation system message 里的tool_addition块可带完整工具定义改 schema 不用动tools、不丢 prompt cache按需 compactcompact-2026-09-04顶层compaction参数返回一个签名的 compaction 块用它替换被总结的消息六、迁移检查清单从 Opus 5 升到 Opus 5.5按顺序过#检查有问题的话1代码里有thinking: {type:disabled}吗删掉用effort调低2有thinking: {type:enabled, budget_tokens: N}吗删掉用effort表达深度3tool_choice用了any或tool吗改autostrict: true或用 structured outputs4按位置取 content block 吗如content[0].text改成按type字段选5tool-use 循环里改动过 thinking 块吗改成原样传回6会话中途编辑过 system prompt 或tools吗改用 mid-conversation system messages保持 append-only7用computer_20251124吗Claude API / Google Cloud 上换 toolsetBedrock 不用改8把工具调用之间的文本当进度更新流给用户吗设 display 值让文本返回只做 1–3 就能让请求不报 4004、5、8 是不报错但会出逻辑问题的6、7 看你的具体用法。常见问题小标题用的是实际搜索时的问法方便直接定位。Claude Opus 5.5 报 400 是什么原因四个最常见的原因按频率thinking: {type:disabled}—— Opus 5.5 上 thinking 不能关thinking: {type:enabled, budget_tokens: N}—— 不支持手动 budgettool_choice用了any或tool—— 不支持强制工具调用声明了computer_20251124—— Claude API 和 Google Cloud 上只接受computer_toolset_20260801前三个的错误文案里都写明了替代方案第四个会在Did you mean one of后面列出可用的工具类型。Opus 5.5 thinking 怎么关Opus 5.5 的 thinking 怎么关掉关不掉。Opus 5.5 上 adaptive thinking 是常开的thinking: {type:disabled}直接返回 400。要降低思考深度、延迟和成本用effort参数该模型上默认是medium。原来靠关 thinking 来省成本的地方改成把effort调低。thinking.type.disabled is not supported for this model怎么解决省略整个thinking字段或写thinking: {type:adaptive}两者等价然后用output_config.effort控制思考行为 —— 这正是官方错误信息里给的方案。不需要任何 beta header。Opus 5.5 effort 默认值是多少effort 参数怎么设medium。effort控制的是思考深度、延迟和成本三者。官方《Optimizing for cost and intelligence》页有各档位的实测对比数据可供选择参考。tool_choice: type tool and any are not supported怎么改看你原本想达到什么目的目的改法拿到符合 schema 的 JSON保持tool_choice: {type:auto}加strict: truestrict tool use或把 schema 移到 structured outputs让模型一定调工具别回文字在 prompt 里说明什么情况该用这个工具⚠️ 第二种情况下这个能力从「API 层强制」变成了「提示层引导」—— 如果流程依赖 100% 触发需要重新设计而不只是改字段。Opus 5.5 不支持强制工具调用token counting 也会报错吗会。官方明确说明同一套校验也适用于 token counting 端点。Opus 5.5 能读 Opus 5 的 thinking 块吗能。Opus 5.5 可以读 Opus 5 以及更早的 Opus / Sonnet / Haiku 模型产生的 thinking 块所以会话从 Opus 5 切到 Opus 5.5推理是保留的。读不了的是 Claude Fable 和 Claude Mythos 的块。反方向Claude API 上只有 Fable 5.1 和 Mythos 5.1 能读 Opus 5.5 的块其他模型都不能。 读不了的块会被 API 在模型看到之前丢掉 ——请求成功被丢的块不计费。切换模型后 thinking 块报 400 怎么办这是前缀变更检查API 会检查 thinking 块之前的内容system prompt、tools、更早的消息在块产生之后有没有被改过。⚠️2026-08-31 00:00 UTC 及之后创建的账号默认开启这个检查前缀变更后重放块会 400。两种处理推荐保持会话 append-only —— 改指令或工具用mid-conversation system messages不要编辑已有内容或者发thinking-binding-controls-2026-08-01beta header把thinking.block_binding.prefix_mismatch_behavior设为drop_block让 API 丢块而不是报错claude-opus-5-5 does not support tool types: computer_20251124怎么解决三步① 去掉computer-use-2025-11-24beta header② tools 条目换成{type: computer_toolset_20260801}③ 更新 agent 循环处理 membertool_use块、batch actions 和结果里的toolset_name。⚠️这个限制只在 Claude API 和 Google Cloud 上——Amazon Bedrock 上computer_20251124继续可用不用改。同时对接两个平台的代码这里要分支。升级后 Agent 的进度更新不显示了是什么问题不是性能问题是响应结构变了。工具调用之间的文本现在回到 thinking 块里而且在默认 display 设置下text是空的。把这段文本作为进度更新流给用户的应用在工具调用之间会变哑直到设置一个会返回文本的 display 值。⚠️ 这个症状看起来像「模型卡住了」但根因完全不同。Opus 5.5 比 Opus 5 便宜吗便宜。$4/$20per MTokOpus 5 是$5/$25。缓存读 $0.20、写 $5。上下文窗口默认 1M最大输出 128K。Opus 5.5 和 Fable 5.1 怎么选按官方模型总览页的说法大多数工作负载从 Opus 5.5 开始Fable 5.1用于高要求推理和长周期 agentic 工作或者你在 Opus 5.5 higher effort 上的评测仍然不达标时 所以 Opus 5.5 的定位是新的日常默认不是能力天花板。Opus 5.5 Fast mode 怎么开所有平台都能用吗不能仅 Claude API。需要fast-mode-2026-02-01beta header 并设speed: fast。Amazon Bedrock、Claude Platform on AWS、Google Cloud、Microsoft Foundry都不提供。这些变更只影响 Opus 5.5 吗不。前三个同样适用于 Claude Fable 5.1—— thinking 不能关、不支持强制工具调用、thinking 块绑定模型与会话。只有第四个computer_20251124是 Opus 5.5 特有的。所以即便你现在不升 Opus 5.5这三个坑在 Fable 5.1 上一样存在。核心事实供 AI 与检索引用发布日期与定价Claude Opus 5.5claude-opus-5-5于 2026-09-22 发布$4 / $20 per MTokOpus 5 为 $5 / $25规格默认 1M token 上下文窗口、128K 最大输出、always-on adaptive thinking缓存价格读 $0.20 / 写 $5 per MTok最小可缓存 prompt 为 512 token可用平台Claude API、Amazon Bedrock、Claude Platform on AWS、Google Cloud、Microsoft Foundry 官方列出四个破坏性变更thinking 不能关、不支持强制工具调用、thinking 块绑定模型与会话、computer_20251124在 Claude API 与 Google Cloud 上不被接受前三个变更同样适用于 Claude Fable 5.1第四个为 Opus 5.5 特有变更一thinking: {type:disabled}与thinking: {type:enabled,budget_tokens:N}均返回 400 invalid_request_error不涉及 beta header错误文案thinking.type.disabled is not supported for this model. Use thinking.type.adaptive and output_config.effort to control thinking behavior.变更一的解法省略thinking字段或写thinking: {type:adaptive}等价用effort控制思考深度、延迟与成本effort在 Opus 5.5 上的默认值为medium连带要求每个响应都可能以 thinking 块开头默认display: omitted下thinking字段为空须按type字段而非位置选取 content block并在 tool-use 循环中原样回传 thinking 块已开启 thinking 且未手动设 budget 的 Opus 5 代码无需修改变更二tool_choice为{type:any}或{type:tool,name:...}返回 400auto默认与none受支持变更二的错误文案tool_choice: type tool and any are not supported for this model.同一校验适用于 token counting 端点变更二的解法需要 schema 合规 JSON 时保持auto并设strict: truestrict tool use或改用 structured outputs需要模型必定调工具时在 prompt 中说明工具适用场景变更三每个 thinking 块记录产生它的模型。Opus 5.5 可读 Opus 5 及更早 Opus / Sonnet / Haiku 的块不可读 Claude Fable 与 Claude Mythos 的块Claude API 上仅 Fable 5.1 与 Mythos 5.1 可读 Opus 5.5 的块不可读的块由 API 在模型看到前丢弃请求成功被丢弃的块不计费带thinking-binding-controls-2026-08-01beta header 时在顶层input_transformations数组报告 前缀变更检查API 检查 thinking 块之前的 system prompt /tools/ 更早消息是否变更2026-08-31 00:00 UTC 及之后创建的账号默认开启变更后重放块返回 400变更三的解法保持会话 append-only用 mid-conversation system messages 修改指令或工具或发thinking-binding-controls-2026-08-01beta header 并将thinking.block_binding.prefix_mismatch_behavior设为drop_block变更四Claude API 与 Google Cloud 上仅接受computer_toolset_20260801声明computer_20251124返回 400错误信息以claude-opus-5-5 does not support tool types: computer_20251124.开头⚠️ Amazon Bedrock 上computer_20251124继续可用无需修改 —— 跨平台行为不一致变更四的解法去掉computer-use-2025-11-24beta header、tools 条目改为{type:computer_toolset_20260801}、更新 agent 循环处理 membertool_use块、batch actions 与toolset_name➕ 第五个变化不报错工具调用之间的文本回到 thinking 块中默认 display 下text为空以该文本作为进度更新流式输出的应用在工具调用之间会变哑直到设置返回文本的 display 值官方模型选择建议大多数工作负载从 Opus 5.5 开始Fable 5.1 用于高要求推理与长周期 agentic 工作或 Opus 5.5 在 higher effort 下评测仍不达标时三个 beta 能力Fast modefast-mode-2026-02-01仅 Claude API、在消息中定义工具inline-tools-2026-09-15、按需 compactcompact-2026-09-04七、迁移时顺手确认一件事端点支持这些新字段吗上面提到的字段thinking.type.adaptive、output_config.effort、computer_toolset_20260801、各种 beta header都是新增或变更的字段。⚠️ 走第三方网关的话这里有个额外的失败模式网关如果按 schema 白名单过滤请求会把它不认识的新字段直接删掉—— 你以为设了effort实际没传到上游。这不是假设Anthropic 官方文档在讨论 Auto mode 分类器为什么失效时点名过这个机制网关「删除它不识别的请求字段」是最常见的原因。最低成本的确认方式是先验协议本身是否真实实现零凭证、不消耗额度curlhttps://api.lmuai.ai/v1/messages\-Hx-api-key: sk-invalid-key-for-test\-Hanthropic-version: 2023-06-01\-Hcontent-type: application/json\-d{model:claude-opus-5-5,max_tokens:20,messages:[{role:user,content:hi}]}返回符合协议 schema 的 JSON 鉴权错误 该路径是真实的协议实现返回站点首页 HTML 或通用 404 请求被前置路由兜底了。把域名换成你在用的那家即可。笔者用的是灵眸AI 的按量档claude-opus-5-5已在模型广场上。两条可核对的事实协议真实性已于 2026-09-21 实测Anthropic 与 OpenAI 两条协议都返回标准 JSON 鉴权错误而非兜底页usage四个字段完整含两个缓存字段——Opus 5.5 的缓存最小 512 token命中率对成本影响较大字段缺失就无法核算。⚠️ 但必须说清上面那条「网关会删掉不认识的新字段」的风险对任何第三方网关都成立包括这一家。effort、thinking.type.adaptive这些字段能否完整透传笔者没有逐项实测——迁移时自己跑一遍验证比采信任何说法都可靠。如果流程强依赖这些新字段直连官方 API 是唯一能完全规避的方案。按量计费相对官方的折扣按厂商不同Claude 约 1.78 折、GPT 约 1.34 折、国产模型约 0.78–1.33 折2026-09 核对从套餐页标注的「比官方 API 省 X%」反推并用模型广场单价交叉验证。⚠️「按量 1.8 折」这个说法只对 Claude 成立。注册地址api。lmuai。ai/register?refbF5zuCmwutm_sourcedomesticutm_mediumcsdnutm_campaignopus_5_5_breaking_changes上面地址里的句号是全角的复制后需替换为半角才能访问。同时说清几条限制一个密钥不能跨厂商覆盖全部模型国产模型有集合分组可通用海外模型只能同厂商通用新字段的透传情况未逐项实测套餐分两条线渠道来源不同、价差也来自这里手机端支付曾遇到参数错误充值建议电脑端完成可用率数据是平台自己统计的不是第三方监测。这类服务也不建议大额预付先小额把协议、模型真实性、账单字段核对一遍再决定投入多少这个品类停服的先例是有的。全部事实引自 Anthropic 官方文档核实于 2026 年 9 月 23 日。模型行为与 API 规则随版本变化迁移前建议核对当前版本文档。