先给出明确结论:若想在 Cursor 中使用自己申请的模型 API(例如 DeepSeek、Claude 或第三方中转服务),必须手动添加自定义模型,并且三个核心参数——API Key、Base URL 和 Model ID——缺一不可。

这项操作本身并不复杂,但初次尝试时往往会在某个细节上卡住。下面直接拆解完整流程,助你快速完成 Cursor 自定义模型配置。
进入模型设置页面
点击右上角的齿轮图标,随后选择 Models 选项卡。这里有一个前提条件——必须使用 Cursor Pro 版本,免费版无法启用第三方 API,这一步如果搞不定,后续所有配置都将无效。
填写 API Key 和 Base URL
向下滚动页面,找到 OpenAI API Key 输入框,将从平台获取的密钥(格式通常为 sk-xxxxxxxx)粘贴进去。
在 Override OpenAI Base URL 字段中填入对应服务商的请求地址。举例如下:
- DeepSeek 最新版:https://api.deepseek.com/v1
- 147AI:https://147ai.com/v1
- 09API:https://www.09api.com/v1
这里有一个常见的坑必须提醒:URL 结尾必须是 /v1,否则测试时直接报错,没有任何协商余地。
添加自定义模型
第一步:滚动到页面底部,点击 + Add Model 按钮。
第二步:在弹出的输入框中填写模型名称——这个名称仅用于显示,可以随意定义,例如 my-deepseek-v3。
第三步:下方有一个 Model ID 输入框,此处必须填写模型真正的标识符,且需要与服务商模型广场页面上提供的内容完全一致。例如:
- DeepSeek-V3 → deepseek-v3
- Claude-3-5-sonnet → claude-3-5-sonnet-20241022
- Kimi K2.5 → kimi-k2-5(注意使用短横线,而非点号)
第四步:点击 Add 按钮,新添加的模型便会出现在列表底部。
启用并验证模型
将刚添加的模型左侧的 ☑️ 勾选,同时确保 OpenAI API Key 开关处于开启状态——当出现黄色警告标识时,才表示真正生效。
点击右侧的 Verify 按钮,等待几秒钟。如果状态变为 Active 且没有任何错误提示,则说明配置成功。
关闭设置页面,在编辑器中按下 Ctrl+L 打开聊天窗口,从模型下拉菜单中选中你刚添加的模型,发送一条测试消息试试——能够正常使用就代表一切就绪。
