Cursor

仅 Cursor Pro 及以上订阅用户可使用自带 API Key（BYOK）配置自定义模型和自定义 Base URL，免费版会报错。

安装 Cursor

前往 Cursor 官网 下载并安装。

配置 CoffeeRouter

打开设置

在 Cursor 中点击设置图标（右上角齿轮） → Cursor Settings → Models 页面。

配置 API Key 和 Base URL

1. 启用 OpenAI API Key 并输入您的 CoffeeRouter 令牌（API Key）。
2. 启用 Override OpenAI Base URL 并输入：

   https://www.coffeerouter.ai/v1
   

添加模型

在 Add or search model 输入框中搜索需要使用的模型名称（例如 gpt-4o）。如果 Cursor 已内置同名模型，直接启用并选择它；只有列表中不存在该模型 ID 时，才单击 Add Custom Model 添加。

注意： OpenAI Base URL 覆盖仅适用于 Cursor 识别为 OpenAI 系列的聊天模型。Cursor Tab 等专有功能仍会使用 Cursor 内置模型。

开始使用

在聊天面板选择对应模型即可使用。

💡 配置效果图

以下是配置完成后的参考截图：

常见问题

报错 The model xxx does not work with your current plan or api key.

该错误表示当前套餐或 API Key、模型配置无法使用该模型。请先确认 Cursor 账号已升级至 Pro 或以上；如果已经订阅 Pro，请继续检查 API Key、Base URL 与模型 ID 是否正确，并优先使用 Cursor 支持的 OpenAI 聊天模型。