Claude Code
将 Claude Code 与 OpenRouter 配合使用
原文链接：https://openrouter.ai/docs/cookbook/coding-agents/claude-code-integration
Claude Code 与 OpenRouter 仅保证与 Anthropic 第一方 provider 配合使用。为获得最大兼容性，我们建议在 Claude Code 使用时将 Anthropic 1P 设置为最高优先级 provider。
为什么将 OpenRouter 与 Claude Code 一起使用？
Provider Failover 实现高可用性
Anthropic 的 API 偶尔会经历中断或速率限制。当你通过 OpenRouter 路由 Claude Code 时，你的请求会在多个 Anthropic providers 之间自动 failover。
组织预算控制
对于团队和组织，OpenRouter 提供集中式预算管理。你可以设置支出限制、在团队成员之间分配积分，并防止意外成本超支。
使用可见性和分析
OpenRouter 让你全面了解 Claude Code 在团队中的使用情况。在你的 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 | iex
第 2 步：将 Claude 连接到 OpenRouter
在 shell profile 中添加这些环境变量：
nano ~/.zshrc # 或 Bash 用户的 ~/.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="" # 重要：必须明确为空
第 3 步：启动你的会话
cd /path/to/your/project
claude
第 4 步：验证
在 Claude Code 中运行 /status 命令以确认你的连接。
工作原理
OpenRouter 暴露了一个与 Anthropic Messages API 兼容的输入。
- 直接连接：当你将
ANTHROPIC_BASE_URL设置为https://openrouter.ai/api时，Claude Code 直接与 OpenRouter 对话。 - Anthropic Skin：OpenRouter 的 Anthropic Skin 表现得像 Anthropic API。
- 计费：使用你的 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"
Fast Mode
Anthropic 的快速模式以溢价提供高达 2.5 倍的更快输出。快速模式仅在 Claude Opus 4.6 和 Claude Opus 4.7 上可用。
故障排除
- 认证错误：确保
ANTHROPIC_API_KEY设置为空字符串 ("")。 - 上下文长度错误：如果遇到上下文限制，请考虑将任务分解为更小的块。
- 隐私：OpenRouter 不会记录你的源代码 prompts，除非你明确选择加入 prompt logging。