Cursor 接入自定义 AI 模型

Cursor 支持通过 OpenAI 兼容接口接入任意第三方模型。无论是 DeepSeek、Qwen，还是通过中转站访问的 Claude，配置方式完全一致。

前置条件

• 已安装 Cursor（cursor.com 下载，支持 macOS、Windows、Linux）
• 有目标模型的 API Key 和 Base URL（可以是官方地址或中转站地址）

配置步骤

第 1 步：打开模型设置

打开 Cursor，按 Cmd+,（macOS）或 Ctrl+,（Windows/Linux）进入设置，在左侧搜索框输入 model，点击 Models 选项。

或者通过菜单：Cursor → Settings → Models。

第 2 步：添加自定义模型

在 Models 页面，找到 OpenAI API Key 区域，填入以下信息：

• API Key：你的密钥，例如 sk-xxxxxxxxxxxxxxxxxxxxxxxx
• Base URL：API 地址，例如：
  • DeepSeek 官方：https://api.deepseek.com/v1
  • SiliconFlow：https://api.siliconflow.cn/v1
  • 中转站示例：https://api.your-proxy.com/v1

填写完成后点击 Verify 按钮，Cursor 会发送一个测试请求确认连通性。

第 3 步：启用自定义模型名称

在同一页面下方的 Model Names 区域，点击 Add model，输入你要使用的模型名称，例如：

deepseek-chat
deepseek-coder-v2
Qwen/Qwen2.5-72B-Instruct

模型名称必须与 API 提供方支持的名称完全一致，大小写敏感。

第 4 步：在对话中选择模型

打开 Cursor 的 AI 对话面板（Cmd+L 或 Ctrl+L），点击输入框上方的模型选择器，从下拉列表中选择刚才添加的模型名称。

验证接入是否成功

在 AI 对话框中发送以下消息：

你是什么模型？请简短回答。

如果回复中提到了你配置的模型名称（如 DeepSeek、Qwen），说明接入成功。

如果出现错误提示，常见原因：

• 401 Unauthorized：API Key 填写错误或已过期
• 404 Not Found：Base URL 格式不对，检查是否以 /v1 结尾
• model not found：模型名称拼写错误，对照提供方文档确认

常见问题

Q：代码补全（Tab 补全）能用自定义模型吗？

代码补全功能目前只支持 Cursor 内置模型（如 cursor-small），自定义模型只能用于 Chat 和 Composer 功能。

Q：配置了自定义模型后，原来的 Claude/GPT 还能用吗？

可以。Cursor 支持多个模型并存，在对话框里随时切换，互不影响。

Q：Base URL 需要加 /v1 吗？

取决于提供方。大多数 OpenAI 兼容接口需要 /v1，但部分中转站的地址已经包含了路径，填写前确认提供方文档。