跳到正文
OpenRouter：Announcements·· 2 天前精选AI 评分70

Claude Code 触发用量上限后如何用 OpenRouter 继续编码

Hit Your Claude Code Usage Limit? How to Keep Coding

AI 导读

OpenRouter 介绍 Claude Code 触发用量上限时改用 OpenRouter API key 继续编码的方法：设置三个环境变量或用 Ori Harness 的 ori claude 命令，即可按 token 付费使用同样的 Claude 模型，没有五小时和每周限制。

推荐理由

OpenRouter 实测了 Claude Code 走 API key 计费的真实成本，并提醒 Claude Code 自印的价格可能偏高。

正文 · AI 翻译

当你的 Claude Code 用量达到上限时，可以改用 OpenRouter API 密钥继续运行 Claude Code 来写代码。通过 OpenRouter，Claude Code 使用按 token 计费的 API 密钥运行，模型仍是同样的 Claude 模型，而且没有五小时窗口限制。你只需设置三个环境变量，等套餐额度重置后再切回原套餐即可。

我们用 Claude Code 实测了这套配置。下面的输出和费用都来自这些实际运行。

简要说明

  • 你的 Claude 套餐有五小时限额和每周限额。OpenRouter API 密钥两者都没有，改为按实际使用的 token 付费。
  • 最快捷的配置方式是 Ori Harness：ori claude 会在该会话中通过 OpenRouter 启动 Claude Code，只需浏览器登录，无需粘贴密钥。
  • 如果想手动配置，可以用三个环境变量让 Claude Code 指向 OpenRouter。我们把它们放进名为 claude-or 的 shell 函数里，这样 claude 仍然使用你的套餐。
  • 先从 Claude Sonnet 5.5 开始。一次典型的短 Claude Code 会话在 Sonnet 5.5 上花费 $0.16，在 Opus 5.5 上花费 $0.31，在 Haiku 5.5 上不到一美分。
  • 不要相信 Claude Code 打印出来的费用。在我们的测试中，它显示某次运行花费 $0.375，而实际账单只有 $0.008。请查看你的密钥或 Activity 页面。
  • 套餐额度重置后，再次输入 claude 即可。无需撤销任何设置。

Claude Code 为什么会触及用量上限？

Claude 套餐有两个同时生效的限制。第一个在你发出首个提示词五小时后重置，第二个每七天重置一次。Anthropic 并未公布两者的确切提示词数量。Claude Code 消耗的 token 远多于普通聊天，因此可能在任务进行到一半时就用完额度。此时 Claude Code 会停止运行，并告知你额度何时重置。Anthropic 关于用量限制的帮助文章对这两个限制都有说明。

OpenRouter API 密钥不是这样运作的。你按使用的每个 token 付费，只要账户还有余额就可以一直用下去。

最快捷的方式：通过 Ori Harness 运行 Claude Code

Ori Harness 会用 OpenRouter 设置启动你机器上已有的 Claude Code。安装它，然后通过它启动 Claude Code：

curl -fsSL https://openrouter.ai/labs/ori/install.sh | bash
ori claude --model anthropic/claude-sonnet-5.5

Ori 会打开浏览器，让你用 OpenRouter 账户登录。它使用 OAuth，因此无需创建或粘贴密钥。只有用 ori claude 启动的会话才走 OpenRouter，所以直接运行 claude 仍使用你的套餐；套餐额度重置后，输入 claude 即可切回。用量会计入你的 OpenRouter 账单。如果你属于某个组织，账户上设置了预算上限的 guardrail 会限制其可花费的金额，OpenRouter 也会将其应用于 Ori 会话。

下面的步骤用 API 密钥和 shell 函数手动实现同样的效果。如果你想要一个自带信用额度、且适用于任何账户的密钥，可以用这些步骤。第 4 步的费用建议对两种方式都适用。

第 1 步：获取 OpenRouter API 密钥并设置限额

在 API keys 页面创建一个密钥，并为其设置信用额度。我们把额度设为 $4。这样即使会话很长，花费也不会超过 $4。信用额度是控制 OpenRouter 支出的多种方式之一。我们关于在团队中管理 AI 支出的指南介绍了其他方式。

要检查限额，可以向我们的 API 查询你的密钥：

curl https://openrouter.ai/api/v1/key \
  -H "Authorization: Bearer $OPENROUTER_API_KEY"

这是响应中关键的部分：

