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

# Cursor

> 如何通过覆盖 OpenAI Base URL 把 AI 代码编辑器 Cursor 接到 RuAPI——用自己的密钥,无需订阅

[Cursor](https://cursor.com) 是基于 VS Code 的 AI 代码编辑器。覆盖 **OpenAI Base URL** 就能把它的聊天和行内改写指向 RuAPI —— Claude、GPT、Gemini 等模型按各自 ID 接入。

<Note>
  覆盖 base URL 影响的是**聊天和行内命令**。Cursor 的招牌功能(Tab 补全、智能体 Composer)依赖 Cursor 自家模型,走第三方端点可能不工作 —— 这是预期内的。
</Note>

## 前置

<Steps>
  <Step title="RuAPI 账号和密钥">
    控制台 →\*\*「令牌」\*\*→ 创建 `sk-...` 密钥。余额用 USDT 充 —— 见[充值](/zh/topup)。
  </Step>
</Steps>

## 配置

<Steps>
  <Step title="打开模型设置">
    **Cursor Settings**(右上角齿轮,或 `Cmd/Ctrl + Shift + J`)→ **Models** 区。
  </Step>

  <Step title="填密钥和地址">
    | 字段                           | 值                                         |
    | ---------------------------- | ----------------------------------------- |
    | **OpenAI API Key**           | `sk-你的密钥`                                 |
    | **Override OpenAI Base URL** | `https://www.ruapi.ai/v1`  —— **带** `/v1` |

    打开 **Override OpenAI Base URL** 开关,粘贴地址。
  </Step>

  <Step title="添加模型">
    在模型列表里关掉默认模型,点 **+ Add model** —— 填入精确模型 ID(来自[价格页](https://www.ruapi.ai/pricing))。ID 要一字不差。
  </Step>

  <Step title="验证密钥">
    点 **Verify**(或保存)。通过即可使用。
  </Step>
</Steps>

## 第一个请求

打开聊天(`Cmd/Ctrl + L`),顶部选你加的模型,发:

```
解释这个文件是做什么的。
```

有回复 + RuAPI 控制台 →\*\*「日志」\*\*有记录 = 正常。

## 出问题时

<AccordionGroup>
  <Accordion title="Verify 不过 / 401">
    * 密钥得是 RuAPI 令牌(`sk-...`),不是 OpenAI 密钥。
    * 确认 Override Base URL 开关已开、地址是带 `/v1` 的 `https://www.ruapi.ai/v1`。
    * 粘贴时去掉多余空格。
  </Accordion>

  <Accordion title="找不到模型">
    模型 ID 要和 RuAPI 一字不差。精确名称见[价格页](https://www.ruapi.ai/pricing)。
  </Accordion>

  <Accordion title="Tab 和 Composer 用不了我的模型">
    正常:这些功能用 Cursor 自家模型。走第三方 Base URL 时,聊天和行内改写稳定可用。
  </Accordion>
</AccordionGroup>