OpenRouter 接入 Claude Code 与 Codex CLI
Anthropic (Claude Code) 风控越来越严格了，想在国内使用 Claude Opus 和 Claude Sonnet 越来越难，每天要和 Anthropic 斗智斗勇，IP、时区、语言设置甚至在海外远程 Mac 操作 Claude Code。尽管如此谨慎，还是难逃 KYC 认证和封号的风险。
如果是轻量使用，可以在全球最大的中转站 OpenRouter 来使用最先进 Claude Opus、 Claude Sonnet 和 GPT 模型，虽然比官方的订阅贵上不少（OpenRouter 按 token 结算），但是胜在稳定，正常封号风险较低，适合个人开发者。搭配国产模式一起使用会更香。下面是使用教程。
准备
- Claude Code 与 Codex CLI 安装
- Apple Pay 绑定外币信用卡（账单地址需要填写美国，可以用美国地址生成器）
- 美国梯子（推荐Just My Socks）
目录
一、注册与充值
1.1 充值入口
- 在 openrouter.ai 注册登录。
- 打开 Credits 页：openrouter.ai/settings/credits。
- 点 Add Credits，或者 Auto Top-Up 绑定信用卡订阅（自动扣款），有手续费，最低0.8刀，超过15刀收 5.5% 。
- 跳转 stripe.com 后使用 Apple Pay 或信用卡支付。
会提示 Your billing address is in a region that does not have access to models from OpenAI, Anthropic, and Google. All other models remain available. 但是实测经过美国梯子调用API使用国外模型是可以的，直连API则会提示禁止。
支持加密货币支付，加密支付（USDC）为 5%
1.2 退款与过期
- 交易处理后 24 小时内可在 Credits 页用退款按钮申请未使用余额退款，退回原支付方式；平台手续费不退；加密货币支付一律不退。
- 官方 FAQ 明确保留让"购买满一年后仍未使用"的额度到期的权利。这不是"某天必然清零"，但同样别一次囤太多。
- 你所在地区的服务可用性、网络连通性与适用条款请自行确认；支付可用不等于所有模型在所有地区可用。
二、建 API Key 与预算控制
- 打开 Workspaces - Default - API keys openrouter.ai/workspaces/default/keys，API keys，New key 新建得到
sk-or-v1-...形式的 Key 记录好。 - 给每个客户端各建一把 Key（如
claude-code、codex），便于按 Key 看用量、按 Key 设上限、泄露可以单独吊销。 - Key 只写进本地环境变量或本地配置文件。"本地"不等于安全：dotfiles 仓库、备份、同步盘都可能把泄露出去。
三、对接 Claude Code
Claude Code 使用 Anthropic Messages 协议。OpenRouter 官方提供了兼容层，行为模仿 Anthropic API，负责模型映射并透传 thinking 块与原生 tool use，如果是使用梯子记得开启虚拟网卡模式代理shell环境。
3.1 安装
# macOS / Linux / WSL（官方推荐的原生安装）
curl -fsSL https://claude.ai/install.sh | bash
# 或者走 npm（需要 Node.js 18+）
npm install -g @anthropic-ai/claude-code
3.2 环境变量（注意 base_url 不带 /v1）
macOS / Linux 写进 ~/.zshrc 或 ~/.bashrc：
export OPENROUTER_API_KEY="sk-or-v1-你的key"
export ANTHROPIC_BASE_URL="https://openrouter.ai/api"
export ANTHROPIC_AUTH_TOKEN="$OPENROUTER_API_KEY"
export ANTHROPIC_API_KEY="" # 必须显式置空
export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1 # 可选：开启网关模型选择器
Windows（PowerShell，写成用户级变量后重开终端）：
setx OPENROUTER_API_KEY "sk-or-v1-你的key"
setx ANTHROPIC_BASE_URL "https://openrouter.ai/api"
setx ANTHROPIC_AUTH_TOKEN "sk-or-v1-你的key"
setx ANTHROPIC_API_KEY ""
setx CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY "1"
四个要点都是有原因的 ：
- base_url 是
https://openrouter.ai/api，不要加/v1； - 用
ANTHROPIC_AUTH_TOKEN：OpenRouter 是 bearer token 网关，Claude Code 会把该变量放进Authorization: Bearer <token>请求头；而ANTHROPIC_API_KEY会被当作"直连 Anthropic 的凭据"放进x-api-key，还会在交互模式里多问一次； ANTHROPIC_API_KEY必须显式置空，否则 Claude Code 可能回退去用 Anthropic 官方登录态；- 变量顺序有讲究：
ANTHROPIC_AUTH_TOKEN="$OPENROUTER_API_KEY"在 source 时展开，若OPENROUTER_API_KEY定义在后面或由 secrets manager 晚注入，token 会展开成空串，之后每个请求都认证失败。
改完 source ~/.zshrc（或重开终端），否则当前终端可能仍在用旧环境变量。
3.3 曾登录过 Anthropic 的，先 logout
以前用 Anthropic 账号登录过 Claude Code 的，先跑一次 /logout 清掉缓存登录态。官方说明：缓存登录与网关凭据并存会触发认证冲突，典型表现是莫名其妙的 model-not-found（如 openrouter/auto、openrouter/pareto-code 这类 OpenRouter 专属模型报找不到）。然后退出并重启 claude。
3.4 验证
在项目目录里跑 claude，然后：
> /status
Auth token: ANTHROPIC_AUTH_TOKEN
Anthropic base URL: https://openrouter.ai/api
若 Auth token 显示的是 ANTHROPIC_API_KEY，或出现指向 Claude 账号的 Login method，说明环境没进去，重载 shell 再启动。也可以看 openrouter.ai/activity 是否有实时请求进来。
3.5 按角色分配模型
Claude Code 用几个环境变量决定哪类任务用哪个模型，可直接填 OpenRouter 模型 ID：
export ANTHROPIC_DEFAULT_FABLE_MODEL="~anthropic/claude-fable-latest[1m]"
export ANTHROPIC_DEFAULT_OPUS_MODEL="~anthropic/claude-opus-latest[1m]"
export ANTHROPIC_DEFAULT_SONNET_MODEL="~anthropic/claude-sonnet-latest[1m]"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="~anthropic/claude-haiku-latest"
export CLAUDE_CODE_SUBAGENT_MODEL="~anthropic/claude-opus-latest[1m]"
四、对接 Codex CLI
Codex CLI 是 OpenAI 的开源本地编码 agent，原生支持多个 model provider；OpenRouter 提供了专门的 Codex CLI 接入指南 [官方文档]。
4.1 安装
# macOS / Linux
curl -fsSL https://chatgpt.com/codex/install.sh | sh
# 或者
npm install -g @openai/codex
# 或者
brew install --cask codex
4.2 写 ~/.codex/config.toml
model_provider = "openrouter"
model_reasoning_effort = "high"
model = "~openai/gpt-sol-latest"
[model_providers.openrouter]
name = "openrouter"
base_url = "https://openrouter.ai/api/v1"
[model_providers.openrouter.auth]
command = "sh"
args = ["-c", "echo $OPENROUTER_API_KEY"]
三个关键点：
- 这里的 base_url 带
/v1（https://openrouter.ai/api/v1），和 Claude Code 的https://openrouter.ai/api不同 —— 这是最常见的踩坑点。 - 用命令式
auth而不是env_key：两种都能认证，但只有命令式 auth 会触发 Codex 拉取 OpenRouter 的模型目录；用env_key时非 OpenAI 模型会退化成缺省元数据并给 "Unknown model" 警告。 - Windows 上
sh不存在，换 PowerShell：
[model_providers.openrouter.auth]
command = "powershell"
args = ["-NoProfile", "-Command", "Write-Output $env:OPENROUTER_API_KEY"]
别同时叠
auth、env_key、experimental_bearer_token、requires_openai_auth：这几项互斥，已有配置的用户改之前先确认原来用的是哪一种。
4.3 设置 Key 并启动
export OPENROUTER_API_KEY="sk-or-v1-你的key" # 写进 ~/.zshrc / ~/.bashrc / config.fish
cd /path/to/your/project
codex
Windows 用 setx OPENROUTER_API_KEY "sk-or-v1-..." 设为用户级变量，然后完全重启 Codex（桌面版看不到只在终端会话里设的变量）。
4.4 验收步骤
一次走完这四步，能提前挡掉大部分配置问题：
- 启动无配置报错、无 "Unknown model" 警告；
/model能选到你要的 OpenRouter 模型；- 发一句最小请求，返回正常；
- 在 openrouter.ai/activity 看到对应 Key 与模型的记录，再让它做一次受控的文件操作。
五、费用参考与选型
5.1 Claude 模型费用示例
下面是 2026-11-07 从 OpenRouter /api/v1/models 抓取的基础标准价（美元 / 每百万 token）。它只是示例，不代表所有供应商、服务等级或输入长度的最终账单：
| 模型 slug | 输入 | 输出 | 上下文 |
|---|---|---|---|
anthropic/claude-opus-5 |
$5.00 | $25.00 | 1M |
anthropic/claude-sonnet-5.5 |
$2.00 | $10.00 | 1M |
anthropic/claude-haiku-5.5（提示 ≤ 100k token） |
$0.10 | $0.50 | 1M |
anthropic/claude-haiku-5.5（提示 > 100k token） |
$0.50 | $2.50 | 1M |
必须一起读的计费条件：
- Haiku 5.5 有长输入阶梯：提示超过 100,000 token 后输入/输出跳到 $0.50 / $2.50，涨 5 倍；
- 缓存读写、web search、fast/priority 等服务等级都另有计价（同一模型在 API 里就能看到
input_cache_read、web_search等字段）； ~...-latest是解析别名，指向的版本会变，别把上表的固定版本价格当成别名永久价格；- 价格随时调整，下单前看模型页与结算页。
5.2 选型与省钱
- 主模型放 Sonnet 档，Opus 档留给卡住的问题，简单任务可考虑 Haiku 档 —— 但都要在自己的任务上验证质量与成本，不是无脑降级。
- 长会话、反复贴大文件、挂一堆 MCP 会显著推高输入费用；实际成本还受输出长度、推理 token、缓存命中与工具调用影响，不能一概而论。精简 MCP、及时
/clear、用子 agent 隔离探索通常比换模型见效快。 - 想按 Key 看花费和设上限，回看第二节。
六、常见问题
Q1：一把 Key 两个客户端共用行不行？
技术上可以，但建议分开：按 Key 设 guardrail 限额、按 Key 查花费、出问题只吊销一把。
Q2：支付宝付了 $20，为什么到账不是 $20？
因为充值平台费：Standard 5.5%（最低 $0.80），推理本身按供应商标价、不加价；加密支付 5%。$20 在"费用从订单金额扣除"的假设下示例到账 $18.90，实际金额以结算页为准。
Q3：OpenRouter 挂了还能干活吗？
不一定。OpenRouter 能在部分上游供应商故障时尝试切换，但绕不过它自身的服务或网络中断。Key 限额只解决费用风险；需要可用性保障时，应另行准备一条独立接入路径并验证客户端切换配置。
Q4：能省掉官方订阅费吗？
没有普适答案：OpenRouter 是按 token 计费的网关（没有包月额度），官方订阅是固定月费 + 额度。按你每月的实际 token 用量与所需功能算一遍再决定。
Q5：模型、提示词和工具输出会经过谁？
源码、提示词和工具输出都会经过 OpenRouter 与实际提供服务的供应商。用公司代码前先确认组织政策与各方的数据保留设置（OpenRouter 有 opt-in 的提示词日志开关与 ZDR 选项，具体以隐私设置为准）。
参考来源（抓取日期 2026-11-07）
- OpenRouter FAQ（支付方式含 AliPay、$0.80 最低手续费、退款规则、Credits 一年过期权利、Stripe 充值延迟）：https://openrouter.ai/docs/faq [官方文档]
- OpenRouter Pricing（Standard 5.5% / Business 8%、推理不加价）：https://openrouter.ai/pricing [官方文档]
- OpenRouter 平台费变更公告（取消固定 $0.35）：https://openrouter.ai/blog/announcements/simplifying-our-platform-fee/ [官方文档]
- OpenRouter《Claude Code Integration》（base URL、
ANTHROPIC_AUTH_TOKEN、置空ANTHROPIC_API_KEY、/logout、/status、模型变量、fast mode、statusline）：https://openrouter.ai/docs/cookbook/coding-agents/claude-code-integration [官方文档] - OpenRouter《Codex CLI》（
config.toml、/api/v1、auth.command与env_key差异、项目信任级别）：https://openrouter.ai/docs/cookbook/coding-agents/codex-cli [官方文档] - OpenRouter Provider Routing（
order/only/allow_fallbacks/:floor/:nitro）：https://openrouter.ai/docs/guides/routing/provider-selection [官方文档] - OpenRouter Spend Controls（workspace budget 与 guardrail 两层控制）：https://openrouter.ai/docs/guides/best-practices/spend-controls [官方文档]
- OpenRouter 模型目录 API（价格与
pricing.overrides阶梯抓取来源）：https://openrouter.ai/api/v1/models [官方文档] - Anthropic 模型与定价（Haiku 5.5 长输入阶梯口径）：https://platform.claude.com/docs/en/about-claude/pricing [官方文档]
- Anthropic Claude Code 模型配置 / fast mode（与 OpenRouter 指南存在差异，见 3.7）：https://code.claude.com/docs/en/model-config 、https://code.claude.com/docs/en/fast-mode [官方文档]
- OpenAI Codex 仓库（安装方式）：https://github.com/openai/codex [官方文档]
- OpenAI Codex 配置参考（
model_providers.<id>字段、项目级配置限制）：https://learn.chatgpt.com/docs/config-file/config-reference **
