# Cursor

来源: https://docs.aicentos.com/clients/cursor

Language: zh-CN

> 在 Cursor 中使用 aicentos —— 通过自定义 OpenAI 兼容设置接入

Cursor 支持自定义 OpenAI 兼容的 API，把 Base URL 指向 aicentos、填入 API Key，即可在 Chat / Composer 中使用 aicentos 接入的模型。

## 准备工作

先在控制台「API Key」页面为 Cursor 创建一个专用 Key（建议命名 `cursor-desktop` 或 `cursor-work`，方便追踪用量）。

## 需要填写的配置

| 字段       | 值                         |
| -------- | ------------------------- |
| API Key  | 控制台创建的 Key                |
| Base URL | `https://aicentos.com/v1` |
| 模型       | 控制台「模型广场」中的模型名            |

## 配置步骤

* 打开 Cursor 设置（Settings）。
* 进入 **Models** 或 **API Keys** 区域。
* 找到 **OpenAI API Key** / 自定义 OpenAI 兼容设置 / **Base URL** 覆盖选项。
* 填入你在 aicentos 控制台创建的 API Key。
* 把 Base URL 设为：`https://aicentos.com/v1`
* 如需手动添加模型，填入控制台中的模型名（参考 [支持的模型](https://docs.aicentos.com/billing/models-list)）。
* 保存并点击 **Verify**，或直接新建一个对话测试。

## 测试

保存后，先用一句简单提示词轻量测试一下，确认通了再正式使用 Composer / Chat。

## 注意事项

* 自定义 API Key 通常只对标准对话模型生效。
* **Tab 补全**和部分 **Agent** 能力可能仍走 Cursor 自带服务。
* Verify 失败时，检查：Base URL 是否正确（只填到 `/v1`）、Key 是否有多余空格、模型是否可用、账户余额是否充足、是否已选中自定义 OpenAI Provider。