Cursor 接入 DeepSeek 等国产模型配置教程
把 DeepSeek 等国产模型接进 Cursor，本质是利用 Cursor 设置里的”自定义模型 + OpenAI 兼容接口”通道：你提供一个兼容 OpenAI 协议的 Base URL 和 API Key，Cursor 把对话请求按 OpenAI 的格式发过去。配通之后，你既能用国产模型省钱，又能保留 Cursor 熟悉的编辑器体验。这篇讲清原理、通用配置步骤和最容易踩的坑——参数会变，机制不变。
如果你还没用过 Cursor，建议先看 Cursor 教程；想了解 DeepSeek 本身，可看 DeepSeek 入门。
为什么要给 Cursor 接国产模型
Cursor 默认用的是 Claude、GPT 这类海外模型，对很多人来说有三个痛点：网络不稳、按量计费偏贵、数据出境有顾虑。
接入 DeepSeek 这类国产模型，能缓解这三点：国内访问更稳、token 单价通常更低、合规上更省心。代价是你要自己管一个 API Key，并接受补全功能可能受限（下面会讲为什么）。
适合这么做的人：写代码量大、对成本敏感、或团队有合规要求的开发者。
原理：Cursor 的 OpenAI 兼容通道
理解这一层，后面配什么模型都一通百通。
Cursor 的设置里有一个 “OpenAI API Key / Override OpenAI Base URL” 的开关。打开后，Cursor 不再把对话请求发给它自己的服务器，而是发给你指定的 Base URL，并用你的 Key 鉴权。
关键前提是：目标模型的接口必须兼容 OpenAI 的 chat/completions 协议。DeepSeek、Kimi、GLM 等主流国产模型官方都提供 OpenAI 兼容端点，所以能直接接。换句话说，Cursor 以为自己在跟 OpenAI 说话，实际背后是国产模型在应答。
一句话记住：你只是把”收信地址”和”门钥匙”换了，信的格式还是 OpenAI 那一套。
通用配置 5 步
下面是与具体模型无关的通用流程，DeepSeek、Kimi、GLM 都照此办理。
- 拿 API Key：去模型厂商的开放平台注册，创建一个 API Key，复制好。
- 拿 Base URL（端点）：在厂商文档里找到”OpenAI 兼容”那条 Base URL。具体地址以官方文档为准，不要凭记忆填。
- 打开 Cursor 设置：
Settings → Models（或叫 AI / Model 区域），找到 OpenAI 相关设置。 - 填 Key 与覆盖 Base URL：把 API Key 粘进 OpenAI API Key 框；勾选 Override OpenAI Base URL，填上第 2 步的端点。
- 添加自定义模型名：在 Models 列表里点 Add model，填模型标识符（如
deepseek-chat，以官方为准），保存后勾选启用。
填完后通常会有一个 Verify 按钮，点它做连通性验证（见下文）。
分情况说明：各家模型怎么填
下面给出”填什么”的对应关系，具体的 Base URL 和模型名一律以各家官方文档为准，本文不写死，避免过期误导。
| 模型 | 在 Cursor 里填什么 | 备注 |
|---|---|---|
| DeepSeek | OpenAI 兼容 Base URL + Key + 模型名（如 deepseek-chat / 推理模型名） | 官方提供 OpenAI 兼容端点，最省事 |
| Kimi（月之暗面） | 同上，端点与模型名以官方为准 | 支持 OpenAI 兼容协议 |
| GLM（智谱） | 同上，端点与模型名以官方为准 | 支持 OpenAI 兼容协议 |
要点：Cursor 一次只认一个 Base URL。如果你想在 DeepSeek、Kimi 之间切换，要么改 Base URL，要么用一个聚合中转的网关（自行评估安全与稳定性），不要指望同时挂多家。
chat 模型和推理模型别混着填
DeepSeek、Kimi、GLM 这类厂商，通常同时开放普通对话模型和推理/深度思考模型两条线，模型标识符不一样，能力和延迟也不一样：
- 普通对话模型（如常见的
xxx-chat系）：响应快，适合日常改代码、写小函数、聊需求，Cursor 里用起来手感接近原生 Claude/GPT 的对话档。 - 推理模型（带
reasoner/thinking一类标识）：会先在后台”想”一段再出结果，逻辑链更长，适合排查诡异 bug、设计架构、写复杂算法，但首字延迟明显更高，在 Cursor 里等首个 token 可能要多等好几秒甚至十几秒。
实操建议：在 Cursor 里分别注册两个自定义模型（如 deepseek-chat、deepseek-reasoner，标识符以官方为准），日常用 chat 档，遇难题再手动切推理档，别把推理模型设成默认，不然改一行 import 都要多等十秒。
要不要接聚合网关
如果你想在 DeepSeek、Kimi、GLM 之间随时切、或者想统一计费和限流，市面上有不少”一个 Key 通吃多家模型”的聚合网关，用法上等价于换一个 Base URL。接之前想清楚三件事：
- 数据是否二次落地：聚合网关本质是个中转，你的 Prompt 和代码片段会经过它的服务器，选之前确认对方的日志留存和数据使用政策，涉及公司代码尽量别图省事直连未知第三方。
- 计费透明度：有的网关按官方原价转发只赚差价或订阅费，有的会在原价上加价，先拿官方定价和网关面板对一次账，别等月底账单吓一跳。
- 稳定性兜底：官方端点抖动时，网关是否有自动切换到备用节点的能力，还是原样把错误抛给你——这决定了你半夜写代码时会不会突然卡死。
个人项目或练手，直连官方端点最省心；团队协作、需要统一管控多个 Key 时，聚合网关能省切换成本，但要把上面三条落实成书面确认，别口头”应该没问题”。
补全和对话不是一回事
这是新手最容易困惑的地方，一定要分清。
- 对话 / Chat / Composer：你接入的国产模型，主要在这里生效。问答、改代码、Agent 任务都走它。
- Tab 自动补全（行内代码补全）：这是 Cursor 自家训练的专用小模型，不走你填的 OpenAI 兼容通道，也就改不了。
所以即使你成功接了 DeepSeek，行内补全大概率还是 Cursor 原生的那套。想用国产模型，重心放在对话和 Composer 上，别指望它接管 Tab 补全。
怎么验证成功
填完别急着写代码，先确认通了：
- 点 Verify：设置里有验证按钮就先点，绿勾/成功提示说明 Key 和 Base URL 能连通。
- 发一句测试对话：在 Chat 里随便问一句”用一行 Python 打印 hello”，能正常回答 = 通道走通。
- 看模型是否被真正调用：可在厂商开放平台后台看调用记录/用量，有新增请求说明确实走的是国产模型，而不是 Cursor 默认模型在兜底。
三步都过，才算真接好了。
常见坑与排查
| 现象 | 可能原因 | 解法 |
|---|---|---|
| Verify 失败 / 401 | API Key 错、过期或没充值激活 | 重新复制 Key，确认账户已开通、有余额 |
| Verify 失败 / 连接超时 | Base URL 填错或漏了路径 | 严格按官方 OpenAI 兼容端点填，注意结尾是否带 /v1 |
| 报模型不存在 / 404 | 自定义模型名拼错 | 用官方文档里的精确模型标识符 |
| 开了之后官方模型不能用了 | Override Base URL 是全局开关 | 想用回 Claude/GPT 就关掉覆盖，二者不能并存 |
| 补全没变化 | Tab 补全不走该通道 | 正常现象，补全是 Cursor 自家模型 |
| 对话偶尔很慢/断开 | 国产端点限流或网络抖动 | 看后台限流策略，必要时降并发或换时段 |
排查口诀：先看 Key（鉴权），再看 URL（地址），最后看模型名（标识）——三层逐个排除。
一个真实排查案例走一遍
假设你填完 Key、Base URL、模型名，点 Verify 显示成功，但一进 Chat 发消息就转圈转到超时。按上面口诀走一遍：
- Key 没问题——Verify 通过说明鉴权这一层是通的，不用再折腾 Key。
- URL 大概率也没问题——同上，能 Verify 成功意味着握手成功了。
- 问题多半出在模型名或参数：这时候去看厂商开放平台的调用日志，如果压根没有新请求进来，说明 Cursor 实际没把请求发出去，回头检查模型是否勾选启用；如果日志里有请求但报错，把报错内容对照官方文档，常见的是上下文长度超限（你把一个很大的文件塞进对话，超过了该模型的 context window）或者并发限流（免费额度/低档位账户同时只能跑 1-2 个请求，Cursor 后台可能悄悄发了多个）。
这套”先看有没有请求到达，再看请求报什么错”的思路，比瞎猜 Base URL 拼错更快定位问题，遇到别的诡异现象也照此排查。
Key 的安全习惯，顺手养成
国产模型的 Key 一旦泄露，被人拿去跑满你的额度是常事，接入时顺手做好这几点，比出事后补救省心得多：
- 不要把 Key 提交进 Git 仓库：Cursor 的 Key 存在本地设置里，不会进代码库，但如果你团队用配置文件同步 Cursor 设置，记得把敏感字段排除在版本控制之外。
- 给 Key 设额度上限：多数厂商开放平台支持给单个 Key 设每日/每月消费上限，设一个略高于你正常用量的值，一旦被盗刷也能及时触发告警，不会一夜刷爆账户。
- 团队场景一人一个 Key：别为了省事全team共用一个 Key，出问题时你分不清是谁的请求打爆了限流，也没法单独吊销某个人的权限。
常见问题
问：接了 DeepSeek 后，Cursor 的代码补全也会变成 DeepSeek 吗？ 不会。Tab 行内补全用的是 Cursor 自家专用模型，不走你填的 OpenAI 兼容通道。你接入的国产模型主要在 Chat / Composer 里生效。
问：可以同时挂 DeepSeek 和 Kimi 两个模型随时切换吗？ Cursor 的 Override Base URL 一次只认一个端点，没法原生同时挂多家。要切换得改 Base URL，或自建/使用一个聚合网关（注意安全与稳定性）。
问：开了 Override Base URL，原来的 Claude、GPT 还能用吗？ 不能同时用。覆盖是全局生效的，想用回官方模型就把覆盖关掉。建议根据当下任务来回切。
问：Base URL 到底填什么？文章里怎么没给具体地址？ 因为各家端点和模型名会调整，写死容易过期误导。请到对应厂商开放平台的”OpenAI 兼容”文档页复制，一切以官方文档为准。
问：Cursor 接国产模型，和 Claude Code 接国产模型有什么不同？ 思路类似（都是 OpenAI 兼容通道），但配置位置和粒度不同。想对照另一条路线，可看 Claude Code 接入国产模型。
👉 看看我们的 AI 编程实战体系课，或逛 AI 编程教程大全 把基本功打扎实。