本文介绍 Claude Opus 4.7 在推理控制上的两项关键变化,并给出 AIHubmix 原生 API 与 Chat 统一接口两种用法的完整说明。延伸阅读:Anthropic 官方公告 与 模型更新日志。

1. Opus 4.7 新增了哪些推理控制能力?
✦ 新增 xhigh 推理强度档位
新增的 xhigh 档位介于 high 与 max 之间,专为编码与 Agent 类任务设计,在能力与效率之间取得了更好的平衡。
✦ 思考内容默认隐藏
在流式响应中,思考过程默认不再展示。若需获取推理摘要,请在请求中显式传入display 字段:
| display 取值 | Opus 4.7 | Opus 4.6 | 行为 |
|---|---|---|---|
| ”omitted” | 默认 | 非默认 | 思考块内容为空 |
| ”summarized” | 需手动设置 | 默认 | 返回思考摘要文本 |
图:Opus 4.7 新增 xhigh 档位 —— Agent 编码性能对比(来源:Anthropic 官方)

2. Claude 原生 API 参考
Anthropic 原生 API 的 effort 取值与官方规范保持一致:
| effort 取值 | 支持的模型 | 说明 | 推荐场景 |
|---|---|---|---|
| low | 所有支持的模型 | 显著节省 token,能力适度折中 | 简单任务、高并发请求、子 Agent |
| medium | 所有支持的模型 | 均衡模式,适度节省 token | 通用 Agent 任务 |
| high | 所有支持的模型 | 默认值;高能力表现 | 复杂推理、编码、Agent 任务 |
| xhigh(新增) | 仅 Opus 4.7 | 介于 high 与 max 之间的增强能力;擅长长周期任务 | 编码与 Agent 任务的推荐起点 |
| max | Opus 系列 | 最高能力 | 前沿研究类难题 |
AIHubmix Claude 原生 API —— Opus 4.7 示例
3. AIHubmix Chat 统一接口对推理强度的支持
AIHubMix Chat 统一接口对齐 OpenAI 规范,通过reasoning.effort 控制推理强度。不同的 Claude 模型会自动映射到对应的 effort 档位:
Claude 模型的 reasoning_effort(推理强度控制)
| effort 取值 | Opus >=4.7(新增) | Opus 4.6 / 4.5 | Sonnet 4.6 |
|---|---|---|---|
| minimal | low | low | low |
| medium | medium | medium | medium |
| high | high | high | high |
| xhigh | xhigh | max | high |
| max | max | max | high |
xhigh 仅 Opus 4.7 原生支持。其他 Opus 模型会自动回退到 max,Sonnet 系列回退到 high。
Chat 统一接口 —— Opus 4.7 示例
4. 如何在 Chat 统一接口中控制思考内容?
在 OpenAI 兼容接口中,reasoning 支持 display 字段,用于控制是否返回思考摘要。
Claude Opus 4.7 默认不返回思考内容。设置 "display": "summarized" 即可开启。
| 字段 | 取值 | 说明 |
|---|---|---|
display | (省略) | 不返回思考内容(默认) |
display | "summarized" | 返回思考摘要 |