Cursor 接入 Models Hub:自定义 Base URL 使用 Claude 与 GPT
在 Cursor 里通过 Override OpenAI Base URL 接入 Models Hub,用一个 API Key 调用 Claude、GPT 等模型,附模型名、验证步骤与「does not work with your current plan」等报错排查。
Cursor 允许用你自己的 API Key 与接入地址替换内置模型服务。把接入地址指向 Models Hub 后,Chat 与 Cmd-K 会用 Models Hub 的额度调用你指定的模型,包括 Claude 与 GPT 系列,不需要各家厂商的账号。
先确认两件事
- 自定义 Base URL 与自定义模型是 Cursor Pro 及以上 的功能,免费版填了也会报错。
- 自定义 Key 只作用于 Chat 与 Cmd-K(行内编辑)。Tab 补全始终走 Cursor 自有模型;Agent 模式对自定义 Key 的支持随版本变化,以你当前版本的提示为准。
准备
- Cursor 已安装并登录 Pro 账号。下载地址:cursor.com/download。
- 一个 Models Hub API Key,在 令牌页 创建,所在分组要能访问你打算用的模型。
推荐模型
Cursor 走的是 OpenAI 兼容格式,Models Hub 网关会自动转换,所以 Claude 模型也从这条路径接入。
模型名以 模型定价页 为准。
配置步骤
-
打开 Cursor 设置:右上角齿轮,或快捷键
Cmd + ,(Windows 为Ctrl + ,),进入 Models。 -
找到 OpenAI API Key,打开开关,粘贴你的 Models Hub API Key。
-
展开 Override OpenAI Base URL,打开开关,填入:
https://modelsok.com/v1末尾的
/v1必须带上,Cursor 会在它后面拼/chat/completions。 -
点击 Verify。通过后开关会保持打开;失败会提示原因,对照下面的报错表处理。
-
在模型列表的 Add Custom Model 输入上面的模型名,一次一个,添加后在列表里勾选启用。把 Cursor 自带的模型取消勾选可以避免误用到别的额度。
验证
打开 Chat(Cmd + L),在模型下拉框选你添加的模型,发一句「用一句话介绍当前项目」。能回复即接通。再到 Models Hub 控制台的 用量日志 看一眼,会出现一条对应模型名的请求,这一步能确认走的是 Models Hub 而不是 Cursor 自带服务。
常见报错
| 现象 | 原因 | 处理 |
|---|---|---|
The model xxx does not work with your current plan or api key | 免费版不支持自定义模型;或模型名在 Models Hub 不存在 | 升级 Pro;对照 定价页 核对模型名 |
| Verify 失败,提示无法连接 | Base URL 写错,最常见是漏了 /v1 或多了空格 | 重新填 https://modelsok.com/v1 |
Invalid API key / 401 | Key 复制不完整,或令牌被禁用 | 到 令牌页 重新复制 |
回复很慢或 429 | 并发触发限流 | 稍后重试;持续出现联系客服提额 |
| 用量日志里没有记录 | 请求走了 Cursor 自带服务 | 确认 Override 开关是打开状态,且聊天框里选的是你添加的自定义模型 |
| Tab 补全没变化 | 正常,Tab 不走自定义 Key | 无需处理 |
更多排查见 故障排查。
常见问题
计费方式? 按每次请求实际消耗的输入与输出 token 计费,价格看各模型定价页。Cursor 的 Chat 会把上下文文件一并发送,长对话消耗会明显高于单条提问,用量日志里能看到每条请求的 token 数。
可以同时保留 Cursor 自带模型吗? 可以。自定义模型和内置模型在同一个下拉框里切换。只勾选自定义模型是为了避免不小心用到 Cursor 的额度。
Claude 模型为什么填在 OpenAI 那一栏? Cursor 只允许覆盖 OpenAI 的 Base URL。Models Hub 网关会把 OpenAI 格式的请求转换后发给 Claude,你只管填模型名。
相关
- Claude Code 接入:终端里的同类工具,支持一键配置
- 模型定价 与 模型状态页
- Codex CLI 接入、Cherry Studio 接入