用 OpenRouter 接入 Claude Code：更稳、更可控的开发体验
在 Claude Code 里把请求走 OpenRouter，本质上是给 Anthropic API 加一层“可靠性与管理”中间层。需要注意：官方只保证与 Anthropic 第一方（1P）提供商完全兼容；为了最佳兼容性，建议将 Anthropic 1P 设为最高优先级。
为什么要这样接入？
• 自动故障切换（高可用）：遇到 Anthropic API 宕机或限流时，OpenRouter 可在多个 Anthropic 提供商间自动切换，减少编码被打断的概率。
• 团队预算管理：集中设置额度、分配成员用量、避免成本失控。
• 用量可视化：在 OpenRouter 的 Activity Dashboard 里实时查看消耗、项目/成员用量等。
快速上手（核心步骤）
1）安装 Claude Code
• macOS / Linux / WSL：
•
• Windows PowerShell：
•
2）把 Claude Code 指到 OpenRouter
关键点只有三个：
1. Base URL 用：
2. Auth token 用你的 OpenRouter API Key
3. 必须把
把下面环境变量写进你的 shell 配置（例如
•
•
•
•
补充提醒：
• 不要放在项目级
• 若之前用 Anthropic 账号登录过 Claude Code，先在会话里执行
3）启动并验证
• 进入项目目录运行：
• 在 Claude Code 内用
•
•
• 也可去 OpenRouter Activity Dashboard 看请求是否实时出现。
进阶：Agent SDK 与 GitHub Action
• Anthropic Agent SDK（Python / TypeScript）：由于它以 Claude Code 为运行时，同样使用上述环境变量即可接入 OpenRouter。
• Claude Code GitHub Action：在 action step 里
•
• 环境变量加
成本跟踪 Statusline（可选）
可以给 Claude Code 加自定义 statusline，实时显示 provider、模型、累计成本、缓存折扣等信息；脚本来自 openrouter-examples 仓库，并通过
常见排错
• 认证报错：确认
• 上下文长度错误：拆分任务或新开会话。
• 隐私：OpenRouter 默认不记录你的源码 prompts，除非你在账号设置里明确选择开启日志。
原链接：https://openrouter.ai/docs/guides/guides/claude-code-integration
#ClaudeCode #OpenRouter #Anthropic #开发工具 #成本管理
在 Claude Code 里把请求走 OpenRouter，本质上是给 Anthropic API 加一层“可靠性与管理”中间层。需要注意：官方只保证与 Anthropic 第一方（1P）提供商完全兼容；为了最佳兼容性，建议将 Anthropic 1P 设为最高优先级。
为什么要这样接入？
• 自动故障切换（高可用）：遇到 Anthropic API 宕机或限流时，OpenRouter 可在多个 Anthropic 提供商间自动切换，减少编码被打断的概率。
• 团队预算管理：集中设置额度、分配成员用量、避免成本失控。
• 用量可视化：在 OpenRouter 的 Activity Dashboard 里实时查看消耗、项目/成员用量等。
快速上手（核心步骤）
1）安装 Claude Code
• macOS / Linux / WSL：
•
curl -fsSL https://claude.ai/install.sh | bash• Windows PowerShell：
•
irm https://claude.ai/install.ps1 | iex2）把 Claude Code 指到 OpenRouter
关键点只有三个：
1. Base URL 用：
https://openrouter.ai/api2. Auth token 用你的 OpenRouter API Key
3. 必须把
ANTHROPIC_API_KEY 显式设为空字符串（避免与默认 Anthropic 登录冲突）把下面环境变量写进你的 shell 配置（例如
~/.zshrc / ~/.bashrc）：•
export OPENROUTER_API_KEY="<your-openrouter-api-key>"•
export ANTHROPIC_BASE_URL="https://openrouter.ai/api"•
export ANTHROPIC_AUTH_TOKEN="$OPENROUTER_API_KEY"•
export ANTHROPIC_API_KEY=""补充提醒：
• 不要放在项目级
.env 里：Claude Code 原生安装器不会读常见 .env。• 若之前用 Anthropic 账号登录过 Claude Code，先在会话里执行
/logout 清掉缓存凭据。3）启动并验证
• 进入项目目录运行：
claude• 在 Claude Code 内用
/status 查看是否生效，应该能看到：•
Auth token: ANTHROPIC_AUTH_TOKEN•
Anthropic base URL: https://openrouter.ai/api• 也可去 OpenRouter Activity Dashboard 看请求是否实时出现。
进阶：Agent SDK 与 GitHub Action
• Anthropic Agent SDK（Python / TypeScript）：由于它以 Claude Code 为运行时，同样使用上述环境变量即可接入 OpenRouter。
• Claude Code GitHub Action：在 action step 里
•
anthropic_api_key 传入 secrets.OPENROUTER_API_KEY• 环境变量加
ANTHROPIC_BASE_URL: https://openrouter.ai/api成本跟踪 Statusline（可选）
可以给 Claude Code 加自定义 statusline，实时显示 provider、模型、累计成本、缓存折扣等信息；脚本来自 openrouter-examples 仓库，并通过
~/.claude/settings.json 配置 statusLine.command 启用。常见排错
• 认证报错：确认
ANTHROPIC_API_KEY 是 ""（空字符串），而不是未设置；否则 Claude Code 可能回退到默认 Anthropic 认证流程。• 上下文长度错误：拆分任务或新开会话。
• 隐私：OpenRouter 默认不记录你的源码 prompts，除非你在账号设置里明确选择开启日志。
原链接：https://openrouter.ai/docs/guides/guides/claude-code-integration
#ClaudeCode #OpenRouter #Anthropic #开发工具 #成本管理
