Cursor

Cursor 是 AI 原生代码编辑器。通过自定义 OpenAI 兼容端点接入 LimAPI。

安装

• macOS：brew install --cask cursor 或从 官网 下载
• Windows：winget install -e --id Cursor.Cursor 或从官网下载

配置接入凭证

在 Cursor 中，点击设置图标，进入 Cursor Settings → Models，开启 OpenAI API Key 和 Override OpenAI Base URL，填入以下配置：

配置项	填写内容
API Key	Portal 创建的 LimAPI API Key（sk- 开头）
Base URL	https://limapi.com/api/v1
可用模型	点击 Verify 校验连通性，或在模型列表中手动添加模型 ID（如 qwen3.8-max），完整列表通过 GET /api/v1/models 查询或在 Portal 模型广场查看

验证配置

在聊天面板关闭 Auto 模式，在模型下拉栏选择刚添加的模型，发送一条消息，正常回复即配置成功。

常见问题

在 Cursor 中无法调用已添加的模型

报错信息如下：

• The model xxx does not work with your current plan or api key.
• Named models unavailable Free plans can only use Auto. Switch to Auto or upgrade plans to continue.

原因：Cursor 免费版仅支持 Auto 模式，不支持调用自定义模型。

解决方案：请升级至 Cursor Pro 及以上套餐。

配置完成后找不到添加的模型

请在聊天面板点击并关闭 Auto 模式，在模型下拉栏选择所需模型。

调用模型报错 "We're having trouble connecting to the model provider." 或 "Unauthorized User API key"

请逐项排查：

• 检查 API Key、Base URL 和模型名称是否填写正确，Base URL 为 https://limapi.com/api/v1，末尾 /v1 不可省略；
• 确认 API Key 复制完整、无首尾空格，且在 Portal 状态正常。