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

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

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

Claude Code 在 2026 年 9 月 22 日发布的 2.1.280 版把默认模型换成了 Claude Opus 5.5，`opus` 别名也随之指向它；而只要设置了 `ANTHROPIC_BASE_URL`，Claude Code 就把网关当作 Claude API 对待。所以经 Router One 使用时，升级后的 Claude Code 只要没有固定模型，发出的就是 `claude-opus-5-5`——截至 2026-09-24，套餐接口里 Pro、Max、Ultra 都没有任何档位列出这个 ID，这些请求一律按 token 从钱包扣费。

下面给出三套可以直接粘贴的配置，并讲清背后的几件事：为什么写裸 ID、1M 上下文、思考强度，以及哪些做不到。curl、SDK 与端点见 [Claude Opus 5.5 API 接入指南](https://router.one/zh/blog/claude-opus-5-5-api-guide)；自己的代码要改哪些地方、会遇到哪些 400 报错，见 [Opus 5.5 迁移指南](https://router.one/zh/blog/claude-opus-5-5-migration-guide)。国内可直连 Router One，无需 VPN，钱包可用支付宝充值。

## Claude Code 2.1.280 改了什么

[Claude Code 更新日志](https://code.claude.com/docs/en/changelog)里 2.1.280 的条目原文是："Added Claude Opus 5.5 (`claude-opus-5-5`), now the default Opus model"。[模型配置文档](https://code.claude.com/docs/en/model-config)列出了 Anthropic API 连接下的变化：

| 项目 | v2.1.219 至 v2.1.279 | v2.1.280 及以后 |
| --- | --- | --- |
| `default` 模型 | Opus 5 | Opus 5.5 |
| `opus` 别名 | Opus 5（`claude-opus-5`） | Opus 5.5（`claude-opus-5-5`） |
| 该模型的起始思考强度 | `high` | `medium` |
| 该模型的思考 | 可以关闭 | 始终开启 |

同一页写明 "Opus 5.5 requires Claude Code v2.1.280 or later"（Opus 5.5 需要 v2.1.280 或更高版本）。[LLM 网关协议页](https://code.claude.com/docs/en/llm-gateway-protocol)又补充：设置 `ANTHROPIC_BASE_URL` 之后，"Claude Code treats the gateway as the Claude API"（Claude Code 把网关当作 Claude API）——所以 Router One 上的会话拿到的就是表格右栏。

Anthropic 的 [Opus 5.5 概览页](https://platform.claude.com/docs/en/models/opus-5-5/overview)把它定位为 "For long-running agentic coding and knowledge work"（面向长时间运行的 agentic 编码与知识工作），列出 1M token 上下文窗口、同步 Messages API 下最多 128K 输出 token、始终开启的自适应思考，默认思考强度为 `medium`。以上是厂商的说法；Router One 负责的是目录条目本身，以及网关如何路由和计费。

## 落到 Router One 上意味着什么

- **ID 直接可用。** 自 2026-09-24 起，网关把 `claude-opus-5-5` 解析为目录 ID `anthropic/claude-opus-5.5`，并在 Claude Code 调用的 `/v1/messages` 端点上提供服务。目录标注 1,048,576 token 窗口、文本与图像输入，整个窗口只有一行单价；实时单价见[模型页](https://router.one/zh/models/claude-opus-5-5)。
- **不在套餐内。** 截至 2026-09-24，套餐接口里 Pro、Max、Ultra 都没有任何档位列出 `claude-opus-5-5`，所以不论是否订阅，Opus 5.5 的每次调用都按 token 从钱包扣费。Claude Opus 5 仍在三个套餐的「高级模型」档里。原先用 Opus 5 消耗高级档额度的订阅用户，Claude Code 一升级到 2.1.280 就改为从钱包扣费；钱包余额为 0 或过低时，这些请求会返回 HTTP 402，错误类型是 `billing_error`，消息以 "insufficient balance" 开头（见[错误码说明](https://router.one/zh/llm-api-error-codes)）。
- **后台任务跟着主模型走。** 网关协议页写明，用 `ANTHROPIC_AUTH_TOKEN` 接入的会话，后台任务用的是 "The main model"（主模型），除非 `ANTHROPIC_DEFAULT_HAIKU_MODEL` 另行指定。没有指定模型的子代理同样跑在会话模型上。
- **不会偷换模型。** Router One 不会用 Opus 5 或其他模型来回答 Opus 5.5 的请求；参数类的 400 错误会直接返回给 Claude Code，不会重试。截至 2026-09-24，Opus 5.5 也没有 AWS 或 Google Cloud 渠道 ID，`aws/` 与 `vertex/` 的 Claude ID 只到 Opus 5（见[渠道模型 ID 指南](https://router.one/zh/blog/azure-aws-vertex-channel-model-ids)）。
- **单价按 ID 各算各的。** [Claude Opus 5.5 vs Claude Opus 5](https://router.one/zh/models/compare/claude-opus-5-5-vs-claude-opus-5) 用实时目录把两者并排列出，切换前先看一眼，别默认新模型每 token 更便宜。Claude Code 的 `/model` 选择器里显示的价格只是 Claude Code 自带的展示标签，不是 Router One 的单价。

Dashboard → Logs 里每个请求一行，带模型、输入输出 token、费用和状态（[逐请求可观测](https://router.one/zh/llm-observability)）；改完配置后看最新几行，就知道 Claude Code 实际发的是哪个模型。

## 三套配置，直接粘贴

三套都保留 [Claude Code 国内接入](https://router.one/zh/claude-code-china)里的两个变量：`ANTHROPIC_BASE_URL=https://api.router.one`（不带 `/v1`），以及填入 Router One Key 的 `ANTHROPIC_AUTH_TOKEN`。`ANTHROPIC_API_KEY` 不需要设置，保持未设即可。每套都给两种写法：写进 `~/.zshrc` 或 `~/.bashrc` 的 shell export，以及 `~/.claude/settings.json` 的 `env` 块——Router One 一键安装脚本正是写在这里。同一个变量只放一处：settings 文件里的 `env` 块会覆盖从 shell 继承来的值。先执行 `claude update`，下文都以 2.1.280 或更高版本为前提。

### 配置 A：Opus 5.5，走钱包

新的默认模型，显式固定下来，以后默认值再变也不会悄悄换掉：

```bash
export ANTHROPIC_BASE_URL=https://api.router.one
export ANTHROPIC_AUTH_TOKEN=sk-your-api-key
export ANTHROPIC_MODEL=claude-opus-5-5
```

```json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.router.one",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-api-key",
    "ANTHROPIC_MODEL": "claude-opus-5-5"
  }
}
```

这套配置下每个请求都从钱包扣费；想让后台请求不走 Opus 5.5，再叠加配置 C。

### 配置 B：继续用套餐额度，模型用 Opus 5

适合希望 Claude Code 继续消耗「高级模型」档额度的 Pro、Max、Ultra 订阅用户：

```bash
export ANTHROPIC_BASE_URL=https://api.router.one
export ANTHROPIC_AUTH_TOKEN=sk-your-api-key
export ANTHROPIC_MODEL=claude-opus-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5
```

```json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.router.one",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-api-key",
    "ANTHROPIC_MODEL": "claude-opus-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5"
  }
}
```

`ANTHROPIC_MODEL` 决定会话模型；`ANTHROPIC_DEFAULT_OPUS_MODEL` 让 `opus` 别名也指向 Opus 5，`/model opus`、`opusplan` 的规划阶段，以及定义里写着 `model: opus` 的子代理都会跟着用 Opus 5。本周期的高级档额度用完后，后续调用按公示单价走钱包；各套餐的模型列表与额度以[价格页](https://router.one/zh/pricing)为准，超出额度后怎么计费见 [Claude Code 订阅方案](https://router.one/zh/claude-max-alternative)。

### 配置 C：后台任务交给 Haiku 4.5

在配置 A 或 B 上加一行，shell 写法加进 shell 配置文件，JSON 写法加进同一个 `env` 块。下面的 JSON 是配置 A 加上这一行后的样子；用配置 B 的话，把最后这一行同样加进它的 `env` 块：

```bash
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5
```

```json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.router.one",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-api-key",
    "ANTHROPIC_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5"
  }
}
```

这个变量决定 `haiku` 别名背后的模型，也决定 Claude Code [后台功能](https://code.claude.com/docs/en/costs#background-token-usage)用哪个模型。Router One 接受 `claude-haiku-4-5` 作为 `anthropic/claude-haiku-4.5` 的别名，它在三个套餐的「普通模型」档里。

只想改一次会话，就用 `claude --model claude-opus-5` 启动；会话启动时，`--model` 和 `ANTHROPIC_MODEL` 的优先级高于用 `/model` 保存的模型。

## 为什么写裸 ID，而不是目录 ID

`claude-opus-5-5` 和 `anthropic/claude-opus-5.5` Router One 都接受，但 Claude Code 对两者的理解不一样。它按模型 ID 决定各种默认行为，认出 Opus 5.5 靠的是官方 ID。目录 ID 里包含 `claude-opus-5` 这段文字，而 Claude Code 文档写明，包含已知 Claude 模型名的 ID（例如 `anthropic/claude-opus-4-8`）会被解析成那个模型。于是用目录 ID 时，拿到的是 Opus 5 的默认值：思考强度从 `high` 起步，`/model` 显示 Opus 5，部分旁路请求会关闭思考或强制调用某个工具，而 Opus 5.5 不接受这两种设置。Router One 会为 Opus 5.5 改写这两项设置，这些请求不再报错，但强制调用工具会变成可选（例如 WebSearch 可能不搜索就直接用文字回答），默认值和显示名也仍然不对。

| 模型填写 | Router One | Claude Code 当作 |
| --- | --- | --- |
| `claude-opus-5-5` | 接受（别名） | Opus 5.5——推荐 |
| `opus` | Claude Code 发出 `claude-opus-5-5`（除非设置了 `ANTHROPIC_DEFAULT_OPUS_MODEL`） | Opus 5.5 |
| `anthropic/claude-opus-5.5` | 接受（目录 ID） | Opus 5——避免使用，或做映射 |
| `claude-opus-5.5`、`anthropic/claude-opus-5-5`、`claude-opus-5-5-thinking` | 不接受，返回 HTTP 404（模型不存在） | — |

如果共享配置必须保留目录 ID，就按 Claude Code [错误参考](https://code.claude.com/docs/en/errors#unrecognized-model-id-on-a-request)的写法，在 settings 文件里用 `modelOverrides` 做映射，键写 Anthropic 官方 ID。这样 Claude Code 发出的是目录 ID，同时按 Opus 5.5 处理这个会话：

```json
{
  "modelOverrides": {
    "claude-opus-5-5": "anthropic/claude-opus-5.5"
  }
}
```

## 1M 上下文窗口

Opus 5.5 在 Anthropic API 上原生支持 1M token 窗口；Router One 目录标注 1,048,576 token，整个窗口一行单价，没有长上下文阶梯。不过经网关接入时，Claude Code 文档说它 "can't verify 1M support"（无法确认是否支持 1M），并给出用 `[1m]` 选择完整窗口的办法（原文针对 Sonnet 5）。不加后缀时，Claude Code 可能按较小的窗口来规划，远不到 1M 就开始压缩。Opus 5.5 加上后缀即可：

```bash
export ANTHROPIC_MODEL='claude-opus-5-5[1m]'
export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-5-5[1m]'
# 或者只对这一次启动生效
claude --model 'claude-opus-5-5[1m]'
```

会话内用 `/model opus[1m]` 效果相同。引号别省：zsh 会把命令参数里未加引号的 `[1m]` 当作文件名通配，直接报 "no matches found"。Claude Code 在发出请求前会去掉这个后缀，Router One 收到的仍是 `claude-opus-5-5`；写在 `ANTHROPIC_DEFAULT_OPUS_MODEL` 上，则所有走 `opus` 别名的地方都用完整窗口。如果这两个变量已经像上文配置的 JSON 写法那样写在 `~/.claude/settings.json` 的 `env` 块里，就直接改那里，例如 `"ANTHROPIC_MODEL": "claude-opus-5-5[1m]"`：settings 文件里的值优先于 shell export。

窗口大也有代价：Claude Code 每一轮都重发整段对话，历史越长，每轮的输入越多。`CLAUDE_CODE_AUTO_COMPACT_WINDOW`（纯整数，`100000` 到 `1000000`）可以让压缩提前发生；其他控制成本的办法见 [Claude Code token 成本拆解](https://router.one/zh/blog/claude-code-token-costs-explained)。

## 思考强度：唯一的思考旋钮

Opus 5.5 的思考始终开启，思考强度决定想多少。Claude Code 提供 `low`、`medium`、`high`、`xhigh`、`max` 五档，Opus 5.5 从 `medium` 起步：

```bash
claude --effort high                    # 只对这次启动生效
export CLAUDE_CODE_EFFORT_LEVEL=high    # 每个会话都生效，优先于 --effort 和 /effort
# 会话内：/effort high                  # 按当前模型保存
```

[模型配置文档](https://code.claude.com/docs/en/model-config)里有两个细节："a top-level `effortLevel` in your user settings file doesn't count for Opus 5.5"——用户 settings 顶层的 `effortLevel` 对 Opus 5.5 不生效，以前在这个键里为 Opus 5 存的档位不会带过来；`max` 只对当前会话生效，除非它来自 `CLAUDE_CODE_EFFORT_LEVEL`。Claude Code 每次请求都会带上档位，Router One 的 `/v1/messages` 会把 `output_config.effort` 原样转发。档位越高，思考 token 越多；思考 token 按输出 token 计费，与 Anthropic API 一致。

## 做不到的两件事：关闭思考、快速模式

**关闭思考。** Claude Code 文档写得很明确："You can't turn thinking off on Opus 5.5 or the Fable models. The session toggle, `alwaysThinkingEnabled`, and `MAX_THINKING_TOKENS=0` have no effect there, and the model decides per step how much to think based on the effort level."（Opus 5.5 与 Fable 系列无法关闭思考，会话开关、`alwaysThinkingEnabled` 与 `MAX_THINKING_TOKENS=0` 对它们都无效，模型会按思考强度逐步决定想多少。）想少花在思考上，就调低思考强度。

**快速模式。** 经 Router One 用不了 `/fast`。Claude Code 的[快速模式文档](https://code.claude.com/docs/en/fast-mode)写明，只用 `ANTHROPIC_AUTH_TOKEN` 认证的会话会把快速模式视为被组织禁用；Router One 对 Opus 5.5 的快速模式请求也会在到达模型之前返回 HTTP 400。

## 余额、Key 与版本

- **余额留足。** 请求执行前，Router One 会按请求的 `max_tokens` 预估一笔费用并先行预留，而 Claude Code 对 Opus 5.5 申请的输出额度很大。余额不够预留时，网关会把 `max_tokens` 压到余额能覆盖的数；思考始终开启，长回答就可能提前截断。并行的子代理各自都要预留，所以长会话之前先充值：支付宝或银行卡走同一个托管收银台，也支持 6 条链上的 USDT/USDC。
- **每个工具一把 Key。** 给 Claude Code 单独建一把 Key 并设置 `maxSpend` 上限。这把 Key 触顶后，花费不会超过这个上限，其他 Key 照常可用；Key 还可以设置过期时间。Dashboard → API Keys 里能看到这把 Key 已花多少、离上限还剩多少（[按 Key 追踪成本](https://router.one/zh/llm-cost-tracking)）。
- **确认版本。** Opus 5.5 需要 2.1.280 或更高：

```bash
claude --version    # 应显示 2.1.280 或更高
claude update
```

2.1.281（2026 年 9 月 23 日）还修复了几处经代理或网关使用时的流式问题，建议升级到这一版。

## 常见问题

**我订阅了 Router One 的 Max 套餐，为什么还在扣钱包？**
Claude Code 2.1.280 起，没有固定模型时发出的就是 claude-opus-5-5；截至 2026-09-24，套餐接口里 Pro、Max、Ultra 都没有任何档位列出 Opus 5.5，所以这些请求（包括后台任务）按 token 从钱包扣费。想继续用套餐额度，就设置 ANTHROPIC_MODEL=claude-opus-5 与 ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5（配置 B），再到 Dashboard → Logs 看新请求的模型。

**我选的是 Opus 5.5，/model 却显示 Opus 5，为什么？**
通常是模型填了目录 ID anthropic/claude-opus-5.5，Claude Code 会把它当作 Opus 5；改用 claude-opus-5-5 或用 modelOverrides 映射目录 ID，并确认 claude --version 在 2.1.280 或以上。Claude Code 自己也可能切换模型：文档描述了一种自动回退，被安全分类器标记的请求会在另一个模型上重跑（生物类用 Opus 5，网络安全类用 Opus 4.8），并在对话里显示提示。这个切换发生在 Claude Code 里，不在 Router One；用 /model 切回即可。

**能关掉思考省 token 吗？**
不能。Claude Code 的开关、alwaysThinkingEnabled 和 MAX_THINKING_TOKENS=0 对 Opus 5.5 都无效。改为调低思考强度（/effort low、--effort low 或 CLAUDE_CODE_EFFORT_LEVEL=low），或者换一个可以关闭思考的模型，例如 Opus 5。

**加 [1m] 后缀会更贵吗？**
每 token 单价不变。截至 2026-09-24，Router One 目录对 Opus 5.5 整个窗口只列一行单价，而且后缀根本不会发到网关。它改变的是 Claude Code 压缩前保留多少历史；每一轮都会重发这段历史，所以会话越长，总花费越高。用 CLAUDE_CODE_AUTO_COMPACT_WINDOW 可以把压缩点提前。

**经 Router One 能用 /fast 吗？**
不能。只设置 ANTHROPIC_AUTH_TOKEN 时，Claude Code 会把快速模式视为禁用；Router One 对 Opus 5.5 的快速模式请求也会返回 HTTP 400。想让每轮更快，就调低思考强度。

**怎么切回 Opus 5？**
只改一次启动：claude --model claude-opus-5；会话内输入 /model claude-opus-5 会切换并保存为默认值。每次都用 Opus 5：按配置 B 写进 shell 配置文件，或写进 ~/.claude/settings.json 的 env 块。截至 2026-09-24，Opus 5 在 Pro、Max、Ultra 三个套餐的「高级模型」档里，订阅用户会重新消耗套餐额度。

**子代理用的是哪个模型？**
Claude Code 依次查看：Claude 启动子代理时传入的模型、子代理定义里的 model、CLAUDE_CODE_SUBAGENT_MODEL，最后是会话模型。前三项都没设的子代理，在模型不固定的会话里就跑在 Opus 5.5 上。想给它们换个默认模型，可以设置 CLAUDE_CODE_SUBAGENT_MODEL（例如 claude-sonnet-5）；后台任务默认跟主模型走，设了 ANTHROPIC_DEFAULT_HAIKU_MODEL（配置 C）才改用它。

## 下一步

- 直接调用模型见 [Claude Opus 5.5 API 接入指南](https://router.one/zh/blog/claude-opus-5-5-api-guide)，改自己的代码见 [Opus 5.5 迁移指南](https://router.one/zh/blog/claude-opus-5-5-migration-guide)。
- 对比实时规格：[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 Claude Sonnet 5](https://router.one/zh/models/compare/claude-opus-5-5-vs-claude-sonnet-5)（Sonnet 5 在三个套餐的「中级模型」档）与 [Claude Opus 5.5 vs GPT-6 Sol](https://router.one/zh/models/compare/claude-opus-5-5-vs-gpt-6-sol)。GPT-6 Sol 要在 Codex CLI 等 OpenAI 兼容工具里用，Claude Code 调不了（见 [GPT-6 Sol 工具接入](https://router.one/zh/blog/gpt-6-sol-coding-tools-setup)）。
- 第一次在 Router One 上用 Claude Code？从 [Claude Code 国内接入](https://router.one/zh/claude-code-china)的一行安装命令开始，或者看[配置指南](https://router.one/zh/blog/claude-code-setup-guide)。

## 相关页面

- 本页规范地址：https://router.one/zh/blog/claude-code-opus-5-5-setup
- 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