通过 Claude Code 与 Cursor 对接 OpenRouter：小白也能看懂的指南

chenbo980

1062人浏览 · 2026-04-06 09:35:24

chenbo980 · 2026-04-06 09:35:24 发布

本文面向刚接触 AI 编程工具的读者，用通俗语言说明：OpenRouter 是什么、为什么要对接、以及 Claude Code（终端） 和 Cursor（编辑器） 分别怎么接上它。文末会提到与本仓库示例目录的对应关系，便于你对照实践。

一、先搞清三个名字：它们各管什么？

名字	简单理解
OpenRouter	一个「模型超市 + 统一收银台」：用一把钥匙（一个 API Key）访问很多家厂商的模型，按使用计费，常带路由、统计、预算等能力。
Claude Code	Anthropic 出的终端里的 AI 编程助手（命令行里对话、改代码、跑命令等），默认连官方 Claude API。
Cursor	基于 VS Code 的编辑器，内置 Chat、Composer、Agent 等，默认用 Cursor 自己的服务或你配置的各家 API。

三者关系可以记成：

OpenRouter = 你买「流量/模型调用权」的地方（中间层）。
Claude Code / Cursor = 你写代码、下指令的两套界面；它们本来各自找「官方直连」，对接 OpenRouter 后，改为先经过 OpenRouter 再选模型。

二、OpenRouter 是什么？（给小白的一句话 + 展开）

一句话：OpenRouter 是一个 AI 模型的聚合 API 平台，把很多提供商（如 Anthropic、OpenAI、Google、开源模型托管方等）的模型，通过相对统一的接口开放给你调用。

稍微展开：

统一入口 你不必为每家模型单独注册、单独对接文档；在 OpenRouter 选好模型 ID，用同一类请求格式（常见为 OpenAI 兼容的 Chat Completions，或对部分工具提供 Anthropic 兼容路径）去调。
模型选择多 同一套账号里可以切换不同厂商、不同价位的模型（具体以 OpenRouter 网站展示的模型列表为准）。
计费与用量可见 费用一般在 OpenRouter 账户里体现，便于个人或小团队做成本控制和用量查看（以官网说明为准）。
对接开发工具的意义 当你把 Claude Code 或 Cursor 指到 OpenRouter 时，相当于：工具负责写代码、对话；OpenRouter 负责「这次对话到底用哪个模型、花多少钱」。

三、对接 OpenRouter 有什么作用？（为什么要折腾这一下）

下面用「小白能用的场景」来说明价值——不是技术炫技，而是解决实际问题。

1. 一把 Key，多模型试错

做项目时，你可能想：这段用强模型、那段用便宜模型。对接 OpenRouter 后，往往只需在配置里改模型 ID，而不必为每个模型单独搞一套官方账号（具体以 OpenRouter 支持的模型与计费为准）。

2. 成本与预算更好把控

对个人开发者：可以在 OpenRouter 充值或按套餐使用，在一张账单/一个控制台里看用量。对团队：便于统一采购、统一 key 分发（配合权限管理，以官方功能为准）。

3. 与「官方直连」相比的取舍

官方直连：最「原汁原味」，适合只认某一家的合规与 SLA。
经 OpenRouter：多模型、统一 key、路由与统计往往更方便，但多一层中间服务，需接受其条款与可用性。

4. 对 Claude Code 的特别说明（官方文档里的卖点）

OpenRouter 与 Anthropic 合作文档中提到：把 Claude Code 指到 OpenRouter 时，可获得例如多提供商容错、组织侧预算与可见性等能力（详见 OpenRouter：Claude Code 集成）。是否采用取决于你的账号类型与需求。

5. 对 Cursor 的特别说明

Cursor 里对接 OpenRouter，通常走 OpenAI 兼容通道（Base URL 指向 OpenRouter 的 /v1），这样你可以在 Cursor 的模型列表里选用 OpenRouter 上存在的模型 ID。注意：Cursor 的 Tab 自动补全往往仍走 Cursor 自有服务，与 OpenRouter 无关——这是正常现象。

四、概念补一句：两种对接路径不一样

这是小白最容易晕的点，记住即可：

工具	常见对接方式	原因
Claude Code	使用 Anthropic API 兼容的 Base URL（OpenRouter 文档写的是 `https://openrouter.ai/api`）+ Bearer Token（OpenRouter 的 Key）	Claude Code 原生协议接近 Anthropic Messages API，OpenRouter 提供对应「皮肤」。
Cursor	OpenAI API Key 填 OpenRouter Key + Override Base URL 为 `https://openrouter.ai/api/v1`	Cursor 这条线按 OpenAI 兼容的 Chat 接口走，与 Claude Code 不是同一套环境变量。

