在 Cursor 里使用

打开 Override OpenAI Base URL、添加自定义模型,并了解哪些 Cursor 功能仍走官方后端。

Cursor 支持自带密钥(BYOK):在设置里填入本站的 OpenAI 兼容地址与密钥,Chat 里的请求就会走你的 OLETOKEN 额度。

准备工作

  1. 创建 API 密钥(控制台「API 密钥」页),保存完整密钥。
  2. 模型广场拿到一个模型 ID。
  3. Cursor 版本支持自定义模型(Settings → Models 里有 “Add Model”)。

配置

  1. 打开设置:⌘⇧J(macOS)/ Ctrl⇧J(Windows、Linux),或 ⌘⇧PCursor Settings

  2. 进入 ModelsModel Names → 点 + Add Model,填入要用的模型 ID 后回车。

  3. 在同一页的 API KeysOpenAI API Key,点 + 粘贴本站密钥。

  4. 打开 Override OpenAI Base URL,填本站 OpenAI 兼容地址并带上 /v1

    https://<your-base-url>/v1
    

    Cursor 会在它后面拼 /chat/completions,所以 /v1 不能省。

  5. Verify 校验。非 OpenAI 官方模型名有可能提示校验失败,这是误报——直接在 Chat 里发一条消息测试即可。

  6. 回到编辑器按 ⌘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密钥粘贴不完整或已被停用,重新复制一遍
404Override OpenAI Base URL 少了 /v1
Chat 里没有新模型模型 ID 拼写不对,或没在 Chat 的模型下拉里切换
额度不足充值后再试