# Cursor 接入指南

Cursor 是一款 AI 编程 IDE。本文介绍如何让它通过 UModelverse 平台调用模型。

## **系统要求**

| 平台 | 要求 |
| --- | --- |
| Windows | Windows 10 或 Windows 11 |
| macOS | macOS 10.15 (Catalina) 或更高版本 |
| Linux | 主流发行版（Ubuntu、Debian 等） |

所有平台均需要网络连接，且需要 **Cursor Pro 及以上套餐**（免费版仅支持 Auto 模式，无法调用自定义模型）。

## **1. 安装 Cursor**

前往 [Cursor 官网](https://cursor.com/) 下载并安装对应平台的客户端。

## **2. 配置 UModelverse API**

### 2.1 获取 API Key

访问 [UModelverse 控制台](https://console.ucloud.cn/modelverse/api) 获取您的 API 密钥。可用模型见 UModelverse 平台[支持的模型](https://api.modelverse.cn/v1/models)。

### 2.2 在 Cursor 中填写配置

1.  点击右上角设置图标，进入 **Cursor Settings** → **Models**。
    
2.  打开 **OpenAI API Key** 和 **Override OpenAI Base URL** 两个开关，按下表填写：
    

| 项目 | 填写值 |
| --- | --- |
| OpenAI API Key | 您的 UModelverse [API Key](https://console.ucloud.cn/modelverse/api) |
| Override OpenAI Base URL | `https://api.modelverse.cn/v1` |
| 模型 | 添加 UModelverse 平台[支持的模型](https://api.modelverse.cn/v1/models)，例如 `gpt-5.2`、`claude-sonnet-4-6` |

3.  在模型列表中添加需要的模型名称，保存后即可使用。
    

## **3. 使用模型**

在聊天面板中先点击并关闭 **Auto** 模式，再从模型下拉栏选择刚添加的模型即可开始对话。

## **常见问题**

### 提示 "The model xxx does not work with your current plan or api key." 或只能使用 Auto？

Cursor 免费版只支持 Auto 模式，无法调用自定义模型。请升级到 **Cursor Pro 及以上套餐**后再使用。

### 配置完成后在对话里找不到添加的模型？

在聊天面板中关闭 **Auto** 模式，然后在模型下拉栏手动选择所需模型。

### 报错 "We're having trouble connecting to the model provider." 或 "Unauthorized User API key"？

请逐项排查：

-   确认 API Key 来自 UModelverse 平台、复制完整且无空格。
    
-   确认 Override OpenAI Base URL 为 `https://api.modelverse.cn/v1`。
    
-   确认填写的模型名称是 UModelverse 平台[支持的模型](https://api.modelverse.cn/v1/models)之一。若某个模型名与 Cursor 内置模型重名导致冲突，可改用不含小数点的写法（如把 `kimi-k2.6` 写成 `kimi-k2-6`）。