Cursor в России: подключение и настройка без VPN

Cursor в России ставится и запускается — упирается всё не в сам редактор, а в доступ к моделям: подписку не оплатить российской картой, а без оплаченного доступа агент в IDE молчит. Обходной путь не требует ни VPN, ни зарубежного счёта: Cursor остаётся вашим редактором, а агент внутри него — Claude Code или Codex — ходит за моделью через сторонний ключ с рублёвой оплатой. Быстрее всего это делается через AI для кода от PurpleSchool: один ключ, общий баланс токенов, оплата в рублях. Ниже — обе официальные схемы подключения, разбор того, что ломается чаще всего, и тарифы.

Почему Cursor не работает в России напрямую

Cursor — это редактор кода со встроенным AI-агентом: он видит проект целиком, правит файлы, гоняет команды и держит контекст между запросами. Сам редактор — обычное десктопное приложение, оно скачивается и открывается без фокусов.

Проблема начинается на следующем шаге. Агентная часть Cursor живёт не на вашей машине: каждый запрос уходит на сервер, там работает модель, ответ возвращается в IDE. За этот трафик надо платить, а оплата привязана к зарубежным платёжным системам. Карта российского банка не проходит, виртуальные карты регулярно отклоняются — ровно тот же сюжет, что мы разбирали в статье про оплату OpenAI из России.

Отдельно стоит разобраться с формулировкой «Cursor заблокировали». В запросах она встречается часто, но за ней обычно стоит не бан аккаунта, а одно из двух: не прошла оплата или редактор перестал получать ответы от моделей. Это важная разница, потому что лечится это не сменой аккаунта, а сменой того, откуда IDE берёт модель.

И здесь у Cursor есть встроенная лазейка, которой мы и воспользуемся. Cursor совместим с расширениями для VS Code, а два самых серьёзных агента для кода — Claude Code от Anthropic и Codex от OpenAI — существуют именно в виде таких расширений. Оба умеют ходить не в родное облако, а по произвольному совместимому адресу. Вы остаётесь в привычном редакторе, а агент внутри него получает доступ через ключ, который оплачивается в рублях.

Сразу оговорюсь, чтобы не было завышенных ожиданий: этот способ даёт вам полноценного агента внутри Cursor, но не оживляет собственную подписку Cursor Pro. Автодополнение и встроенный чат самого Cursor по-прежнему требуют его родной оплаты. На практике это мало кого расстраивает — Claude Code и Codex в агентном режиме закрывают те же задачи, а часто и шире.

Способ: Cursor через AI для кода от PurpleSchool

AI для кода от PurpleSchool — это доступ сразу к двум экосистемам по одному ключу. Модели Claude (Haiku, Sonnet, Opus) работают через Anthropic-совместимый эндпоинт, модели GPT — через OpenAI-совместимый. Баланс токенов общий, оплата российской картой, зарубежный банк и VPN не нужны.

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

• Anthropic-путь — расширение Claude Code в Cursor, настройка правится в settings.json.
• OpenAI-путь — Codex CLI плюс расширение Codex в Cursor, настройка лежит в ~/.codex/config.toml.

Если возиться с конфигами не хочется, на сайте есть команда, которая прописывает всё автоматически:

npx @purpleschool/ai-for-code

Ручную настройку всё равно советую прочитать: понимая, какие файлы правятся, вы почините конфиг, когда что-то пойдёт не так. А пойдёт — обязательно, обычно на переменных окружения.

Anthropic-путь: Claude Code внутри Cursor

Этот вариант короче: отдельный CLI ставить не нужно, всё делается в интерфейсе редактора.

Откройте в Cursor вкладку Extensions, найдите и установите расширение Claude Code. После установки зайдите в само расширение, нажмите значок настроек и выберите Settings, а на экране настроек — Edit in settings.json.

В открывшийся JSON-объект вставьте блок:

"claudeCode.environmentVariables": [
  {
    "name": "ANTHROPIC_BASE_URL",
    "value": "https://app.purpleschool.ru/api-v2/public/ai-proxy/anthropic"
  },
  {
    "name": "ANTHROPIC_API_KEY",
    "value": "ваш ключ"
  },
  {
    "name": "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY",
    "value": "1"
  }
],
"claudeCode.disableLoginPrompt": true

