Claude Opus 5.5 接入实战：缓存与 effort 调优省下四成

9 月 22 日 Anthropic 发布 Claude Opus 5.5（API 名 claude-opus-5-5）。本文只做一件事：从接入与成本角度，把这一代模型在国内环境怎么调起来、账单怎么压住、常见报错怎么解讲清楚。不评测、不站队，只给能直接用的步骤。

一、这次到底改了什么

• 模型 ID：claude-opus-5-5，9/22 起在 Claude API、Bedrock、Google Cloud、Microsoft Foundry 同步上线。
• 上下文：默认 1M token，单次输出 128K（Batches 走 beta 头可到 300K）。
• Thinking：自适应思考常开、不能关闭；用 effort 参数（low / medium / high / xhigh / max，默认 medium）控制深度。
• 价格：发布价约为每百万输入 4 美元 / 输出 20 美元，缓存读 0.20 美元，缓存写 5 分钟 5 美元 / 1 小时 8 美元，Batch 五折。（具体以官方最新定价为准）
• 四个破坏性变更：thinking 不能禁用、强制 tool_choice 报错、thinking 块绑定产出它的模型与对话、旧版 computer use 工具在 API 上被拒。

二、国内环境调 Claude 的常见卡点

• 区域与网络：直连官方常遇不稳定，需要在合规前提下选稳定的访问路径。
• 额度：新号低频、首笔易触发风控。
• Claude Code 限制：CLI 默认指向官方，需要手动改 base_url 才能走兼容接口。
• thinking 不可关：老代码写了 thinking disabled 会直接 400，要改成用 effort 控制。

三、用同一套 OpenAI 兼容接口接 Claude

下面用 OpenAI Python SDK 接入。只要把 base_url 指到同一套接口，Claude 和 GPT / DeepSeek 就是同一套调用方式，不用为每个模型单独接 SDK：

import os
from openai import OpenAI

# 将 base_url 指向同一套 OpenAI 兼容接口即可接入 Claude
client = OpenAI(
    api_key=os.environ["OPENAI_API_KEY"],
    base_url="https://easy88ai.com/v1",
)

resp = client.chat.completions.create(
    model="claude-opus-5-5",
    messages=[{"role": "user", "content": "用 Python 写一个快速排序"}],
    extra_body={"effort": "medium"},
)
print(resp.choices[0].message.content)

要点：模型名传 claude-opus-5-5；thinking 不用管，由 effort 控制；extra_body 透传 Anthropic 专属字段即可。

四、Claude Code 配置 base_url 与 Key

如果用 Claude Code 跑 agent，编辑配置文件或环境变量：

export ANTHROPIC_BASE_URL="https://easy88ai.com/v1"
export ANTHROPIC_API_KEY="sk-xxx"

或在 settings 里写：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://easy88ai.com/v1",
    "ANTHROPIC_API_KEY": "sk-xxx"
  }
}

这样 Claude Code 的所有调用都走兼容接口，省去每个项目单独配置。

五、把账单压住：缓存命中与 effort 调优

Opus 5.5 最大的省钱点在缓存读：0.20 美元 / MTok，是输入价的 5%。agent 反复读同一份代码库时，把不变前缀标成可缓存段：

system_prompt = "你是资深 Python 工程师，项目背景与常量定义如下：\n<长期不变的内容>"

resp = client.chat.completions.create(
    model="claude-opus-5-5",
    messages=[{"role": "system", "content": system_prompt},
              {"role": "user", "content": "把 utils.py 的 parse_config 改成支持嵌套字典"}],
    extra_body={"cache_control": {"type": "ephemeral"}, "effort": "medium"},
)

另外 effort 用 medium 而非 max，长任务能少掉不少 token；非复杂任务直接上 Sonnet 档（约 2 / 10 美元）更划算。

提示：文中价格为发布参考价，实际以官方最新定价为准。

六、高频报错排查

小结

Opus 5.5 对长链路 agentic coding 是明显利好：1M 上下文加便宜的缓存读，让反复读大仓库的成本降下来。接入上，用同一套兼容接口加改 Claude Code 的 base_url 就能跑起来；成本上，缓存命中加 effort 调优是两张最实在的牌。先把这两点落进你的编排层，比追任何新基准都管用。