Cursor 国内接入 Claude / GPT API 完整教程:自定义端点配置 + 报错排查(2026)
Cursor 里覆盖 OpenAI Base URL 指向国内可充值的中转,就能调 Claude / GPT / Gemini。逐步配置、模型代号、model not found 等报错的排查表,和各模式(Chat / Tab / Agent)对自定义端点的支持差异。
1. 原理:Cursor 留了标准入口
Cursor 允许覆盖 OpenAI 的 Base URL,把模型请求指向任何 OpenAI 兼容端点——这是产品内置能力,不是修改客户端。对国内用户意味着:不用办海外卡订阅 Cursor Pro,用一个国内可充值的中转 key,就能在 Cursor 里调 Claude / GPT / Gemini / DeepSeek。要配置的核心就三个值:**Base URL、API Key、模型名**,下面逐个来。
2. 逐步配置(两分钟)
① 注册 cocodot,支付宝充值,控制台建一个 API Key;② 打开 Cursor Settings → Models;③ 在 OpenAI API Key 栏粘贴你的 key;④ 打开「Override OpenAI Base URL」,填 https://cocodot.co/api/ai/v1;⑤ 在模型列表里点 Add model,添加你要用的代号:mco-6(Claude Opus 4.8)、mcf-1(Claude Fable 5)、mog-6(GPT)、deepseek-v4-flash(便宜快),保存;⑥ 在 Chat 里选中刚加的模型发一句话,能回就是通了。
3. 模型代号:报错第一来源
Cursor 里添加的模型名必须和中转支持的代号**完全一致**——填官方原名(如 claude-opus)或拼错代号,就是「model not found」。常用代号:mco-6 = Claude Opus 4.8、mcf-1 = Claude Fable 5、mcs-5 = Claude Sonnet、mog-6 = GPT 旗舰、deepseek-v4-flash = 高性价比国产。完整列表以 cocodot 控制台文档为准。建议至少加两个:一个强模型干难活,一个便宜模型干杂活,对话时按需切换。
4. 各模式的支持差异:先搞清预期
这是最容易产生"是不是坏了"误会的地方。**Chat 对话**:完全走自定义端点,正常。**Tab 自动补全**:走 Cursor 自家的补全模型,和你的自定义端点无关——所以配了中转后 Tab 没变化是正常现象,不是故障。**Agent / Composer**:请求会带工具调用等高级要求,对模型能力和端点兼容性要求更高——先把 Chat 跑通,Agent 用 mco-6 这类强模型测试;个别高级特性若有异常,属于 Cursor 私有协议的边角,不影响主流程。
5. 省钱组合:强弱搭配
自定义端点的一大优势是**按活切模型**:重构、跨文件改动、疑难 bug 用 mco-6 / mcf-1;解释代码、写注释、简单改动用 deepseek-v4-flash——单价差一个数量级,日常活便宜模型完全够。Cursor 的模型切换就在对话框上方,一次点击的事。配合按量计费(用多少扣多少、无月费),轻中度用户的月成本通常明显低于固定订阅。
6. 验证清单与建议
配完照这个清单过一遍:① Chat 里每个添加的模型各发一句话,确认都能回;② 发一段代码让它解释,确认上下文正常;③ 看 cocodot 控制台流水,确认扣费和调用对得上。日常建议:第一次小额充值,跑几天真实工作流再加量;key 别提交进代码仓库(放环境变量或本地配置);同一个 key 在 Cherry Studio、Cline、Claude Code 等工具里通用,不用分别开户。
Cursor 自定义端点报错排查表
| 报错 | 最可能原因 | 解法 |
|---|---|---|
| model not found | 模型代号填错 / 端点不支持该代号 | 用中转文档里的代号(mco-6、mog-6、deepseek-v4-flash),别填官方原名 |
| 401 / 鉴权失败 | key 填错栏位或复制不完整 | key 要填在 OpenAI API Key 栏,完整粘贴,确认余额 > 0 |
| 连不上 / 超时 | Base URL 写错 | 必须是 https://cocodot.co/api/ai/v1,末尾 /v1 不能少 |
| 能聊但 Agent 异常 | Agent 对工具调用有额外要求 | 先确认 Chat 正常,Agent 换 mco-6 这类强模型再试 |
| Tab 补全没变化 | Tab 走 Cursor 自家模型 | 正常现象,自定义端点只影响 Chat / Agent |