Что здесь происходит. ANTHROPIC_BASE_URL — адрес, по которому расширение ищет API; вместо серверов Anthropic оно пойдёт на прокси PurpleSchool. ANTHROPIC_API_KEY — ваш ключ из личного кабинета, подставьте его вместо строки ваш ключ. Флаг CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY со значением 1 разрешает расширению спросить у шлюза, какие модели доступны, вместо того чтобы полагаться на зашитый список. А claudeCode.disableLoginPrompt убирает предложение залогиниться в аккаунт Anthropic — аккаунт в этой схеме не нужен, ключ уже есть.

Обратите внимание: это не самостоятельный файл, а вставка внутрь уже существующего settings.json. Не забудьте запятую между блоками — невалидный JSON Cursor проглотит молча, а расширение просто не увидит настроек.

Последний шаг — перезапустить Cursor.

OpenAI-путь: Codex внутри Cursor

Здесь шагов больше, потому что расширение Codex — это обёртка над консольным Codex CLI. Без CLI расширение работать не будет, поэтому начинаем с него. Нужен установленный npm:

npm install -g @openai/codex

Проверяем, что бинарник встал и виден в PATH:

codex --version

Дальше ставим само расширение Codex в Cursor — по идентификатору cursor:extension/openai.chatgpt.

Теперь ключ. Codex CLI читает его из переменной окружения PURPLESCHOOL_API_KEY, а не из конфига, — так ключ не попадёт в файлы проекта. На macOS и Linux добавьте строку в конфиг вашей оболочки, например ~/.zshrc или ~/.bashrc:

export PURPLESCHOOL_API_KEY="ваш ключ"

Если export и переменные окружения для вас не совсем очевидная материя, у нас есть отдельный разбор — переменные окружения в Bash.

На Windows ключ сохраняется в пользовательскую переменную окружения и заодно задаётся для текущей сессии PowerShell:

[Environment]::SetEnvironmentVariable("PURPLESCHOOL_API_KEY", "ваш ключ", "User")
$env:PURPLESCHOOL_API_KEY="ваш ключ"

Остаётся прописать модельного провайдера. Откройте пользовательский ~/.codex/config.toml (на Windows — $env:USERPROFILE.codex\config.toml) и добавьте блок, не удаляя остальные настройки:

model = "<MODEL_NAME>"
model_provider = "purpleschool"

[model_providers.purpleschool]
name = "PurpleSchool OpenAI Proxy"
base_url = "https://app.purpleschool.ru/api-v2/public/ai-proxy/openai/v1"
env_key = "PURPLESCHOOL_API_KEY"
wire_api = "responses"
supports_websockets = false

Разберём по строкам. model — имя модели, которую агент возьмёт по умолчанию; вместо плейсхолдера <MODEL_NAME> подставьте доступную вам модель, на странице подключения как пример указан gpt-5.6-sol. model_provider переключает Codex с провайдера по умолчанию на ваш. Внутри секции [model_providers.purpleschool]: base_url — тот самый OpenAI-совместимый адрес, env_key — имя переменной, из которой брать ключ, wire_api = "responses" — формат протокола, по которому агент общается с моделью, supports_websockets = false отключает попытку поднять постоянное соединение.

Расширение Codex в Cursor использует ровно этот конфиг — отдельно его настраивать не нужно.

Финальный шаг важнее, чем кажется: полностью закройте Cursor и откройте его заново из терминала, в котором доступна PURPLESCHOOL_API_KEY. На Windows достаточно перезапустить редактор после сохранения пользовательской переменной. После запуска откройте боковую панель Codex; если значка нет, вызовите Command Palette и выполните команду Codex: Open Codex Sidebar.

Что делать, если Cursor не видит ключ или отвечает ошибкой

Почти все проблемы на этом маршруте — это не блокировка, а конфиг. Порядок проверки:

