如何通过 OpenRouter 使用 Claude Code

你正在深入进行重构。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 负责快速转换和分类。把这些和基础 URL、令牌一起放进同一个 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 不对令牌定价加价。你支付与提供商相同的每令牌费率，显示在模型目录中，购买额度会收取 5.5% 的手续费，最低 $0.80。

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

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

接入 CI 和你的终端

同样的路由方式在你的本地 shell 之外也适用。

对于 CI，官方 Claude Code GitHub Action 需要两处更改：通过 anthropic_api_key 传入你的 OpenRouter 密钥，并在该步骤的环境变量中设置基础 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 提供商，因此会话无需重新连接即可继续运行。你按实际处理该请求的提供商的费率付费。