首页 › Claude Code › OpenRouter
概览安装CLI 参考文档定价与限制Agent SDK技能与插件GitHub网页、桌面与 IDE模型错误是否开源?教程学生指南QA 自动化与 Cursor 对比与 Codex 和 OpenCode 对比子智能体钩子MCP生态系统VS CodeOpenRouter速率限制中文指南
最后更新:2026 年 11 月

如何在 Claude Code 中使用 OpenRouter(以及何时不宜使用)

人们将 Claude Code 连接到 OpenRouter,通常出于两种不同的原因:通过已有账户支付 Claude 的费用,或在 Claude Code 中运行其他厂商的模型。两种方式都可行,但在花上一下午配置之前,有些注意事项值得先了解。

TLDR

  • 方案 1:通过以下方式连接 OpenRouter 的 Anthropic 兼容端点 ANTHROPIC_BASE_URL + 你的 OpenRouter 密钥——仅支持 Claude 模型,费用为标价加上 OpenRouter 的手续费。
  • 方案 2: claude-code-router 置于 Claude Code 前端——可按任务使用任意 OpenRouter 模型,代价是需要本地代理,并且偶尔会遇到工具调用问题。
  • 非 Claude 模型对 Claude Code 工具模式的处理能力参差不齐;预计会需要更多重试。
  • 如果你只想使用 Claude,Claude 网关比 OpenRouter 更便宜:相同模型按面值的 7.69231 倍收费,而不是标价加手续费。

方案 1:将 Claude Code 直接连接到 OpenRouter

除了 OpenAI 风格的 API,OpenRouter 还提供兼容 Anthropic 的 Messages 端点。Claude Code 只需要基础 URL 和密钥,因此配置时使用的就是连接任何网关时都会用到的那两个变量——如果下方的基础路径已变更,请查看 OpenRouter 文档以获取当前路径:

export ANTHROPIC_BASE_URL=https://openrouter.ai/api
export ANTHROPIC_AUTH_TOKEN=sk-or-...     # your OpenRouter key
claude --model anthropic/claude-sonnet-5   # OpenRouter's model id format

模型 ID 遵循 OpenRouter 的 vendor/model 命名方式,各档位变量中也要使用这一命名方式(ANTHROPIC_DEFAULT_SONNET_MODEL 及其他相关变量)。运行 /status 以确认端点,并使用 /model 进行切换。计费遵循 OpenRouter 的规则:模型标价加上 OpenRouter 对充值额度收取的平台手续费,因此此方案的费用比直接使用 Anthropic 略*高*——它的意义在于便利和统一账户,而非价格优势。

方案 2:使用 claude-code-router 运行非 Claude 模型

claude-code-router 是一个本地代理,它接收 Claude Code 的请求,并根据规则将每个请求转发给你选择的提供商——默认、后台、思考、长上下文。使用你的密钥将 OpenRouter 配置为提供商,为每条路由选择模型,然后通过以下命令启动 ccr code。人们就是通过这种方式在 Claude Code 中运行开放权重模型或其他厂商的模型。

// ~/.claude-code-router/config.json (excerpt)
{
  "Providers": [{
    "name": "openrouter",
    "api_base_url": "https://openrouter.ai/api/v1/chat/completions",
    "api_key": "sk-or-...",
    "models": ["anthropic/claude-sonnet-5", "google/gemini-2.5-pro", "deepseek/deepseek-chat"]
  }],
  "Router": { "default": "openrouter,anthropic/claude-sonnet-5", "background": "openrouter,deepseek/deepseek-chat" }
}

会遇到哪些问题:Claude Code 的智能体循环依赖 Anthropic 的工具使用格式,路由器必须将其转换为 OpenAI 风格模型所用的格式。能力强的模型可以应对;较小的模型则会漏掉工具调用、编造文件路径,或忽略权限协议,使会话陷入反复重试。将*默认*和*思考*路由保留在 Claude 模型上,其他路由用于后台工作,就是一种不错的配置。

