作者注：本文依据 2026-11-08（UTC+8）Anthropic 官方文档与 2026-11-09 10:40 更新的 API易 Claude 思考参数指南整理，口径核对日期为 2026-11-13，帮助你避开 claude-opus-5-5 与 claude-sonnet-5-5 在 thinking 参数上的 400 报错。
如果你在 claude-opus-5-5 上把 thinking 的 type 传成 disabled，接口会直接返回 400——这是 2026-11-08（UTC+8）Anthropic 官方文档写明的口径。API易（apiyi.com）已在 2026-11-09 10:40 同步刷新了 Claude 思考参数指南，把两个模型 ID 的正确写法梳理清楚。本文快速解读这一变化对 Claude API 调用方的影响。
这不是小道消息：两个关键结论均以文档为准——claude-opus-5-5 无法关闭思考，只能降低 effort；claude-sonnet-5-5 关闭前置思考要改用 between_tools。
核心价值：3 分钟了解两个模型 ID 的正确写法、between_tools 的参数边界，以及 400 报错的排查思路。
核心信息速览：claude-opus-5-5 与 claude-sonnet-5-5 的 thinking 口径
先看结论表，再逐条展开：
| 信息项 | 详情 |
|---|---|
| 官方口径 | 2026-11-08（UTC+8）Anthropic 官方文档 |
| API易指南更新 | 2026-11-09 10:40，docs.apiyi.com 已同步 |
| claude-opus-5-5 | 不传 thinking 即自适应思考；传 disabled 返回 400 |
| claude-sonnet-5-5 | 不传 thinking 同为自适应思考；关闭前置思考用 between_tools |
effort 默认值 |
Opus 5.5 为 medium，Sonnet 5.5 为 high |
| 最大输出 | 两个模型 ID 均为 128000，思考 token 计入其中 |
claude-opus-5-5 的口径相当直接。请求中不传 thinking 字段时，模型进入自适应思考，由它自行决定当次是否思考、思考多深；而一旦把 thinking 的 type 设为 disabled，接口不会静默忽略，而是直接返回 400。换句话说，这个模型 ID 没有关闭思考的开关，文档给出的唯一调节手段是降低 effort，默认档位为 medium。
claude-sonnet-5-5 的处境略有不同。它同样支持不传 thinking 的自适应思考，但多了一条官方认可的关闭路径：把 type 设为 between_tools，即可关闭前置思考，只保留工具调用之间的进度更新。这条路径的边界同样写得清楚，建议直接对照下表：
| 约束项 | 文档口径 |
|---|---|
effort 取值 |
只接受 low、medium、high |
| 档位上限 | 不能高于 high |
| 搭配限制 | 不能同时携带 display 或 budget_tokens |
| 实际效果 | 关闭前置思考，仅保留工具调用之间的进度更新 |
还有一个容易被忽略的细节：思考 token 会计入 max_tokens。两个模型 ID 的最大输出都是 128000，如果请求把 max_tokens 压得太低，思考可能先吃掉大半预算，正文随之被截断。排查“回复莫名变短”的问题时，值得先确认思考的占用情况。
配图说明：图中调用链路以 API易 apiyi.com 的 Anthropic 原生格式网关为例。走 Anthropic 格式时，base 地址是 https://api.apiyi.com，注意不要写成带 /v1 的形式。
影响分析：disabled 报 400 波及哪些调用方
这次口径变化对调用方的影响集中在报错处理、参数组合与预算规划三处，逐项拆开看会更直观。
对存量代码的影响：disabled 写法的迁移
| 场景 | 旧写法 | 现在的结果 | 正确做法 |
|---|---|---|---|
| claude-opus-5-5 想关思考 | type 传 disabled |
返回 400 | 无法关闭，只能降低 effort |
| claude-sonnet-5-5 想关前置思考 | type 传 disabled |
返回 400 | 改用 between_tools |
| 想精细控制思考预算 | between_tools 搭配 budget_tokens |
组合不被接受 | 二者不可同传，改用 effort 三档 |
| 担心思考挤占输出 | 把 max_tokens 设得很小 |
正文被截断 | 思考计入 max_tokens，预留余量 |
第一重影响是参数组合的约束变多。between_tools 不能与 budget_tokens 或 display 同时出现，意味着想精细控制思考预算的做法在这条路径上失效，只能靠 low、medium、high 三档间接调控。叠加“思考 token 计入 max_tokens”这条规则，调用方需要在 effort 与 max_tokens 之间重新找平衡。
第二重影响是分支逻辑要更新。如果脚本按模型 ID 决定是否传 disabled，遇到这两个 ID 就要走分支：前者接受“关不掉”的现实，用 effort 降档；后者切换到 between_tools。把这类分支集中到一处配置里维护，后续口径再变时改动面最小。
顺带一提，同页还写明 Fable 5.1 和 Fable 5 传 disabled 同样会 400，一样关不掉；Haiku 5.5 和 Opus 5 则在 effort 不高于 high 时仍可使用 disabled。如果代码同时服务多个模型 ID，建议按模型维护一张开关矩阵，而不是全局套用同一个写法。
对成本结构的影响：thinking token 与用量
claude-sonnet-5-5 在 API易（apiyi.com）总表的计价为输入 $2、输出 $10、缓存读 $0.1。由于思考 token 计入 max_tokens，是否关闭前置思考、选哪一档 effort，都会直接反映在 token 用量上。高频调用场景下这点差距会被放大，改代码时值得顺手算一笔账。
配图说明：口径整理自 2026-11-08 官方文档，可在 API易 apiyi.com 文档中心对照原文核实。
| 模型 ID | disabled 可用性 |
文档口径 |
|---|---|---|
| claude-opus-5-5 | 不可用，返回 400 | 关不掉思考，只能降 effort（默认 medium） |
| claude-sonnet-5-5 | 不可用，返回 400 | 改用 between_tools（默认 high） |
| Fable 5.1 / Fable 5 | 不可用，返回 400 | 同样关不掉 |
| Haiku 5.5 / Opus 5 | effort 不高于 high 时可用 |
旧写法仅在这两个 ID 上成立 |
如何快速验证 claude-sonnet-5-5 的 between_tools
改动上线前，建议先用小流量验证行为差异。在 API易（apiyi.com）注册并获取 API Key，新用户有免费测试额度；请求发往 https://api.apiyi.com，在请求体里把 thinking 的 type 设为 between_tools，effort 在三档中任选其一，先跑一轮，再对比不传 thinking 的自适应模式，观察输出结构与 token 用量的变化。
🚀 快速验证建议：通过 API易 apiyi.com 获取免费测试额度，用同一组提示词分别跑
between_tools与自适应两种模式，确认差异后再改存量代码。平台支持 Claude、OpenAI、Gemini 等主流模型的统一调用，OpenAI 兼容接口按量计费，方便横向对比与切换。
常见问题 FAQ：disabled、between_tools 与 400 报错
Q1：claude-opus-5-5 到底能不能关闭思考？
不能。2026-11-08 的官方口径写明：传 `disabled` 会返回 400，这个模型 ID 没有关闭思考的开关，只能通过 `effort` 降低思考深度，默认档位是 `medium`。如果场景必须完全无思考，只能更换模型 ID。
Q2：claude-sonnet-5-5 的 between_tools 可以搭配 budget_tokens 吗？
不可以。文档明确写了 `between_tools` 不能同时携带 `display` 或 `budget_tokens`，对应的 `effort` 只接受 `low`、`medium`、`high` 三档且不能高于 `high`。想精细控制思考预算，只能退回自适应模式或更换模型 ID。
Q3：为什么我的 Claude 请求突然返回 400？
先检查请求体里是否把 `thinking` 的 `type` 设成了 `disabled`——在 claude-opus-5-5 与 claude-sonnet-5-5 上，这是文档写明的触发条件。确认后按本文对照表处理：前者降 `effort`，后者切 `between_tools`。适用写法以 2026-11-08（UTC+8）官方文档为准，API易页面已于 2026-11-09 10:40 同步。
Q4：如何快速验证 claude-sonnet-5-5 的 between_tools 效果？
在 API易（apiyi.com）注册账号并获取 API Key，新用户有免费测试额度。请求发往 `https://api.apiyi.com`，把 `thinking` 的 `type` 设为 `between_tools`、`effort` 任选一档，跑一轮即可对比出与自适应模式的差异。
Q5：思考 token 会不会挤占输出预算？
会。思考 token 计入 `max_tokens`，两个模型 ID 的最大输出均为 128000。请求中把 `max_tokens` 设得太低时，思考可能先消耗预算、正文被截断，建议为正文预留足够空间。
claude-opus-5-5 与 claude-sonnet-5-5 核心要点 Key Takeaways
- claude-opus-5-5 关不掉思考：传
disabled直接 400，只能用effort降档，默认medium。 - claude-sonnet-5-5 改用
between_tools：关闭前置思考，只保留工具调用之间的进度更新。 - 三条参数红线：
effort仅low、medium、high，不能高于high，禁配display与budget_tokens。 - 预算规则：思考 token 计入
max_tokens，两个 ID 上限均为 128000。 - 验证入口：API易 apiyi.com，Anthropic 格式 base 为
https://api.apiyi.com，不要加/v1。
总结：避开 400 的三个动作
claude-opus-5-5 与 claude-sonnet-5-5 的口径可以浓缩成三句话：
- claude-opus-5-5：传
disabled会 400，思考关不掉，只能降低effort。 - claude-sonnet-5-5：关闭前置思考改用
between_tools，三档effort，禁配display与budget_tokens。 - 预算：思考 token 计入
max_tokens，上限 128000，为正文留余量。
如果你正被这个 400 卡住，推荐先到 API易 apiyi.com 用免费测试额度跑一轮 between_tools，确认行为后再修改存量代码。平台一个 API Key 即可调用 OpenAI、Claude、Gemini 等主流模型，按量计费，适合快速对比与切换。
📚 参考资料
- API易 Claude 思考参数指南：effort 与 thinking 的适用写法
- 链接：
docs.apiyi.com/api-capabilities/claude-effort-thinking.md -
说明：2026-11-09 10:40 更新的版本，本文主要事实来源
-
API易 指南刷新动态：本轮口径同步的官方说明
- 链接：
docs.apiyi.com/live/2026-11/claude-thinking-guide-refresh.md -
说明：记录与 2026-11-08 官方文档对齐的过程
-
Anthropic 官方文档：thinking 参数的原始口径
- 链接：
docs.anthropic.com - 说明：建议对照阅读，确认最新写法
作者：API易 技术团队
技术交流：欢迎在 API易 网站首页联系我们，更多资料可访问 docs.apiyi.com 文档中心
