Cursor 国内接入 Claude / GPT API 完整教程(自定义端点 + 常见报错)
Cursor 里用自定义 OpenAI 端点接入国内可充的中转,调 Claude / GPT / Gemini,改 Base URL 和 key 就行。附逐步配置、模型添加,和 model not found 等常见报错的解决。
1. 原理:Cursor 支持自定义 OpenAI 端点
Cursor 允许你覆盖 OpenAI 的 Base URL,指向一个 OpenAI 兼容的中转 —— 这样不用官方海外卡,也能在 Cursor 里调 Claude / GPT / Gemini。核心就三个值:Base URL、API Key、模型名。
2. 逐步配置
打开 Cursor 的 Settings → Models;在 OpenAI API Key 区域填入你在中转控制台建的 key;打开「Override OpenAI Base URL」,把地址填成 https://cocodot.co/api/ai/v1;然后在自定义模型里添加你要用的模型名(如 mco-6 = Claude Opus、mog-6 = GPT、deepseek-v3.2),保存。发一句话验证能不能回,通了就能用。
3. 模型名怎么填
Cursor 里添加的模型名要和中转支持的代号一致:mco-6(Claude Opus)、mog-6(GPT)、mgg-8(Gemini)、deepseek-v3.2 等,具体以中转控制台 / 文档为准。填错代号是「model not found」最常见的原因。
4. 常见报错
① model not found / 模型不存在:模型代号填错或该中转不支持这个代号,核对文档;② 401 / 鉴权失败:key 填错、或没填到「自定义 OpenAI key」那一栏;③ 连不上 / 超时:Base URL 写错(末尾要 /v1)、或网络问题;④ 能聊但 Agent / Composer 异常:Cursor 的高级 agent 对模型能力和工具调用有要求,基础对话 / 补全先跑通,复杂 agent 模式建议先小额测你的实际用法。
5. 提醒
第一次先小额充值、跑通一次真实调用,确认延迟和模型没问题再加量。Base URL 末尾是 /v1,别少写也别多写。一个 key 还能切 GPT / Gemini / DeepSeek,做对比和省钱路由很方便。