Использование ключа в Cursor
Переопределите OpenAI Base URL, добавьте свои модели и узнайте, какие функции Cursor работают через собственный бэкенд.
Cursor поддерживает использование собственного ключа (BYOK): укажите совместимый с OpenAI базовый URL и ваш ключ OLETOKEN — и запросы из Chat будут списываться с вашего баланса OLETOKEN.
Перед началом
- Вы создали API-ключ и сохранили полный ключ.
- У вас есть ID модели из каталога моделей.
- Ваша сборка Cursor поддерживает пользовательские модели (в Settings → Models есть кнопка «Add Model»).
Настройка
-
Откройте настройки:
⌘⇧J(macOS) /Ctrl⇧J(Windows, Linux) или⌘⇧P→Cursor Settings. -
Перейдите в Models → Model Names → + Add Model, введите нужный ID модели и нажмите Enter.
-
На той же странице в разделе API Keys → OpenAI API Key нажмите + и вставьте ваш ключ OLETOKEN.
-
Включите Override OpenAI Base URL и введите совместимый с OpenAI адрес, включая
/v1:https://<your-base-url>/v1Cursor добавляет к нему
/chat/completions, поэтому/v1обязателен. -
Нажмите Verify. Для названий моделей, не принадлежащих самой OpenAI, проверка может не пройти — это ложная тревога; вместо этого отправьте сообщение в Chat для проверки.
-
Вернувшись в редактор, нажмите
⌘L/Ctrl+L, чтобы открыть Chat, и выберите свою модель в выпадающем списке моделей.
Полезно знать
- Покрываются только Chat и Plan. Composer, автодополнение по Tab и Inline Edit по-прежнему работают на собственном бэкенде Cursor и не расходуют ваш баланс OLETOKEN.
- Ваши встроенные модели Anthropic могут быть затронуты. При включённом Override OpenAI Base URL встроенные модели Claude в Cursor тоже могут направляться на этот сайт. Если вам всё же нужны официальные, добавьте ID моделей Claude как пользовательские через + Add Model и выбирайте их в выпадающем списке.
- Чтобы вернуть как было: отключите Override OpenAI Base URL. Записи ключа и моделей можно оставить.
- В Cursor также можно установить расширение Claude Code (Cursor принимает магазин расширений VS Code) — см. использование VS Code. Этот путь работает по протоколу Anthropic Messages и не ограничен Chat / Plan.
Решение проблем
| Симптом | Причина и решение |
|---|---|
| Проверка Verify не проходит | Ложная тревога для названий моделей не от OpenAI — проверьте в Chat |
| 401 | Ключ вставлен неполностью или отключён; скопируйте его заново |
| 404 | В Override OpenAI Base URL отсутствует /v1 |
| Новая модель отсутствует в Chat | ID модели написан с ошибкой или вы не переключились на неё в выпадающем списке моделей Chat |
| Insufficient balance | Сначала пополните счёт |

