Source: https://wiki.niceai.dev/guide/clients/cursor

# Cursor 接入自定义 API

在 Cursor 的 **Settings → Models → API Keys** 中填入 NiceAI 密钥，打开 **Override OpenAI Base URL** 并填写 `https://api.niceai.dev/v1`，Cursor 本地的 Chat 和 Agent 就会通过 NiceAI 调用模型。

## 准备工作

在 NiceAI 控制台「[API 密钥](https://niceai.dev/keys)」页面创建密钥，分组选择 **OpenAI**。

## 配置步骤

1. 打开 Cursor 设置（macOS 按 `Cmd+Shift+J`，Windows / Linux 按 `Ctrl+Shift+J`），进入 **Models**，展开 **API Keys**。
2. 在 **OpenAI API Key** 中粘贴 NiceAI 密钥，并打开 **Use OpenAI API Key**。
3. 打开 **Override OpenAI Base URL**，填写：

   ```text
   https://api.niceai.dev/v1
   ```

4. 在模型列表中启用要用的模型；列表里没有的，点击添加模型，输入 [模型广场](https://niceai.dev/model-plaza) 中的模型名。
5. 在 Chat 或 Agent 的模型选择器中选中该模型，发一句话测试。

**地址要带 /v1**
Cursor 会在 Base URL 后面拼接 `/chat/completions`。不要填 `https://api.niceai.dev`（缺 `/v1`），也不要填到 `/chat/completions`。


## 适用范围

根据 Cursor 官方说明，自带密钥（BYOK）只用于本地的 Chat 和 Agent 请求，**不**作用于 Tab 补全、Auto 模型选择、云端 / 后台 Agent、Cursor CLI 等功能，这些仍使用 Cursor 自己的模型。另外，使用自定义 Base URL 时，请求会先经过 Cursor 的服务器再转发到你填写的地址。

## 常见问题

### 提示找不到资源（404）？

检查 Base URL 是否正好以 `/v1` 结尾，后面没有多余路径。详见 [接口地址要不要加 /v1](https://wiki.niceai.dev/guide/v1-404)。

### 提示密钥无效？

确认密钥复制完整、处于启用状态，并且已打开 **Use OpenAI API Key**。

### 想在 Cursor 里用 Claude 等非 OpenAI 模型？

Cursor 的 Override 只走 OpenAI 格式（Chat Completions）。如果你的密钥分组支持通过 Chat Completions 调用该模型，可以在模型列表里手动添加模型名；能否使用以控制台分组说明和 [模型广场](https://niceai.dev/model-plaza) 为准。

## 下一步

- [Cline 接入](https://wiki.niceai.dev/guide/clients/cline)
- [常见错误码对照](https://wiki.niceai.dev/guide/error-codes)
