Cursor 配置教程

⚠️ 重要前置条件：Cursor 的自定义 API 功能（"自带密钥" BYOK 模式）仅对 Pro 或更高版本的付费订阅用户开放。如果你未订阅，将无法使用下文介绍的配置方法。

步骤 1：下载并安装 Cursor

访问 Cursor 官网下载对应操作系统的安装包

运行安装程序，按照提示完成安装

打开 Cursor，点击右上角 齿轮图标 ⚙️ 打开设置（或使用快捷键 Ctrl/Cmd + ,）

在左侧导航栏中选择 "Models" 选项卡

在 "Models" 页面中，找到 "OpenAI API Key" 部分：

API Key：粘贴你在平台创建的令牌

Override OpenAI Base URL：点击开关启用，填写 https://jiniu.ai/v1

配置好 API 密钥和地址后，你需要手动添加要使用的模型：

在 "Models" 页面，找到 "Add Custom Model" 按钮并点击

输入模型的准确名称（必须与平台模型广场中的名称完全一致）

点击 "Add Model" 完成添加

常用模型名称示例：

💡 具体可用模型请在平台控制台的「模型广场」中查看。

验证配置：在 Cursor 的 Chat 或 Composer 面板中，点击底部的模型选择器，选择你添加的自定义模型，发送一个测试消息（例如 "你好"），如果能收到正常回复，说明配置成功。

开始使用：配置完成后，你可以在 Cursor 的各种功能（Chat、Composer、Cmd+K 等）中使用模型了。

⚠️ 重要提示：配置好自定义模型后，建议在模型列表中关闭 Cursor 内置的同名或冲突模型，以防止请求被错误地路由到官方服务。

你也可以直接编辑 Cursor 的配置文件。路径如下：

系统	路径
Windows	`%APPDATA%\Cursor\User\settings.json`
macOS	`~/Library/Application Support/Cursor/User/settings.json`
Linux	`~/.config/Cursor/User/settings.json`

添加如下配置：

{
  "cursor.openAiBaseUrl": "https://jiniu.ai/v1"
}

保存文件后重启 Cursor 即可生效。

Q：无法开启 "Override OpenAI Base URL"？
A：此功能是 Cursor Pro/Business 订阅用户的专属功能，免费版用户无法使用。

Q：添加模型后，在列表里找不到？
A：请检查输入的模型名称是否与平台提供的完全一致。可以尝试重启 Cursor 或刷新模型列表。

Q：报错 "Connection refused" 或 "404 Not Found"？
A：请检查 Base URL 是否正确，特别是末尾是否包含了 /v1 路径。正确格式：https://jiniu.ai/v1。

Q：配置成功了，但感觉用的是 Cursor 官方的模型？
A：请在模型列表中关闭 Cursor 内置的、与你添加的自定义模型同名的模型开关，避免请求被错误路由。

Q：如何获取更详细的错误信息？
A：通过 Cursor 菜单 Help → Toggle Developer Tools 打开开发者工具，在 Console 面板中查看详细错误日志。