Adaptive Thinking 思考强度配置

2026 Claude Code 思考强度：Adaptive Thinking 的 thinking 与 effort 参数、与 budget_tokens 差异、支持模型与成本。

需要 API Key？ 前往注册 →·端点与 Base URL →

在 Claude Code 里调整「思考强度」，用的就是 Adaptive Thinking：从 Claude 4.6 起，模型自己决定何时推理、推理多少 tokens，你用 effort（Claude Code 里是 /effort）粗调深度。本文给出 thinking 与 effort 的 API 写法、支持模型矩阵、与旧 budget_tokens 的差异，以及成本观测方法。

关于参数来源：下表各行按 Anthropic 官方文档整理（截至 2026-10-15）；4.x 模型此前已在 QCode 上实测可调用，5 系尚未在 QCode 上逐项实测。5 系选型见 模型选择。

与旧 Extended Thinking 的关键差异¶

简短规则：4.6 及以后的模型都用 adaptive；4.5 及以前才用 budget_tokens（这些旧模型对 type: "adaptive" 会返回 400）。

支持模型矩阵¶

上述 4.x 模型此前已在 QCode 上实测可调用；5 系的参数行为按官方文档，各型号单价与可用状态以 qcode.cc/models 为准。

effort 参数：思考深度的粗调旋钮¶

effort 控制 adaptive thinking 的整体强度（包括思考 tokens、工具调用次数、回答详尽度），在请求里写作 output_config.effort。

经验法则：Opus 5.5 与 Haiku 5.5 默认 medium，Sonnet 5.5 在 API 上默认 high；官方建议换模型后重新跑一遍自己的评测，不要把旧模型的档位直接照搬。xhigh 适合长 agent loop（如多步骤代码审查、深度调研）；max 仅在正确性远比成本重要时启用。提高档位时同时调大 max_tokens，因为思考 tokens 也计入输出上限。

改 effort 会让提示缓存失效：同一会话里保持思考配置与 effort 不变才能持续命中缓存；中途调整请用官方的「按消息调整 effort」（beta，需 beta 头 mid-conversation-output-config-2026-07-01，Opus 5.5、Sonnet 5.5、Haiku 5.5 等支持）。

API 调用示例¶

Python（anthropic SDK）¶

import anthropic

client = anthropic.Anthropic(
    base_url="https://api.qcode.cc/api",
    api_key="cr_xxxxxxxx",
)

response = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=16000,
    thinking={"type": "adaptive"},
    output_config={"effort": "high"},
    messages=[{"role": "user", "content": "重构 user service 模块的认证逻辑..."}],
)

for block in response.content:
    if block.type == "thinking":
        print(f"[思考] {block.thinking}")
    elif block.type == "text":
        print(f"[回答] {block.text}")

TypeScript（@anthropic-ai/sdk）¶

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({
  baseURL: "https://api.qcode.cc/api",
  apiKey: "cr_xxxxxxxx",
});

const response = await client.messages.create({
  model: "claude-opus-5-5",
  max_tokens: 16000,
  thinking: { type: "adaptive" },
  output_config: { effort: "high" },
  messages: [{ role: "user", content: "重构 user service..." }],
});

Claude Code CLI¶

Claude Code 里用 /effort 调整：不带参数会打开滑块，/effort high 直接设置，/effort auto 清除已保存的档位；也可以在启动时用 --effort 参数，或设置环境变量 CLAUDE_CODE_EFFORT_LEVEL。当前档位显示在会话顶部模型名旁边。各模型可选档位：Opus 5.5 / Sonnet 5.5 / Haiku 5.5 / Opus 5 / Sonnet 5 / Opus 4.8 / Opus 4.7 为 low、medium、high、xhigh、max；Opus 4.6 与 Sonnet 4.6 为 low、medium、high、max。

Claude Code 的默认档（官方文档，截至 2026-10-15）：Opus 5.5、Sonnet 5.5、Haiku 5.5 为 medium，Opus 4.7 为 xhigh，其他支持 effort 的模型为 high。这几个 5.5 模型的思考无法关闭，想少思考就降低 effort。

思考内容的渲染¶

5 系模型（含 Opus 5.5、Sonnet 5.5、Haiku 5.5）默认不显示思考文本（display 默认 "omitted"），只在内部推理，思考 tokens 仍照常计费。如果想在 UI 里展示思考过程：

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

display: "summarized" 让模型输出思考摘要（可见的 thinking blocks）；omitted 只统计思考 tokens 不输出文本。

Task Budgets（Beta）¶

如果你跑 agent loop 想给整个回合（包括思考 + 工具 + 最终输出）一个全局上限，用 task_budget。官方文档列出 Opus 5.5、Sonnet 5.5、Haiku 5.5、Opus 5、Opus 4.8、Opus 4.7 等为 beta 支持，Sonnet 5 不支持：

response = client.beta.messages.create(
    betas=["task-budgets-2026-03-13"],
    model="claude-opus-5-5",
    max_tokens=64000,
    thinking={"type": "adaptive"},
    output_config={
        "effort": "high",
        "task_budget": {"type": "tokens", "total": 128000},
    },
    messages=[...],
)

模型看到剩余预算的倒计时，会自我调节避免超支。最小 total 是 20,000，更小的值会返回 400。

成本观测建议¶

启用 adaptive thinking 后输入 / 输出 token 会上升，需要监控：

print(response.usage)
# 关注：input_tokens、output_tokens、cache_read_input_tokens
# Adaptive thinking 不会单独计费 thinking tokens —— 它们按输出 token 计费，计入 output_tokens

QCode 按 token 计费，各模型单价见 qcode.cc/models。请求会上报到 probe.qcode.cc，可以在那里看每次请求的 input / output / 思考占比。

常见问题¶

budget_tokens 升级到 adaptive thinking 怎么换算？¶

没有线性换算关系。budget_tokens=8000 不等于某个 effort 级别。建议从 effort: "medium" 开始测，根据回答质量与 token 用量再调整。如必须有硬上限，可用 task_budget（见上）。

我的请求在 Opus 4.7 / 4.8 / 5 系上 400 报错说 budget_tokens 不允许¶

把 thinking={"type": "enabled", "budget_tokens": N} 全部改成 thinking={"type": "adaptive"}。Opus 4.7 及以后的模型不再支持 budget_tokens（任何值都 400）。

Sonnet 4.6 上要不要继续用 budget_tokens？¶

不建议。新代码一律用 adaptive thinking。budget_tokens 在 4.6 仍工作但属于 deprecated 路径。

想关掉思考，Opus 5.5 返回 400 怎么办？¶

Opus 5.5 的思考无法关闭。想让它少思考，降低 effort（例如 low）。Sonnet 5.5 用 thinking: {"type": "between_tools"}，Haiku 5.5 用 thinking: {"type": "disabled"}，两者都只在 effort 为 high 及以下时可用。

Claude Code CLI 怎么改 effort？¶

用 /effort（见上文），或启动时加 --effort；持久化默认值写在 ~/.claude/settings.json 里的 effortLevel 或按模型的 modelSettings。

下一步¶

• 模型选择指南 — 各模型定价、能力对比
• 最佳实践 — 大上下文、agent 工作流的 prompt 技巧
• 接入点与 API 格式 — QCode.cc 接入域全表
• Claude Code 完整教程 — CLI 全功能用法

企业团队版 →