如何在 2026 年结合 OpenRouter 使用 Claude Code

Claude Code 是 Anthropic 推出的强大 CLI 编程智能体，而 OpenRouter 是一个统一的 API 网关，可将请求路由至数十个 AI 模型提供商。通过将两者结合，你可以在享受 Claude Code 的智能体能力的同时，获得更广泛的模型选择和更灵活的计费方式。

本指南将详细展示如何通过 OpenRouter 配置 Claude Code、配置不同的模型、管理成本以及解决常见问题。

为什么通过 OpenRouter 使用 Claude Code？

通过 OpenRouter 路由 Claude Code 有几个实际理由：

优势	描述
多模型访问	在 Claude、GPT-5、Gemini、DeepSeek 等模型间自由切换
按量付费	无需月费订阅，按 Token 使用量计费
速率限制池化	OpenRouter 会管理跨供应商的速率限制
故障转移路由	如果某个供应商宕机，会自动切换到备用路由
成本追踪	提供详细的使用仪表盘和支出控制
统一 API 密钥	一个密钥即可调用所有供应商的模型

前提条件

你需要：

已安装 Claude Code (npm install -g @anthropic-ai/claude-code)
一个 openrouter.ai 的 OpenRouter 账户
OpenRouter 账户中存有余额（建议初始充值至少 $5）

第 1 步：获取你的 OpenRouter API 密钥

登录 openrouter.ai
前往控制面板中的 Keys 选项卡
点击 Create Key
为其命名，例如 "claude-code-cli"
复制密钥（以 sk-or- 开头）

在 Credits 栏目下为你的账户添加余额。OpenRouter 根据你使用的模型按 Token 计费。

第 2 步：配置 Claude Code

Claude Code 支持通过环境变量配置自定义 API 终端节点。在你的 Shell 配置文件中设置以下内容：

选项 A：环境变量（推荐）

添加到你的 ~/.zshrc、~/.bashrc 或 ~/.bash_profile 中：

# Claude Code 的 OpenRouter 配置
export ANTHROPIC_BASE_URL="https://openrouter.ai/api/v1"
export ANTHROPIC_API_KEY="sk-or-your-openrouter-key-here"

重新加载你的 Shell：

source ~/.zshrc  # 或 source ~/.bashrc

选项 B：单次会话配置

如果你只想临时使用 OpenRouter：

ANTHROPIC_BASE_URL="https://openrouter.ai/api/v1" \
ANTHROPIC_API_KEY="sk-or-your-key" \
claude

选项 C：使用 .env 文件

在你的项目根目录创建一个 .env 文件：

ANTHROPIC_BASE_URL=https://openrouter.ai/api/v1
ANTHROPIC_API_KEY=sk-or-your-openrouter-key-here

注意：Claude Code 不会自动加载 .env 文件。你需要使用 direnv 之类的工具或者手动 source：

# 使用 direnv (进入目录时自动加载 .env)
brew install direnv  # macOS
echo 'eval "$(direnv hook zsh)"' >> ~/.zshrc

# 或手动 source
source .env && claude

第 3 步：验证连接

启动 Claude Code 并检查其是否通过 OpenRouter 连接：

claude

你应该能看到 Claude Code 正常初始化。运行一个简单的测试：

You: What model are you? What provider is handling this request?

Claude 的回答应表明它正通过 OpenRouter 运行。

你也可以通过运行 /cost 命令来验证：

/cost

这将显示 Token 使用情况和成本，数据应反映 OpenRouter 的定价。

第 4 步：切换模型

OpenRouter 最大的优势之一是能够访问多个模型。你可以在启动 Claude Code 时指定要使用的模型：

# 使用 Claude Sonnet 4 (Claude Code 默认模型)
claude --model anthropic/claude-sonnet-4

# 使用 Claude Opus 4 处理复杂任务
claude --model anthropic/claude-opus-4

# 通过 OpenRouter 使用 GPT-5
claude --model openai/gpt-5

# 使用 Gemini 2.5 Pro
claude --model google/gemini-2.5-pro

# 使用 DeepSeek V3 (价格极其低廉)
claude --model deepseek/deepseek-chat-v3

可用模型与定价

以下是 OpenRouter 上适合编程任务的热门模型：

模型	输入单价	输出单价	上下文窗口	最适合
claude-opus-4	$15/M	$75/M	200K	复杂逻辑推理
claude-sonnet-4	$3/M	$15/M	200K	日常编程
gpt-5	$5/M	$15/M	200K	代码生成
gpt-4o	$2.5/M	$10/M	128K	快速、高性价比
gemini-2.5-pro	$1.25/M	$5/M	1M	超长上下文
deepseek-chat-v3	$0.27/M	$1.10/M	128K	低预算编程

价格仅为估算，可能会有变动。请查看 openrouter.ai/models 获取当前定价。

第 5 步：设置模型别名

为了方便切换，可以创建 Shell 别名：

