APIMODELSAPIMODELS

Claude Code 怎么接 OpenRouter 和其他 API 服务商

更新于 2026-11-19

TL;DR 一句话:只要对方支持 Anthropic Messages API,ANTHROPIC_BASE_URL 指向哪里,Claude Code 就和哪里通信。把 ANTHROPIC_BASE_URL 设成服务商的地址(结尾不要带 /v1),把服务商的 key 放进 ANTHROPIC_AUTH_TOKEN,再跑 /status 确认。OpenRouter 是 https://openrouter.ai/api,同时把 ANTHROPIC_API_KEY 设成空字符串;APIMODELS 是 https://api.apimodels.app。

模型页: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_MODELClaude Code 使用的型号,比如 claude-opus-5-5。
ANTHROPIC_DEFAULT_SONNET_MODEL / _OPUS_MODEL / _HAIKU_MODELsonnet、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 / $24claude-fable-5-2
Claude Opus 5.5$4 / $20$2.40 / $12claude-opus-5-5
Claude Sonnet 5.5$2 / $10$1.20 / $6claude-sonnet-5-5
Claude Haiku 5.5(提示词 10 万 token 以内)$0.10 / $0.50$0.09 / $0.45claude-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 empty

cURL

# 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 模式会被当作关闭;细粒度工具流式输出默认关闭。

相关阅读

收录于
APIMODELS on Product HuntAPIMODELS featured on ToolifyAPIMODELS featured on There's An AI For That