Cursor 自定义 API 配置教程:用 Override OpenAI Base URL 接入 API 快连

更新于

Cursor 支持填自己的 API Key,并把 OpenAI 的请求地址改成第三方服务。这篇讲清楚 Cursor 里在哪设置、怎么添加自定义模型,以及最重要的:自定义密钥能用在哪些功能、不能用在哪些功能。

📌
一句话答案:Cursor 设置 → Models → API Keys:「OpenAI API Key」填 API 快连密钥,打开「Override OpenAI Base URL」并填 https://apikl.ai/v1,再添加自定义模型 gpt-5.6-sol。
⚠️
先了解限制:自定义密钥只用于你手动选择的自定义模型的对话和 Agent;Tab 自动补全等功能仍走 Cursor 自己的服务,需要 Cursor 自己的套餐。如果你主要想用 Claude 写代码,Claude Code 或 Cline 会更省心。

配置步骤

  1. 用快捷键打开 Cursor 设置:macOS 按 Cmd + Shift + J,Windows / Linux 按 Ctrl + Shift + J。
  2. 进入 Models,滚动到 API Keys 区域。
  3. 打开 Override OpenAI Base URL,填入 https://apikl.ai/v1。
  4. 在 OpenAI API Key 里粘贴你的 API 快连密钥(GPT 分组)。
  5. 地址和密钥都填好后,再打开 OpenAI API Key 的开关;弹出确认框时点确认启用。
  6. 在模型列表里添加自定义模型,名字填 gpt-5.6-sol(必须和 模型广场 里的写法完全一致),并把它勾选启用。
  7. 打开对话面板,选中这个模型,发一句「你好」测试。
Cursor 设置
OpenAI API Key : sk-你的密钥Override OpenAI Base URL : https://apikl.ai/v1自定义模型 : gpt-5.6-sol
💡
先填地址和密钥、再打开开关。顺序反过来时,Cursor 可能会先拿密钥去官方地址验证而失败。

哪些功能会用到你的密钥

功能是否走 API 快连
对话(Chat / Ask)选中自定义模型时是
Agent 模式选中自定义模型时是(部分高级功能可能要求 Cursor 自带模型)
Tab 自动补全否,始终走 Cursor 自己的服务
选择 Cursor 自带的模型开着覆盖地址时也会发到 API 快连,通常报模型不可用;用自带模型前先关掉覆盖(见下文已知问题)

Cursor 会经由自己的服务器转发这些请求,所以 Base URL 必须是公网可访问的地址。API 快连本身就是公网地址,不需要额外处理。

在 Cursor 里用 Claude 模型

Override OpenAI Base URL 走的是 OpenAI 格式。在这里填 Claude 的模型名,Cursor 可能把它识别成官方 Anthropic 模型、走到别的通道,造成报错或扣到 Cursor 额度,这是常见误区。

  • 在 Cursor 里通过 API 快连,推荐使用 GPT 模型(例如 gpt-5.6-sol、gpt-6.1-sol)。
  • 想用 Claude 写代码:在 Cursor 里装 Cline 扩展接 Claude,或直接用 Claude Code。

已知问题

  • 打开覆盖地址后 Cursor 自带模型也报错:Cursor 官方论坛确认,开启 Override OpenAI Base URL 后,所有请求都会发到这个地址,包括内置模型列表里的 Cursor 自带模型,目前还没有修复时间。要用 Cursor 自带模型时,先关掉 Override OpenAI Base URL,用完再打开。
  • 设置里的输入框点不进去:某些版本存在这个界面问题,更新 Cursor 到最新版即可。
  • 改完不生效:完全退出 Cursor 再打开。

常见报错

  • 401 / Key 无效:检查 Override 开关是否真的打开、地址是否带 /v1。看 401 排查。
  • 模型不存在:自定义模型名和平台上的不一致,或密钥是 Claude 分组的。看 模型不存在排查。
  • 报错提示与 Cursor 套餐或额度有关:你当前选中的是 Cursor 自带模型,或所用功能不支持自定义密钥。
✅