---
title: Cursor
description: Свой ключ и переопределённый base URL в настройках моделей Cursor — и чат редактора ходит через шлюз. Плюс честный список того, что через него не ходит.
keywords: cursor, редактор, openai base url, api keys, custom model, настройки
group: integrations
---

## Быстро {#quick keywords="settings, models, api keys, base url"}

Cursor настраивается не файлом, а экраном: **Settings → Models → API Keys**. Три поля, все на одном экране.

```bash title=Cursor
# Cursor → Settings → Models → API Keys
api_key  = "$KUMO_API_KEY"     # OpenAI API Key
base_url = "https://api.kumorouter.com/v1"    # Override OpenAI Base URL
model    = "<model>"         # Add custom model
```

:::steps
- **Включите свой ключ OpenAI** — Вставьте в поле ключа ключ Kumo.
- **Переопределите base URL** — Включите «Override OpenAI Base URL» и впишите `https://api.kumorouter.com/v1`.
- **Добавьте модель** — В поле добавления модели впишите идентификатор из каталога.
- **Нажмите Verify** — Cursor сам сходит на шлюз и скажет, принят ли ключ.
:::

Экран у разных выпусков Cursor называется по-разному — Models или Providers. Ищите пару «OpenAI API Key» и «Override OpenAI Base URL»: она и есть точка подключения.

## Модели {#models keywords="add model, встроенные модели, каталог"}

Cursor не знает каталога Kumo и не покажет его сам. Модели добавляются вручную: по одному идентификатору на строку, каноническое имя или псевдоним из [каталога](/ru/models).

Встроенные модели Cursor при этом никуда не деваются. Выключите те из них, которые не должны уходить на собственный бэкенд редактора, — иначе выбор модели в чате решает, куда пойдёт запрос, а вы этого не заметите.

:::warning
Через шлюз ходит только то, что идёт по пути «свой ключ OpenAI»: чат с выбранной вами моделью. Собственные функции Cursor — автодополнение Tab и агентские возможности, которые работают на серверах редактора, — на ваш ключ не переключаются и через Kumo не проходят.
:::

## Проверка {#verify keywords="verify, curl, журнал"}

Проверьте шлюз до того, как трогать редактор: тогда красная кнопка Verify будет означать настройку Cursor, а не ключ. В поле Cursor ключ вставляется целиком, а команда ниже читает его из переменной оболочки: экспортируйте ключ один раз в том терминале, из которого проверяете.

```bash title=Проверка
export KUMO_API_KEY="kumo_sk_..."

curl https://api.kumorouter.com/v1/chat/completions \
  -H "Authorization: Bearer $KUMO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<model>",
    "max_tokens": 64,
    "messages": [{ "role": "user", "content": "reply with OK" }]
  }'
```

Дальше задайте один вопрос в чате Cursor, выбрав добавленную модель, и найдите этот вызов в журнале консоли.

## Если не работает {#troubleshooting keywords="verify, 401, 404, модель"}

- **Verify не проходит** — ключ или адрес. Сначала повторите curl выше: он отвечает — значит дело в полях Cursor.
- **404** — в base URL нет `/v1` или добавлен лишний путь. Адрес заканчивается ровно на `/v1`.
- **Модель не найдена** — идентификатор не из каталога либо не добавлен в список моделей Cursor.
- **Запрос не виден в журнале** — в чате выбрана встроенная модель Cursor, а не добавленная вами.

> [Как называется модель →](/ru/models) [Все статусы шлюза →](/ru/errors)

:::cards
- [Расширения VS Code](/ru/vscode-extensions) — Cline, Roo Code, Continue.
- [Все рецепты](/ru/integrations) — обзор и промпт для агента.
- [Расход и журнал](/ru/usage) — где видно вызовы.
:::