Claude 思考模式怎么用？Adaptive Thinking 与 effort 参数详解（2026）

Claude 思考模式让模型在回答前先进行推理：拆解问题、规划步骤、检查结果，再给出答案。复杂编程、数学推理、多步骤 Agent 任务开启思考后效果明显更好。2026 年的新一代 Claude 模型已经改为自适应思考（Adaptive Thinking）：由模型自己决定想多少，你通过 effort 参数控制思考强度。

这篇文章讲清 Claude 思考模式怎么计费、各模型的思考设置有什么不同、effort 参数怎么选，以及旧代码迁移时最常见的 400 报错。各模型的基础价格见《Claude API 价格是多少？2026 Claude API 收费标准与省钱指南》。

---

Claude 思考模式怎么计费

思考内容按输出 Token 计费，而输出单价是输入的 5 倍。无论你是否在响应里看到思考原文，思考过程都会产生费用。

所以控制思考强度，本质上就是在控制成本：简单任务思考太多，是在为用不上的推理付钱；复杂任务思考太少，又可能需要多轮重试，反而更贵。Token 的计费方式见《AI Token 是什么？大模型 Token 怎么计算与计费》。

---

各模型的思考设置对比

模型	能否关闭思考	API 默认 effort	effort 可选值
Fable 5.1	不能，始终开启	high	low / medium / high / xhigh / max
Opus 5.5	不能，始终开启	medium	low / medium / high / xhigh / max
Sonnet 5.5	不能用 disabled，可用 between_tools 关闭回答前的思考	high	low / medium / high / xhigh / max
Haiku 5.5	可以（effort 为 high 及以下时）	medium	low / medium / high / xhigh / max

注意 Opus 5.5 和 Haiku 5.5 的默认 effort 是 medium，比其他模型低一档；需要更深入的推理时要显式设置。

---

Claude 思考模式的写法

自适应思考 + effort

import anthropic

client = anthropic.Anthropic(base_url="https://api.supastore.cc/v1")

response = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=16000,
    thinking={"type": "adaptive"},
    output_config={"effort": "high"},
    messages=[{"role": "user", "content": "设计一个支持百万并发的短链接服务"}],
)

for block in response.content:
    if block.type == "text":
        print(block.text)

print("输出 Token（含思考）：", response.usage.output_tokens)

在 Opus 5.5、Fable 5.1 上，不写 thinking 参数效果等同于自适应思考。effort 写在 output_config 里，不是顶层参数。

显示思考摘要

新一代模型默认不返回思考文字，思考块的内容为空。想在界面里展示推理过程，设置 display: "summarized"，返回的是思考摘要，原始思维链在任何模型上都不会返回：

thinking={"type": "adaptive", "display": "summarized"}

display 只影响是否显示，思考本身照常进行、照常计费。配合流式输出可以实时显示思考进度，见《Claude API 流式输出怎么做？Claude Streaming 教程》。

多轮对话要原样回传思考块

多轮对话或工具调用时，把助手消息里的思考块原样传回下一次请求，不要修改、过滤或重新拼装，否则会返回 400。最简单的做法是直接把 response.content 追加进对话历史。

---

effort 参数怎么选

effort	适合的任务
low	分类、提取、简单问答、子代理的轻量任务
medium	日常对话、一般代码修改，质量够用时的省钱选择
high	需要认真推理的任务，兼顾质量和 Token 消耗
xhigh	复杂编程和长链路 Agent 任务
max	正确率比成本更重要的难题

几条经验：

1. 按场景分别设置，不要全局统一用最高档；
2. 先用真实样本测：新一代模型用较低的 effort，常常就能达到上一代模型高 effort 的效果；
3. 比较"完成一个任务的成本"：低 effort 如果导致多次重试，总成本反而更高；
4. effort 要按场景固定：同一个对话里来回修改 effort，会让消息部分的 Prompt 缓存失效。

---

旧写法在新模型上报 400 怎么办

报错（节选）	原因	解决方法
"thinking.type.enabled" is not supported for this model	新模型已移除 budget_tokens 固定预算写法	改用 thinking: {"type": "adaptive"} + effort
"thinking.type.disabled" is not supported for this model	Opus 5.5、Fable 5.1 的思考无法关闭	删除 thinking 参数，把 effort 调低
Sonnet 5.5 传 disabled 报 400	Sonnet 5.5 关闭思考的写法变了	改用 {"type": "between_tools"}，且 effort 不能高于 high
thinking blocks ... cannot be modified	回传时改动了思考块	原样回传 response.content

更多错误码见《Claude API 报错怎么办？2026 Claude API 错误码大全》。

---

在 Claude Code 中调节思考强度

Claude Code 中 Opus 5.5、Sonnet 5.5、Haiku 5.5 的默认 effort 都是 medium。用 /effort 可以随时调整：改格式、写注释这类简单任务用 /effort low，疑难 Bug 再调到 high 或 xhigh。这是控制 Claude Code Token 消耗最直接的方法之一，更多方法见《Claude Code Token 消耗太快？10 个 Claude Code 省 Token 技巧》；模型和 effort 怎么搭配，见《Claude Opus 和 Sonnet 有什么区别？》。

---

常见问题 (FAQ)

Q: Claude 思考模式要额外收费吗？

答： 思考内容按输出 Token 计费，即使响应中不显示思考原文也会产生费用，所以 effort 越高、思考越多，输出 Token 和费用也越高。

Q: Claude Opus 5.5 能关闭思考吗？

答： 不能，Opus 5.5 和 Fable 5.1 的思考始终开启，传入 disabled 会返回 400，只能通过 output_config 中的 effort 参数调低思考强度。

Q: budget_tokens 为什么报错？

答： 新一代 Claude 模型已经移除了 budget_tokens 固定思考预算的写法，需要改用 thinking 为 adaptive，并通过 effort 参数控制思考强度。

Q: effort 参数应该设置多少？

答： 简单的分类和提取用 low，日常任务用 medium，需要认真推理的任务用 high，复杂编程和 Agent 任务用 xhigh，最难的问题再用 max，最好用真实样本对比后再确定。

Q: 怎么看到 Claude 的思考过程？

答： 在 thinking 参数中设置 display 为 summarized，响应中会返回思考摘要；新一代模型默认不返回思考文字，原始思维链在任何设置下都不会返回。