# 使用OpenRouter连接Claude Code - 来源：OpenRouter：Announcements（RSS） - 发布时间：2026-06-17 03:00 - AIHOT 分数：64 - AIHOT 链接：https://aihot.virxact.com/items/cmqitbwsh0465sl5wo6g58hlh - 原文链接：https://openrouter.ai/blog/tutorials/claude-code-openrouter ## AI 摘要 设置三个环境变量即可将Claude Code连至OpenRouter，无需本地代理或Docker。OpenRouter提供供应商故障转移、预算控制与用量监控，支持Anthropic Skin原生协议，保留Thinking、工具调用、流式输出。可为Opus（架构推理）、Sonnet（日常编码）、Haiku（快速转换）分别指定模型。Fast Mode最高2.5倍速度，仅限Claude Opus 4.6/4.7/4.8，需Claude Code v2.1.96+。团队场景：一个OpenRouter密钥统一计费、设置每密钥限额，活动仪表板查看会话成本。 ## 正文 如何使用 Claude Code 与 OpenRouter OpenRouter · 2026/6/16 On this page 三步连接 Claude Code Anthropic Skin 如何在无需代理的情况下工作 将每类任务路由到合适的模型 Opus 会话的快速模式 费用与免费层级 将其集成到 CI 和终端 常见问题 你正深入进行重构。Claude Code 已经跨十几个文件拉取上下文，规划了差异，并开始执行。然后会话因速率限制而停止，进度完成 70%。 通过 OpenRouter 路由 Claude Code 就是让会话保持活跃的方法。OpenRouter 位于 Claude Code 与 Anthropic 的 API 之间，充当可靠性和管理层。它增加了供应商故障切换、预算控制和使用情况可见性，并且无需运行本地代理。设置只需三个环境变量。本文涵盖该设置、模型路由、快速模式和成本计算。 团队场景同样实用。多名开发者同时运行 Claude Code 意味着多个 Anthropic 账户，没有共享消费视图，并且在收到账单之前没有每位开发者的上限。一个 OpenRouter 密钥即可管理所有：共享计费、每密钥限制，以及显示每次会话成本的 Activity 仪表板。 三步连接 Claude Code 整个设置就是三个环境变量，在 Claude Code 集成指南中有文档说明，无需代理、无需 Docker、无需运行本地端口。 # Add to ~/.zshrc or ~/.bashrc export OPENROUTER_API_KEY="" export ANTHROPIC_BASE_URL="https://openrouter.ai/api" export ANTHROPIC_AUTH_TOKEN="$OPENROUTER_API_KEY" export ANTHROPIC_API_KEY="" # must be explicitly empty 需要正确设置三件事。基础 URL 是 https://openrouter.ai/api。身份验证令牌是你的 OpenRouter 密钥，以 sk-or- 开头。并且 ANTHROPIC_API_KEY 必须是一个空字符串，而不是未设置，否则 Claude Code 可能会回退到直接向 Anthropic 进行身份验证。 更倾向于将其限定在一个项目中？将相同的三个值放在项目根目录下 .claude/settings.local.json 的 env 块中。不要使用普通的 .env 文件，因为原生安装程序不会读取它。 如果你之前使用 Anthropic 账户登录过 Claude Code，请运行一次 /logout 然后重新启动，否则缓存的登录会覆盖你的变量，导致出现令人困惑的模型未找到错误。使用 /status 确认切换： > /status Auth token: ANTHROPIC_AUTH_TOKEN Anthropic base URL: https://openrouter.ai/api 你的请求也应在几秒钟内显示在 Activity 仪表板中。 Anthropic Skin 如何在无需代理的情况下工作 OpenRouter 暴露了一个与 Anthropic Messages API 兼容的端点，它称之为 Anthropic Skin。Claude Code 直接以其原生协议与 OpenRouter 通信，而 Skin 负责模型映射，并原样传递高级功能。 这意味着思考块、原生工具使用、流式传输和多轮上下文都能像直接与 Anthropic 交互那样正常工作。旧有的设置依赖像 claude-code-router 这样的本地代理来转换请求，这意味着需要 Node.js 运行时、本地端口和一个翻译层来维持。原生路由为 Anthropic 工作流去掉了整个这一层。 在底层，OpenRouter 在提供某个模型的所有 Anthropic 提供商之间进行负载均衡。如果它首先尝试的提供商对您进行速率限制，它就会将同一模型路由到另一个提供该模型的提供商，而您只需为实际执行的调用付费。对于一个在多次调用中保持状态的多步骤智能体任务，发生在 Claude Code 之下的故障转移决定了任务是完成还是仅部分应用了编辑。 将每个任务类别路由到合适的模型 Claude Code 将工作分配到多个模型槽中。您可以覆写每个槽位，使其指向 OpenRouter 上的特定模型。`~author/model-latest` 别名总是解析为某个模型系列中的最新版本，因此它们不会过时： export ANTHROPIC_DEFAULT_OPUS_MODEL="~anthropic/claude-opus-latest" export ANTHROPIC_DEFAULT_SONNET_MODEL="~anthropic/claude-sonnet-latest" export ANTHROPIC_DEFAULT_HAIKU_MODEL="~anthropic/claude-haiku-latest" export CLAUDE_CODE_SUBAGENT_MODEL="~anthropic/claude-opus-latest" 一个合理的分配方案：Opus 用于架构和深度推理，Sonnet 用于日常编码，Haiku 用于快速转换和分类。将这些配置与 base URL 和 token 放在同一个 shell 配置文件或项目设置文件中。 不过，请保持模型为 Anthropic 的。Claude Code 是围绕 Anthropic 请求语义构建的，其集成仅保证与 Anthropic 第一方提供商配合使用。为了获得最大兼容性，请将 Anthropic 1P 设为首选提供商。 用于 Opus 会话的快速模式 Anthropic 的快速模式提供高达 2.5 倍的输出速度，但价格更高，并且仅由 Anthropic 第一方提供商提供。它适用于 Claude Opus 4.6、4.7 和 4.8，不适用于其他模型。 Claude Code 内置了 /fast 开关。当它开启时，Claude Code 会随配置的 Opus 模型一起发送 speed: "fast"，然后 OpenRouter 会重新路由到匹配的 -fast 变体。要使用它，只需设置一个变量： export CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK=1 这需要 Claude Code v2.1.96 或更新版本。向不支持 “fast” 的模型发送该速度参数时，OpenRouter 会直接忽略该参数，因此请求将以标准速度和价格运行。适用于交互式会话和实时调试场景——在这些场景下，延迟是你能直观感受到的。在为生产环境启用前，请先查看定价页面了解当前的 Opus 费率。 费用与免费额度 OpenRouter 不对 token 定价加价。你支付的每 token 费率与提供商收取的价格一致，该价格显示在模型目录中，充值购买会附加 5.5% 的手续费，最低收费 0.80 美元。 相对于实际使用量，这笔手续费很小。以每月 1000 万 token 使用 Claude Sonnet 4.5 为例，输入/输出比例为 80/20。按每百万输入 3 美元、每百万输出 15 美元计算，直接 token 成本约为 54 美元，5.5% 的充值手续费大约增加 3 美元。作为回报，你获得了故障转移、按密钥预算上限以及跨团队的统一账单视图。 此外还有用于试用的免费额度。免费模型每天最多可发起 50 次请求，一旦你充值了 10 美元，上限就提升至每天 1000 次。这些模型的上下文窗口比付费的 Anthropic 模型更小，因此适合用来学习 Claude Code 的工作流程，而非用于生产会话。在 Activity 仪表盘中实时查看费用，这是捕捉会话被路由到比任务所需更重型模型的最快方式。 接入 CI 和终端 相同的路由机制不仅限于本地终端。 对于 CI，官方 Claude Code GitHub Action 需要做两项修改：通过 `anthropic_api_key` 传入你的 OpenRouter 密钥，并在步骤的环境变量中设置基础 URL。 - 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 要在终端中实时查看费用，`openrouter-examples` 仓库提供了一个状态栏脚本，可显示提供商、模型、当前运行费用以及缓存折扣。将你的 `~/.claude/settings.json` 指向它： { "statusLine": { "type": "command", "command": "/path/to/statusline.sh" } } 正在基于 Claude Code 构建智能体？Anthropic Agent SDK 使用 Claude Code 运行时，因此同样的三个环境变量即可将其请求通过 OpenRouter 路由，无需额外配置。 常见问题 我是否需要订阅 Anthropic 才能将 Claude Code 与 OpenRouter 一起使用？ 请求会通过您的 OpenRouter 积分路由，因此您需要一个 OpenRouter 账户和一个 API 密钥，而非 Anthropic 的套餐。如果您之前曾用 Anthropic 账户登录过 Claude Code，请先运行 `/logout` 清除缓存会话，然后再切换。 我可以通过 OpenRouter 在 Claude Code 中使用非 Anthropic 的模型吗？ 原生集成是针对 Anthropic 模型构建的，且仅保证能与 Anthropic 第一方提供商配合使用。Claude Code 期望 Anthropic 的请求语义，因此非 Anthropic 模型无法通过原生端点获得支持。 通过 OpenRouter 使用 Claude Code 需要多少费用？ 您需支付提供商的每 token 费率，外加 5.5% 的积分购买手续费，最低消费为 0.80 美元。推理本身按提供商费率计费。活动面板会实时显示每次会话的确切成本。 OpenRouter 会记录我的源代码吗？ 不会。默认情况下，OpenRouter 仅保留元数据（如 token 数量），不会保留您的提示词或补全内容。记录您自己的输入和输出是可选加入功能，另有单独的可选加入选项允许 OpenRouter 使用您的数据来改进产品，作为交换您可享受 1% 的使用折扣。具体条款请参阅隐私政策。 什么是快速模式？哪些模型支持它？ 快速模式能以最高 2.5 倍的输出速度运行，需支付溢价，由 Anthropic 第一方提供商提供。该模式仅在 Claude Opus 4.6、4.7 和 4.8 上可用。在 Claude Code 中使用 `/fast` 切换。 如果 Anthropic 的 API 对我进行速率限制，会发生什么？ OpenRouter 会自动故障转移到提供相同模型的其他 Anthropic 提供商，因此会话会继续运行而无需重新连接。您只需为实际处理请求的提供商所对应的费率付费。