Cursor 怎么接入任意第三方模型？自定义模型配置
Cursor 自定义模型，指的是绕开官方内置模型列表，把你自己的 OpenAI 兼容接口（base url + API key）接进 Cursor，让它用第三方或私有部署的大模型来对话。 这样你可以用上 DeepSeek、Kimi、GLM 等国产模型，也能接公司自建的网关，按自己的额度和合规要求来跑。
本文讲清 Cursor 自定义模型的原理、配置步骤、生效范围，以及最容易踩的”只对对话生效、补全不走自定义模型”这个坑。想接 DeepSeek 的，可直接看 Cursor 接入 DeepSeek 实战（规划中）。
原理：Cursor 自定义模型靠的是 OpenAI 兼容协议
Cursor 之所以能接”任意”模型，核心不是它内置了多少家，而是它支持 OpenAI 兼容的 API 协议。
只要某个模型服务暴露的接口长得和 OpenAI 的 chat/completions 一样——同样的请求体、同样的鉴权头、同样的 model 字段——Cursor 就能把它当成一个普通模型来调用。现在主流的国产模型平台（DeepSeek、Kimi、GLM 等）和绝大多数自建网关，都提供 OpenAI 兼容端点。
所以自定义模型这件事，本质就是三件事：
- 告诉 Cursor 一个模型名（要和服务端认的
model名对上）； - 填一个 base url（服务的 OpenAI 兼容地址）；
- 填一个 API key（鉴权用）。
机制就这么简单。具体的端点路径、模型名拼写、是否要带 /v1 后缀，各家略有差异，以官方文档为准——但原理不变。
举几个我自己接过的例子，帮你建立直观感受（具体值随时可能变动，填之前务必去对应平台的官方文档核对一遍，别照抄我这里的字符串）：
- DeepSeek：base url 形如
https://api.deepseek.com（有的版本要求带/v1，两种都试一下），模型名对话用deepseek-chat，深度推理用deepseek-reasoner。key 在 DeepSeek 开放平台的 API Keys 页面生成。 - 智谱 GLM：base url 是
https://open.bigmodel.cn/api/paas/v4，模型名比如glm-4-plus。这家的鉴权 key 格式和纯 OpenAI 略有差异，Cursor 这边填法不变，但如果验证一直 401，去平台文档确认 key 是否需要额外拼接。 - 公司自建网关：如果你们是用 One API、New API 这类聚合网关统一管理多家模型的 key，那 base url 就填网关自己暴露的地址，模型名填网关里配置的别名，鉴权用网关发的 key——对 Cursor 来说，网关本身就是”一个 OpenAI 兼容服务”，行为和直连某家平台完全一样。
从这几个例子能看出一个规律：Cursor 侧的操作永远是那三步不变，变的只是你去哪家平台复制这三个值。 把这个心智模型立住，以后换任何新模型都不会手忙脚乱。
通用配置步骤
下面是接入自定义模型的标准流程。Cursor 的设置入口在不同版本里位置略有调整，以你本地实际界面为准，但逻辑一致。
第一步：打开模型设置。 进入 Cursor 的 Settings（设置），找到 Models 面板。这里列着所有可用模型，也是添加自定义模型的地方。
第二步：添加自定义模型名。 在 Models 列表里点 Add Model（添加模型），输入你要用的模型名。这个名字必须和服务端识别的一致——比如接 DeepSeek 就填它文档里规定的对话模型名，填错了请求会被服务端拒绝。
第三步：填 base url 和 API key。 在 Models 面板里有 OpenAI API Key 相关的设置区，展开后：
- Base URL / Override OpenAI Base URL：填第三方服务的 OpenAI 兼容地址；
- API Key：填该服务发给你的密钥。
第四步：验证并启用。 填完后点验证（Verify）按钮，Cursor 会发一个测试请求。通过后，把你刚加的自定义模型名勾选启用，其余不需要的官方模型可以取消勾选，避免对话框里选错。
配置好之后，在对话框（Chat / Cmd+K）的模型下拉里就能选到你的自定义模型。
一个容易漏的细节：Cursor 的模型配置是按账号走的，不是按项目走的。 也就是说你在 A 项目里加的自定义模型，切到 B 项目照样能选到，不用每个项目重新配一遍。但反过来说，如果你在公司电脑和自己电脑都装了 Cursor，两边的自定义模型是分开配的，不会自动同步——换设备记得把这三项抄一遍。
什么时候值得折腾自定义模型，什么时候别费这个劲
配之前先想清楚你图什么，别为了”能配”而配：
- 图成本：官方内置模型走 Cursor 自己的订阅额度，超额度要么限速要么加钱。如果你团队用量大，接一个便宜的国产模型跑对话（比如日常问答、简单代码解释），能省下不少订阅费。但代码补全省不了——前面讲过，补全走不了自定义模型。
- 图合规/数据不出境：公司要求代码上下文不能发到境外服务器，这时候接一个境内部署或私有网关的模型，是刚需，没得选。
- 图效果：单纯觉得某个第三方模型比官方内置的更聪明——这个理由要打个问号。官方模型经过 Cursor 针对 IDE 场景做过 prompt 和上下文拼接的优化，直连的第三方模型在长上下文、多文件理解上不一定更好用，得自己实测对比，别只看跑分。
- 不建议为了”图省事”接：如果你就是个人用户、用量不大，官方模型的订阅额度基本够用，折腾自定义模型反而多一层排查成本（key 过期、额度用完、接口变更都要自己盯着），性价比不高。
关键注意：自定义模型只对”对话”生效
这是最多人栽跟头的地方，单独拎出来讲。
自定义模型通常只对对话类功能（Chat、Cmd+K、Composer）生效，不接管行内代码补全（Tab 自动补全）。
原因是 Cursor 的 Tab 补全用的是它自家训练的专用小模型，跑在 Cursor 的服务上，并不是简单调一个 chat/completions 接口——它对延迟和上下文格式有特殊要求。所以你接的第三方模型再强，也替换不了 Tab 补全。
这意味着：
- 你接了 DeepSeek，对话会走 DeepSeek，但代码补全仍走 Cursor 自己的补全模型；
- 想完全本地化/私有化、连补全都自己掌控，靠自定义模型这条路是做不到的；
- 部分依赖官方模型能力的高级功能（如某些 Agent 行为），接自定义模型后也可能受限，以官方文档说明为准。
把”省钱接对话”和”完全替换 Cursor”这两件事分开看，期望就不会落空。
怎么验证接入成功
填完别急着干活，先确认真的接通了：
- 看验证结果：Models 面板里点验证，提示成功才算 key 和地址没问题。
- 发一句话试对话：在 Chat 里选中你的自定义模型，随便问一句，能正常回复即通。
- 核对计费/日志：到第三方平台后台看是否产生了调用记录，确认请求确实打到了你的服务，而不是悄悄回退到官方模型。
- 故意问个模型自己身份：让它说自己是谁，有时能侧面验证当前到底在用哪个模型（不绝对，仅供参考）。
常见坑与排查
| 现象 | 可能原因 | 解法 |
|---|---|---|
| 验证失败 / 401、403 | API key 错、没权限、地址带错后缀 | 核对 key 和 base url，注意 /v1 是否该加，以官方文档为准 |
| 验证失败 / 404 | base url 路径不对 | 确认填的是 OpenAI 兼容端点，不是平台首页地址 |
| 报模型不存在 | 模型名和服务端对不上 | 用服务文档里规定的精确模型名，别自己改写 |
| 对话能用，补全没变化 | 补全本就不走自定义模型 | 正常现象，Tab 补全用 Cursor 自家模型 |
| 接入后官方模型用不了 | 覆盖了 OpenAI Base URL，影响到官方调用 | 切换回官方模型前，按需关闭自定义 base url 覆盖 |
| 时通时不通 | 网络/第三方服务限流 | 看第三方平台状态和你的额度，与 Cursor 无关 |
一个高频细节：覆盖了 base url 后，Cursor 走”OpenAI 系”的请求都会打到你填的地址。所以当你想切回 Cursor 官方模型时，要留意这个覆盖设置是否需要关掉，否则官方模型也会被路由到你的第三方地址而报错。切换管理的核心就是搞清楚：哪些模型走官方、哪些走自定义，别让一个全局覆盖配置把两边都搅乱。
如果你是冲着”用国产模型省成本”来的，也可以看看 Claude Code 接入国产模型 的思路做横向对比，两种工具的接入逻辑相通。
常见问题
Cursor 能接 DeepSeek、Kimi、GLM 吗？ 能。这些平台都提供 OpenAI 兼容接口，按上面的步骤填模型名、base url、key 即可。具体模型名和地址以各平台官方文档为准。
接了自定义模型，代码补全会变快/变强吗？ 不会。补全走 Cursor 自家的专用模型，自定义模型只接管对话（Chat、Cmd+K）。这是设计如此，不是配置错了。
为什么验证一直失败？
九成是三件事之一：key 填错、base url 路径不对（比如该不该带 /v1）、模型名和服务端对不上。逐个核对，参照第三方平台文档。
接了自定义模型后，官方的 Claude、GPT 还能用吗？ 能，但若你覆盖了全局 OpenAI Base URL，切回官方模型时要注意这个覆盖是否会把官方请求也路由到第三方地址。按需关闭覆盖即可。
自定义模型能让 Cursor 完全离线/私有化吗？ 不能完全。对话可以指向你的私有网关，但 Tab 补全等部分能力仍依赖 Cursor 的服务。要彻底私有化得考虑别的方案。
👉 看看我们的 AI 编程实战体系课，或逛 AI 编程教程大全 把基本功打扎实。