Cursor не видит модели после смены base URL

Cursor подключается к стороннему API через раздел настроек с ключом OpenAI. Настройка простая, но у неё есть несколько неочевидных мест, на которых спотыкаются почти все.

Адрес должен быть с /v1

Cursor работает через OpenAI SDK, а тот считает базой уже версионированный префикс. Правильно:

Без /v1 запросы уйдут в корень, и вы получите 404. Это причина номер один, проверьте первым делом.

Кнопку проверки нужно нажать

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

Порядок такой: вставить ключ, вставить адрес, нажать проверку, дождаться зелёного результата, только потом закрывать окно.

Имена моделей нужно добавить вручную

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

Добавьте нужные имена в список моделей вручную, ровно как они называются в каталоге. Посмотреть точные идентификаторы можно так:

curl -s https://api.zukko.pro/v1/models

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

Не все режимы Cursor ходят через ваш ключ

Это ограничение самого редактора, а не шлюза. Обычный чат и правки в редакторе идут через указанный вами API. Часть фирменных возможностей — автодополнение на лету, некоторые агентные режимы — работает через инфраструктуру Cursor и вашим ключом не пользуется.

Отсюда типичная жалоба «в истории расходов пусто, хотя я весь день работаю»: расходуется то, что действительно проходит через шлюз, а не всё подряд.

Проверка, что всё сошлось

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