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 需要 Claude Code 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 窗口、文本与图像输入,整个窗口只有一行单价;实时单价见 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" 开头(见错误码说明)。 - 后台任务跟着主模型走。 网关协议页写明,用
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 的单价。
控制台 → 日志里每个请求一行,带模型、输入输出 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 后台功能用哪个模型;按 Claude Code 2.1.300 的更新日志与模型配置文档(2026-10-15 核对),2.1.293 起不设它时这个别名解析到 Claude Haiku 5.5(claude-haiku-5-5);截至 2026-10-10 的模型目录 Router One 已列出它,但 2026-10-10 的套餐接口里没有档位列出它,按 token 从钱包扣费。Router One 接受 claude-haiku-4-5 作为 anthropic/claude-haiku-4.5 的别名,它在三个套餐的「普通模型」档里。
只想改一次会话,就用 claude --model claude-opus-5 启动;会话启动时,--model 和 ANTHROPIC_MODEL 的优先级高于用 /model 保存的模型。
Claude Code 2.1.284 及以后:sonnet 也要固定(haiku 可选)
按 Claude Code 更新日志与模型配置文档(2026-10-01 核对),Claude Code 2.1.284(2026 年 9 月 28 日)把 sonnet 别名指向 Claude Sonnet 5.5,发出的 ID 是 claude-sonnet-5-5。Router One 自 2026-09-29 起列出 claude-sonnet-5-5,但 2026-09-29 的套餐接口里 Pro、Max、Ultra 都没有档位列出它。上面几套配置的会话模型不受影响,但用套餐时,凡是经过 sonnet 别名的请求都按 token 从钱包扣费:/model sonnet、定义里写着 model: sonnet 的子代理、/statusline,以及 opusplan 的执行阶段。不论用哪套配置,都加上这几行(Haiku 这一行可选):
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5
{
"env": {
"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5"
}
}
JSON 写法请把这几个键合并进你已有的 env 块。Haiku 这一行就是配置 C。Claude Sonnet 5 在三个套餐的「中级模型」档。从 Claude Code 2.1.321 起,fable 别名也要单独固定。按 Claude Code 2.1.300 的模型配置文档(2026-10-15 核对),它解析到 Claude Fable 5.1(claude-fable-5-1);按 Claude Code 的更新日志与模型配置文档(2026-11-10 核对),2.1.321 改为解析到 Claude Fable 5.2(claude-fable-5-2),它不在 2026-11-10 的 Router One 模型目录里。用这个别名的,同样设置 ANTHROPIC_DEFAULT_FABLE_MODEL=claude-fable-5-1,让它留在 Claude Fable 5.1:截至 2026-10-15 的模型目录 Router One 已重新列出它;截至 2026-10-15 的套餐接口,它和 Claude Fable 5 一样不在任何套餐档位,按 token 从钱包扣费。之前设过 ANTHROPIC_DEFAULT_FABLE_MODEL=claude-fable-5 的,改掉这一行之前,别名仍指向 Claude Fable 5。用钱包、想让 sonnet 别名用 Claude Sonnet 5.5 的,可以去掉 Sonnet 这一行。
为什么写裸 ID,而不是目录 ID
claude-opus-5-5 和 anthropic/claude-opus-5.5 Router One 都接受,但 2.1.314 之前的 Claude Code 对两者的理解不一样;按 Claude Code 的更新日志(2.1.314 版,2026-10-30 核对),这个版本修复了经 LLM 网关时带点号的模型 ID 被当作旧模型的问题,而官方 ID 从 2.1.280 起在各版本上都一样可用。Claude Code 按模型 ID 决定各种默认行为,认出 Opus 5.5 靠的是官方 ID。目录 ID 里包含 claude-opus-5 这段文字,而 Claude Code 文档写明,包含已知 Claude 模型名的 ID(例如 anthropic/claude-opus-4-8)会被解析成那个模型。于是在 2.1.314 之前的版本上用目录 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) | 2.1.314 之前为 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 更新日志与模型配置文档(2026-10-01 核对),自 2.1.285(2026 年 9 月 29 日)起,在通过自定义 ANTHROPIC_BASE_URL 接入的会话里,Claude Code 认得的模型都使用与 Anthropic API 上相同的窗口——Opus 4.7 及以后、Sonnet 5 及以后与 Fable 系列直接用 1M,无需选择 [1m] 版本——所以 claude-opus-5-5 本身就能用上完整窗口,默认约 967K token 时才压缩。2026-10-15 核对时,两个发布通道都已是 2.1.285 或更新(npm dist-tags:stable 2.1.292,latest 2.1.300)。只有在这次改动之前的 2.1.280 至 2.1.284 上,才需要加 [1m] 后缀,让 Claude Code 按完整窗口规划:
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 每一轮都重发整段对话,会话一路涨向约 967K token,每轮的输入也越来越多。Opus 5.5 的这部分输入按它唯一的一行单价从钱包扣费。用套餐时,配置 B 的模型按输入长度扣次:claude-opus-5 的单次请求输入超过 256,000 token 扣 2 次套餐额度,超过 512,000 扣 4 次;固定 sonnet 别名后用的 claude-sonnet-5 也是同样的分段(按 2026-10-01 的目录;实时分段见价格页)。想提前压缩,就设置自动压缩窗口:
export CLAUDE_CODE_AUTO_COMPACT_WINDOW=240000 # 纯整数,100000 到 1000000;也可以写进 env 块
# 会话内:/autocompact 240k # 2.1.288 起只为当前模型保存
设为 240,000 时,会话会在第一段之前压缩,但某一轮加入很大的文件或工具结果时仍可能越过;两者都设时以环境变量为准,/autocompact 不会覆盖它。环境变量对所有模型生效;而按模型配置文档(2026-10-03 核对),Claude Code 2.1.288 起 /autocompact 只为当前模型保存,换到哪个模型就要在那个模型上再运行一次(用配置 B 并固定 sonnet 别名时,就是 claude-opus-5 和 claude-sonnet-5 各一次),或者直接用环境变量。也可以设置 CLAUDE_CODE_DISABLE_1M_CONTEXT=1,把这些模型的窗口限制在 200K。其他控制成本的办法见 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 的模型配置文档(2026-10-01 核对)写得很明确:Opus 5.5 无法关闭思考。会话开关和 /config 里对应的一行会显示 "Thinking can't be turned off",不再提供开关;保存的 alwaysThinkingEnabled: false 或 MAX_THINKING_TOKENS=0 对它都无效,模型会按思考强度逐步决定想多少。想少花在思考上,就调低思考强度。
快速模式。 按 Claude Code 的快速模式文档(2026-10-01 核对),只用 ANTHROPIC_AUTH_TOKEN 认证的会话(没有 claude.ai 登录或 Anthropic API Key)会跳过可用性检查,把快速模式视为被组织禁用,所以在上面几套配置里 /fast 打不开。
余额、Key 与版本
- 余额留足。 请求执行前,Router One 会按请求的
max_tokens预估一笔费用并先行预留,而 Claude Code 对 Opus 5.5 申请的输出额度很大。余额不够预留时,网关会把max_tokens压到余额能覆盖的数;思考始终开启,长回答就可能提前截断。并行的子代理各自都要预留,所以长会话之前先充值:支付宝或银行卡走同一个托管收银台,也支持 6 条链上的 USDT/USDC。 - 每个工具一把 Key。 给 Claude Code 单独建一把 Key 并设置
maxSpend上限。这把 Key 触顶后,从钱包扣的钱不会超过这个上限,其他 Key 照常可用;Key 还可以设置过期时间。控制台 → API 密钥里能看到这把 Key 已从钱包扣了多少、离上限还剩多少(按 Key 追踪成本)。 - 确认版本。 Opus 5.5 需要 2.1.280 或更高:
claude --version # 应显示 2.1.280 或更高
claude update
2.1.281(2026 年 9 月 23 日)还修复了几处经代理或网关使用时的流式问题,2.1.285 又让经网关的会话用上了上文所说的 1M 窗口。2026-10-15 时 stable 通道是 2.1.292、latest 是 2.1.300(npm dist-tags),建议升级。
常见问题
我订阅了 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),再到控制台 → 日志看新请求的模型。
我选的是 Opus 5.5,/model 却显示 Opus 5,为什么? 通常是模型填了目录 ID anthropic/claude-opus-5.5,2.1.314 之前的 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 单价不变,而且 Claude Code 2.1.285 起不需要它。截至 2026-10-01,Router One 目录对 Opus 5.5 整个窗口只列一行单价,而且后缀根本不会发到网关。窗口越大,Claude Code 压缩前保留的历史越多;每一轮都会重发这段历史,所以会话越长,总花费越高。用 CLAUDE_CODE_AUTO_COMPACT_WINDOW 可以把压缩点提前。
经 Router One 能用 /fast 吗? 上面几套配置里用不了。按 Claude Code 的快速模式文档(2026-10-01 核对),只用 ANTHROPIC_AUTH_TOKEN 认证的会话会把快速模式视为被组织禁用。想让每轮更快,就调低思考强度。
怎么切回 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)才改用它。定义为 model: sonnet 的子代理走的是 sonnet 别名,Claude Code 2.1.284 及以后把它发成 claude-sonnet-5-5;Router One 已列出这个 ID,但截至 2026-10-15 的套餐接口,没有套餐档位覆盖它,用套餐时请设置 ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5。定义为 model: haiku 的子代理走 haiku 别名,按 Claude Code 2.1.300 的模型配置文档(2026-10-15 核对),2.1.293 及以后它解析为 claude-haiku-5-5;截至 2026-10-10 的模型目录 Router One 已列出这个 ID(Claude Haiku 5.5),但 2026-10-10 的套餐接口里没有档位列出它,这类子代理按 token 从钱包扣费,设置 ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5(配置 C)则改用 Claude Haiku 4.5。
下一步
- 直接调用模型见 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 国内接入的一行安装命令开始,或者看配置指南。