必须绕过Cursor官方限制直连国产模型API,先在硅基流动等平台创建对应分组的API密钥并复制Base URL(末尾带/v1),再于Cursor设置中填写完整模型标识符、密钥和URL,通过Test Connection验证后启用模型测试响应。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

想在Cursor里用国内模型API Key,必须绕过官方模型限制,直接对接国产大模型服务端口,否则免费版只能用Auto自动调度且无法指定DeepSeek、Qwen、GLM等具体模型。
准备国产模型API凭证
登录你选用的国产模型平台,如硅基流动(SiliconFlow)、147AI、QuickRouter或TokenHub,在「密钥管理」中创建新令牌。注意:分组必须选对,比如DeepSeek-V3要选deepseek-v3分组,通义千问Qwen2.5要选qwen-v2.5分组,填错分组会导致后续请求返回401错误。
复制生成的sk-xxxxxxxx格式Key,同时记下该模型对应的Base URL——不是官网首页,而是模型详情页标注的API端点,例如:https://api.siliconflow.cn/v1或https://api.147ai.com/v1。不要手写URL,必须从模型广场页面直接复制。
【Base URL末尾必须带/v1】,漏掉会触发“invalid endpoint”报错,且不同平台不兼容——SiliconFlow和147AI需要/v1,但QuickRouter的Claude系列模型反而不能加/v1。
在Cursor中配置自定义模型
打开Cursor → 右上角齿轮图标 → Settings → Models → Custom Models → Add Custom Model。
依次填写三项内容:
• Model Name:粘贴模型广场里显示的**完整模型标识符**,例如deepseek-r1、qwen2.5-turbo、glm-4-flash,不可简写为deepseek或qwen;
• API Key:粘贴上一步复制的sk-开头密钥;
• Base URL:粘贴对应平台的端点地址,确认含/v1后缀(除非平台文档明确说明不用)。
点击Add后,新模型会出现在Custom Models列表底部。此时不要关闭窗口,立即点击右侧的Test Connection按钮——只有状态变为Active才算通过基础连通性验证。
启用并测试模型
第一步:回到Models主界面,找到刚添加的模型,将其左侧的启用开关打开;
第二步:在任意代码文件中按Ctrl+L唤出命令面板,输入@触发AI指令;
第三步:在弹出的对话框右下角点击Auto按钮→切换为你刚启用的模型名称;
第四步:输入测试提示词,例如“请解释当前文件中useEffect的依赖数组作用”,等待响应。
若3秒内返回结构化中文回答,且无“model not found”或“authentication failed”类报错,则配置成功。若卡住超8秒,检查网络是否能直连Base URL域名(可浏览器访问https://api.siliconflow.cn/health验证通路)。


















