如何将 Claude Code 接入 OpenRouter

你正深陷一次重构之中。Claude Code 已经拉取了十几个文件的上下文，规划好了 diff，并开始执行。然后会话在完成 70% 时因速率限制而中断。

通过 OpenRouter 路由 Claude Code，就是让该会话保持存活的方法。OpenRouter 作为可靠性与管理层，位于 Claude Code 与 Anthropic API 之间。它增加了提供商故障转移、预算控制和用量可见性，而且无需运行本地代理。设置只需三个环境变量。本文涵盖该设置、模型路由、Fast Mode 以及成本计算。如果你在 Claude Code 之外还运行其他工具，同一个密钥在所有工具中都能用，参见如何将 OpenRouter 与任何编码代理配合使用。

团队场景同样实用。多名开发者同时运行 Claude Code，意味着多个 Anthropic 账户、没有共享支出视图，而且在账单到来之前没有按开发者设置的上限。一个 OpenRouter 密钥就能统管这一切：共享计费、按密钥限额，以及显示每次会话成本的Activity 仪表盘。

三步连接 Claude Code

整个设置就是三个环境变量，记录在Claude Code 集成指南中，无需代理、无需 Docker，也无需运行本地端口。

# Add to ~/.zshrc or ~/.bashrc
export OPENROUTER_API_KEY="<your-openrouter-api-key>"
export ANTHROPIC_BASE_URL="https://openrouter.ai/api"
export ANTHROPIC_AUTH_TOKEN="$OPENROUTER_API_KEY"
export ANTHROPIC_API_KEY=""   # must be explicitly empty

有三点要弄对。基础 URL 是 https://openrouter.ai/api。认证令牌是你的OpenRouter 密钥，以 sk-or- 开头。而 ANTHROPIC_API_KEY 必须是空字符串，而不是未设置，否则 Claude Code 可能会回退到直接向 Anthropic 认证。

更想把它限定到单个项目？把同样的三个值放在项目根目录 .claude/settings.local.json 中的 env 块下。不要使用普通的 .env 文件，因为原生安装程序不会读取它。

如果你之前用 Anthropic 账户登录过 Claude Code，请运行一次 /logout 并重新启动，否则缓存的登录会覆盖你的变量，你会遇到令人困惑的 model-not-found 错误。用 /status 确认切换：

> /status
Auth token: ANTHROPIC_AUTH_TOKEN
Anthropic base URL: https://openrouter.ai/api

你的请求也应该在几秒内出现在Activity 仪表盘中。

Anthropic Skin 如何在无代理的情况下工作

OpenRouter 暴露了一个与 Anthropic Messages API 兼容的端点，它称之为 Anthropic Skin。Claude Code 直接以其原生协议与 OpenRouter 通信，Skin 负责模型映射，并将高级功能原样透传。

这意味着 Thinking 块、原生工具使用、流式传输和多轮上下文都能像直接对接 Anthropic 时一样工作。较旧的方案依赖像 claude-code-router 这样的本地代理来转换请求，这意味着需要 Node.js 运行时、本地端口，以及一个需要保持健康的转换层。原生路由为 Anthropic 工作流省去了整个层级。

在底层，OpenRouter 会在为某个模型提供服务的多个 Anthropic 提供商之间进行负载均衡。如果它首先尝试的那家对你限流，它会把同一模型路由到另一家提供该模型的提供商，而你只需为成功落地的调用付费。对于一个跨多次调用保持状态的多步骤代理任务来说，这种发生在 Claude Code 之下的故障转移，就是任务完成与编辑只应用了一半之间的区别。

将每类任务路由到合适的模型

Claude Code 将工作分配到多个模型槽位。覆盖每个槽位，使其指向 OpenRouter 上的特定模型。~author/model-latest 别名始终解析到某个系列中的最新版本，因此不会过时：

export ANTHROPIC_DEFAULT_OPUS_MODEL="~anthropic/claude-opus-latest"
export ANTHROPIC_DEFAULT_SONNET_MODEL="~anthropic/claude-sonnet-latest"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="~anthropic/claude-haiku-latest"
export CLAUDE_CODE_SUBAGENT_MODEL="~anthropic/claude-opus-latest"

合理的分工：Opus 用于架构和深度推理，Sonnet 用于日常编码，Haiku 用于快速转换和分类。把这些和 base URL、token 一起放进同一个 shell 配置文件或项目设置文件中。

不过模型还是要保持 Anthropic。Claude Code 是围绕 Anthropic 的请求语义构建的，只有使用 Anthropic 第一方提供商才能保证集成正常工作。为了获得最大兼容性，请将 Anthropic 1P 设为首选提供商。

Opus 会话的 Fast Mode

