Cursor 配置教程

需要先说明一个非常重要的前置条件：Cursor 的自定义 API 功能（即“自带密钥” BYOK 模式）仅对 Pro 或更高版本的付费订阅用户开放。如果你未订阅，将无法使用下文介绍的配置方法。

步骤 1：下载并安装 Cursor

访问 Cursor官网下载对应你操作系统（Windows/macOS/Linux）的安装包。

运行安装程序，并按照提示完成安装，过程与常规软件无异。

步骤 2：配置 API

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

在左侧导航栏中选择 “Models” 选项卡。

在“Models”页面中，向下滚动找到 “OpenAI API Key” 部分。

API Key：在此处粘贴你从服务商处获取的 API 密钥。

Override OpenAI Base URL：点击开关启用，并在下方输入框中填写 API 基础地址 https://www.aiide.com/v1。

步骤 3：添加自定义模型

配置好 API 密钥和地址后，你需要手动告诉 Cursor 你想使用哪些模型。

在“Models”页面，找到 “Add Custom Model” 按钮并点击。

在弹出的窗口中，输入模型的准确名称。这个名称必须与你的 API 服务商提供的模型标识符完全一致（例如 aiide-cs-4.5）。

（可选）为该模型设置一个别名（Alias），方便你在 Cursor 的模型列表中识别。

点击“Add Model”完成添加。

claude模型	映射模型名称
claude-opus-4-6	aiide-co-4.6
claude-opus-4-5	aiide-co-4.5
claude-sonnet-4-6	aiide-cs-4.6
claude-sonnet-4-5	aiide-cs-4.5
claude-haiku-4-5	aiide-ch-4.5

如果你要用“claude-opus-4-6”的模型，自定义模型名称要填“aiide-co-4.6”。 Base url填https://www.aiide.com/v1 比如

步骤 4：验证配置并开始使用

验证配置：在 Cursor 的聊天（Chat）或编辑器（Composer）面板中，点击底部的模型选择器，你应该能看到刚刚添加的自定义模型。选择它，然后发送一个简单的测试消息（例如“你好”），如果能收到正常回复，说明配置成功。

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

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

可选：使用 `settings.json` 配置文件

你也可以直接编辑 Cursor 的配置文件来管理 API 设置。该文件路径为：

Windows: %APPDATA%\Cursor\User\settings.json

macOS: ~/Library/Application Support/Cursor/User/settings.json

Linux: ~/.config/Cursor/User/settings.json

你可以在其中添加如下配置来覆盖 OpenAI 的 Base URL：

{
  "cursor.openAiBaseUrl": "https://www.aiide.com/v1"
}

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

常见问题

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

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

Q: 报错 “Connection refused” 或 “404 Not Found”？
A: 请检查你填写的 Base URL 是否正确，特别是末尾是否包含了 /v1 路径。例如，正确的格式应为 https://www.aiide.com/v1。

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

Q: 如何获取更详细的错误信息？
A: 你可以通过 Cursor 的菜单 Help -> Toggle Developer Tools 打开开发者工具，在 Console 面板中查看网络请求的详细错误日志。

Cursor 配置

Cursor 配置教程#

步骤 1：下载并安装 Cursor#

步骤 2：配置 API#

步骤 3：添加自定义模型#

步骤 4：验证配置并开始使用#

可选：使用 settings.json 配置文件#