> ## Documentation Index
> Fetch the complete documentation index at: https://docs.openp.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Cursor

> 在 Cursor 中使用 OpenPAI 作为模型供应商

[Cursor](https://cursor.com/) 支持配置自定义的 OpenAI 兼容 API,从而把内置 AI 流量切到 OpenPAI。

## 配置步骤

<Steps>
  <Step title="打开设置">
    `Cmd/Ctrl + ,` → 进入 **Cursor Settings** → **Models**(模型)选项卡。
  </Step>

  <Step title="启用 Override OpenAI Base URL">
    在 **OpenAI API Key** 区域:

    * 勾选 **Override OpenAI Base URL**。
    * **Base URL**:`https://openp.ai/v1`
    * **API Key**:粘贴 OpenPAI 颁发的 `sk-` 密钥
  </Step>

  <Step title="启用所需模型">
    在 **Models** 列表中勾选你想用的模型(如 `gpt-5.5`、`gpt-5.4-mini`、`o3-mini`)。
    若需要自定义模型 ID,点击 **+ Add model**,填入 OpenPAI 控制台展示的 ID,如:

    * `claude-opus-4-8`
    * `gemini-3.1-pro-preview`
    * `deepseek-v3`
  </Step>

  <Step title="点击 Verify">
    Cursor 会发起一次 `/v1/chat/completions` 验证密钥可用,通过后即可在编辑器中使用。
  </Step>
</Steps>

## 限制说明

<Warning>
  Cursor 部分内置功能(Cursor Tab、Agent、Composer 的特定能力)依赖官方训练的私有模型,
  **勾选 Override Base URL 后这些功能可能不可用**(Cursor 会回退到聊天 / 内联生成能力)。
</Warning>

Override 后能继续工作的功能包括:

* ✅ Chat (`Cmd+L`)
* ✅ Inline Edit (`Cmd+K`)
* ✅ 自定义 Tools(MCP)
* ⚠️ Composer / Agent —— 部分回退
* ❌ Cursor Tab —— 不可用

如果对 Cursor Tab 有依赖,推荐:**Cursor 官方订阅 + OpenPAI 高级模型** 组合使用。

## 在 Composer / Agent 中调用 OpenPAI

即使官方 Agent 不支持自定义 base url,你也可以通过 **MCP 工具** 让 Agent 调用 OpenPAI:

```json theme={null}
{
  "mcpServers": {
    "openpai-search": {
      "command": "npx",
      "args": ["-y", "@openpai/mcp-server"],
      "env": { "OPENPAI_API_KEY": "sk-XXXXXXXXXXXXXXXX" }
    }
  }
}
```

## 注意

* API Key 与 Base URL 仅保存在本地,不会上传 Cursor 服务器。
* 修改配置后建议重启 Cursor 以确保新 base url 全面生效。