Claude Code 怎么接 OpenRouter 和其他 API 服务商
更新于 2026-11-19
模型页:Claude Opus 5.5 API —— 价格、规格与在线体验
大家让 Claude Code 走别的服务商,通常是三个原因:想按 token 付费而不是撞订阅额度;想用一个 key、一张账单管很多模型;或者在当地没法直接用 Anthropic。Anthropic 把这叫作「把 Claude Code 接到 LLM 网关」,不管网关是 OpenRouter、APIMODELS、公司内部代理,还是本地跑的 claude-code-router,规则都一样。
下面的内容都来自 Claude Code 的环境变量和网关文档、OpenRouter 自己的 Claude Code 指南,以及 claude-code-router 的 README,核对日期 2026 年 11 月 19 日。
起作用的几个变量
把这些写在 ~/.claude/settings.json 的 env 里,不管怎么启动 claude 都会生效;终端里 export 的值和配置文件冲突时,以配置文件为准。不要把凭证写进项目里的 .claude/settings.json。如果之前用 Anthropic 账号登录过,先跑一次 /logout,免得缓存的登录状态抢先生效。
| 变量 | 作用 |
|---|---|
| ANTHROPIC_BASE_URL | 请求发到哪里。填服务商的地址,结尾不要带 /v1,Claude Code 会自己拼上 /v1/messages。 |
| ANTHROPIC_AUTH_TOKEN | 作为 Authorization: Bearer <token> 发送。Anthropic 文档说,服务商没说明用哪个时就用它。 |
| ANTHROPIC_API_KEY | 作为 x-api-key 发送。设了它,确认一次之后会盖过你的 Claude 订阅。 |
| ANTHROPIC_MODEL | Claude Code 使用的型号,比如 claude-opus-5-5。 |
| ANTHROPIC_DEFAULT_SONNET_MODEL / _OPUS_MODEL / _HAIKU_MODEL | sonnet、opus、haiku 这几个别名指向哪个型号;haiku 也用于后台任务。 |
| API_TIMEOUT_MS | 每次请求等响应头的时间(默认 600000)。走代理时可以调大。 |
| CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS | 网关拒收 anthropic-beta 请求头时设置它。 |
Claude Code 接 OpenRouter
OpenRouter 自己的指南是:ANTHROPIC_BASE_URL 设成 https://openrouter.ai/api,ANTHROPIC_AUTH_TOKEN 设成你的 OpenRouter key,ANTHROPIC_API_KEY 明确设成空字符串。指南里也写明,Claude Code 走 OpenRouter 只在用 Anthropic 官方提供方时保证可用;Claude Code 是为 Anthropic 模型优化的,换别家模型可能不正常。配好后,/status 应该显示 auth token 和 OpenRouter 的地址。
Claude Code 配合 claude-code-router
claude-code-router(简称 CCR)是一个开源的本地网关,夹在 Claude Code 和各家服务商之间,可以把不同类型的任务分给不同的模型。现在的第 3 版用 npm install -g @musistudio/claude-code-router 安装(需要 Node.js 22 以上),用 ccr ui 打开管理界面,在 Providers 里添加服务商,在 Agent Config 里选 Claude Code。本地网关监听 http://127.0.0.1:3456,配置存在 ~/.claude-code-router/config.sqlite。
老教程里写的是 ~/.claude-code-router/config.json,里面有 Providers 列表(name、api_base_url、api_key、models、transformer)和 Router 段(default、background、think、longContext),用 ccr code 启动。那是第 2 版。第 3 版只会在迁移时读一次 config.json,之后再改它也不起作用。只用 APIMODELS 上的 Claude 型号的话不需要 CCR,Claude Code 可以直接连;想混用多家服务商、按任务分模型时 CCR 才派得上用场。
Claude Code 接 APIMODELS
APIMODELS 用原生的 Anthropic Messages API 提供 Claude,所以 Claude Code 只需要两个变量:ANTHROPIC_BASE_URL 设成 https://api.apimodels.app,ANTHROPIC_AUTH_TOKEN 设成你的 APIMODELS key;想固定型号再加 ANTHROPIC_MODEL。工具调用、thinking 块和流式事件都保持原生结构。长的 Claude 流在模型思考时每 15 秒会收到一个 Anthropic ping,Claude Code 的空闲看门狗会把它算作有活动;现役的每个 Claude 型号都至少有两条上游线路。用 CC Switch 可以一键导入这些设置。
| 型号 | Anthropic 官方价(每百万 token 输入 / 输出) | APIMODELS(每百万 token 输入 / 输出) | 调用名 |
|---|---|---|---|
| Claude Fable 5.2 | $8 / $40 | $4.80 / $24 | claude-fable-5-2 |
| Claude Opus 5.5 | $4 / $20 | $2.40 / $12 | claude-opus-5-5 |
| Claude Sonnet 5.5 | $2 / $10 | $1.20 / $6 | claude-sonnet-5-5 |
| Claude Haiku 5.5(提示词 10 万 token 以内) | $0.10 / $0.50 | $0.09 / $0.45 | claude-haiku-5-5 |
接任何第三方地址都会失去的东西
只有订阅才有的功能:云端会话、Slack 里的 Claude Code、Desktop、/schedule、Code Review、Ultrareview、Chrome 扩展、电脑操作、artifacts 和语音输入,都要用 claude.ai 账号登录。
Remote Control 和服务端下发的设置:只要 ANTHROPIC_BASE_URL 指向 api.anthropic.com 以外的地址,Claude Code 就会关掉它们。
Fast 模式:它的可用性检查直接发给 Anthropic,只设了 ANTHROPIC_AUTH_TOKEN 时,Claude Code 会把 fast 模式当作关闭。
细粒度工具流式输出:走自定义地址时默认关闭。
非 Claude 模型:Anthropic 不支持通过任何网关让 Claude Code 用非 Claude 模型。也许能跑,但出了问题只能自己解决。
订阅额度不再适用:请求带的是服务商的凭证而不是你的 claude.ai 登录,所以由服务商计费,你套餐里 5 小时和每周的额度管不到它们。
接不通的时候
跑 /status,看 Claude Code 实际在用的地址和凭证来源。
设了 ANTHROPIC_API_KEY 却没生效,也没有提示:到 /config 里打开 Use custom API key 选项。
走网关时报 401:401 后面那段话是网关返回的,不是 Anthropic 的,去找那家服务商核对 key。
报 anthropic-beta 请求头相关的错,或者「Extra inputs are not permitted」:设置 CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1。
每次回复都卡住:多半是网关把整段回答攒齐了才发,没有流式转发;Anthropic 文档说这种情况下 Claude Code 会卡住。
调用示例
~/.claude/settings.json (APIMODELS)
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.apimodels.app",
"ANTHROPIC_AUTH_TOKEN": "sk_...your_apimodels_key...",
"ANTHROPIC_MODEL": "claude-opus-5-5"
}
}Shell (OpenRouter, from OpenRouter's guide)
export ANTHROPIC_BASE_URL="https://openrouter.ai/api"
export ANTHROPIC_AUTH_TOKEN="$OPENROUTER_API_KEY"
export ANTHROPIC_API_KEY="" # must be explicitly emptycURL
# Test the endpoint Claude Code will use, before you start claude
curl "$ANTHROPIC_BASE_URL/v1/messages" \
-H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{"model": "claude-opus-5-5", "max_tokens": 64, "messages": [{"role": "user", "content": "ping"}]}'常见问题
Claude Code 怎么用 OpenRouter?
把 ANTHROPIC_BASE_URL 设成 https://openrouter.ai/api,ANTHROPIC_AUTH_TOKEN 设成你的 OpenRouter key,ANTHROPIC_API_KEY 设成空字符串;之前用 Anthropic 账号登录过的话先 /logout 一次,再用 /status 确认。OpenRouter 说明只有用 Anthropic 官方提供方时才保证可用。
Claude Code 能用别的模型吗?
技术上可以把它指向提供别家模型的网关,但 Anthropic 不支持让 Claude Code 用非 Claude 模型,OpenRouter 也提醒可能不正常。受支持的做法是换一家服务商来用同样的 Claude 型号,用 ANTHROPIC_MODEL 或 ANTHROPIC_DEFAULT_*_MODEL 变量选型号。
claude-code-router 是什么?
一个开源的本地网关,夹在 Claude Code 和各家服务商之间,可以把不同任务分给不同模型。第 3 版用 npm install -g @musistudio/claude-code-router 安装,在网页界面(ccr ui)里配置,监听 127.0.0.1:3456;config.json 加 ccr code 是第 2 版的用法。
Claude Code 怎么用 API key 而不是订阅?
设置 ANTHROPIC_API_KEY(Anthropic 的 key,作为 x-api-key 发送),或者 ANTHROPIC_BASE_URL 加 ANTHROPIC_AUTH_TOKEN(APIMODELS 这类服务商)。Claude Code 提示时确认一次,再跑 /status。之后请求按 token 计费,订阅的用量上限也不再管它们。
Claude Code 走第三方 API 会少哪些功能?
会少一些。只要地址不是 api.anthropic.com,Remote Control 和服务端下发的设置就会关闭;云端会话、Slack、Desktop、Code Review 这类只有订阅才有的功能要用 claude.ai 账号登录;只设 auth token 时 fast 模式会被当作关闭;细粒度工具流式输出默认关闭。