实际费用是多少

  • 直接使用 OpenRouter:Anthropic 标价 + OpenRouter 手续费。很方便,但绝不会比 Anthropic 更便宜。
  • claude-code-router + OpenRouter:费用取决于路由所选模型的价格;节省来自将后台任务交给低价模型,而不是 Claude 本身更便宜。
  • Claude 网关(本站):提供相同的 Claude 模型,按标价从额度中扣费,额度购买价格比面值低 87%($13 → $100 的使用额度);也可选择 $1 起的固定费率无限量套餐。还通过 Codex 分组提供 GPT-6 / GPT-5.x。

如果只想使用 Claude,就跳过 OpenRouter

大多数搜索“在 Claude Code 中使用 OpenRouter”的人,想要的是两件事之一:降低 Claude 费用,或无需 Anthropic 控制台账户就能付款。OpenRouter 解决了后者,却让前者变得更糟。网关可以同时解决这两个问题——使用相同的两个变量,无需代理:

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_gateway_key
claude

这两种方案还可以组合使用:在 claude-code-router 中将此网关定义为 Anthropic 类型的提供商,将 Claude 各档位路由到它,同时把后台任务发送到其他地方。生态系统指南对该路由器有更深入的介绍。

计划时长价格
1 小时不限量1 小时$1
24 小时不限量24 小时$10
1 周不限量1 周$49
15 天不限量15 天$89

所有不限量套餐 →

先免费试用

新账户可获得 $5 免费 API 额度 使用优惠码 CLAUDECODE — 足够用 Sonnet 运行 Claude Code 一晚,之后可获得面值 7.69231 倍的额度。

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

使用优惠码 CLAUDECODE 创建账户

常见问题

Claude Code 可以使用 OpenRouter 吗?

可以——直接通过 OpenRouter 的 Anthropic 兼容端点使用 Claude 模型,或通过 claude-code-router 使用任意 OpenRouter 模型。直接连接时,设置 ANTHROPIC_BASE_URL 和你的 OpenRouter 密钥即可。

在 Claude Code 中使用 OpenRouter 更便宜吗?

不。OpenRouter 收取 Anthropic 标价,再加上自己的手续费。只有将后台任务路由到更便宜的非 Claude 模型,或使用以低于标价的价格提供相同模型的 Claude 网关,才能节省费用。

通过 OpenRouter 在 Claude Code 中使用哪些模型效果最好?

毫不意外,是 Claude 模型——智能体循环就是围绕 Anthropic 的工具格式构建的。其他能力强的模型可以配合路由器使用;小模型则难以处理工具调用。

通过网关运行 Claude Code

相同的模型,两个环境变量,面值 7.69231 倍的额度,或固定费率不限量方案。 新账户:使用优惠码 CLAUDECODE 可获得 $5 免费 API 额度。

获取 API 密钥 查看不限量方案

AI Prime Tech 是独立的 API 网关,与 Anthropic 无关联,也未获得其认可或赞助。“Claude”和“Claude Code”是 Anthropic 的商标。此处介绍的 Claude Code 功能以撰写时 Anthropic 的公开文档为依据,且经常发生变化;本页面的价格和模型列表读取自此网关的实时设置。

更多 Claude Code 指南

Claude Code:完整指南如何安装 Claude CodeClaude Code CLI 文档:命令与参数Claude Code 定价与限制详解Claude Code SDK,现已更名为 Claude Agent SDKClaude Code 技能与插件在 GitHub 中使用 Claude Code:App、Action 和 @claudeClaude Code 有网页界面吗?网页、桌面与 IDE 版本详解Claude Code 使用哪个模型,以及如何更改Claude Code 错误及修复方法Claude Code 开源吗?Claude Code 教程:您的首次实际会话学生使用 Claude:Claude Code、API,以及教育优惠实际提供什么如何使用 Claude Code 实现 QA 自动化Claude Code 与 Cursor 对比:如何选择、何时使用,以及如何同时使用两者Claude Code、Codex 与 OpenCode:终端智能体对比Claude Code 子智能体:工作原理、定义方法与智能体团队Claude Code 钩子:以确定性方式控制智能体的行为Claude Code MCP:连接服务器、作用域、远程 MCP 与实际示例Claude Code 生态系统:路由器、框架、插件及收录它们的清单在 VS Code 中使用 Claude Code:扩展、终端方式与常见错误Claude 速率限制错误:“API error: rate limit reached”的含义与解决方法Claude Code 怎么用:从安装到日常使用