{
  "data": {
    "limit": 4,
    "limit_remaining": 4,
    "usage": 0
  }
}

limit_remaining 这个数字告诉你密钥上还剩多少钱。你可以随时运行这项检查。发出请求后，新总额可能需要几秒钟才会显示。

第 2 步：添加一个切换到你的密钥的命令

你可以把这些变量加到 shell 配置文件里，但那样每个 Claude Code 会话都会消耗你的密钥。我们希望平时用的 claude 命令继续走你的套餐，所以把这些变量放进一个小 shell 函数里。把下面这段加到 ~/.zshrc 或 ~/.bashrc 中：

claude-or() {
  ANTHROPIC_BASE_URL="https://openrouter.ai/api" \
  ANTHROPIC_AUTH_TOKEN="$OPENROUTER_API_KEY" \
  ANTHROPIC_API_KEY="" \
  ANTHROPIC_DEFAULT_SONNET_MODEL="anthropic/claude-sonnet-5.5" \
  ANTHROPIC_DEFAULT_OPUS_MODEL="anthropic/claude-opus-5.5" \
  ANTHROPIC_DEFAULT_HAIKU_MODEL="anthropic/claude-haiku-5.5" \
  CLAUDE_CODE_SUBAGENT_MODEL="anthropic/claude-haiku-5.5" \
  claude "$@"
}

前三行是关键：

  • ANTHROPIC_BASE_URL 让 Claude Code 把请求发给我们。
  • ANTHROPIC_AUTH_TOKEN 存放你的 OpenRouter 密钥。
  • ANTHROPIC_API_KEY 必须为空。如果不为空，Claude Code 可能会转而尝试登录 Anthropic。

其余四行是可选的。它们告诉 Claude Code，Sonnet、Opus 和 Haiku 分别用哪个 Claude 模型。它们还会把子智能体——也就是 Claude Code 自行启动的较小辅助任务——交给 Haiku 5.5。

这些变量只在你输入 claude-or 时生效。保存文件，再打开一个新终端，函数就准备好了。

Diagram: typing claude in your terminal uses your Claude plan, with its five-hour and weekly limits. Typing claude-or sends the same session to OpenRouter on your API key, pay per token with no usage window, and OpenRouter serves the same Claude models from Anthropic, Amazon Bedrock and Google Vertex.

第 3 步：确认 Claude Code 正在使用你的密钥

开始正式工作之前，先确认 Claude Code 把请求发给了 OpenRouter，而不是你的套餐。最快的办法是发一条简短的提示词，看看是哪个模型回答的。在终端里运行：

claude-or --model sonnet -p "Reply with exactly: ok" --output-format json

这是我们回复中关键的部分：

{
  "is_error": false,
  "result": "ok"
}

回复正常返回，没有报错。完整输出里的 modelUsage 字段会写明是哪个模型回答的，在我们的运行中是 anthropic/claude-sonnet-5.5。我们用 --model haiku 跑了同一条提示词，modelUsage 显示的是 anthropic/claude-haiku-5.5。

然后再次运行第 1 步的密钥检查。如果 usage 增加了，说明请求计费到了你的密钥上，而不是套餐。如果没有增加，说明 Claude Code 没有读到这些变量。打开一个新终端再试一次。

第 4 步：控制成本

用密钥时，每条消息都要付费。下表是我们对三个 Claude 5.5 模型的定价，也列出了 OpenRouter 上真实 Claude Code 会话（2 到 9 条消息）的费用中位数。

模型每 100 万输入 token 价格每 100 万输出 token 价格会话费用中位数（2 到 9 条消息）
Claude Opus 5.5$4.00$20.00$0.305
Claude Sonnet 5.5$2.00$10.00$0.155
Claude Haiku 5.5$0.10$0.50$0.007

价格截至 2026 年 10 月 21 日。会话费用来自我们的会话费用数据集，覆盖截至 2026 年 10 月 18 日的 30 天。

先从 Sonnet 5.5 开始。它的单次会话费用大约是 Opus 5.5 的一半，能应付大多数日常编码。遇到难题时，输入 /model opus 切换过去，做完再切回来。如果你在我们的 API 上构建自己的应用，还可以在较便宜的模型对答案没把握时，自动把请求转给更强的模型。

每个新会话一开始都会带上约 28,000 个 token 的 Claude Code 自身指令和工具列表（我们在 Claude Code 2.1.307 上运行时是 28,156 个，这个数字会随版本变化）。它们会在第一次请求时写入提示词缓存，所以第 3 步里那条一个词的提示词，在 Sonnet 5.5 上大约花费 $0.07，在 Haiku 5.5 上不到半美分。

