你正深入进行重构。Claude Code 已经跨十几个文件拉取上下文，规划了差异，并开始执行。然后会话因速率限制而停止，进度完成 70%。

通过 OpenRouter 路由 Claude Code 就是让会话保持活跃的方法。OpenRouter 位于 Claude Code 与 Anthropic 的 API 之间，充当可靠性和管理层。它增加了供应商故障切换、预算控制和使用情况可见性，并且无需运行本地代理。设置只需三个环境变量。本文涵盖该设置、模型路由、快速模式和成本计算。

团队场景同样实用。多名开发者同时运行 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 然后重新启动，否则缓存的登录会覆盖你的变量，导致出现令人困惑的模型未找到错误。使用 /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 负责模型映射，并原样传递高级功能。

这意味着思考块、原生工具使用、流式传输和多轮上下文都能像直接与 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 会话的快速模式

Anthropic 的快速模式提供高达 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 或更新版本。向不支持 “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 美元，上限就提升至每天 1000 次。这些模型的上下文窗口比付费的 Anthropic 模型更小，因此适合用来学习 Claude Code 的工作流程，而非用于生产会话。在 Activity 仪表盘中实时查看费用，这是捕捉会话被路由到比任务所需更重型模型的最快方式。

接入 CI 和终端

相同的路由机制不仅限于本地终端。

对于 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 路由，无需额外配置。

常见问题

我是否需要订阅 Anthropic 才能将 Claude Code 与 OpenRouter 一起使用？

请求会通过您的 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% 的使用折扣。具体条款请参阅隐私政策。

什么是快速模式？哪些模型支持它？

快速模式能以最高 2.5 倍的输出速度运行，需支付溢价，由 Anthropic 第一方提供商提供。该模式仅在 Claude Opus 4.6、4.7 和 4.8 上可用。在 Claude Code 中使用 `/fast` 切换。

如果 Anthropic 的 API 对我进行速率限制，会发生什么？

OpenRouter 会自动故障转移到提供相同模型的其他 Anthropic 提供商，因此会话会继续运行而无需重新连接。您只需为实际处理请求的提供商所对应的费率付费。