跳到主要内容
Router One
注册
返回博客

Claude Opus 5.5 API 接入指南：模型 ID、端点与国内调用

发布约 9 分钟读完作者Router One 团队方法说明
Claude Opus 5.5ClaudeAnthropicClaude Code模型选型API 网关指南

Claude Opus 5.5 已经在 Router One 目录里上架，目录 id 是 anthropic/claude-opus-5.5（2026-09-24 观察）；网关同时接受 Anthropic 官方 id claude-opus-5-5 作为它的别名。国内开发者不需要海外账号、不需要 VPN：用 Router One 的 Key 向 https://api.router.one/v1/messages 发 "model": "claude-opus-5-5"，或者把 OpenAI 兼容客户端的 base URL 换成 https://api.router.one/v1，请求就会像目录里其他模型一样被路由、计费并记入日志；实时单价看模型页。

本文讲清六件事：目录对这个 id 公开了什么、Anthropic 官方又补充了什么、费用怎么算、订阅套餐是否覆盖、两个端点上的第一个请求怎么发，以及从 Claude Opus 5 迁过来时有哪些变化。文中的目录与套餐信息都注明了观察日期，发起新请求前以实时目录为准。

Claude Opus 5.5 速览

项目目录所列（2026-09-24）
目录 idanthropic/claude-opus-5.5
短 id（别名）claude-opus-5-5，即 Anthropic 官方模型 id
上下文窗口1,048,576 token
输入 / 输出文本、图像输入，文本输出
能力标签chat、streaming、tool calling、vision
价格线一条，覆盖整个窗口，没有长上下文阶梯
端点POST /v1/messages（Anthropic 原生，推荐）与 POST /v1/chat/completions
不在此端点服务POST /v1/responses
渠道 id无，没有 aws/、vertex/ 或 azure/ 版本

Anthropic 官方的 Claude Opus 5.5 概览页补充了目录里没有的信息：发布日期为 2026 年 9 月 22 日，上下文 1M token，同步 Messages API 下最多输出 128K token，知识截止 2026 年 6 月，定位是 "for long-running agentic coding and knowledge work"（面向长时间运行的 Agent 编码与知识工作）。自适应思考始终开启，思考深度由 output_config.effort 控制，可取 low、medium、high、xhigh 与 max，默认 medium（effort 文档）。以上是厂商的说法；Router One 负责的是目录条目本身，以及网关如何路由和计费。

在 Router One 的 Claude 阵容里处在什么位置

2026-09-24 目录共 63 个 id（56 个文本、7 个图像），与前一天相比只新增了 Claude Opus 5.5。默认渠道的 Claude id 有 anthropic/claude-fable-5、anthropic/claude-opus-5.5、anthropic/claude-opus-5、anthropic/claude-opus-4.8、anthropic/claude-opus-4.7-thinking、anthropic/claude-opus-4.6、anthropic/claude-opus-4.6-thinking、anthropic/claude-sonnet-5、anthropic/claude-sonnet-4.6、anthropic/claude-sonnet-4.6-thinking 与 anthropic/claude-haiku-4.5。它们同属 Claude 端点系列；真正的差别在各自模型页上的规格与单价，以及它们在你自己的提示词上表现如何——本文不做排名。

三个对比页用实时目录把规格和单价并排渲染出来：

AWS 与 Google Cloud 渠道的 Claude id 只到 Claude Opus 5（aws/claude-opus-5、vertex/claude-opus-5），Azure 渠道没有 Claude id，所以在 Router One 上，Claude Opus 5.5 只在默认渠道提供。渠道前缀改变了什么，见渠道模型 id 指南。id 会上会下，写死之前先到模型目录确认。

费用怎么算

模型页公示输入与输出单价，适用于整个 1,048,576 token 窗口：目录没有给 Claude Opus 5.5 设长上下文阶梯，一次几乎填满窗口的请求和一次短请求按同一条价格线计费。

Claude Opus 5.5 的自适应思考对每个请求都开着、无法关闭（思考强度较低时，简单请求可能不思考）。思考 token 按输出 token 计，适用模型公示的输出单价（价格事实页）；响应里不返回思考文本时（这正是该模型的默认设置）也照样计费（Anthropic 迁移指南）。所以思考强度既是质量旋钮，也是成本旋钮：强度越高，单次请求的输出 token 通常越多。先在你打算长期使用的强度上按任务实测，再定默认值。

本文不印每 token 单价，因为它会过时。实时单价看模型页，上面的对比页会渲染它与 Claude Opus 5、GPT-6 Sol、Claude Sonnet 5 之间的价差。

