序言
本教程由「小荣的网络开发日志」实操整理编写,实操踩坑验证,内容真实可靠。
遇到操作问题可直接联系作者,转载需标注原文出处,禁止私自篡改商用。
承接网站、APP、小程序、各类脚本定制开发;
AI 编程教学、一对一项目全程陪跑,提供免费技术咨询。
联系方式: 微信:rongyaolg 电话:18375295913
Cursor 模型设置
Cursor 强大的地方之一,就是可以充分利用大模型能力。
它本身内置了一些常见模型,也支持用户添加自定义模型。比如你想使用 DeepSeek、OpenAI 兼容接口或第三方模型平台,就可以在模型设置里手动配置。
这一节我们按实际操作流程来讲:
- 打开模型设置
- 选择内置模型
- 添加自定义模型
- 配置 API Key 和请求地址
- 验证模型是否可用
- 在聊天窗口中选择模型测试
一、打开模型设置
- 打开 Cursor
- 点击右上角或设置区域的齿轮图标
- 进入设置界面
- 找到 Models / 模型
进入 Models 页面后,可以看到 Cursor 默认已经提供了一些模型选项。
二、选择内置模型
在模型列表中,你可以选择想使用的模型。
常见模型可能包括:
| 模型类型 | 适合场景 |
|---|---|
| GPT 系列 | 通用问答、代码生成、项目理解 |
| Claude 系列 | 长文本理解、代码解释、重构 |
| 轻量模型 | 快速问答、简单补全 |
| 推理模型 | 复杂分析、多步骤任务 |
具体可选模型会随着 Cursor 和模型平台更新而变化,以你设置页面实际显示为准。
三、添加自定义模型
如果你想使用 Cursor 默认列表之外的模型,可以添加自定义模型。
操作步骤:
- 在 Models 页面向下找到 Add Model / 添加模型
- 点击按钮
- 输入模型名称
- 保存模型
例如你想添加 DeepSeek 模型,可以输入类似:
deepseek-v4-flash
deepseek-v4-pro注意:模型名一定不能输错。模型名要以模型服务商官方文档或平台后台显示为准。
如果模型名填错,即使 API Key 和请求地址正确,也可能无法正常调用。
四、配置 API Key 和请求地址
添加模型后,还需要填写 API Key 和请求地址。
通常需要填写:
| 配置项 | 说明 |
|---|---|
| API Key | 模型平台提供的密钥 |
| Base URL / 请求地址 | 模型接口地址 |
| Model Name | 模型名称 |
API Key 和请求地址需要去对应大模型官方平台获取。
五、以 DeepSeek 为例
如果你要使用 DeepSeek,可以去 DeepSeek 官方平台申请 API Key:
https://platform.deepseek.com/usage
DeepSeek 官方 API 文档中,OpenAI 兼容格式的 Base URL 是:
https://api.deepseek.comChat Completions 路径是:
/chat/completions所以完整接口地址可以理解为:
https://api.deepseek.com/chat/completions在 Cursor 中具体应该填 Base URL 还是完整接口地址,要看当前设置项名称。如果设置项写的是 Base URL,通常填写:
https://api.deepseek.com如果设置项明确要求完整请求地址,再填写完整接口地址。
六、验证模型配置
模型名称、API Key、请求地址填写完成后,可以点击 Verify / 验证。
如果没有报错,通常说明配置成功。
如果验证失败,优先检查:
| 问题 | 检查方向 |
|---|---|
| API Key 无效 | 是否复制完整,有没有多余空格 |
| 模型不存在 | 模型名是否写错 |
| 请求地址错误 | Base URL 是否填对 |
| 余额不足 | 模型平台账号是否有额度 |
| 网络问题 | 当前网络是否能访问模型接口 |
七、勾选要使用的模型
模型添加成功后,列表里会出现你刚刚添加的模型。
如果你只想使用某几个模型,可以取消勾选其他不需要的模型,只保留常用模型。
例如:
| 模型 | 用途 |
|---|---|
| deepseek-v4-flash | 日常快速问答、普通代码任务 |
| deepseek-v4-pro | 更复杂的代码理解、推理和重构 |
模型名称可能会随平台更新变化,使用前请确认官方当前模型列表。
八、在聊天窗口中测试
配置完成后,可以打开 Cursor 的聊天窗口。
操作:
- 点击右上角或侧边栏的聊天图标
- 在模型选择处选择你刚添加的模型
- 输入一句简单测试
例如:
你好,请回复 OK,并告诉我你当前可以帮助我做什么。如果模型能正常回复,说明配置基本成功。
九、安全提醒
API Key 很重要,类似账号密码。
请注意:
- 不要把 API Key 发给别人
- 不要把 API Key 写进公开代码
- 不要提交到 GitHub
- 如果泄露,立刻去模型平台删除或重置