> https://router.one/zh/blog/claude-opus-5-5-api-guide 的 Markdown 镜像，供 AI 助手与爬虫使用。Router One 是 OpenAI 兼容的统一 LLM API 网关。
> 发布：2026-09-24 · 作者：Router One Team

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

_Claude Opus 5.5 经 Router One 调用：claude-opus-5-5 模型 ID、1M 上下文、思考始终开启、套餐是否覆盖、两个端点示例与国内直连。_

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`，请求就会像目录里其他模型一样被路由、计费并记入日志；实时单价看[模型页](https://router.one/zh/models/claude-opus-5-5)。

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

## Claude Opus 5.5 速览

| 项目 | 目录所列（2026-09-24） |
| --- | --- |
| 目录 id | `anthropic/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 概览页](https://platform.claude.com/docs/en/models/opus-5-5/overview)补充了目录里没有的信息：发布日期为 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 文档](https://platform.claude.com/docs/en/build-with-claude/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 端点系列；真正的差别在各自模型页上的规格与单价，以及它们在你自己的提示词上表现如何——本文不做排名。

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

- [Claude Opus 5.5 vs Claude Opus 5](https://router.one/zh/models/compare/claude-opus-5-5-vs-claude-opus-5)——代际升级该不该换。
- [Claude Opus 5.5 vs GPT-6 Sol](https://router.one/zh/models/compare/claude-opus-5-5-vs-gpt-6-sol)——跨厂商怎么选。
- [Claude Opus 5.5 vs Claude Sonnet 5](https://router.one/zh/models/compare/claude-opus-5-5-vs-claude-sonnet-5)——同一类任务用 Opus 还是 Sonnet。

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 指南](https://router.one/zh/blog/azure-aws-vertex-channel-model-ids)。id 会上会下，写死之前先到[模型目录](https://router.one/zh/models)确认。

## 费用怎么算

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

Claude Opus 5.5 的自适应思考对每个请求都开着、无法关闭（思考强度较低时，简单请求可能不思考）。思考 token 按输出 token 计，适用模型公示的输出单价（[价格事实页](https://router.one/zh/facts/pricing.md)）；响应里不返回思考文本时（这正是该模型的默认设置）也照样计费（[Anthropic 迁移指南](https://platform.claude.com/docs/en/models/opus-5-5/migration-guide#thinking-in-every-response)）。所以思考强度既是质量旋钮，也是成本旋钮：强度越高，单次请求的输出 token 通常越多。先在你打算长期使用的强度上按任务实测，再定默认值。

本文不印每 token 单价，因为它会过时。实时单价看[模型页](https://router.one/zh/models/claude-opus-5-5)，上面的对比页会渲染它与 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 仍在三个套餐的「高级模型」档。套餐的模型列表会调整，实时列表以[价格页](https://router.one/zh/pricing)为准。

影响最大的是 Claude Code。从 v2.1.280 起，Claude Code 里 Anthropic API 账号的默认模型和 `opus` 别名都指向 Claude Opus 5.5（[模型配置文档](https://code.claude.com/docs/en/model-config)），而 Claude Code 会把通过 `ANTHROPIC_BASE_URL` 接入的网关当作 Claude API 对待（[网关协议文档](https://code.claude.com/docs/en/llm-gateway-protocol)），所以指向 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 之后的配置](https://router.one/zh/blog/claude-code-opus-5-5-setup)。

## 发出第一个请求

1. **创建 Key。** Dashboard → API Keys → New key，Key 形如 `sk-rk-...`。试用阶段给这把 Key 设一个 `maxSpend` 消费上限：花费不会超过这个上限，其他 Key 照常可用（[按 Key 成本追踪](https://router.one/zh/llm-cost-tracking)）。
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` 让输出边生成边返回，不必一直占着连接等整段长回答完成（[流式输出指南](https://router.one/zh/llm-streaming)）。
- **保持充足的钱包余额。** 请求执行前，网关会按预估额从余额中预留；余额不够时，网关会把 `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 结构化输出文档](https://platform.claude.com/docs/en/build-with-claude/structured-outputs)）；Chat Completions 的 `response_format` 不是从 Claude id 拿到 JSON 的可靠办法。另外，Router One 的 `/v1/messages/count_tokens` 返回的是本地估算，不是 Anthropic 的计数——实际计费的数字以每次响应里的 `usage` 为准。

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

## 与 Claude Opus 5 相比有哪些变化

Anthropic 的 [What's new 页](https://platform.claude.com/docs/en/models/opus-5-5/whats-new-opus-5-5)列出了四项不兼容改动和若干行为差异，[迁移指南](https://platform.claude.com/docs/en/models/opus-5-5/migration-guide)把它们整理成了检查清单。简要来说：

- **思考无法关闭。** `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](https://router.one/zh/blog/claude-opus-5-5-migration-guide)。

## 国内怎么用

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

## 常见问题

**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 Opus 5.5 模型页](https://router.one/zh/models/claude-opus-5-5)，查看实时单价和端点列表。
- 与 [Claude Opus 5](https://router.one/zh/models/compare/claude-opus-5-5-vs-claude-opus-5)、[GPT-6 Sol](https://router.one/zh/models/compare/claude-opus-5-5-vs-gpt-6-sol) 或 [Claude Sonnet 5](https://router.one/zh/models/compare/claude-opus-5-5-vs-claude-sonnet-5) 对比。
- 迁移现有代码：[迁移到 Claude Opus 5.5](https://router.one/zh/blog/claude-opus-5-5-migration-guide)。
- 配置终端 agent：[Claude Code 默认 Opus 5.5 之后的配置](https://router.one/zh/blog/claude-code-opus-5-5-setup)。
- 本月目录的其他变化，见 [2026 年 9 月新模型指南](https://router.one/zh/blog/new-llm-models-september-2026)。

## 相关页面

- 本页规范地址：https://router.one/zh/blog/claude-opus-5-5-api-guide
- Claude Code 中国：https://router.one/zh/claude-code-china
- 全部博客文章：https://router.one/zh/blog
- 模型与每模型 token 价格：https://router.one/zh/models （markdown：https://router.one/zh/models.md ）
- 定价：https://router.one/zh/pricing
- API 文档（markdown）：https://router.one/zh/docs.md
- 公司事实（markdown）：https://router.one/zh/facts/company.md