AI 编程工具 免费 ⏱ 阅读约 18 分钟 2026/7/8

Cursor 模型设置

介绍 Cursor Models 设置、自定义添加模型、配置 API Key 和请求地址、验证模型,并以 DeepSeek 为例说明配置流程。

序言

本教程由「小荣的网络开发日志」实操整理编写,实操踩坑验证,内容真实可靠。

遇到操作问题可直接联系作者,转载需标注原文出处,禁止私自篡改商用。

承接网站、APP、小程序、各类脚本定制开发;

AI 编程教学、一对一项目全程陪跑,提供免费技术咨询。

联系方式: 微信:rongyaolg 电话:18375295913


Cursor 模型设置

Cursor 强大的地方之一,就是可以充分利用大模型能力。

它本身内置了一些常见模型,也支持用户添加自定义模型。比如你想使用 DeepSeek、OpenAI 兼容接口或第三方模型平台,就可以在模型设置里手动配置。

这一节我们按实际操作流程来讲:

  1. 打开模型设置
  2. 选择内置模型
  3. 添加自定义模型
  4. 配置 API Key 和请求地址
  5. 验证模型是否可用
  6. 在聊天窗口中选择模型测试

一、打开模型设置

  1. 打开 Cursor
  2. 点击右上角或设置区域的齿轮图标
  3. 进入设置界面
  4. 找到 Models / 模型

进入 Models 页面后,可以看到 Cursor 默认已经提供了一些模型选项。


二、选择内置模型

在模型列表中,你可以选择想使用的模型。

常见模型可能包括:

模型类型 适合场景
GPT 系列 通用问答、代码生成、项目理解
Claude 系列 长文本理解、代码解释、重构
轻量模型 快速问答、简单补全
推理模型 复杂分析、多步骤任务

具体可选模型会随着 Cursor 和模型平台更新而变化,以你设置页面实际显示为准。


三、添加自定义模型

如果你想使用 Cursor 默认列表之外的模型,可以添加自定义模型。

操作步骤:

  1. 在 Models 页面向下找到 Add Model / 添加模型
  2. 点击按钮
  3. 输入模型名称
  4. 保存模型

例如你想添加 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.com

Chat 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 的聊天窗口。

操作:

  1. 点击右上角或侧边栏的聊天图标
  2. 在模型选择处选择你刚添加的模型
  3. 输入一句简单测试

例如:

你好,请回复 OK,并告诉我你当前可以帮助我做什么。

如果模型能正常回复,说明配置基本成功。


九、安全提醒

API Key 很重要,类似账号密码。

请注意:

  • 不要把 API Key 发给别人
  • 不要把 API Key 写进公开代码
  • 不要提交到 GitHub
  • 如果泄露,立刻去模型平台删除或重置

官方教程链接