Основы разработки
Основы Python
CSS Flexbox
Антон Ларичев
23 сентября 2026 
Claude Code и Codex в VS Code ставятся из маркетплейса как любое другое расширение, и на этом штатный сценарий для России заканчивается: диалог открывается, но ответа не приходит. Причина не в редакторе — запрос не доходит до модели. Рабочее решение одно: указать расширению другой адрес API. Оба расширения умеют ходить в совместимый шлюз, и у AI для кода от PurpleSchool такой шлюз есть — ключ берётся в личном кабинете, подписка оплачивается российской картой. Ниже два маршрута настройки, для Claude Code и для Codex: конфиги целиком, построчный разбор и причины, по которым VS Code может не увидеть ключ.
Почему Claude Code и Codex не подключаются в VS Code напрямую из России
Разделите в голове две вещи: интерфейс и вычисления. Всё, что вы видите в боковой панели, — чтение открытых файлов, диалог, применение правок — выполняется локально. Рассуждение выполняется в облаке вендора, и каждое нажатие «отправить» превращается в сетевой запрос наружу. Работоспособность расширения, таким образом, определяется не тем, установилось ли оно, а тем, доходит ли этот запрос до адресата и оплачен ли он.
У разработчика из России тут два независимых барьера. Первый — сетевой доступ к API вендора. Второй — оплата: привязать карту российского банка к зарубежному биллингу не получится. Платёжная сторона вопроса — тема отдельного материала: какие способы оплатить OpenAI из России остаются рабочими.
Решение вытекает из этой же схемы. Раз проблема в адресате запроса, менять надо адресата, а не расширение. PurpleSchool держит два шлюза с совместимыми протоколами: Anthropic-совместимый обслуживает Claude Code, OpenAI-совместимый — Codex. Со стороны расширения это выглядит как ещё один провайдер с другим базовым URL и другим ключом, так что сборка остаётся официальной и обновляется из маркетплейса как обычно.
Важное отличие от терминальных инструментов: в VS Code переменные окружения задаются не только в shell. Расширение Claude Code читает их из собственной настройки в settings.json, а расширение Codex — из конфига Codex CLI и переменной окружения процесса, который запустил редактор. Из-за этого частая ошибка выглядит одинаково у всех: ключ «прописан», а ассистент его не видит. Разберём оба случая по порядку.
Claude Code в VS Code через AI для кода от PurpleSchool
Путь для тех, кому нужны модели Claude прямо в редакторе. Три шага: поставить расширение, прописать переменные в settings.json, перезапустить VS Code.
Установка расширения Claude Code
Откройте панель Extensions в VS Code, найдите расширение Claude Code и установите его. Ничего настраивать на этом шаге не нужно — после установки в боковой панели появится значок ассистента.
Если вам нужен не редактор, а терминал, ставить расширение необязательно: Claude Code существует и как отдельный CLI, его настройка через тот же шлюз разобрана в статье про Claude Code в России.
Настройка settings.json
После установки откройте настройки расширения: значок шестерёнки в панели Claude Code, дальше пункт Settings, дальше «Edit in settings.json». Вы окажетесь в обычном файле настроек VS Code.
Вставьте в корневой JSON-объект settings.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
Что здесь происходит по строкам:
claudeCode.environmentVariables— массив переменных окружения, которые расширение передаст своему процессу. Это и есть заменаexportв shell: то, что в терминале вы бы написали в~/.zshrc, здесь живёт в настройках редактора.ANTHROPIC_BASE_URL— адрес шлюза вместо адреса облака Anthropic. Ровно эта строка и снимает проблему с доступом.ANTHROPIC_API_KEY— ключ PurpleSchool из личного кабинета, раздел «AI для кода». Подставьте его вместоваш ключвместе с кавычками.CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERYсо значением1— включает запрос каталога моделей у шлюза. Без него расширение опирается на список, зашитый в сборку, и доступные вам модели в выпадашке могут не совпасть с реальными.claudeCode.disableLoginPrompt— выключает экран входа в аккаунт Anthropic. Логиниться некуда и незачем: авторизация идёт по ключу из предыдущей строки.
Обратите внимание на запятые. Блок вставляется внутрь существующего объекта, рядом с вашими настройками редактора, а не поверх них — если после вставки VS Code подсветил файл красным, почти всегда дело в лишней или пропущенной запятой на границе блока.
Перезапуск и проверка
Закройте VS Code полностью и откройте снова: расширение читает настройки при старте, и без перезапуска вы будете видеть старое поведение с экраном логина. После перезапуска откройте панель Claude Code и отправьте любой короткий запрос. Ответ пришёл — шлюз подключён, дальше работаете как обычно.
Codex в VS Code через AI для кода от PurpleSchool
С Codex схема другая, и это главный источник путаницы. Расширение Codex для VS Code не самодостаточно: через сторонний совместимый шлюз оно работает поверх Codex CLI и берёт конфигурацию оттуда. Поэтому сначала CLI, потом расширение.
Codex CLI — обязательное условие для расширения
Поставьте CLI глобально через npm:
npm install -g @openai/codex
Проверьте, что бинарь на месте:
codex --version
Команда должна напечатать номер версии. Если вместо этого вы видите «command not found», расширение тоже не заведётся — сначала нужно починить установку CLI.
Отдельно про Codex в терминале — установка, режимы работы и настройка — написано в статье про Codex в России.
Установка расширения и ключ PURPLESCHOOLAPIKEY
Официальное расширение Codex лежит в Visual Studio Marketplace под идентификатором openai.chatgpt — его же можно найти поиском по панели Extensions.
Дальше положите ключ PurpleSchool в переменную окружения. На macOS и Linux — в конфиг вашей активной shell, обычно ~/.zshrc или ~/.bashrc:
export PURPLESCHOOL_API_KEY="ваш ключ"
На Windows в PowerShell сохраните переменную на уровне пользователя и заодно задайте её для текущей сессии:
[Environment]::SetEnvironmentVariable("PURPLESCHOOL_API_KEY", "ваш ключ", "User")
$env:PURPLESCHOOL_API_KEY="ваш ключ"
Первая строка пишет переменную в профиль пользователя — она переживёт перезагрузку. Вторая нужна, чтобы не открывать новое окно PowerShell прямо сейчас.
~/.codex/config.toml — модельный провайдер
Теперь опишите шлюз как провайдера в пользовательском конфиге Codex. Файл лежит по пути ~/.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— какой из описанных провайдеров считать активным. Значениеpurpleschoolссылается на секцию ниже по имени.base_url— адрес OpenAI-совместимого шлюза. Обратите внимание на суффикс/v1: у Anthropic-шлюза для Claude Code его нет, у OpenAI-совместимого есть.env_key— имя переменной окружения, из которой Codex возьмёт ключ. Не сам ключ, а именно имя переменной, поэтому секрет не попадает в конфиг и не уедет в репозиторий вместе с дотфайлами.wire_api— формат протокола, на котором Codex разговаривает со шлюзом.supports_websockets— отключает попытку установить постоянное соединение.
Перезапуск IDE — именно из терминала
Дальше шаг, на котором спотыкаются чаще всего. Закройте VS Code полностью и запустите его заново из того терминала, где доступна PURPLESCHOOL_API_KEY. Расширение Codex берёт переменную из окружения процесса редактора: если VS Code запущен ярлыком из дока или меню «Пуск» до того, как переменная была объявлена, окружения он не унаследует, и ключа для расширения просто не существует.
На Windows после SetEnvironmentVariable с областью User достаточно полностью закрыть и открыть IDE заново — переменная уже сохранена в профиле.
Откройте боковую панель Codex. Если значка не видно, вызовите Command Palette и выполните команду Codex: Open Codex Sidebar.
Автоматическая настройка одной командой
Оба конфига выше можно не писать руками. На странице подключения лежит вспомогательный CLI: он находит установленные инструменты и расставляет ключ с адресом шлюза по их конфигам сам.
npx @purpleschool/ai-for-code
Для запуска нужен Node.js версии 22 или новее. Для первой настройки способ хороший, но разделы выше он не отменяет: диагностика в любом случае сводится к тем же settings.json и config.toml, и понимать, что в них написано, придётся при первой же ошибке.
Что делать, если VS Code не видит ключ или модель
Три причины закрывают большинство случаев.
Расширение Codex молчит, а CLI установлен. Проверьте, из чего запущен редактор. Расширение Codex наследует переменные окружения от процесса VS Code, и запуск ярлыком в обход shell — самый частый способ остаться без PURPLESCHOOL_API_KEY. Закройте редактор и откройте его командой из терминала, в котором echo $PURPLESCHOOL_API_KEY печатает ваш ключ.
Claude Code показывает экран входа в аккаунт. Значит, настройки не применились: либо блок попал не внутрь корневого объекта settings.json, либо VS Code не перезапускали. Проверьте, что claudeCode.disableLoginPrompt действительно стоит в файле и что файл сохранён без синтаксических ошибок.
Значка Codex нет в боковой панели. Это не всегда поломка: панель может быть просто не активирована. Вызовите Command Palette и выполните Codex: Open Codex Sidebar. Если команда не находится, расширение не установлено или не активировалось — тогда проверяйте codex --version в терминале.
Если ошибка выглядит иначе и относится к самому Claude Code, а не к интеграции с редактором, отдельный разбор частых сбоев запуска есть в статье про то, почему Claude Code не запускается.
Сколько стоит доступ через PurpleSchool
Модель оплаты — подписка с ежемесячным лимитом токенов, картой российского банка. Младший тариф «Помощник» стоит 499 ₽ в месяц и даёт 2,5 млн токенов. Средний, «Напарник», — 1 199 ₽ за 5,5 млн. Старший, «Соавтор», — 2 499 ₽ за 12,5 млн. Остаток лимита не сгорает в конце месяца, а переходит в следующий, но копить его дольше одного цикла не выйдет.
Баланс общий для обеих экосистем: один и тот же ключ обслуживает и Claude Code, и Codex, а списание зависит от того, какую модель вы выбрали в настройках инструмента. Практически это значит, что оба расширения можно держать в редакторе одновременно и переключаться между ними по задаче, не заводя второй подписки.
Если вы только начинаете работать с агентами в редакторе, у нас есть курсы под оба инструмента: Claude Code и Основы Codex. Там разбирается не подключение, а сама работа — как ставить задачи, как проверять результат и где агент ошибается чаще всего.
Заключение
В VS Code подключение сводится к одному решению: какой из двух шлюзов вы используете. Claude Code настраивается целиком внутри редактора — блок claudeCode.environmentVariables в settings.json и перезапуск. Codex требует установленного CLI, переменной окружения и секции [model_providers.purpleschool] в ~/.codex/config.toml, а редактор обязательно запускается из терминала с ключом.
Те же расширения работают в редакторах на базе VS Code. Настройка для Cursor разобрана в отдельной статье про Cursor в России, а полный список клиентов с готовыми инструкциями — от Windsurf до Neovim — собран на странице AI для кода.
14
AI-тренажеры
Практика в студии
4.9
Комментарии
0