Cursor API Key: свой адрес, модели и ограничения
Cursor подключается через поле Override OpenAI Base URL и протокол OpenAI Chat. Чат на своей модели работает, в Agent mode на чужом адресе бывают ошибки, а Tab остаётся на моделях Cursor. Официальная страница про собственные ключи это поле не описывает: порядок настройки сверен с ответами сотрудников Cursor на форуме.
- Тип: Редактор и IDE
- Протокол: OpenAI Chat Completions
- Статус: Частично
Что заработает
| Возможность | Отметка | Примечание |
|---|---|---|
| Чат | Да | |
| Вызов инструментов | Частично | В Agent mode на своём адресе бывают ошибки: начинайте с режима Ask. |
| Автодополнение | Нет | Tab остаётся на моделях Cursor. |
Настройка
Понадобятся ключ из раздела «Ключи» кабинета и идентификатор модели. В примерах подставлена модель gpt-5.6-luna; для протокола Anthropic Messages подставлена claude-haiku-5-5. Свою модель выбирайте в каталоге.
- Откройте Cursor Settings, раздел Models.
- Вставьте ключ в поле OpenAI API Key и сохраните его. Включите Override OpenAI Base URL и введите
https://, адрес сrelay-llm.ru/ v1 /.v1 - Добавьте свою модель: введите в поле поиска моделей идентификатор из каталога, в примере
gpt-5.6-luna, и нажмите Enter. Включите добавленную модель. - Откройте чат в режиме Ask и выберите добавленную модель. В Agent mode на своём адресе бывают ошибки, поэтому начните с Ask.
Поля в Cursor Settings, Models
OpenAI API Key: YOUR_API_KEY
Override OpenAI Base URL: https://relay-llm.ru/v1
Model (add and enable): gpt-5.6-lunaПроверка
Сначала проверьте ключ и адрес без клиента. В ответе должно быть is_active: true.
macOS и Linux
curl https://relay-llm.ru/v1/key \
-H "Authorization: Bearer $RELAY_API_KEY"Windows PowerShell
curl.exe https://relay-llm.ru/v1/key `
-H "Authorization: Bearer $env:RELAY_API_KEY"Windows cmd
curl https://relay-llm.ru/v1/key ^
-H "Authorization: Bearer %RELAY_API_KEY%"Затем проверьте сам клиент.
Откройте чат в режиме Ask, выберите добавленную модель и отправьте «ping». Ответ пришёл, запрос появится в журнале запросов кабинета: адрес и ключ верны.
Запрос из клиента появится в журнале запросов кабинета с моделью, токенами и стоимостью.
Ограничения протоколов
OpenAI Chat Completions
Работают чат-модели каталога по пути /. Не поддерживаются /, /, /, /, Assistants и Realtime: функции клиента, которым они нужны, не заработают.
Ловушки
- Запросы с вашим ключом идут через серверы Cursor, а не с вашего компьютера: Cursor сам собирает итоговый промпт. Адрес должен быть доступен из интернета, localhost и частные адреса не подойдут. Адрес шлюза публичный, для него это не помеха.
- Собственные ключи работают только с чат-моделями. Tab (автодополнение) остаётся на встроенных моделях Cursor, это сказано на официальной странице про ключи.
- В Agent mode на форуме Cursor описаны две ошибки. Тело в формате Responses уходит на путь
/: в апреле 2026 сотрудник назвал это известной ошибкой без срока исправления. И сообщение «model is required»: в июле 2026 сотрудник написал, что оно должно быть исправлено. Начните с режима Ask.chat/ completions - Ключ и адрес OpenAI действуют на все модели, кроме Claude и Gemini, включая Composer и Grok. Эти модели работают на инфраструктуре Cursor и с чужим ключом отклоняются. Для них отключайте ключ OpenAI в Cursor Settings, Models. Так ответил сотрудник Cursor на форуме в сентябре 2026 года.
- Политика Zero Data Retention у Cursor при собственных ключах не действует. Условия хранения запросов определяет выбранный провайдер.
- Для настройки по этой инструкции используйте
https://. Не добавляйте путьrelay-llm.ru/ v1 /. При ошибке 404 сначала сверьте адрес с этим значением.chat/ completions
Типичные ошибки
| Что вы видите | Почему так | Что сделать |
|---|---|---|
Ответ 404, в тексте Unknown path (код not_found). | В Override OpenAI Base URL нет / или в конце стоит лишний путь, например /. | Впишите ровно https://, без пути метода и без слэша в конце. |
| Ответ 401, в тексте Invalid API key. | В OpenAI API Key вставлен неверный или отозванный ключ, либо ключ другого сервиса. | Создайте новый ключ в разделе «Ключи» кабинета и вставьте его заново. Ключ показывается один раз, при создании. |
Ответ 404, модель не найдена (код model_not_found). | Имя добавленной модели не совпадает с идентификатором из каталога. | Скопируйте идентификатор из каталога моделей, добавьте модель заново и включите её. |
| Встроенные модели Cursor, например Composer или Grok, отвечают ошибкой с текстом вроде This model does not support custom API keys. | Ключ OpenAI и адрес включены и действуют на все модели, кроме Claude и Gemini. Модели Cursor свой адрес не принимают. | Отключите ключ OpenAI в Cursor Settings, Models, пока работаете со встроенной моделью, и включите снова для своей. |
| В Agent mode запрос завершается ошибкой 400. | Cursor может отправить тело в формате Responses на путь /, и модель такой запрос отклоняет. | Работайте в режиме Ask. Агентные задачи ведите в клиенте, где свой адрес поддерживается официально, например в Cline. |
Вопросы и ответы
Работает ли Tab?
Нет. Tab остаётся на встроенных моделях Cursor, чужой адрес на него не действует.
Можно ли подключить модели Claude или Gemini через шлюз?
Не через это поле. Ключ и адрес OpenAI на модели Claude и Gemini не действуют: у них в Cursor отдельные поля ключей. Для Claude через шлюз возьмите Claude Code или Cline.
Как вернуться к встроенным моделям Cursor?
Выключите переключатель Override OpenAI Base URL и отключите ключ OpenAI в Cursor Settings, Models. Пока они включены, запросы остальных моделей идут на ваш адрес.
Можно ли указать адрес из локальной сети?
Нет. Запросы идут с серверов Cursor, поэтому адрес должен быть доступен из интернета. Адрес шлюза публичный.
Где смотреть расход?
В журнале запросов кабинета: там видны модель, токены и стоимость каждого запроса.
Ссылки
Официальная документация: Cursor API Key: свой адрес, модели и ограничения
Скачайте Cursor с сайта производителя
Форум Cursor: тело Responses уходит на /chat/completions (апрель 2026)
Форум Cursor: ошибка «model is required» в Agent mode (июль 2026)
Форум Cursor: модели Cursor и свой адрес OpenAI (август и сентябрь 2026)
Подключение клиентов: общие сведения и все клиенты