订阅套餐覆盖 Claude Opus 5.5 吗？

截至 2026-09-24 的套餐接口：Pro、Max、Ultra 的任何档位都没有列出 claude-opus-5-5，所以不论是否持有套餐，Claude Opus 5.5 的调用都按 token 从钱包余额扣费，单价以模型页公示为准。Claude Opus 5 仍在三个套餐的「高级模型」档。套餐的模型列表会调整，实时列表以价格页为准。

影响最大的是 Claude Code。从 v2.1.280 起，Claude Code 里 Anthropic API 账号的默认模型和 opus 别名都指向 Claude Opus 5.5（模型配置文档），而 Claude Code 会把通过 ANTHROPIC_BASE_URL 接入的网关当作 Claude API 对待（网关协议文档），所以指向 Router One 的会话，只要没有固定模型，就会发 claude-opus-5-5。Router One 的一键安装脚本只设置 ANTHROPIC_BASE_URL 与 ANTHROPIC_AUTH_TOKEN，不指定模型。也就是说，订阅用户升级 Claude Code 之后，一项设置都没改，计费就从套餐配额变成了钱包扣费；想继续用套餐额度，就同时设置 ANTHROPIC_MODEL=claude-opus-5 与 ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5（后者让 opus 别名也指向 Claude Opus 5）。模型固定、后台任务、思考强度与 1M 窗口的完整配置，见 Claude Code 默认 Opus 5.5 之后的配置。

发出第一个请求

  1. 创建 Key。 Dashboard → API Keys → New key，Key 形如 sk-rk-...。试用阶段给这把 Key 设一个 maxSpend 消费上限：花费不会超过这个上限，其他 Key 照常可用（按 Key 成本追踪）。
  2. 按客户端选 base URL。 Anthropic 原生 SDK 和工具填 https://api.router.one（SDK 的 base_url，或 ANTHROPIC_BASE_URL），请求发往它下面的 /v1/messages；OpenAI 兼容 SDK 填 https://api.router.one/v1。
  3. 调用模型。 下面的示例都用 claude-opus-5-5；直接发 HTTP 请求时，目录 id anthropic/claude-opus-5.5 同样可用。

Messages API，流式输出，并显式设置思考强度（厂商默认为 medium）：

bash
curl https://api.router.one/v1/messages \
  -H "x-api-key: sk-your-api-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-opus-5-5",
    "max_tokens": 16000,
    "stream": true,
    "output_config": {"effort": "medium"},
    "messages": [{"role": "user", "content": "审阅这份迁移方案，列出风险最高的三个步骤。"}]
  }'

用 Anthropic Python SDK 调用（请用新版 SDK：pip install -U anthropic），只需要改 base_url 和 Key。响应可能以一个或多个 thinking 块开头，所以要按块的类型读取内容，不要按位置取：

python
import anthropic

client = anthropic.Anthropic(
    base_url="https://api.router.one",
    api_key="sk-your-api-key",
)

with client.messages.stream(
    model="claude-opus-5-5",
    max_tokens=16000,
    output_config={"effort": "medium"},
    messages=[{"role": "user", "content": "审阅这份迁移方案，列出风险最高的三个步骤。"}],
) as stream:
    message = stream.get_final_message()

for block in message.content:
    if block.type == "text":
        print(block.text)
print(message.stop_reason, message.usage)

Chat Completions，给 OpenAI 兼容客户端用，同样显式设置 max_tokens 并开启流式：

bash
curl https://api.router.one/v1/chat/completions \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-5-5",
    "max_tokens": 16000,
    "stream": true,
    "messages": [{"role": "user", "content": "审阅这份迁移方案，列出风险最高的三个步骤。"}]
  }'

两个端点通用的四条规则：

  • 每个请求都显式设置 max_tokens。 思考和正文共用这个上限，而 Claude Opus 5.5 的思考无法关闭，所以不要依赖默认值，要给两者都留出空间。用 xhigh 或 max 时，Anthropic 迁移指南建议从 64,000 起步。
  • 长任务用流式。 stream: true 让输出边生成边返回，不必一直占着连接等整段长回答完成（流式输出指南）。
  • 保持充足的钱包余额。 请求执行前，网关会按预估额从余额中预留；余额不够时，网关会把 max_tokens 调低到余额能覆盖的数值，长回答可能因此被截断。
  • 不要传 temperature、top_p、top_k。 在这个模型上，Anthropic 对非默认值返回 400。

