> ## 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

> Как подключить AI-редактор Cursor к RuAPI через переопределение OpenAI Base URL — свой ключ, без подписки

[Cursor](https://cursor.com) — редактор кода с ИИ на базе VS Code. Чат и инлайн-правки можно направить на RuAPI, переопределив **OpenAI Base URL** — модели Claude, GPT, Gemini и другие подставляются по своим ID.

<Note>
  Переопределение базового адреса влияет на **чат и инлайн-команды**. Фирменные функции Cursor (Tab-автодополнение, агентный Composer) завязаны на собственные модели Cursor и через сторонний эндпоинт могут не работать — это ожидаемо.
</Note>

## Предварительные требования

<Steps>
  <Step title="Аккаунт RuAPI и API-ключ">
    Консоль → **Токены** → создайте ключ `sk-...`. Баланс пополняется в USDT — см. [Пополнение](/ru/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 включён и адрес — `https://www.ruapi.ai/v1` с `/v1`.
    * Уберите лишние пробелы при вставке.
  </Accordion>

  <Accordion title="Модель не найдена">
    ID модели должен совпадать с RuAPI дословно. Точные имена — на [странице цен](https://www.ruapi.ai/pricing).
  </Accordion>

  <Accordion title="Tab и Composer не работают на моих моделях">
    Это нормально: эти функции используют собственные модели Cursor. Через сторонний Base URL надёжно работают чат и инлайн-правки.
  </Accordion>
</AccordionGroup>