Anthropic 的 Fast Mode 以溢价提供最高 2.5 倍的输出速度，仅由 Anthropic 第一方提供商提供。它适用于 Claude Opus 4.6、4.7 和 4.8，不适用于其他模型。

Claude Code 有一个内置的 /fast 开关。开启后，Claude Code 会在配置的 Opus 模型旁发送 speed: "fast"，OpenRouter 会重新路由到匹配的 -fast 变体。要使用它，只需设置一个变量：

export CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK=1

这需要 Claude Code v2.1.96 或更新版本。向不支持该参数的模型发送 speed: "fast" 时，OpenRouter 会直接丢弃该参数，因此请求会以标准速度和价格运行。在交互式会话和实时调试中使用它，因为延迟是你最能感受到的。在生产环境中开启前，请查看定价页面了解当前的 Opus 费率。

费用与免费额度

OpenRouter 不会对 token 定价加价。你支付的价格与提供商收取的每 token 费率相同，显示在模型目录中，购买额度会收取 5.5% 的手续费，最低 $0.80。

相对于实际使用量，这笔费用很小。以每月 1000 万 token 的 Claude Sonnet 4.5 为例，输入/输出比例为 80/20。按每百万输入 $3、每百万输出 $15 计算，直接的 token 成本约为 $54，5.5% 的额度手续费大约增加 $3。作为回报，你可以获得故障转移、按密钥的预算上限，以及跨团队的统一账单视图。

还有一个用于尝试的免费额度。免费模型每天最多可运行 50 次请求，添加 $10 额度后每天可提升至 1,000 次。它们的上下文窗口比付费的 Anthropic 模型更小，因此适合学习 Claude Code 的工作流程，而不适合生产会话。在活动仪表盘中实时查看支出，这是发现会话被路由到比任务所需更重的模型的最快方式。

接入 CI 和你的终端

同样的路由方式不仅适用于本地 shell。

对于 CI，官方的 Claude Code GitHub Action 需要两处改动：通过 anthropic_api_key 传入你的 OpenRouter 密钥，并在该步骤的 env 中设置 base URL。

- name: Run Claude Code
  uses: anthropics/claude-code-action@v1
  with:
    anthropic_api_key: ${{ secrets.OPENROUTER_API_KEY }}
  env:
    ANTHROPIC_BASE_URL: https://openrouter.ai/api

要在终端中实时查看成本，openrouter-examples 仓库提供了一个状态栏脚本，可显示提供商、模型、运行成本和缓存折扣。将你的 ~/.claude/settings.json 指向它：

{
  "statusLine": {
    "type": "command",
    "command": "/path/to/statusline.sh"
  }
}

在 Claude Code 之上构建智能体？Anthropic Agent SDK 使用 Claude Code 运行时，因此同样的三个环境变量就能将其请求通过 OpenRouter 路由，无需额外配置。

常见问题

使用 Claude Code 搭配 OpenRouter 需要 Anthropic 订阅吗？

不需要。请求通过你的 OpenRouter 额度路由，因此你需要一个 OpenRouter 账户和 API 密钥，而不是 Anthropic 套餐。如果你之前使用 Anthropic 账户登录过 Claude Code，请运行一次 /logout 以清除缓存的会话，然后再切换。

我可以通过 OpenRouter 在 Claude Code 中使用非 Anthropic 模型吗？

原生集成专为 Anthropic 模型构建，仅保证与 Anthropic 第一方提供商配合使用。Claude Code 需要 Anthropic 的请求语义，因此通过原生端点不支持非 Anthropic 模型。

通过 OpenRouter 使用 Claude Code 的费用是多少？

你需要按提供商的每 token 费率付费，外加购买额度时 5.5% 的手续费，最低 $0.80。推理本身仍按提供商费率计费。活动仪表盘会实时显示每次会话的精确费用。

OpenRouter 会记录我的源代码吗？

不会。默认情况下，OpenRouter 仅保留 token 数量等元数据，而不保留你的提示词或补全内容。记录你自己的输入和输出需要主动选择开启，另有单独的主动选择开启项允许 OpenRouter 使用你的数据来改进产品，以换取 1% 的使用折扣。相关条款请参阅隐私政策。

什么是 Fast Mode，哪些模型支持它？

Fast Mode 以高级定价提供最高 2.5 倍的输出速度，由 Anthropic 第一方提供商提供服务。它仅适用于 Claude Opus 4.6、4.7 和 4.8。在 Claude Code 中使用 /fast 切换。

如果 Anthropic 的 API 对我限流会怎样？

OpenRouter 会故障转移到另一个提供相同模型的 Anthropic 提供商，因此会话无需重新连接即可继续运行。你按实际处理该请求的提供商的费率付费。