# 添加到 ~/.zshrc 或 ~/.bashrc
alias claude-opus='claude --model anthropic/claude-opus-4'
alias claude-sonnet='claude --model anthropic/claude-sonnet-4'
alias claude-gpt5='claude --model openai/gpt-5'
alias claude-cheap='claude --model deepseek/deepseek-chat-v3'
alias claude-long='claude --model google/gemini-2.5-pro'

现在你可以快速选择合适的模型：

claude-cheap "解释这个函数的作用"   # 低成本任务
claude-opus "架构一个微服务迁移方案"  # 复杂任务
claude-long "分析整个代码库"         # 长上下文任务

第 6 步：配置成本控制

OpenRouter 提供支出控制功能，以防止产生意外费用。

设置支出限制

在 OpenRouter 控制面板中：

前往 Settings > Limits
设置月度支出上限（如 $50）
也可以为每个 Key 分别设置限制

监控使用量

实时检查使用情况：

# 在 Claude Code 中查看当前会话成本
/cost

# 查看 OpenRouter 控制面板的历史使用记录
open https://openrouter.ai/activity

成本优化技巧

策略	节省程度
简单任务使用 DeepSeek	比 Claude Opus 便宜 10-50 倍
长上下文任务使用 Gemini	处理大输入时单 Token 成本更低
在 Claude Code 中使用 `/compact`	在会话中途压缩上下文大小
将大任务拆分为集中式会话	避免重复发送完整的历史上下文
一次性任务使用 print 模式	`claude -p "quick question"` 消耗更少 Token

高级配置

备用模型 (Fallback Models)

OpenRouter 支持自动回退。如果你的首选模型被限速或宕机，请求会自动转到备份模型：

# 在请求中配置备用模型 (通过自定义 Header)
export OPENROUTER_FALLBACK_MODELS="anthropic/claude-sonnet-4,openai/gpt-4o"

注意：回退配置取决于 OpenRouter 的 API 设置。请查阅其最新文档了解具体实现。

你可以向 OpenRouter 传递额外的 Header 进行追踪：

export OPENROUTER_REFERRER="https://your-app.com"
export OPENROUTER_APP_TITLE="My Claude Code Setup"

在代理环境中使用

如果你处于公司代理网络之后：

export HTTPS_PROXY="http://proxy.company.com:8080"
export ANTHROPIC_BASE_URL="https://openrouter.ai/api/v1"
export ANTHROPIC_API_KEY="sk-or-your-key"
claude

实际工作流

工作流 1：高效成本开发

使用廉价模型进行探索，使用高级模型进行实现：

# 探索并理解代码库 (廉价)
claude-cheap "解释这个项目的架构"

# 实现功能 (高级)
claude-sonnet "使用 JWT refresh token 实现用户认证"

# 审查与优化 (中等)
claude-gpt5 "审查认证实现的安全性问题"

工作流 2：长上下文分析

当你需要分析庞大的代码库时：

# 使用 Gemini 的 1M Token 上下文
claude-long "分析 src/ 下的所有文件并创建一个依赖图"

工作流 3：自动化 CI/CD

在 CI 流水线中结合 OpenRouter 使用 Claude Code：

# .github/workflows/code-review.yml
name: AI Code Review
on: [pull_request]
jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: npm install -g @anthropic-ai/claude-code
      - run: |
          gh pr diff ${{ github.event.pull_request.number }} | \
          ANTHROPIC_BASE_URL="https://openrouter.ai/api/v1" \
          ANTHROPIC_API_KEY="${{ secrets.OPENROUTER_KEY }}" \
          claude -p --model deepseek/deepseek-chat-v3 \
          "简要审查此 diff 中的 bug 和安全问题。"
        env:
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

故障排除

问题	解决方案
"Invalid API key"	检查密钥是否以 `sk-or-` 开头且账户有余额
"Model not found"	在 openrouter.ai/models 中检查确切的模型 ID
响应速度慢	尝试切换模型或查看 OpenRouter 状态页
"Rate limited" (限速)	等待片刻或切换到不同的模型/供应商
"Context too long"	使用 `/compact` 或切换到上下文窗口更大的模型
"Connection refused"	检查 `ANTHROPIC_BASE_URL` 是否正确以及网络连接
意外扣款	在 OpenRouter 控制面板设置支出限额

恢复到 Anthropic 直接连接

若要切换回直接使用 Anthropic：

# 移除 OpenRouter 配置
unset ANTHROPIC_BASE_URL
export ANTHROPIC_API_KEY="sk-ant-your-anthropic-key"
claude

结论

将 Claude Code 与 OpenRouter 结合使用可以让你兼得两者的优势：Anthropic 强大的编程智能体，以及多供应商网关带来的灵活性和成本优化。你可以从预算模型开始探索，在处理复杂任务时切换到顶级模型，并通过统一的仪表盘追踪每一分钱的开支。

如果你的开发工作涉及 AI 生成的媒体素材（如图像、视频或音频），Hypereal AI 以实惠的价格提供生产级的媒体生成 API。将其与你的 Claude Code + OpenRouter 环境结合，即可构建完整的 AI 驱动应用程序。