Cursor 配置教程

通过 CERouter API 在 Cursor 中接入第三方模型（如 Claude 系列）。

[!IMPORTANT]
Cursor 的自定义 API 功能（BYOK 模式）仅对 Pro 或更高版本的付费订阅用户开放。

安装 Cursor

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

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

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

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

向下滚动找到 OpenAI API Key 部分：

API Key：粘贴你的 CERouter API 密钥。

Override OpenAI Base URL：启用开关，填写 https://cerouter.com/v1。

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

在 Models 页面，点击 Add Custom Model。

在弹出的窗口中输入模型名称（必须与 CERouter 提供的模型标识符完全一致）：

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

点击 Add Model 完成添加。

⚠️ 注意： 建议在模型列表中关闭 Cursor 内置的同名模型，避免请求被错误路由到官方服务。

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

也可以直接编辑 Cursor 的配置文件来覆盖 OpenAI Base URL：

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

添加如下配置：

{
  "cursor.openAiBaseUrl": "https://cerouter.com/v1"
}

保存后重启 Cursor 即可生效。

问题	解决方案
无法开启 "Override OpenAI Base URL"	此功能是 Pro/Business 订阅用户的专属功能，免费版用户无法使用
添加模型后列表里找不到	检查输入的模型名称是否与 CERouter 提供的一致；尝试重启 Cursor 或刷新模型列表
报错 "Connection refused" 或 "404 Not Found"	检查 Base URL 是否正确，格式应为 `https://cerouter.com/v1`（包含 `/v1` 路径）
配置成功但感觉用的是官方模型	在模型列表中关闭 Cursor 内置的同名模型开关
如何获取详细错误信息	通过菜单 Help → Toggle Developer Tools 打开开发者工具，在 Console 面板查看网络请求的错误日志