Claude 4.7 Opus 引入三项变化：①temperature、top_p、top_k 采样参数被忽略（不报错，但无效）；②推理模式只剩自适应思考，reasoning.max_tokens 和 reasoning.effort 均被忽略；③新增 verbosity: 'xhigh' 努力等级（位于 high 和 max 之间）。verbosity 成为影响响应质量的唯一可调参数，映射到 Anthropic 的 output_config.effort。

Claude 4.7 Opus 在 4.6 基础上进一步简化了参数体系。本文记录三项关键变化。

官方迁移说明：Anthropic - Migrating to Claude Opus 4.7

变化一：采样参数被移除

Claude 4.7 Opus 不再接受 temperature、top_p、top_k。传入这些参数不会报错，但会被静默忽略，请求仍然成功：

// 这些参数在 Claude 4.7 Opus 上被忽略
{
  "model": "anthropic/claude-4.7-opus",
  "temperature": 0.5,
  "top_p": 0.9,
  "top_k": 50,
  "messages": [{ "role": "user", "content": "Hello" }]
}

变化二：纯自适应思考

Claude 4.7 Opus 只支持自适应思考——当推理启用时，唯一的模式就是自适应。4.6 上的预算式思考（reasoning.max_tokens / thinking.budget_tokens）在 4.7 上已移除。

注意：推理本身仍然是可选的，默认关闭，需要通过 reasoning.enabled: true 开启。

// 开启自适应思考（4.7 唯一支持的推理模式）
{
  "model": "anthropic/claude-4.7-opus",
  "reasoning": { "enabled": true },
  "messages": [{ "role": "user", "content": "Solve this problem step by step" }]
}

在 4.7 上，下面这两个请求等效（max_tokens 和 effort 均被忽略）：

// 等效于 { "reasoning": { "enabled": true } }
{
  "model": "anthropic/claude-4.7-opus",
  "reasoning": { "enabled": true, "max_tokens": 10000 }
}

// 等效于 { "reasoning": { "enabled": true } }
{
  "model": "anthropic/claude-4.7-opus",
  "reasoning": { "enabled": true, "effort": "low" }
}

变化三：新增 xhigh 努力等级

verbosity 参数新增 'xhigh' 等级，位于 'high' 和 'max' 之间：

{
  "model": "anthropic/claude-4.7-opus",
  "verbosity": "xhigh"
}

完整努力等级序列：low → medium → high → xhigh → max

• 'xhigh' 仅在 Claude 4.7 Opus 上支持，旧版模型自动降级为 'high'
• 'max' 从 4.6 起支持，在 4.7 上继续有效

参数总结

移除采样参数和推理预算后，verbosity（映射到 output_config.effort）成为影响响应质量的唯一可调参数：

参数	Claude 4.7 Opus 行为
temperature / top_p / top_k	被忽略
reasoning.effort	被忽略（使用自适应）
reasoning.max_tokens	被忽略（使用自适应）
verbosity	正常工作，控制整体响应努力程度

{ "model": "anthropic/claude-4.7-opus", "verbosity": "xhigh" }

与 4.6 的完整对比

功能	Opus 4.6	Opus 4.7
temperature / top_p / top_k	支持	被忽略
推理时的思考模式	自适应或预算式	只有自适应
reasoning.max_tokens	预算式思考	被忽略
reasoning.effort	被忽略（自适应）	被忽略（自适应）
verbosity: 'xhigh'	降级为 high	支持
verbosity: 'max'	支持	支持

常见问题

Q: 移除 temperature 参数会影响输出的多样性吗？

A: 是的，Claude 4.7 Opus 的输出由模型内部决定，不再受外部温度参数控制。Anthropic 认为这一设计让模型能够更好地控制输出质量，而不是依赖随机采样参数。如果你的应用严重依赖温度参数控制输出风格，需要评估是否适合迁移到 4.7。

Q: verbosity: 'xhigh' 和 verbosity: 'max' 在实际输出上有什么区别？

A: xhigh 介于 high 和 max 之间，代表更详细、更彻底的响应，但不会达到 max 那样的极限详细程度。max 会产生最全面的输出，但同时也意味着更多 token 消耗和更高延迟。选择时需要在响应质量和成本之间权衡。

Q: 我的代码中有 reasoning.max_tokens，迁移到 4.7 需要删除这些参数吗？

A: 不需要，保留这些参数不会导致请求失败，只是会被忽略。如果你想保持代码整洁，可以在迁移时清理这些参数，但这不是必须的。