Skip to main content

Search: #OpenRouter

面条的草稿箱
面条的草稿箱
无原创，纯转发

  1. 用 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：
    • curl -fsSL https://claude.ai/install.sh | bash
    • Windows PowerShell：
    • irm https://claude.ai/install.ps1 | iex

    2）把 Claude Code 指到 OpenRouter

    关键点只有三个：

    1. Base URL 用：https://openrouter.ai/api
    2. 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 #开发工具 #成本管理
1px