模型Cursor配置自定义API完整教程，接入GPT / Claude大模型

很多开发者在用Cursor写代码，官方额度经常限流，本文完整讲解如何配置兼容OpenAI格式的自定义API，解决调用报错、模型不识别等常见坑。

Cursor配置自定义API完整教程，接入GPT / Claude大模型

前言

Cursor作为AI代码编辑器，内置模型经常遇到限流、额度不足。Cursor支持兼容OpenAI协议的第三方API接口，我们可以接入各类大模型，实现满血模型写代码。

注意：Cursor免费版本不支持自定义API，需要升级Cursor Pro会员才可以使用自定义BaseURL功能。

一、准备工作

1. 获取兼容OpenAI格式的API密钥 sk‑xxxx
2. 获取接口地址，地址必须以 /v1 结尾

示例格式：shturl.cc/iG2SkqEsuPKR

二、打开Cursor模型配置页面

两种打开方式任选其一：

1. 快捷键 Windows：Ctrl+Shift+P；Mac：Cmd+Shift+P 输入命令：Cursor Settings: Models，回车进入模型配置页

2. 点击左上角设置按钮 → 选择 Models

三、填写API信息

1. 找到 Override OpenAI Base URL，把你的接口地址填入（末尾一定带上/v1）
2. 在 OpenAI API Key 填入你的 sk‑开头密钥
3. 点击 Verify 按钮做连通测试，显示Success代表连通成功。

四、添加需要使用的模型ID

向下滑动，自定义新增模型ID，举例：

• gpt‑4o‑pro
• claude‑3‑5‑sonnet‑20241022

⚠️坑点：模型ID必须和你的接口服务商支持的模型完全一致，写错会返回404报错。

把需要的模型开关打开，关闭Cursor内置重复模型，防止调度冲突。

五、实战调用测试

1. 回到Cursor聊天窗口 Ctrl+L
2. 在顶部模型下拉框，选中刚才添加的自定义模型
3. 输入简单代码提问，看是否正常返回结果。

六、高频踩坑汇总（大部分人会遇到）

坑1：Verify验证失败

排查：

1. baseURL结尾必须是 /v1，不要多写斜杠，不要少写
2. 密钥复制不要带空格换行
3. 检查网络，接口服务是否正常运行

坑2：填完模型，下拉列表看不到新增模型

• 模型ID写错
• 没有打开模型开关 操作完成之后，完全关闭Cursor软件重新打开。

坑3：可以聊天，但不能写代码、Agent失效

部分第三方接口不支持Function Call工具调用。

写代码场景优先选择完整支持Function Call的模型通道。

坑4：高峰期超时、回复慢

高并发场景下接口会出现超时，优先选择稳定性高的服务。

七、隐私小提示

Cursor默认会上传对话数据，如果你不想代码上传Cursor服务器： 打开 Settings → Privacy，开启 Privacy Mode隐私模式。 开启之后索引功能性能会下降，按需开启。

总结

1. Cursor Pro才支持自定义API；免费版没有这个功能
2. baseURL格式严格以/v1结尾
3. 模型ID必须和后端支持列表保持一致
4. 配置完成务必重启编辑器，很多异常重启即可解决

希望本篇可以帮到踩坑的掘友。