Cursor из России: как подключить свой API-ключ

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

Что понадобится

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

И ключ от совместимого API. Дальше на примере Zukko↗, где ключ выглядит как fetch_..., а пополнение идёт картой, через СБП или криптой.

Настройка

Откройте настройки Cursor, раздел моделей, и выберите провайдера OpenAI Compatible. Дальше два поля:

Обратите внимание на суффикс /v1 — для OpenAI-совместимого режима он обязателен. Если его не поставить, Cursor будет получать 404 на каждый запрос.

После сохранения добавьте модели, которыми хотите пользоваться. Названия берутся из каталога провайдера: claude-opus-5, claude-sonnet-5, gpt-5.6-sol, qwen3.8-max-preview и другие. Актуальный список всегда можно получить запросом:

curl https://api.zukko.pro/v1/models -H "Authorization: Bearer fetch_ваш_ключ"

Сколько это стоит

Здесь всё считается иначе, чем в подписке. Вы платите за токены, а не за месяц, поэтому расход зависит от того, как вы пользуетесь редактором.

Автодополнение и короткие правки почти ничего не стоят. Дорого обходится агентский режим на большом проекте: он подгружает в контекст много файлов, и входные токены исчисляются сотнями тысяч за сессию. При цене $0.30 за миллион это десятки центов; при официальных $5 за миллион у Anthropic — уже единицы долларов.

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

Расширения VS Code

Если Cursor не нужен, те же модели подключаются к расширениям обычного VS Code:

Правило простое: Anthropic-совместимые клиенты идут без /v1, OpenAI-совместимые — с ним. Ключ во всех случаях один и тот же.

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

404 на каждый запрос. Проверьте /v1 в адресе — для Cursor он нужен.

401. Ключ скопирован с пробелом или уже отозван. Ключи показываются один раз при создании; при сомнении выпустите новый.

Модель не найдена. Название не совпадает с каталогом. Сверьтесь со списком из /v1/models — регистр и точки в номере версии имеют значение.

Всё настроено, но агент не запускается. Скорее всего, у вас trial, а не Pro.

Попробовать можно бесплатно: @zukkopro_bot↗ начисляет $1 при первом входе, и этого хватает, чтобы понять, во сколько обойдётся именно ваш стиль работы.