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 会更省心。
配置步骤
- 用快捷键打开 Cursor 设置:macOS 按
Cmd + Shift + J,Windows / Linux 按Ctrl + Shift + J。 - 进入 Models,滚动到 API Keys 区域。
- 打开 Override OpenAI Base URL,填入
https://apikl.ai/v1。 - 在 OpenAI API Key 里粘贴你的 API 快连密钥(GPT 分组)。
- 地址和密钥都填好后,再打开 OpenAI API Key 的开关;弹出确认框时点确认启用。
- 在模型列表里添加自定义模型,名字填
gpt-5.6-sol(必须和 模型广场 里的写法完全一致),并把它勾选启用。 - 打开对话面板,选中这个模型,发一句「你好」测试。
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 再打开。