Claude Opus 4.7 新参数指南

推理时代阅读约 3 分钟
Claude Opus 4.7 新参数指南

1. 新的推理控制功能

✦ 新的 xhigh 推理努力级别

新的 xhigh 级别位于 high 和 max 之间,专为 编码和代理任务 设计,在能力和效率之间取得了更好的平衡。

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

✦ 默认情况下隐藏思考内容

在流式响应中,思考过程 默认不再显示。要接收推理摘要,请在请求中显式传递 display 字段:

显示值Opus 4.7Opus 4.6行为
”省略”默认非默认思考块内容为空
”总结”必须手动设置默认返回思考摘要文本
"reasoning": {
  "effort": "xhigh",
  "display": "summarized"
}
: Opus 4.7 新的 xhigh 级别 — 代理编码性能比较(来源:Anthropic 官方)
图片

2. Claude 原生 API 参考

Anthropic 原生 API 的 effort 值与官方规范一致:

努力值支持的模型描述推荐用例
所有支持的模型显著的令牌节省,能力适度折衷简单任务,高并发请求,子代理
所有支持的模型平衡模式,适度的令牌节省一般代理任务
所有支持的模型默认;高能力性能复杂推理、编码、代理任务
xhigh(新)仅限 Opus 4.7在高和最大之间扩展能力;在长时间任务中表现出色推荐用于编码和代理任务的起始点
最大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": "一只蜗牛在一个10米深的井底。每天它爬升3米,但每晚又滑回2米。它需要多少天才能到达井口?"
        }
    ]
)

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

3. AIHubmix Chat 统一接口中的推理努力支持

AIHubMix Chat 统一接口与 OpenAI 规范一致,通过 reasoning.effort 控制推理强度。 不同的 Claude 模型会自动映射到相应的努力级别:

reasoning_effort (Claude 模型的推理强度控制)

努力值Opus >=4.7(新)Opus 4.6 / 4.5Sonnet 4.6
最小
xhighxhighmax
最大最大最大

注意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": "一只蜗牛在一个10米深的井底。每天它爬升3米,但每晚又滑回2米。它需要多少天才能到达井口?"
        }
    ],
    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": "一只蜗牛在一个10米深的井底。每天它爬升3米,但每晚又滑回2米。它需要多少天才能到达井口?"
        }
    ],
    extra_body={
        "reasoning": {"effort": "xhigh", "display": "summarized"}
    }
)

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

有关更多详细信息,请参阅 AIHubmix 文档Anthropic 官方文档

最后更新:2026-06-01