端点怎么选。 Claude Opus 5.5 推荐走 /v1/messages：output_config.effort、带 display 选项的 thinking 以及 anthropic-beta 请求头都原样透传，也会保留你在工具循环里传回的 thinking 块。/v1/chat/completions 能用于普通对话和工具调用，但不转发 anthropic-beta 请求头，也不会跨轮回放思考块，所以多轮工具循环仍能跑通，只是丢失了推理的连续性。要 JSON 输出，请用 /v1/messages 加 output_config.format，或者用 strict 工具并把 tool_choice 设为 auto（见 Anthropic 结构化输出文档）；Chat Completions 的 response_format 不是从 Claude id 拿到 JSON 的可靠办法。另外，Router One 的 /v1/messages/count_tokens 返回的是本地估算，不是 Anthropic 的计数——实际计费的数字以每次响应里的 usage 为准。

  1. 看 Trace。 Dashboard → Logs 里每次调用都带模型、输入输出 token、费用、延迟和状态（每请求可观测）。参数错误导致的 400 不会被重试，也不会换到别的模型：失败的 Claude Opus 5.5 请求绝不会被 Claude Opus 5 或其他模型悄悄代答。

与 Claude Opus 5 相比有哪些变化

Anthropic 的 What's new 页列出了四项不兼容改动和若干行为差异，迁移指南把它们整理成了检查清单。简要来说：

  • 思考无法关闭。 thinking: {"type": "disabled"} 与 {"type": "enabled", "budget_tokens": N} 都返回 400；要么不传 thinking，要么传 {"type": "adaptive"}，用 output_config.effort 控制思考强度。
  • 默认思考强度是 medium，比 Claude Opus 5 的 high 低一档。提示词如果是按旧默认值调的，请显式设置。
  • 强制工具调用返回 400。 tool_choice 的 any 与 tool 会被拒绝；改用 auto 加 strict 工具，并在提示词里写明什么时候该用这个工具，要 JSON 就用结构化输出。
  • 思考块与模型和会话绑定。 工具循环里要把思考块原样传回，并按 type 读取内容；工具调用之间的文字现在以 thinking 块返回，在默认的 display: "omitted" 下是空的。
  • Computer use 改用 computer_toolset_20260801。 在 Claude API 与 Google Cloud 上，computer_20251124 会被拒绝。
  • 拒答以 HTTP 200 加 stop_reason: "refusal" 返回。在 Router One 上，请在自己的代码里换一个模型重试：服务端的 fallbacks 参数会在请求到达模型之前被 400 拒绝。

经 Router One 调用 Claude Opus 5.5 时（两种 id 都适用），网关会在两个端点上做兼容处理，避免遗留参数导致请求失败：旧式 thinking 设置改写为自适应思考（disabled 且没有设思考强度的请求，会补上 effort: "low"），去掉 temperature、top_p、top_k，把强制 tool_choice 降级为 auto，并把 Chat Completions 的 reasoning_effort 映射到 output_config.effort（none 与 minimal 映射为 low）。请求仍被 400 拒绝时，非流式 /v1/messages 通常会返回 Anthropic 的报错原文；prompt is too long: … 这类参数校验报错，现在在流式 /v1/messages 和 /v1/chat/completions 上也会原样返回，这两条路径上的其他 400 则统一返回通用提示 invalid request (upstream rejected with status 400)。代码仍然要改——直连 Anthropic 会对同样的参数返回 400，其他网关也可能如此；而且强制工具调用被降级后，模型可能直接用文字回答，所以要检查 stop_reason 和内容块类型，不要默认一定会有工具调用。每项改动的前后对照代码，见迁移到 Claude Opus 5.5。

国内怎么用

中国大陆可直连 api.router.one，无需 VPN，Key 和 base URL 与海外完全一致，Claude Code 也一样。充值可用支付宝或银行卡在同一个托管收银台完成，也支持 6 条链上的 USDT/USDC（Tron、BSC、以太坊、Polygon、Base、Arbitrum），无需美国信用卡。Claude Code 的两个环境变量怎么设，见 Claude Code 国内使用；一步步的配置教程见 Claude Code 配置指南。

常见问题

Claude Opus 5.5 在 Router One 上的模型 id 是什么？ 目录 id 是 anthropic/claude-opus-5.5；自 2026-09-24 起，网关也接受 Anthropic 官方 id claude-opus-5-5，指向同一个模型。在 Claude Code 以及按模型名识别模型的 SDK 里，请用 claude-opus-5-5，因为它们只对官方 id 应用 Opus 5.5 的行为。claude-opus-5.5、anthropic/claude-opus-5-5 这两种写法以及任何 -thinking 变体，网关都不接受。

