Cursor

Быстро

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

# 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

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

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

Модели

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

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

Проверка

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

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, выбрав добавленную модель, и найдите этот вызов в журнале консоли.

Если не работает

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

Как называется модель → Все статусы шлюза →