所以：不是复制同一段配置到两个软件里，而是「各按各的入口填」。

五、Claude Code 如何对接 OpenRouter？（步骤思路）

以下与 OpenRouter 官方：Claude Code 及 Claude Code 环境变量说明一致，便于你核对。

1. 准备

在 OpenRouter 注册并创建 API Key（形如 sk-or-v1-...，请妥善保管，不要发到公开仓库）。
本机已安装 Node.js，并在项目里安装 @anthropic-ai/claude-code（或用官方安装脚本安装 claude 命令）。

2. 核心环境变量（概念）

ANTHROPIC_BASE_URL = https://openrouter.ai/api
ANTHROPIC_AUTH_TOKEN = 你的 OpenRouter API Key（作为 Bearer）
ANTHROPIC_API_KEY = 必须显式留空（避免和 Anthropic 官方 Key 冲突）

文档还建议在非官方网关时开启 ENABLE_TOOL_SEARCH=true（便于 MCP 等工具行为，详见 Claude Code 文档）。

3. 想换模型（例如 Qwen3.6 Plus）

可通过例如 ANTHROPIC_DEFAULT_SONNET_MODEL 等变量指定 OpenRouter 上的模型 ID（如 qwen/qwen3.6-plus）。注意：Claude Code 为 Claude 系列优化，换其他模型可能遇到工具调用或行为差异，需自行试错。

4. 与本仓库示例的对应关系

若你使用本仓库中的脚本：

用 claude.ps1 启动，可在同目录准备 openrouter.secrets.ps1（勿提交 Git），内容模板见 openrouter.secrets.ps1.example。
claude.ps1 会设置「配置与缓存在本项目 claude-data 下」等便携环境，并自动加载 openrouter.secrets.ps1（若存在）。

这样你可以把「对接 OpenRouter」和「数据落在指定盘符」两件事一起做（具体路径以你本机为准）。

六、Cursor 如何对接 OpenRouter？（步骤思路）

1. 打开设置

快捷键 Ctrl+Shift+J（Windows）打开 Cursor Settings，切到 Models。

2. 填写 OpenAI 兼容通道

OpenAI API Key：粘贴 OpenRouter 的 API Key（与 Claude Code 用的是同一把 OpenRouter Key，不是 OpenAI 官方的 sk-proj）。
Override OpenAI Base URL：填 https://openrouter.ai/api/v1（末尾不要多一个 /）。

3. 添加模型

在 Add model 中加入你在 OpenRouter 上选用的模型 ID，例如：qwen/qwen3.6-plus（若使用免费变体则可能是 qwen/qwen3.6-plus:free，以 OpenRouter 页面为准）。

4. 在界面里选用

在 Chat、Composer 或 Agent 的模型选择器里选中你添加的模型。

5. 与本仓库的对应关系

本仓库在 .vscode/cursor-openrouter.txt 里有一份简短清单；也可运行 open-cursor-openrouter.ps1 在 Cursor 里打开该说明。再次强调：Cursor 的密钥存在其安全存储里，一般需要你在界面里粘贴一次，不能只靠复制某段 settings.json 就完成全部步骤。

七、小白常见疑问（FAQ）

Q：对接后，还要不要买 Cursor 订阅？ A：订阅与「是否用 OpenRouter」是两条线。Tab 补全、部分内置能力仍与 Cursor 套餐相关；自定义 API 多用于 Chat/Agent 等（以 Cursor 当前版本说明为准）。

Q：OpenRouter 和「直接买 Anthropic / OpenAI 官方 API」哪个便宜？ A：没有固定答案，取决于模型、用量、活动价。建议以各平台实时定价页为准，并设好预算告警。

Q：验证按钮失败但能用，正常吗？ A：社区里有人反馈 Verify 不稳定；若对话实际能通，可先以实测为准。

Q：密钥能写进博客或 Git 吗？ A：绝对不能。密钥应只在本地或密钥管理工具中保存；公开仓库请用 .gitignore 排除密钥文件。

八、安全与合规小结

API Key = 钱与额度：泄露等于把钱包挂在公网上。
代码与提示词：经第三方网关时，请阅读 OpenRouter 与各模型提供商的隐私条款与数据策略。
公司项目：先问清楚是否允许使用聚合 API 与境外服务。

九、结语

OpenRouter 是「多模型、统一 API」的聚合层，适合想一把 Key 管理多种模型、统一看用量与费用的开发者。
Claude Code 通过 Anthropic 兼容 Base URL + Bearer Token 接上 OpenRouter；Cursor 通过 OpenAI 兼容 Base URL + OpenRouter Key 接上。
对接的作用：让你在熟悉的工具里灵活选模型、控成本、做对比实验；代价是多一层服务依赖，需要自己会看文档与账单。