Claude Code 能用 Claude Opus 5.5 吗？ 能，要求 Claude Code v2.1.280 及以上。指向 Router One 后，只要没有固定其他模型，Claude Code 默认就发 claude-opus-5-5。请保持官方 id（或 /model opus），不要改成目录 id：用 anthropic/claude-opus-5.5 时，Claude Code 会套用 Claude Opus 5 的默认设置。

经 Router One 调用 Claude Opus 5.5 多少钱？ 按 token 计费，单价以 Claude Opus 5.5 模型页公示的输入与输出单价为准：整个窗口只有一条价格线，思考按输出 token 计费。对比页会实时渲染它与 Claude Opus 5、GPT-6 Sol、Claude Sonnet 5 之间的价差。截至 2026-09-24，不论是否持有套餐，每次调用都从钱包余额扣费。

Router One 的订阅套餐包含 Claude Opus 5.5 吗？ 截至 2026-09-24 的套餐接口不包含：Pro、Max、Ultra 的任何档位都没有列出它，调用按 token 从钱包余额扣费。Claude Opus 5 在三个套餐的「高级模型」档，所以想让 Claude Code 继续用套餐额度的订阅用户，可以同时设置 ANTHROPIC_MODEL=claude-opus-5 与 ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5。

Codex CLI 或 Responses API 能调用 Claude Opus 5.5 吗？ 不能。Router One 在 /v1/messages 与 /v1/chat/completions 上提供 Claude 系列；/v1/responses 不提供 Claude id。Codex CLI 只支持 Responses 协议，所以让它继续用 /v1/responses 上提供的 id，比如 GPT 系列。

有 AWS 或 Google Cloud 渠道版的 Claude Opus 5.5 吗？ 截至 2026-09-24 没有。aws/ 与 vertex/ 的 Claude id 只到 Claude Opus 5，也没有 azure/ 的 Claude id。

经 Router One 能用快速模式（fast mode）吗？ 不能。对 Claude Opus 5.5，Router One 会在请求到达模型之前以 HTTP 400 拒绝 speed "fast"，所以 Claude Code 的 /fast 经 Router One 也用不了。对延迟敏感的任务，可以试试更低的思考强度。

最大输出是多少？长回答为什么被截断了？ Anthropic 文档写明同步 Messages API 最多输出 128K token，思考也计入 max_tokens。请显式设置 max_tokens 并给两者留出空间，长任务用流式，并检查 stop_reason：值为 max_tokens 表示触到了上限。钱包余额也要充足：余额不够覆盖一次请求的预估额时，网关会调低 max_tokens，长回答可能因此提前结束。

下一步

相关权威页面

这篇文章归入「Claude Code 中国」主题，以下页面作为商业页、配置文档、证据页和信任事实源。

商业主页面Claude Code 中国主页面承接 Claude Code 免 VPN、支付、配置和信任信息的转化页面。编辑器接入Cursor 国内接入在 Cursor 里填自定义 Base URL 和 Key，与 CLI 工具共用同一个钱包和请求 trace。桌面客户端Chatbox / Cherry Studio 接入不碰命令行也能把两个桌面客户端指向网关。配置文档Claude Code 与 CLI 配置Claude Code 和 OpenAI 兼容工具可复制的环境变量配置。证据页中国延迟基准测试公开 p50 延迟、超时率、样本窗口、城市和运营商说明。对比页OpenRouter 替代方案聚焦中国路由、本地支付和开发者工作流的克制对比。信任页安全边界直接 API 调用仅保留请求元数据、不留存 prompt/回复正文；Playground 保存会话历史。数据留存数据留存政策网关请求中 prompt 与 completion 正文的留存边界。

相关阅读

Claude Code 默认 Opus 5.5 之后：固定模型、套餐额度与 1M 上下文

Claude Code 默认换成 Opus 5.5，截至 2026-09-24 经 Router One 调用从钱包扣费。切回 Opus 5 可用套餐额度，后台任务交给 Haiku 4.5。

查看

迁移到 Claude Opus 5.5：不兼容改动与 400 报错排查

Opus 5 代码迁到 claude-opus-5-5：四项不兼容改动、400 报错原文与改法、前后对照 JSON、Router One 网关兜底的范围，以及各客户端和 SDK 是否就绪。

查看

Claude Skills 详解：构建可复用的 Agent 能力

Claude Skills 让 Agent 按需获取专业能力。本文讲清模型、带你写第一个 Skill，并给出在生产环境安全交付 Skill 的最佳实践。

查看