子智能体用 Haiku 很便宜。我们让 Sonnet 5.5 启动一个子智能体时，主智能体运行在 Sonnet 5.5 上，子智能体运行在 Haiku 5.5 上，与函数的设置一致。

Haiku 也能自己处理小修复。我们给 Haiku 5.5 一个购物车文件，里面有两个 bug 和三个失败的测试。它修好了两个 bug，三个测试全部通过，这次运行计费 $0.008。

不要依赖 Claude Code 显示的费用。那次 Haiku 运行中，Claude Code 报告的是 $0.375，但我们实际被计费 $0.008。Claude Code 用 Anthropic 自己的价格表来估算会话费用，遇到不认识的 OpenRouter 模型名时只能靠猜。想知道真实花费，用第 1 步的命令查看 limit_remaining，或者打开你的活动页面。

第 5 步：套餐重置后切回来

当套餐额度重置后，输入 claude 而不是 claude-or。你不需要改动任何东西，因为 OpenRouter 的设置只存在于这个函数内部。在我们的测试中，直接使用 claude 时，请求由套餐内的模型作答，而我们 OpenRouter 密钥的用量没有变化。

如果 API 密钥的额度用完了会怎样？

当密钥达到额度上限，或账户余额耗尽时，我们会在请求到达模型之前就将其拦截，并返回一个错误。错误信息中包含一个 limit_source 字段，说明具体原因：

  • openrouter_key_limit 表示该密钥的额度已用完。
  • openrouter_credits 表示你的账户余额不足。

要继续使用，可以在 API 密钥页面提高该密钥的额度，或为账户充值。我们的额度说明页面介绍了各种类型的额度，包括团队管理员可以设置的额度。

常见问题

OpenRouter 对 Claude Code 有使用限制吗？

没有五小时或每周的限制。唯一的限制与花费有关：你的余额有多少、你为密钥设置的额度，以及团队管理员设定的预算。

这些模型和我 Claude 套餐里的一样吗？

一样。它们都是 Anthropic 的 Claude 模型。我们从 Anthropic 以及 Amazon Bedrock、Google Vertex 等云服务商获取这些模型，如果某个服务商出现问题，我们会把请求转给另一家。使用 Claude Code 时，我们建议把 Anthropic 设为首选服务商，因为 Claude Code 只在 Anthropic 上保证可用。

额度用完后，我可以改用更便宜的模型吗？

可以。Sonnet 5.5 每个会话的费用约为 Opus 5.5 的一半，Haiku 5.5 每个会话不到一美分。你也可以在函数的某个变量里换成其他模型。很多人通过 OpenRouter 在 Claude Code 里使用其他模型。本月，GLM 5.3 Flash 是我们应用页面上的 Claude Code 中用量第二高的模型，仅次于 Claude Opus 5.5。不过 Claude Code 是为 Claude 模型打造的，所以换用其他模型时，建议先拿小任务试一试。如果你在自己的代码里调用我们的 API，还可以列出备用模型，这样第一个模型失败时，请求会转到第二个模型。想了解更多降低单次请求费用的方法，请参阅我们的 OpenRouter 最低成本 LLM 推理指南。

Claude Code 的使用限制什么时候重置？

五小时限制会在该时间窗口内第一个提示词发出五小时后重置。每周限制会在开始七天后重置。Claude Code 在阻止你继续使用时，会显示重置时间，这样你就知道什么时候可以再次输入 claude。

如何查看我还剩多少用量？

在 Claude 套餐中，Claude Code 会在阻止你使用时告诉你额度何时重置。在 OpenRouter 上，可以用 GET /api/v1/key 查看 limit_remaining，或打开你的 Activity 页面。

后续步骤

我们的Claude Code 设置指南提供了完整的设置步骤，包括一条在工作时显示费用的状态栏。如果你想每天都用 OpenRouter 搭配 Claude Code，而不只是在额度用完时，我们的 Claude Code 教程会带你一步步完成。如果想在 OpenRouter 上运行而不必管理密钥，Ori Harness 可以用一条命令启动 Claude Code 或其他智能体 CLI。如果你是为团队配置，工作区预算可以让你限制每个团队的花费。

来源：OpenRouter：Announcements · openrouter.ai

OpenRouterAI 编码教程实践#教程/实践#编码