Claude Opus 4.7 新参数指南

Claude Opus 4.7 推理控制实操指南：新增 xhigh 档位、思考内容默认隐藏，附 AIHubMix 原生 API 与 Chat 统一接口的完整调用示例。

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

​

1. Opus 4.7 新增了哪些推理控制能力？

​

✦ 新增 xhigh 推理强度档位

新增的 xhigh 档位介于 high 与 max 之间，专为编码与 Agent 类任务设计，在能力与效率之间取得了更好的平衡。

low  ──  medium  ──  high  ──  xhigh ★NEW  ──  max

​

✦ 思考内容默认隐藏

在流式响应中，思考过程默认不再展示。若需获取推理摘要，请在请求中显式传入 display 字段：

display 取值	Opus 4.7	Opus 4.6	行为
”omitted”	默认	非默认	思考块内容为空
”summarized”	需手动设置	默认	返回思考摘要文本

"reasoning": {
  "effort": "xhigh",
  "display": "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 示例

from anthropic import Anthropic

client = Anthropic(
    api_key="<AIHUBMIX_API_KEY>",
    base_url="https://aihubmix.com"
)

response = client.messages.create(
    model="claude-opus-4-7",
    max_tokens=16000,
    thinking={"type": "adaptive"},
    output_config={"effort": "xhigh"},  # 可选：low / medium / high / xhigh / max
    messages=[
        {
            "role": "user",
            "content": "A snail is at the bottom of a 10-meter well. Each day it climbs 3 meters, but each night it slides back 2 meters. How many days does it take to reach the top?"
        }
    ]
)

print(response.content[-1].text)

---

​

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 示例

from openai import OpenAI

client = OpenAI(
    base_url="https://aihubmix.com/v1",
    api_key="<AIHUBMIX_API_KEY>",
)

completion = client.chat.completions.create(
    model="claude-opus-4-7",
    # max_tokens=10000,  # 默认 4096；需要更长输出时开启
    messages=[
        {
            "role": "user",
            "content": "A snail is at the bottom of a 10-meter well. Each day it climbs 3 meters, but each night it slides back 2 meters. How many days does it take to reach the top?"
        }
    ],
    extra_body={
        "reasoning": {"effort": "xhigh"}
    }
)

print(completion.choices[0].message.content)

---

​

4. 如何在 Chat 统一接口中控制思考内容？

在 OpenAI 兼容接口中，reasoning 支持 display 字段，用于控制是否返回思考摘要。

Claude Opus 4.7 默认不返回思考内容。设置 "display": "summarized" 即可开启。

字段	取值	说明
display	（省略）	不返回思考内容（默认）
display	"summarized"	返回思考摘要

​

Opus 4.7 —— 思考摘要示例

from openai import OpenAI

client = OpenAI(
    base_url="https://aihubmix.com/v1",
    api_key="<AIHUBMIX_API_KEY>",
)

completion = client.chat.completions.create(
    model="claude-opus-4-7",
    messages=[
        {
            "role": "user",
            "content": "A snail is at the bottom of a 10-meter well. Each day it climbs 3 meters, but each night it slides back 2 meters. How many days does it take to reach the top?"
        }
    ],
    extra_body={
        "reasoning": {"effort": "xhigh", "display": "summarized"}
    }
)

print(completion.choices[0].message.content)

---

​

更多细节请参阅 AIHubmix 文档 或 Anthropic 官方文档。

更新时间：2026-06-26