Агент не видит ключ. Самая частая история, и почти всегда она про то, как запущен редактор. Переменную окружения процесс получает от того терминала, из которого стартовал. Вы дописали export в ~/.zshrc, но Cursor висит запущенным с утра — он про новую переменную не знает. Закройте его полностью и запустите из свежего терминала. Проверить, что переменная вообще есть, можно прямо там:

echo $PURPLESCHOOL_API_KEY

Пусто — значит, строка ушла не в тот файл оболочки или терминал не перечитал конфиг.

Настройки Claude Code как будто не применились. Проверьте settings.json на валидность: лишняя или пропущенная запятая ломает весь файл, и редактор откатывается к значениям по умолчанию. Заодно убедитесь, что блок лежит внутри корневого объекта, а не рядом с ним.

Запросы уходят не туда. Сверьте base_url посимвольно. У двух экосистем адреса разные, и хвост /v1 есть только у OpenAI-совместимого: .../ai-proxy/openai/v1 против .../ai-proxy/anthropic. Перепутанный хвост — классика.

Codex ругается на модель. Плейсхолдер <MODEL_NAME> остался в конфиге как есть или указана модель, которой нет на вашем тарифе. Актуальный набор виден в самом подключённом инструменте.

Расширение Codex молчит, хотя ключ на месте. Проверьте, что Codex CLI действительно установлен: codex --version. Расширение без него не работает.

Всё работало и перестало. Посмотрите баланс токенов в личном кабинете: когда лимит месяца исчерпан, доступ к API временно прекращается до обновления лимита или до смены тарифа.

И одно правило вне зависимости от способа: ключ не должен попадать в репозиторий. Он живёт в переменной окружения или в пользовательских настройках редактора, а не в файлах проекта. Если всё же держите локальный файл с ключом — добавьте его в .gitignore до первого коммита, а не после.

Чем это отличается от VPN и своего прокси

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

VPN плюс зарубежная карта. Самый «честный» путь: вы остаётесь на официальной подписке. Минусы известны: карту надо где-то взять и регулярно пополнять, VPN должен быть поднят постоянно, а не только в момент оплаты, и любой сбой туннеля роняет агента посреди работы.

Свой обратный прокси на зарубежном VPS. Вариант для тех, кому важен полный контроль: вы поднимаете сервер, который переписывает запросы к API. Работает стабильно, но вопрос оплаты никуда не девается — ключ провайдера всё равно нужно чем-то оплатить, плюс добавляется сервер, который надо администрировать.

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

Если вы работаете не только в Cursor, у нас есть разборы соседних инструментов по той же схеме: Codex в России для консольного агента и Claude Code в России — там же подробнее про переменные ANTHROPIC_*.

Сколько стоит подписка через PurpleSchool

Тарифы устроены как месячный лимит токенов с общим балансом на Claude и GPT:

Лимит обновляется каждый месяц, а неизрасходованные токены переносятся на следующий — то есть за простой в отпуске вы не платите дважды. Если токены кончились раньше срока, можно дождаться обновления лимита, сменить тариф (изменение применяется сразу) или докупить дополнительный пакет токенов, не трогая подписку.

Как прикинуть свой расход: тысяча токенов — это примерно 750 слов, а один заход агента в IDE съедает от нескольких сотен до десятков тысяч токенов в зависимости от объёма контекста и ответа. Агентный режим с чтением всего проекта расходует заметно больше, чем точечный вопрос по одному файлу. Для знакомства хватает младшего тарифа, а дальше видно по расходу в кабинете — он показан по каждому запросу.

Заключение

Cursor в России чинится не VPN, а сменой того, откуда IDE берёт модель. Редактор остаётся официальным и обновляется как обычно, меняется один адрес в настройках — и вместе с ним способ оплаты.

Коротко весь маршрут: заводите ключ в AI для кода от PurpleSchool, выбираете экосистему — Claude через расширение Claude Code или GPT через Codex, — прописываете base_url и ключ в settings.json либо в ~/.codex/config.toml и перезапускаете Cursor из терминала, который видит переменную окружения. Дальше это обычная работа с агентом, без туннеля в фоне и без поисков зарубежной карты.