Claude Code 接入 OpenRouter
已验证将 Claude Code 连接到 OpenRouter 官方的 Anthropic 兼容端点。一个密钥即可访问数百个模型，并支持服务商故障转移。
已于 2026-07-30 依据服务商官方文档验证。
关于 Claude Code
Claude Code 是运行在终端中的 Agent 编程工具，可通过环境变量指向任意兼容 Anthropic Messages API 的端点。
关于 OpenRouter
OpenRouter 是聚合了数百个模型的统一 API 网关。一个密钥即可访问模型目录中的模型，并支持服务商故障转移与统一计费。
要点
- OpenRouter 官方文档化了对 https://openrouter.ai/api 的 Anthropic 兼容端点支持。
- ANTHROPIC_API_KEY 必须显式置空——否则 Claude Code 会直接向 Anthropic 认证。
- 如果之前用 Anthropic 账号登录过，请先在 Claude Code 中执行 /logout，否则缓存的登录会覆盖你的环境变量。
- 以 ~ 开头的模型别名会自动解析为 OpenRouter 上该模型的最新版本。
接入 Claude Code 接入 OpenRouter
选择操作系统、Shell 与模型。下方步骤会实时更新，且全部在浏览器本地生成。
推荐使用 Anthropic 模型：该集成对 Anthropic 第一方服务商有保障。请在 OpenRouter 中将其设为首选服务商。
Browse the full OpenRouter model catalog获取 API Key
创建 OpenRouter API Key。Claude Code 通过它进行认证——它永远不会离开你的设备。
获取 OpenRouter API Key- 安装 Claude Code：npm install -g @anthropic-ai/claude-code
- Sign in, open Keys, and create a key that starts with sk-or-. Free-tier requests are available; adding $10 in credits raises your daily free limit.
配置连接
在 Shell 配置文件中设置以下环境变量。
- 1将以下内容添加到 ~/.zshrc
- 2执行：source ~/.zshrc
export OPENROUTER_API_KEY="sk-or-"
export ANTHROPIC_BASE_URL="https://openrouter.ai/api"
export ANTHROPIC_AUTH_TOKEN="$OPENROUTER_API_KEY"
export ANTHROPIC_API_KEY=""
# ANTHROPIC_API_KEY 必须显式置空，不能未设置
export ANTHROPIC_DEFAULT_OPUS_MODEL="~anthropic/claude-sonnet-latest"
export ANTHROPIC_DEFAULT_SONNET_MODEL="~anthropic/claude-sonnet-latest"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="~anthropic/claude-sonnet-latest"
export CLAUDE_CODE_SUBAGENT_MODEL="~anthropic/claude-sonnet-latest"将占位符替换为你的 API Key，然后打开一个新的终端窗口。
验证配置
在新终端中运行以下命令。成功返回即表示 Claude Code 已连接到目标端点。
claudeAfter Claude Code opens, type `/status` inside the session. The exact labels vary by version; confirm the auth token and base URL shown there.
开始使用
启动 Claude Code 并发送第一条消息。
- 输入：Hello. What can you help me with today?
claude故障排查
大多数问题可以归为以下几类，每一条都包含原因、解决方法与验证方式。
401 未授权
排障指南API Key 错误、已过期，或服务商账户余额不足。
在服务商后台创建新密钥，然后用新密钥重新生成配置。如果密钥保存在 Shell 配置文件中，请打开新终端使导出生效。
验证： 运行 `echo $ANTHROPIC_AUTH_TOKEN`（Codex 使用 `echo $DEEPSEEK_API_KEY` / `$OPENROUTER_API_KEY`），确认输出形如有效的密钥。
404 未找到
排障指南Base URL 错误（拼写错误、多余路径段），或 Codex 的 wire 协议与服务商提供的不匹配。
从本页复制准确的 Base URL。Codex 搭配 OpenRouter 时保留 `wire_api = "responses"`；如果 DeepSeek 在 /responses 返回 404，尝试删除 wire_api 行以匹配服务商提供的端点。
验证： 重新运行第 3 步的验证命令，检查报错路径：应指向 /anthropic（Claude Code）或 /responses（Codex）。
模型不存在
排障指南模型名称在服务商处不存在，或 Agent 缓存了旧登录状态，覆盖了环境变量。
从本页的模型列表中选择。Claude Code 搭配 OpenRouter 时，先在 Claude Code 内执行 `/logout` 再重新启动——缓存的 Anthropic 登录会覆盖你的环境变量。
验证： 确认 ANTHROPIC_API_KEY 已置空（OpenRouter）或未设置（DeepSeek），然后重新运行 `claude /status`。
限流 / 配额不足
排障指南服务商限制了每分钟请求数，或账户余额用尽。
等待限流窗口结束、充值账户余额，或改用更便宜的模型。OpenRouter 用户可以通过充值提升免费额度上限。
验证： 到服务商后台（余额与用量页面）查看被拒绝的请求。
网络错误 / 连接失败
排障指南本机无法访问服务商端点，或代理拦截并改写了请求。
检查到 Base URL 的 DNS 与连通性，检查代理与防火墙设置后重试。请使用本页给出的端点；第三方镜像不受支持。
验证： 运行 `curl -I <base url>`（例如 `curl -I https://api.deepseek.com/anthropic`），确认可以访问。
超时 / 请求超时
排障指南模型响应慢、提示词过长，或与服务商所在地区的网络受限。
重试请求、缩短提示词，或改用更快的模型。区域性的网络问题可能需要更换网络或选择节点更近的服务商。
验证： 在网络空闲时重新运行验证命令，确认可以完成。
使用旧账号时模型不存在
缓存的 Anthropic OAuth 登录覆盖了你的环境变量。
在 Claude Code 内执行 /logout，设置四个环境变量后重新启动。
验证： /status 应显示 "Anthropic base URL: https://openrouter.ai/api"。
常见问题
为什么 ANTHROPIC_API_KEY 必须置空？
当该变量未设置或包含真实密钥时，Claude Code 会回退到 Anthropic 认证。显式置空会强制所有流量走 OpenRouter 端点。
~ 模型别名是什么意思？
类似 ~anthropic/claude-sonnet-latest 的别名会自动解析为 OpenRouter 上的最新模型版本，新版本发布时无需更新配置。
OpenRouter 会额外收费吗？
token 价格不加价。充值收取少量手续费，并可在后台为每个密钥设置预算上限。