将 Claude Code 接入 OpenRouter 只需设置三个环境变量：ANTHROPIC_BASE_URL=https://openrouter.ai/api、ANTHROPIC_AUTH_TOKEN=<你的 OpenRouter API key>、ANTHROPIC_API_KEY=""（必须显式清空）。接入后可获得 Provider 自动故障转移（Anthropic API 限流时无缝切换）、团队积分预算管控、全员用量可视化等能力。同时支持 Fast Mode、GitHub Action 集成和状态栏实时费用追踪。

通过 OpenRouter 使用 Claude Code，可以在 Anthropic API 与 Claude Code 之间加入一层可靠性和管理层，获得多项企业级能力。

为什么要通过 OpenRouter 使用 Claude Code？

Provider 故障自动转移

Anthropic API 偶发限流或中断时，通过 OpenRouter 的请求会自动切换到其他 Anthropic Provider，保持编程会话不中断。

团队预算管控

为团队和组织提供集中预算管理：设置用量上限、分配积分给各成员、防止意外超支。特别适合多个开发者同时使用 Claude Code 的团队。

用量可视化与分析

在 OpenRouter 活动面板中追踪全团队的 Claude Code 用量：费用趋势、模型使用分布、各成员消耗等。

快速开始

第一步：安装 Claude Code

macOS、Linux、WSL：

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell：

irm https://claude.ai/install.ps1 | iex

第二步：连接到 OpenRouter

在 shell profile（~/.bashrc、~/.zshrc 或 ~/.config/fish/config.fish）中添加：

export OPENROUTER_API_KEY="<你的 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 清除缓存凭证。

第三步：启动会话

cd /path/to/your/project
claude

第四步：验证连接

在 Claude Code 会话中运行 /status 命令，或查看 OpenRouter 活动面板确认请求已到达。

工作原理

1. 直连：设置 ANTHROPIC_BASE_URL=https://openrouter.ai/api 后，Claude Code 使用原生 Anthropic 协议直接与 OpenRouter 通信，无需本地代理
2. Anthropic 协议层：OpenRouter 的 "Anthropic Skin" 完全兼容 Anthropic Messages API，支持思考块（Thinking blocks）和原生工具调用
3. 计费：通过你的 OpenRouter 积分计费，用量（含推理 token）显示在 OpenRouter 面板中

配置使用的模型

Claude Code 使用多个环境变量控制不同任务类型使用的模型：

export ANTHROPIC_DEFAULT_OPUS_MODEL="anthropic/claude-opus-4.7"
export ANTHROPIC_DEFAULT_SONNET_MODEL="anthropic/claude-sonnet-4.6"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="anthropic/claude-haiku-4.5"
export CLAUDE_CODE_SUBAGENT_MODEL="anthropic/claude-opus-4.7"

变量	用途
ANTHROPIC_DEFAULT_OPUS_MODEL	Opus 级任务（复杂推理）
ANTHROPIC_DEFAULT_SONNET_MODEL	Sonnet 级任务（通用编码）
ANTHROPIC_DEFAULT_HAIKU_MODEL	Haiku 级任务（快速补全）
CLAUDE_CODE_SUBAGENT_MODEL	Claude Code 启动的子 agent 任务

Claude Code 针对 Anthropic 模型优化，使用其他 Provider 的模型可能无法正常工作。

Fast Mode

Anthropic Fast Mode 为 Claude Opus 4.7 提供最高 2.5x 的输出速度（以溢价计费）。通过 OpenRouter 使用时，设置以下环境变量启用：

export CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK=1

需要 Claude Code v2.1.96 或更新版本。在 Claude Code 会话中使用 /fast 命令切换 Fast Mode。

Fast Mode 激活时，OpenRouter 会限制路由仅走 Anthropic 直连 Provider（Bedrock、Vertex 不支持 Fast Mode）。响应的 usage 对象中会包含 "speed": "fast" 确认。

GitHub Action 集成

在官方 Claude Code GitHub Action 中使用 OpenRouter，需修改两处配置：

- name: Run Claude Code
  uses: anthropics/claude-code-action@v1
  with:
    anthropic_api_key: ${{ secrets.OPENROUTER_API_KEY }}
  env:
    ANTHROPIC_BASE_URL: https://openrouter.ai/api

1. 将 anthropic_api_key 设为你的 OpenRouter API key（存储为 GitHub Secret OPENROUTER_API_KEY）
2. 设置 ANTHROPIC_BASE_URL 环境变量

状态栏实时费用追踪

可为 Claude Code 添加自定义状态栏，实时显示 OpenRouter API 费用（Provider、模型、累计费用、缓存折扣）：

从 openrouter-examples 仓库下载状态栏脚本，设为可执行，然后在 ~/.claude/settings.json 中添加：

{
  "statusLine": {
    "type": "command",
    "command": "/path/to/statusline.sh"
  }
}

脚本使用 ANTHROPIC_AUTH_TOKEN 环境变量（即你的 OpenRouter API key）。

故障排除

• 认证错误：确认 ANTHROPIC_API_KEY 已显式设为空字符串 ""（未设置 vs 空字符串行为不同——未设置时 Claude Code 可能尝试连接 Anthropic 服务器）
• Context Length 错误：将任务分解为更小块，或开启新会话
• 隐私：OpenRouter 不记录源代码 prompt，除非你在账号设置中主动开启 prompt 日志

常见问题

Q: 通过 OpenRouter 使用 Claude Code 会增加延迟吗？

A: 通常不明显。OpenRouter 使用 Cloudflare Workers 边缘节点将网关延迟控制在毫秒级。主要延迟来自 Anthropic 模型本身。

Q: 使用 Claude Code 通过 OpenRouter 时，Thinking 功能是否正常工作？

A: 是的。OpenRouter 的 Anthropic 协议层完整支持扩展思考（Extended Thinking）功能。

Q: 团队中多个开发者如何共享成本追踪？

A: 在 OpenRouter 中创建组织，邀请团队成员加入。所有成员通过组织 API key 使用 Claude Code，用量统一从组织积分池扣除，可在组织活动面板中按成员/API key 筛选查看。