在 Cursor 里使用
打开 Override OpenAI Base URL、添加自定义模型,并了解哪些 Cursor 功能仍走官方后端。
Cursor 支持自带密钥(BYOK):在设置里填入本站的 OpenAI 兼容地址与密钥,Chat 里的请求就会走你的 OLETOKEN 额度。
准备工作
- 已创建 API 密钥(控制台「API 密钥」页),保存完整密钥。
- 在模型广场拿到一个模型 ID。
- Cursor 版本支持自定义模型(Settings → Models 里有 “Add Model”)。
配置
-
打开设置:
⌘⇧J(macOS)/Ctrl⇧J(Windows、Linux),或⌘⇧P→Cursor Settings。 -
进入 Models → Model Names → 点 + Add Model,填入要用的模型 ID 后回车。
-
在同一页的 API Keys → OpenAI API Key,点 + 粘贴本站密钥。
-
打开 Override OpenAI Base URL,填本站 OpenAI 兼容地址并带上
/v1:https://<your-base-url>/v1Cursor 会在它后面拼
/chat/completions,所以/v1不能省。 -
点 Verify 校验。非 OpenAI 官方模型名有可能提示校验失败,这是误报——直接在 Chat 里发一条消息测试即可。
-
回到编辑器按
⌘L/Ctrl+L打开 Chat,在模型下拉里选中刚添加的模型。
注意
- 只覆盖 Chat 与 Plan:Composer、Tab 补全、Inline Edit 仍走 Cursor 自己的后端,不消耗本站额度。
- 可能影响内置 Anthropic 分支:打开 Override OpenAI Base URL 后,Cursor 内置的 Claude 模型可能也会被转发到本站。如果还想要官方 Claude,把 Claude 的模型 ID 也用 “+ Add Model” 添加一份,然后在下拉里选自定义的那个。
- 想恢复:关掉 Override OpenAI Base URL 即可,密钥与模型条目可保留。
- 在 Cursor 里也可以直接装 Claude Code 插件(Cursor 兼容 VS Code 扩展市场),做法见在 VS Code 里使用——这种方式走 Anthropic Messages 协议,不受上面 Chat/Plan 的限制。
常见问题
| 现象 | 原因与处理 |
|---|---|
| Verify 失败 | 非 OpenAI 官方模型名的误报,直接在 Chat 里测试 |
| 401 | 密钥粘贴不完整或已被停用,重新复制一遍 |
| 404 | Override OpenAI Base URL 少了 /v1 |
| Chat 里没有新模型 | 模型 ID 拼写不对,或没在 Chat 的模型下拉里切换 |
| 额度不足 | 先充值后再试 |

