作者注：claude-haiku-5-5 默认就会思考，想关掉却报错？多半是 effort 高于 high。本文讲清规则、三步修复与参数边界。
让 claude-haiku-5-5 少思考、把输出额度留给正文，是跑批处理和结构化任务时很常见的诉求。你可能已经把 thinking 设成了 disabled，结果接口却返回了报错：明明是想关掉思考，为什么反而被拦下来？本文将介绍 effort 与 disabled 的配合规则，帮助你快速掌握 claude-haiku-5-5 关闭思考的正确方法。
这不是玄学问题，也不是模型抽风。文档记载得很清楚：claude-haiku-5-5 不传 thinking 就是自适应思考，默认开启；关闭思考用 thinking 的 type: disabled，但这个写法只在 effort 不高于 high 时被接受。本文参数以 2026-11-08（UTC+8）的 Anthropic 官方文档为准，核对日期为 2026-11-13。
核心价值：读完本文，你将弄清报错的真实原因、三步修复方法，以及 max_tokens 和思考 token 的关系，之后无论在哪套环境里调用，都不会再被这条规则绊住。
claude-haiku-5-5 核心要点
先把结论放前面，赶时间的读者看这一节就够了：
| 要点 | 文档记载 | 对你的影响 |
|---|---|---|
| 默认开启思考 | 不传 thinking 就是自适应思考，默认开启 |
想省额度必须显式关闭 |
| 关闭开关 | thinking 设为 type: disabled |
唯一的关闭方式 |
| effort 门槛 | 仅在 effort 不高于 high 时接受 disabled |
配 xhigh 或 max 会报错 |
| effort 默认值 | 默认 medium，与 claude-opus-5-5 相同 |
不主动上调就不会踩坑 |
| 额度边界 | 最大输出 128000，思考 token 计入 max_tokens |
思考会挤占正文空间 |
claude-haiku-5-5 重点详解
第一，默认会思考。 claude-haiku-5-5 是默认带着思考能力运行的模型：请求里不出现 thinking 字段时，它按自适应思考运行。文档没有展开自适应模式的具体决策细节，但可以确定的是，默认状态下思考就是开着的。
如果你的场景是短问答、批量打标、格式转换这类不太需要深度推理的任务，思考 token 就是纯开销。文档同时记载，思考 token 计入 max_tokens，最大输出为 128000，思考越多，留给正文的额度就越少。这正是“想关掉思考、把额度留给正文”这个诉求的由来。
第二，关闭有门槛。 关闭思考的唯一开关，是把 thinking 设为 type: disabled。但文档同时写明，这个写法只在 effort 不高于 high 时被接受：effort 为 medium 或 high 时一切正常，一旦配成 xhigh 或 max，请求就会报错。官方给的修复口径也很直白——把 effort 降到 high 或以下。如果你是通过 API易 apiyi.com 调用 claude-haiku-5-5，排查这类报错时同样先从这对参数组合查起。
第三，默认值反而是安全的。 claude-haiku-5-5 的 effort 默认是 medium，和 claude-opus-5-5 一致，其余多数模型默认是 high。容易踩坑的路径通常是：从别的模型迁移代码，习惯性地把 effort 显式拉到 xhigh 或 max 去换质量，又顺手加上 disabled 想控制成本，两个意图打架，报错就来了。
反过来，只要不主动把 effort 向上传，默认的 medium 天然满足“不高于 high”的条件，disabled 可以正常生效。需要在不同型号之间做切换对比时，在 API易 apiyi.com 上用一个 API Key 调多个模型，也省得反复改接入配置。
上面这张图就是标准的排查路径，最常见的情况卡在中间那个判断框：effort 越界。修复之后，建议先用小额度在 API易 apiyi.com 上跑一遍验证，确认返回正常，再放进生产流量。
claude-haiku-5-5 快速上手：三步修复
不需要翻长文档，照下面三步做，这类报错基本就能解决：
- 确认模型 ID：请求里的
model应为claude-haiku-5-5，先排除型号写错带来的干扰。 - 把 effort 降下来：设为
high或更低。medium是默认值，直接不传也可以；关键是不要传xhigh或max。 - 再关闭思考：把
thinking设为{"type": "disabled"}。此时effort不高于high，请求会被正常接受。
claude-haiku-5-5 请求参数速查
| 参数 | 建议取值 | 说明 |
|---|---|---|
model |
claude-haiku-5-5 |
本文讨论的型号，注意别写成其他版本 |
thinking |
{"type": "disabled"} |
关闭思考的唯一开关 |
effort |
medium（默认）或 high |
必须不高于 high，否则与 disabled 冲突 |
effort 禁用值 |
xhigh、max |
与 disabled 组合会报错 |
max_tokens |
上限 128000 | 思考 token 计入此值，关闭思考后可全留给正文 |
接入侧的信息也不复杂，以 API易 为例：
- 接入地址：
https://api.apiyi.com/v1 - 认证方式：一个 API Key 即可
- 接口风格：OpenAI 兼容接口
- 计费方式：按量计费、价格优惠，新用户有免费测试额度
- 覆盖范围：OpenAI、Claude、Gemini 等主流模型
🚀 快速开始：推荐在 API易 apiyi.com 上完成这次验证。注册后用免费测试额度把修复后的请求跑一遍，确认
disabled正常生效、报错消失，再接入真实业务，几分钟就能闭环。
claude-haiku-5-5 的 effort 兼容性
下表是全文最值得记住的一张，建议直接存进团队笔记：
| effort 取值 | 与 disabled 组合 | 结果 |
|---|---|---|
medium（默认） |
兼容 | 正常关闭思考 |
high |
兼容 | 正常关闭思考 |
xhigh |
冲突 | 请求报错 |
max |
冲突 | 请求报错 |
对照这张表再看自己的请求，方向就很明确：只要报错出现在同时传了 disabled 的请求里，第一反应就是检查 effort 有没有越过 high 这条线。文档记载的修复口径只有一句——把 effort 降到 high 或以下，没有别的绕行写法。
claude-haiku-5-5 与其他型号的默认 effort 对照
| 模型 | 默认 effort | 与关闭思考的关系 |
|---|---|---|
| claude-haiku-5-5 | medium |
默认满足“不高于 high”，disabled 可直接生效 |
| claude-opus-5-5 | medium |
默认值与 haiku 相同，其思考开关规则本文不展开 |
| 其余多数模型 | high |
默认值同样在门槛内，手动上调才会越界 |
这张表解释了“为什么偏偏是我的请求报错”：不同型号的默认 effort 不一样，迁移代码时沿用旧的参数习惯，很容易把 effort 显式设到 xhigh 或 max。迁移前对照一下默认值，是成本最低的预防动作。
claude-haiku-5-5 报错排查与自检清单
| 现象 | 最可能的原因 | 处理方式 |
|---|---|---|
传了 disabled 仍报错 |
effort 为 xhigh 或 max |
把 effort 降到 high 或以下 |
不确定 effort 是多少 |
没传时默认为 medium |
默认值满足门槛，无需额外处理 |
| 正文变短或被截断 | 思考 token 计入了 max_tokens |
关闭思考，或在 128000 上限内调大 max_tokens |
| 想要更深的推理质量 | 关闭思考后没有思考过程 | 去掉 disabled，回到默认的自适应思考 |
修完之后，发请求前过一遍这份自检清单：
model准确写成了claude-haiku-5-5effort缺省，或显式为medium、highthinking为{"type": "disabled"}max_tokens不超过 128000
四个条件都满足，这一类报错就不会再找上门。把最终参数组合固化成请求模板，还能避免后续误改。
claude-haiku-5-5 常见问题 FAQ
Q1：claude-haiku-5-5 默认会思考吗？
会。文档记载，不传 `thinking` 时，claude-haiku-5-5 按自适应思考运行，默认开启。想让输出额度全部留给正文，需要显式传 `disabled` 关闭。
Q2：为什么传了 disabled 还是报错？
最常见的原因是 `effort` 高于 `high`。文档写明 `disabled` 只在 `effort` 不高于 `high` 时被接受，配 `xhigh` 或 `max` 会报错，修复口径是把 `effort` 降到 `high` 或以下。
Q3：不传 effort 会怎样？
默认是 `medium`。claude-haiku-5-5 与 claude-opus-5-5 的默认值相同，都是 `medium`，其余多数模型默认 `high`。默认值本身满足“不高于 high”，可以直接搭配 `disabled`。
Q4：关闭思考后，输出长度有什么变化？
文档记载思考 token 计入 `max_tokens`，最大输出为 128000。关闭思考后，同样的 `max_tokens` 预算可以全部用于正文，被截断的风险也随之下降。
Q5：临时想要更深的推理怎么办？
去掉 `disabled`，让 claude-haiku-5-5 回到默认的自适应思考即可。如果要同时上调 `effort`，注意别停在“`xhigh` 或 `max` 加 `disabled`”这个组合上。
Q6：如何快速验证修复是否生效？
在 API易 apiyi.com 注册后获取免费测试额度，接入地址用 `https://api.apiyi.com/v1`，把修复后的参数跑一次：请求不再报错、正文正常返回，就说明 `disabled` 已经生效。平台按量计费，小额度验证的成本很低。
Q7：报错一定来自 effort 吗？
不一定，但这是文档明确记载的一类。先核对 `model` 是否准确写成了 `claude-haiku-5-5`，再检查 `thinking` 与 `effort` 的组合是否越界，都排除后再看其他原因。通过 API易 调用时遇到报错，同样先从这对参数查起。
Q8：这些参数口径以哪个版本为准？
本文以 2026-11-08（UTC+8）的 Anthropic 官方文档为准，核对日期为 2026-11-13。若官方后续调整 `effort` 与 `disabled` 的规则，请以最新文档为准。
总结
claude-haiku-5-5 关闭思考这件事，核心就四条：
- 默认会思考：不传
thinking就是自适应思考，默认开启，想省额度必须显式关闭。 - 关闭有门槛：
thinking设为disabled时，effort必须不高于high，配xhigh或max会报错。 - 默认即安全：
effort默认medium，与 claude-opus-5-5 相同，不主动上调就不会触发冲突。 - 额度边界：最大输出 128000，思考 token 计入
max_tokens，关闭后额度全部留给正文。
下次再遇到“想关掉思考却报错”，先看 effort 有没有越过 high 这条线，把参数组合理顺，问题基本就解决了。推荐通过 API易 apiyi.com 用免费测试额度快速验证效果，一个 API Key 即可调用 claude-haiku-5-5 在内的多种主流模型，OpenAI 兼容接口也让型号切换省事不少。
📚 参考资料
- API易文档：Claude effort 与 thinking 参数说明
- 链接：
docs.apiyi.com/api-capabilities/claude-effort-thinking.md -
说明： effort 取值、disabled 的接受条件与报错口径
-
API易文档：Claude 思考指南更新（2026-11）
- 链接：
docs.apiyi.com/live/2026-11/claude-thinking-guide-refresh.md -
说明： 思考相关指南的更新记录与背景
-
Anthropic 官方文档
- 链接：
docs.anthropic.com - 说明： 本文参数以 2026-11-08（UTC+8）版本官方口径为准
作者：API易技术团队
技术交流：欢迎在 API易网站首页联系我们，更多资料可访问文档中心
