如何在 OpenRouter 中使用 Claude Code?
将 base URL 设置为 https://openrouter.ai/api，把你的 OpenRouter API 密钥放入 ANTHROPIC_AUTH_TOKEN，并将 ANTHROPIC_API_KEY 留空。这样 Claude Code 会直接连接 OpenRouter，无需本地代理，费用从你的 OpenRouter 积分中扣除。
本文介绍的就是 OpenRouter 官方的 Claude Code 指南 中的配置方法。按照该指南的说法，Claude Code 会直接用其原生协议与 OpenRouter 通信，不需要本地代理服务器。这也是它与 Claude Code Router 等工具的主要区别，后者需要在你的机器上运行代理（如果你想走这条路线，请参阅我们的 Claude Code Router 指南）。
本文其余部分将介绍具体的变量、放置位置、OpenRouter 声明的注意事项、费用构成，以及免费积分如何抵扣这些费用。
精选初创企业AI积分
通过这些已认证的计划直接申请。
OpenRouter 需要哪些环境变量?
三个变量起关键作用。指南要求填写包含协议部分的完整 OpenRouter API 地址，因此只写域名是不行的。
| 变量 | 值 | 原因 |
|---|---|---|
| ANTHROPIC_BASE_URL | https://openrouter.ai/api | 将 Claude Code 的流量发送至 OpenRouter |
| ANTHROPIC_AUTH_TOKEN | 你的 OpenRouter API 密钥 | 用于向 OpenRouter 进行身份验证 |
| ANTHROPIC_API_KEY | 空字符串 | 明确留空，以避免冲突 |
在搜索 claude code base url openrouter 的答案时，人们最常出错的正是 base URL 这一项。请严格使用 https://openrouter.ai/api，开头必须带上 https://。
将 ANTHROPIC_API_KEY 留空很重要，因为 Claude Code 会同时读取这两个变量。如果仍设置着旧的 Anthropic 密钥，它可能与 OpenRouter 令牌发生冲突。
变量应放在哪里，哪里又不行?
有两个受支持的位置，还有一个行不通的位置。
方案一：你的 shell 配置文件。 OpenRouter 推荐这种方式以实现持久化。将变量添加到其中，然后重新加载 shell。指南对重新加载说得很直接：如果跳过这一步，你测试的仍是旧环境，然后会错误地认为配置有问题。
方案二：项目级设置文件。 你也可以在项目根目录使用 .claude/settings.local.json。这样配置只作用于单个项目。
不要使用 .env 文件。 指南说明不要把这些变量放在项目级 .env 文件中，因为原生 Claude Code 安装程序不会读取标准的 .env 文件。
还有一个陷阱：如果你的 OpenRouter 密钥保存在 ANTHROPIC_AUTH_TOKEN 所引用的另一个变量中，必须在它被读取之前先定义好，否则身份验证会失败。指南建议使用更早加载的文件，例如 zsh 对应的 ~/.zshenv。
精选初创企业AI积分
通过这些已认证的计划直接申请。
如何分步完成设置?
第一步：通过 AI Perks 获取积分
通过 OpenRouter 使用 Claude Code 是从你的 OpenRouter 积分中扣费的，因此首先要找到免费积分。AI Perks 指南 列出了 最高 $3,000 的 OpenRouter 积分，以及 Anthropic 积分，如果你使用自己的密钥，也可以用这些积分。在花费自己的钱之前，请先查看目录中的金额和详细信息。
第二步：创建 OpenRouter API 密钥
在你的 OpenRouter 账户设置中生成密钥。这就是要填入 ANTHROPIC_AUTH_TOKEN 的值。
第三步：添加变量
将 base URL、认证令牌以及留空的 ANTHROPIC_API_KEY 放入你的 shell 配置文件，或 .claude/settings.local.json 中。不要使用 .env 文件。完成后重新加载 shell。
第四步：如有需要，运行 /logout
如果你之前用 Anthropic 账户登录过 Claude Code，请运行一次 /logout 以清除缓存的会话。然后退出并重新启动 claude，使其读取新变量。如果你从未用 Anthropic 账户登录过，可以跳过这一步。
第五步：用 /status 验证
在 Claude Code 中运行 /status 以确认连接。然后查看你的 OpenRouter 控制面板：其中会显示用量，包括推理 token。
OpenRouter 声明了哪些注意事项?
指南对限制说得很清楚，它们会影响你的配置方式。
- 仅限 Anthropic 第一方。 通过 OpenRouter 使用 Claude Code 只保证能与 Anthropic 第一方提供商配合工作。为获得最佳兼容性，OpenRouter 建议将 Anthropic 1P 设为最高优先级的提供商。
- 其他模型可能无法正常工作。 Claude Code 针对 Anthropic 模型进行了优化，与其他提供商配合时可能无法正确运行。请将非 Anthropic 模型视为实验性选项，而非默认选择。
- 上下文窗口假设。 除非模型名称以
[1m]结尾，否则 Claude Code 默认假设上下文窗口为 200k。 - 故障转移。 通过 OpenRouter 路由时，请求会在多个 Anthropic 提供商之间自动切换。
- 隐私。 除非你在账户设置中主动选择开启提示词日志记录，否则 OpenRouter 不会记录你的源代码提示词。
第一条注意事项正是搜索 "claude code openrouter free" 时需要谨慎的原因。OpenRouter 确实提供免费模型，但这些模型有使用上限，而且 Claude Code 只保证在 Anthropic 第一方上运行。免费模型的限制为每分钟 20 次请求、每天 50 次，在你至少购买 $10 积分后，每天的上限会提高到 1,000 次。完整说明请参阅我们的 OpenRouter 免费套餐指南。
精选初创企业AI积分
通过这些已认证的计划直接申请。
能否通过 OpenRouter 使用快速模式?
可以，但仅限特定条件。Anthropic 的快速模式可将输出速度提升至 2.5x，但定价高于底层 Opus 模型的标准 token 费率。
| 要求 | 详情 |
|---|---|
| 模型 | Claude Opus 4.6、4.7、4.8 以及 Claude Opus 5 |
| Claude Code 版本 | v2.1.96 或更高 |
| 环境变量 | 使用 /fast 需设置 CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK=1 |
| 提供商 | 仅限 Anthropic 第一方 |
| 模型设置 | 将 Opus 变量固定为特定 ID，例如 anthropic/claude-opus-5 |
快速模式仅由 Anthropic 第一方提供商提供，因为 Amazon Bedrock 和 Google Vertex 等其他提供商并不支持。要真正用上它，请将 Opus 模型变量固定为某个具体的 Opus ID，而不是最新的别名。指南在此未公布溢价倍数，因此在依赖它之前，请先核实当前费率。
通过 OpenRouter 使用 Claude Code 与直接使用 Anthropic 相比费用如何?
OpenRouter 不会对推理费用加价。在所有套餐中，推理均按提供商的标价计费。手续费仅在你购买积分时收取，不会针对单次请求收取。
以下是购买 $10 积分时的手续费计算：
| 积分购买方式 | 手续费率 | $10 的手续费 |
|---|---|---|
| 非加密货币，Standard | 5.5%，最低 $0.80 | $0.80（$10 的 5.5% 为 $0.55，低于最低额，因此按最低额收取） |
| 加密货币 | 固定 5.0%，无最低额 | $0.50（$10 的 5.0%） |
| 非加密货币，Business | 8% | $0.80（$10 的 8%） |
因此，客观的比较是：每 token 价格为提供商的标价，而 OpenRouter 会在此基础上加收购买手续费。直接向 Anthropic 付费则可避免这笔手续费。你所获得的回报是：一个密钥、一个控制面板，以及在 Anthropic 提供商之间的故障转移。
OpenRouter 定价页面未公布各模型的 token 价格，需要从模型 API 中读取。关于 Anthropic 自身的价格，请参阅我们的 Claude API 定价分析。
BYOK 如何改变计算方式?
Standard 和 Business 套餐每月包含 $25,000 的标价推理额度，通过 BYOK（自带密钥，bring your own key）使用，且无需支付 OpenRouter 手续费。超出该额度后，OpenRouter 会按请求在标价下成本的 5% 收费，并从你的积分中扣除。
使用 BYOK 时，你可以通过自己的提供商账户控制速率限制和费用。这时免费的供应商积分就派上用场了：如果你的提供商账户中有积分，你的 Claude Code 用量就可以使用这些积分，但需遵守该供应商自身的积分条款。
精选初创企业AI积分
通过这些已认证的计划直接申请。
哪些免费积分可以覆盖你的 Claude Code 用量?
以下是与运行 Claude Code 最相关的目录金额。具体详情以及每项福利的内容，请参阅 AI Perks 目录。
| 公司 | 免费积分 | 获取方式 |
|---|---|---|
| OpenRouter | 最高 $3,000 | 获取此福利 |
| Anthropic（直接） | $20,000 | 获取此福利 |
| 通过合作伙伴获取的 Claude | 最高 $100,000 | 获取此福利 |
| AWS（Amazon Bedrock） | $300,000 | 获取此福利 |
以上四项合计：$3,000 + $20,000 + $100,000 + $300,000 = 目录所列积分最高 $423,000。
目录中还列出了 OpenAI、Google Cloud、Azure OpenAI、Mistral AI、Together AI、Cerebras 和 Novita AI 的积分。这些积分主要适用于测试非 Anthropic 模型，但请注意 OpenRouter 的警告：Claude Code 与这些模型配合时可能无法正常工作。若专门关注 Anthropic 方面，请阅读我们的 免费 Anthropic API 密钥指南，并查看目录以了解更多 Claude 积分额度。
常见问题
Claude Code 与 OpenRouter 配合使用时需要本地代理吗?
不需要。OpenRouter 声明，Claude Code 会直接用其原生协议与 OpenRouter 通信，无需本地代理服务器。你只需设置环境变量。Claude Code Router 等基于代理的工具是另一种方式，适用于需要在多个模型之间进行自定义路由规则的场景。
为什么 Claude Code 仍在使用我旧的 Anthropic 登录信息?
你很可能有缓存的会话。运行一次 /logout，然后退出并重新启动 claude，使其读取新变量。另外，请确认你在编辑配置文件后已重新加载 shell，并且 ANTHROPIC_API_KEY 为空。可用 /status 检查结果。
能否免费通过 OpenRouter 使用 Claude Code?
部分可以。新的 OpenRouter 用户会获得少量免费额度，并且存在免费模型，但有每分钟 20 次请求、每天 50 次的上限。不过，Claude Code 只保证在 Anthropic 第一方提供商上运行。如需实际使用，请查看 getaiperks.com 上列出的免费积分。
使用 Claude 模型时，OpenRouter 会对每次请求额外收费吗?
不会。推理按提供商的标价计费，OpenRouter 的手续费在购买积分时收取：Standard 为 5.5%，Business 为 8%。非加密货币购买有 $0.80 的最低手续费，加密货币购买则为固定 5.0%。你可以将此与直接向 Anthropic 付费进行比较，并参考 目录中的 Anthropic 积分。
能否通过 OpenRouter 使用免费的 Anthropic 积分?
通过 BYOK，你可以接入自己的提供商密钥，费用将通过你的提供商账户结算。Standard 和 Business 套餐包含每月 $25,000 的 BYOK 额度，且无需支付 OpenRouter 手续费。如需查找 通过合作伙伴获取、最高价值 $100,000 的 Anthropic 积分，请访问 AI Perks 目录。
为什么我的 Claude Code 上下文窗口是 200k?
除非模型名称以 [1m] 结尾，否则 Claude Code 默认假设上下文窗口为 200k。如果你希望 Claude Code 将窗口视为更大，模型名称必须带上该后缀。指南未公布哪些模型支持此功能的更多细节。
精选初创企业AI积分
通过这些已认证的计划直接申请。
准备好为你的 Claude Code 配置提供资金了吗?
设置只需几分钟，而值得规划的是费用部分：OpenRouter 积分、Anthropic 积分和云积分都统一列在一个目录中，因此你可以在按标价付费之前，为你的用量匹配合适的积分。
在 getaiperks.com 浏览完整的免费 AI 积分目录，用你没有花钱购买的积分运行 Claude Code。
