What This Is
Claude Code 是 Anthropic 生态里的 agentic coding 工具，默认更贴近 Anthropic 的认证和接口习惯；OpenRouter 则是一个模型聚合层，允许你用一套 API Key 访问不同提供商的模型，并通过自己的 credits、路由和活动面板来结算与排查。
当你让 Claude Code 走 OpenRouter 时，本质上是在告诉 Claude Code：虽然你原本理解的是 Anthropic 风格的接口，但现在实际请求要改走 OpenRouter 提供的兼容通道。因此你需要同时处理三类状态： - **接口地址**：请求到底发到 Anthropic 官方，还是发到 OpenRouter。 - **认证凭证**：请求头里带的到底是 Anthropic key，还是 OpenRouter key。 - **本地缓存状态**：你以前是否登录过 Anthropic，Claude Code 会不会优先使用旧的本地登录态。
这也是为什么 Claude Code + OpenRouter 的问题，经常不只是“key 对不对”，而是 Base URL、环境变量优先级、缓存登录态、模型可见性和 OpenRouter credits 一起影响最终行为。更稳妥的做法是：先看环境变量，再用 `/status`、OpenRouter Activity Dashboard、`/v1/models` 和后台 usage 记录逐层验证。
Setup or Check Steps
- 1 准备 OpenRouter API Key，并确认账户已有可用 credits 或预算空间
- 2 把 `ANTHROPIC_BASE_URL` 设为 OpenRouter 提供的 API 地址，确保 Claude Code 的请求入口指向 OpenRouter 而不是官方 Anthropic
- 3 把 `ANTHROPIC_AUTH_TOKEN` 设为你的 OpenRouter API Key，用它完成实际认证
- 4 显式把 `ANTHROPIC_API_KEY` 置空，避免 Claude Code 同时读到旧的 Anthropic key 或登录态
- 5 如果你之前登录过 Anthropic，先执行 `/logout`，清掉缓存的登录状态，再重新启动 Claude Code
- 6 启动后使用 `/status` 检查当前配置是否生效，确认显示的是预期后端、模型或连接状态
- 7 再用最小化任务做一次小额测试，并去 OpenRouter Activity Dashboard 查看 request_id、usage 和路由记录是否出现
Common Errors
- 401 authentication error：`ANTHROPIC_AUTH_TOKEN` 填错、复制不完整、已过期，或请求仍在使用旧的 Anthropic 登录态
- 403 permission / credits / budget / access issue：OpenRouter 账户 credits 不足、预算限制触发，或当前模型对该账户不可用
- no credits：OpenRouter 余额不足，Claude Code 发出的请求被上游拒绝
- key expired or revoked：你使用的是被禁用、轮换后失效或已撤销的 OpenRouter key
- model not found：模型名写错、当前模型对该账户不可见，或路由别名与你填写的不一致
- provider unavailable：当前路由的上游 provider 暂时不可用，或 OpenRouter 针对该模型做了临时限制
- rate limit：Claude Code 多轮循环、工具调用和重试把请求频率推高，触发限流
- timeout：Base URL、网络链路、OpenRouter 上游 provider 或 Claude Code 本地重试链路过长，导致请求超时
Security / Billing / Permission Risks
- Claude Code 是 agentic coding 工具，长上下文、工具调用、多轮循环、文件读取都会放大 Token 和 credits 消耗。
- 不要把真实 API Key 写进页面示例、截图、shell 历史记录、仓库或公开 issue。
- 不要硬编码到源码，也不要提交到 public repo。优先用环境变量或权限受控的本地配置。
- 如果你在同一台机器上混用 Anthropic 官方和 OpenRouter，尤其要注意缓存登录态和环境变量优先级。
- 成本、模型、credits、路由和 provider 可用性以当前 OpenRouter 后台和官方文档为准。
- 检测结果用于辅助判断，不等于绝对安全或绝对可用；失败扣费要结合 request_id、usage、后台记录和服务商规则综合判断。
When to Use AI API Doctor
当你不确定问题是出在 Base URL、key、兼容性还是模型可见性时，先用 AI API Doctor 做一次辅助检查，确认请求入口、模型列表返回和基础认证是否正常。它更适合缩小排查范围，而不是替代真实请求验证。
When to Use LinkAI for Small Tests
如果你想对比另一条兼容接口链路，或者希望先用更小的预算测试模型可见性、Base URL 填法和 usage 透明度，可以在 LinkAI 注册后做小额测试。重点不是立刻迁移，而是建立一个低风险的对照样本。
AI Summary
Claude Code 接 OpenRouter 时，最关键的不是单独记住某个变量名，而是理解三个动作：把 `ANTHROPIC_BASE_URL` 指到 OpenRouter，把 `ANTHROPIC_AUTH_TOKEN` 换成 OpenRouter key，并显式清空 `ANTHROPIC_API_KEY`，防止 Anthropic 旧登录态干扰。配置后用 `/status`、OpenRouter Activity Dashboard、`/v1/models` 和 usage 记录交叉验证，先小额测试，再扩大任务规模。