Claude Code в VS Code: подключение и настройка из России

Claude Code в VS Code ставится из маркетплейса как любое другое расширение, и на этом штатный сценарий для России заканчивается: панель открывается, диалог есть, ответа нет. Причина не в редакторе — запрос не доходит до модели. Рабочее решение одно: указать расширению другой адрес API. Claude Code это умеет — базовый URL задаётся в его настройках, и дальше расширение ходит в совместимый шлюз. У AI для кода от PurpleSchool такой шлюз есть: ключ берётся в личном кабинете, подписка оплачивается российской картой. Ниже — подключение Claude Code целиком: расширение, блок в settings.json, построчный разбор, проверка и частые ошибки. Вторым разделом — то же для Codex, если в том же редакторе нужны модели OpenAI.

Почему Claude Code в 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, здесь живёт в настройках редактора. Если сама механика переменных окружения для вас не очевидна, у нас есть отдельный разбор — переменные окружения в Bash.
• 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 и отправьте любой короткий запрос. Ответ пришёл — шлюз подключён, дальше работаете как обычно.

Частые ошибки Claude Code в VS Code

Четыре ситуации закрывают почти все случаи, когда расширение установлено, а работать отказывается.

Вместо ответа — экран входа в аккаунт Anthropic. Настройки не применились: либо блок попал не внутрь корневого объекта settings.json, либо редактор не перезапускали. Проверьте, что claudeCode.disableLoginPrompt сохранён в файле и что VS Code не подсвечивает файл как невалидный JSON.

Запрос уходит, ответа нет. Сверьте ANTHROPIC_BASE_URL посимвольно. Частая опечатка — лишний суффикс /v1: он нужен OpenAI-совместимому адресу для Codex, а у Anthropic-совместимого адреса его нет.

В списке моделей не то, что ожидалось, или выбор модели выдаёт ошибку. Не сработал запрос каталога у шлюза. Проверьте, что CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY задан строкой "1" — ровно как в блоке выше, внутри массива переменных, а не отдельной настройкой.

Работало и перестало. Конфиг сам не меняется, поэтому смотрите на то, что меняется: остаток токенов по тарифу в личном кабинете. Когда месячный лимит исчерпан, запросы не проходят до обновления лимита или смены тарифа.

Если сбой относится к самому Claude 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 в России.

Установка расширения и ключ PURPLESCHOOL_API_KEY

Официальное расширение 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 показывает экран входа или не отвечает. Это разобрано выше, в «Частых ошибках Claude Code в VS Code»: дело в невалидном settings.json, пропущенном перезапуске или перепутанном адресе шлюза.

Значка Codex нет в боковой панели. Это не всегда поломка: панель может быть просто не активирована. Вызовите Command Palette и выполните Codex: Open Codex Sidebar. Если команда не находится, расширение не установлено или не активировалось — тогда проверяйте codex --version в терминале.

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

Модель оплаты — подписка с ежемесячным лимитом токенов, картой российского банка. Младший тариф «Помощник» стоит 499 ₽ в месяц и даёт 2,5 млн токенов. Средний, «Напарник», — 1 199 ₽ за 5,5 млн. Старший, «Соавтор», — 2 499 ₽ за 12,5 млн. Остаток лимита не сгорает в конце месяца, а переходит в следующий, но копить его дольше одного цикла не выйдет.

Баланс общий для обеих экосистем: один и тот же ключ обслуживает и Claude Code, и Codex, а списание зависит от того, какую модель вы выбрали в настройках инструмента. Практически это значит, что оба расширения можно держать в редакторе одновременно и переключаться между ними по задаче, не заводя второй подписки.

Если вы только начинаете работать с агентами в редакторе, у нас есть курсы под оба инструмента: Claude Code и Основы Codex. Там разбирается не подключение, а сама работа — как ставить задачи, как проверять результат и где агент ошибается чаще всего.

Заключение

Claude Code в VS Code настраивается целиком внутри редактора: расширение из маркетплейса, блок claudeCode.environmentVariables в settings.json и перезапуск — VPN и зарубежная карта в этой схеме не нужны. Codex требует установленного CLI, переменной окружения и секции [model_providers.purpleschool] в ~/.codex/config.toml, а редактор обязательно запускается из терминала с ключом.

Те же расширения работают в редакторах на базе VS Code. Настройка для Cursor разобрана в отдельной статье про Cursor в России, а полный список клиентов с готовыми инструкциями — от Windsurf до Neovim — собран на странице AI для кода.