Cursor 接入国产模型教程：DeepSeek/GLM 配置实测（2026）
发布于 2026年9月8日
Cursor 好用，但官方订阅按美元结算、还要科学上网，长期用下来成本不低。于是很多人想给 Cursor 接入国产模型——用 DeepSeek、GLM、Kimi、Qwen 这些又便宜又免翻墙的 API 顶替官方额度。这条路技术上走得通，但有一个绝大多数教程都不告诉你的关键前提：Cursor 的自定义模型并不是「接上就全功能可用」。这篇教程实测讲清楚配置方法、各家 Base URL 与模型名，以及哪些功能能用、哪些用不了，帮你少踩坑。
先搞清楚：Cursor 接国产模型，到底能用在哪
这是全文最重要的一节，先看完再动手，否则配好了发现「Agent 不理你」会一头雾水。Cursor 允许你在设置里覆盖 OpenAI 的 Base URL、填自己的 API Key、添加自定义模型名，把请求转发到任意 OpenAI 兼容的国产网关。但 Cursor 的很多核心能力（Composer/Agent 自动改代码、Ctrl+K 内联编辑、Apply 应用改动、Tab 自动补全）是绑死在 Cursor 自家后端上的，它们并不会走你填的国产模型。
配置前必读的三条限制
① 自定义 Base URL 目前主要对「聊天（Chat）/ Plan 规划面板」可靠生效；Composer/Agent、内联编辑、Apply、Tab 补全仍走 Cursor 后端，不会用你的国产模型。② 一旦覆盖了 OpenAI Base URL，Cursor 自带的付费模型（Cursor Pro）可能一起失效——这是社区已多次报告的 BYOK 冲突。③ 规避办法：在模型列表里只勾选你的自定义模型、取消其它内置模型的勾选。想用国产模型跑「全自动改代码的 Agent」，Cursor 这条路目前是受限的。
第一步：拿到国产模型的 Base URL 和模型名
去对应平台开通 API、创建一个 API Key，记下它的 OpenAI 兼容 Base URL 和模型名。主流几家整理如下（Base URL 结尾都记得带 /v1 或对应版本路径，Cursor 会在后面自动拼 /chat/completions）：
| 厂商 | OpenAI 兼容 Base URL | 常用模型名 | 特点 |
|---|---|---|---|
| DeepSeek | https://api.deepseek.com/v1 | deepseek-v4-pro / deepseek-v4-flash | 编程能力强、价格极低 |
| 智谱 GLM | https://open.bigmodel.cn/api/paas/v4 | glm-4.7 / glm-4.6 | 综合均衡、有编程套餐 |
| 月之暗面 Kimi | https://api.moonshot.cn/v1 | kimi-k2 系列 | 长上下文、K2 编程不俗 |
| 通义千问 Qwen | https://dashscope.aliyuncs.com/compatible-mode/v1 | qwen3-coder-plus / qwen-max | 阿里出品、专门的 Coder 模型 |
DeepSeek 模型名换新了
DeepSeek 已把旧模型名 deepseek-chat / deepseek-reasoner 于 2026-07-24 弃用，改为 deepseek-v4-flash（非思考/思考两态）与 deepseek-v4-pro。填模型名时直接用新名字，别再写 deepseek-chat。
第二步：在 Cursor 里配置自定义模型
- 1打开 Cursor 设置（快捷键 Ctrl/Cmd + Shift + J），进入 Models（模型）一栏。
- 2找到「Override OpenAI Base URL」，填入你的国产网关地址，例如 https://api.deepseek.com/v1（务必带 /v1，Cursor 会自动在后面拼 /chat/completions）。
- 3在「OpenAI API Key」输入框粘贴你申请到的 Key，点 Verify / Save 保存并验证。
- 4在「Add model / 添加模型」里，填一个和厂商完全一致的模型名，例如 deepseek-v4-pro，回车添加。
- 5关键：取消勾选其它所有内置模型，只保留你新加的这个自定义模型，避免 Cursor 用官方 Key 去验证时报错。
- 6回到聊天面板（Chat），在模型下拉里选中你的自定义模型，发一句话测试是否有正常回复。
如果你更习惯用配置文件，也可以在 Cursor 的 User Settings (JSON) 里以 openai-compatible 方式声明 provider、apiKey、baseURL 和 model 字段，效果等价。多数人用界面点几下就够了。
进阶：用 One API / New API 网关聚合多个模型
Cursor 的 Base URL 一次只能填一个。如果你想在 DeepSeek、GLM、Kimi 之间随时切换，或者手上有多家 Key 想统一管理，可以自建一个 One API / New API 这类聚合网关：把各家 Key 都录进去，网关对外暴露一个统一的 OpenAI 兼容地址和一批模型名，Cursor 只需要填网关地址，就能在一个下拉里选到所有模型。这也方便统计各模型的用量和花费。
bash
# 以 DeepSeek 为例，先用 curl 验证你的 Key 和 Base URL 通不通
curl https://api.deepseek.com/v1/chat/completions \
-H "Authorization: Bearer $DEEPSEEK_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "deepseek-v4-pro",
"messages": [{"role": "user", "content": "用一句话解释什么是递归"}]
}'
# 能返回 JSON 回复，说明 Key/地址没问题，再填进 Cursor 就不会白折腾国产模型 API 到底多便宜
以 DeepSeek 官方价为例（2026 年永久降价后，价格随官方调整为准）：V4-Flash 大约缓存命中输入 0.02 元、未命中输入 1 元、输出 2 元（每百万 tokens）；V4-Pro 大约缓存命中输入 0.025 元、未命中输入 3 元、输出 6 元。日常写代码几块钱能用很久，相比 Cursor 官方订阅确实省，也不用担心额度按月清零。
常见报错与排查
| 现象 | 可能原因 | 排查方向 |
|---|---|---|
| 保存后 Cursor 自带模型全部失效 | 覆盖 Base URL 引发 BYOK 冲突 | 只勾选自定义模型，取消其它内置模型的勾选 |
| 聊天报 404 / Not Found | Base URL 没带 /v1，或多带了 /chat/completions | 只填到 /v1，剩下的路径 Cursor 自动拼 |
| Agent/Composer 没反应或报错 | 这些功能不走自定义模型（见开头限制） | 改用聊天面板；Agent 场景考虑用支持自定义模型的 CLI/插件 |
| 带思考的 DeepSeek 多轮报校验错误 | reasoning_content 未回传，Cursor BYOK 路径有兼容问题 | 改用非思考模型 deepseek-v4-flash，或走聚合网关 |
| 模型名报错 model not found | 填的模型名和厂商不一致 | 对照官方文档的准确模型 id，逐字符核对 |
接 Cursor 还是直接用国产 CLI？
结论很直接：如果你主要用 Cursor 的聊天/问答、代码解释、写点函数，接国产模型完全够用、还省钱。但如果你追求「让 AI 全自动读整个仓库、自己改多个文件」的 Agent 体验，Cursor 的自定义模型目前跑不满这条路——那种场景更适合用原生支持自定义模型的工具，比如 Cline、Roo Code、Continue 这类 VS Code 插件，或直接给 Claude Code 接国产模型。这些工具在 IMAI 站内都有对应的「接国产模型」实测教程，可以按需选。
给 Cursor 接国产模型能省钱、免翻墙，但也要清楚它的边界——聊天问答顺手，全自动 Agent 受限。真正决定你效率的，从来不是「用哪个模型」，而是你会不会拆需求、写清上下文、把 AI 的能力用在刀刃上。想系统掌握用各类 AI 编程工具做出可交付项目的方法，欢迎来 IMAI 看看我们的体系化实战课程。
想系统学会用 AI 编程,从入门到做出真实产品?
查看系统课程