Source: https://aiprimetech.io/zh/claude-code/openrouter/

[首页](/zh/) › [Claude Code](/claude-code/zh/) › OpenRouter

[概览](/claude-code/zh/)[安装](/claude-code/zh/install/)[CLI 参考文档](/zh/claude-code/cli/)[定价与限制](/claude-code/zh/pricing/)[Agent SDK](/zh/claude-code/sdk/)[技能与插件](/zh/claude-code/skills/)[GitHub](/zh/claude-code/github/)[网页、桌面与 IDE](/zh/claude-code/web-and-desktop/)[模型](/zh/claude-code/models/)[错误](/zh/claude-code/errors/)[是否开源？](/zh/claude-code/open-source/)[教程](/claude-code/zh/tutorial/)[学生指南](/zh/claude-code/for-students/)[QA 自动化](/zh/claude-code/qa-automation/)[与 Cursor 对比](/zh/claude-code/vs-cursor/)[与 Codex 和 OpenCode 对比](/zh/claude-code/vs-codex/)[子智能体](/zh/claude-code/subagents/)[钩子](/zh/claude-code/hooks/)[MCP](/zh/claude-code/mcp/)[生态系统](/zh/claude-code/ecosystem/)[VS Code](/zh/claude-code/vscode/)[OpenRouter](/zh/claude-code/openrouter/)[速率限制](/zh/claude-code/rate-limits/)[中文指南](/claude-code/zh/)

最后更新：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

[所有不限量套餐 →](/zh/plans/)

## 先免费试用

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

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

[使用优惠码 CLAUDECODE 创建账户](/register?promo=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 密钥](/register?promo=CLAUDECODE) [查看不限量方案](/zh/plans/)

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

## 更多 Claude Code 指南

[Claude Code：完整指南](/claude-code/zh/)[如何安装 Claude Code](/claude-code/zh/install/)[Claude Code CLI 文档：命令与参数](/zh/claude-code/cli/)[Claude Code 定价与限制详解](/claude-code/zh/pricing/)[Claude Code SDK，现已更名为 Claude Agent SDK](/zh/claude-code/sdk/)[Claude Code 技能与插件](/zh/claude-code/skills/)[在 GitHub 中使用 Claude Code：App、Action 和 @claude](/zh/claude-code/github/)[Claude Code 有网页界面吗？网页、桌面与 IDE 版本详解](/zh/claude-code/web-and-desktop/)[Claude Code 使用哪个模型，以及如何更改](/zh/claude-code/models/)[Claude Code 错误及修复方法](/zh/claude-code/errors/)[Claude Code 开源吗？](/zh/claude-code/open-source/)[Claude Code 教程：您的首次实际会话](/claude-code/zh/tutorial/)[学生使用 Claude：Claude Code、API，以及教育优惠实际提供什么](/zh/claude-code/for-students/)[如何使用 Claude Code 实现 QA 自动化](/zh/claude-code/qa-automation/)[Claude Code 与 Cursor 对比：如何选择、何时使用，以及如何同时使用两者](/zh/claude-code/vs-cursor/)[Claude Code、Codex 与 OpenCode：终端智能体对比](/zh/claude-code/vs-codex/)[Claude Code 子智能体：工作原理、定义方法与智能体团队](/zh/claude-code/subagents/)[Claude Code 钩子：以确定性方式控制智能体的行为](/zh/claude-code/hooks/)[Claude Code MCP：连接服务器、作用域、远程 MCP 与实际示例](/zh/claude-code/mcp/)[Claude Code 生态系统：路由器、框架、插件及收录它们的清单](/zh/claude-code/ecosystem/)[在 VS Code 中使用 Claude Code：扩展、终端方式与常见错误](/zh/claude-code/vscode/)[Claude 速率限制错误：“API error: rate limit reached”的含义与解决方法](/zh/claude-code/rate-limits/)[Claude Code 怎么用：从安装到日常使用](/claude-code/zh/)