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 接入指南;自己的代码要改哪些地方、会遇到哪些 400 报错,见 Opus 5.5 迁移指南。国内可直连 Router One,无需 VPN,钱包可用支付宝充值。
Claude Code 2.1.280 改了什么
Claude Code 更新日志里 2.1.280 的条目原文是:"Added Claude Opus 5.5 (claude-opus-5-5), now the default Opus model"。模型配置文档列出了 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 网关协议页又补充:设置 ANTHROPIC_BASE_URL 之后,"Claude Code treats the gateway as the Claude API"(Claude Code 把网关当作 Claude API)——所以 Router One 上的会话拿到的就是表格右栏。
Anthropic 的 Opus 5.5 概览页把它定位为 "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解析为目录 IDanthropic/claude-opus-5.5,并在 Claude Code 调用的/v1/messages端点上提供服务。目录标注 1,048,576 token 窗口、文本与图像输入,整个窗口只有一行单价;实时单价见模型页。 - 不在套餐内。 截至 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" 开头(见错误码说明)。 - 后台任务跟着主模型走。 网关协议页写明,用
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 指南)。 - 单价按 ID 各算各的。 Claude Opus 5.5 vs Claude Opus 5 用实时目录把两者并排列出,切换前先看一眼,别默认新模型每 token 更便宜。Claude Code 的
/model选择器里显示的价格只是 Claude Code 自带的展示标签,不是 Router One 的单价。
Dashboard → Logs 里每个请求一行,带模型、输入输出 token、费用和状态(逐请求可观测);改完配置后看最新几行,就知道 Claude Code 实际发的是哪个模型。
三套配置,直接粘贴
三套都保留 Claude Code 国内接入里的两个变量: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,走钱包
新的默认模型,显式固定下来,以后默认值再变也不会悄悄换掉:
export ANTHROPIC_BASE_URL=https://api.router.one
export ANTHROPIC_AUTH_TOKEN=sk-your-api-key
export ANTHROPIC_MODEL=claude-opus-5-5
{
"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 订阅用户:
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
{
"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。本周期的高级档额度用完后,后续调用按公示单价走钱包;各套餐的模型列表与额度以价格页为准,超出额度后怎么计费见 Claude Code 订阅方案。
配置 C:后台任务交给 Haiku 4.5
在配置 A 或 B 上加一行,shell 写法加进 shell 配置文件,JSON 写法加进同一个 env 块。下面的 JSON 是配置 A 加上这一行后的样子;用配置 B 的话,把最后这一行同样加进它的 env 块:
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5
{
"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 后台功能用哪个模型。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 错误参考的写法,在 settings 文件里用 modelOverrides 做映射,键写 Anthropic 官方 ID。这样 Claude Code 发出的是目录 ID,同时按 Opus 5.5 处理这个会话:
{
"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 加上后缀即可:
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 成本拆解。
思考强度:唯一的思考旋钮
Opus 5.5 的思考始终开启,思考强度决定想多少。Claude Code 提供 low、medium、high、xhigh、max 五档,Opus 5.5 从 medium 起步:
claude --effort high # 只对这次启动生效
export CLAUDE_CODE_EFFORT_LEVEL=high # 每个会话都生效,优先于 --effort 和 /effort
# 会话内:/effort high # 按当前模型保存
模型配置文档里有两个细节:"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 的快速模式文档写明,只用 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 追踪成本)。 - 确认版本。 Opus 5.5 需要 2.1.280 或更高:
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 接入指南,改自己的代码见 Opus 5.5 迁移指南。
- 对比实时规格:Claude Opus 5.5 vs Claude Opus 5、Claude Opus 5.5 vs Claude Sonnet 5(Sonnet 5 在三个套餐的「中级模型」档)与 Claude Opus 5.5 vs GPT-6 Sol。GPT-6 Sol 要在 Codex CLI 等 OpenAI 兼容工具里用,Claude Code 调不了(见 GPT-6 Sol 工具接入)。
- 第一次在 Router One 上用 Claude Code?从 Claude Code 国内接入的一行安装命令开始,或者看配置指南。