Как установить Claude Code на Windows: инструкция из России

Claude Code ставится на Windows одной командой npm install -g @anthropic-ai/claude-code — при условии, что в системе есть Node.js. Проблема начинается после установки: CLI поднимется, но при первом же запросе вернёт ошибку доступа, потому что API Anthropic не обслуживает запросы из России. Поэтому установка на Windows из России — это два отдельных дела: поставить сам пакет и подсунуть ему рабочий адрес API с ключом. Ниже — оба шага по порядку, с синтаксисом именно для PowerShell, а не для bash.

Что нужно перед установкой

Claude Code — это обычный npm-пакет, поэтому всё упирается в Node.js. Проверьте, что он есть и достаточно свежий:

node -v
npm -v

Обе команды должны вернуть номер версии. Если PowerShell отвечает, что node не распознан как имя командлета, Node.js либо не установлен, либо не прописан в PATH — поставьте его с официального сайта и откройте терминал заново.

На старых сборках Node.js Claude Code падает при старте с невнятными сообщениями или не устанавливается вообще, поэтому если версия давно не обновлялась — обновите её до актуальной LTS до всех остальных шагов. Это дешевле, чем потом разбирать ошибки установки.

Отдельно про WSL: если вы работаете внутри подсистемы Linux, то все команды ниже выполняются не в PowerShell, а в bash — и переменные окружения там задаются через export, как на Linux. Нативный путь через PowerShell работает, WSL для Claude Code не обязателен.

Шаг 1: устанавливаем Claude Code через npm

Откройте PowerShell и выполните:

npm install -g @anthropic-ai/claude-code

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

Get-Command claude

Команда вернёт путь до исполняемого файла. Если вместо этого вы получили ошибку «claude не распознан», пакет установился, но каталог npm не попал в PATH. Посмотрите, куда именно npm кладёт глобальные пакеты:

npm config get prefix

Полученный путь нужно добавить в переменную PATH пользователя и перезапустить терминал. Это самая частая заминка на Windows: на macOS каталог npm обычно уже в PATH, на Windows — далеко не всегда.

Шаг 2: почему одной установки из России мало

Пакет установлен, но работать он пока не будет. Блокировка у Anthropic стоит не на скачивании CLI, а на стороне API: запрос с российского IP или с ключа, привязанного к России, возвращает ошибку с упоминанием региона. Установка тут ни при чём — чинить конфиг или переустанавливать пакет бесполезно.

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

Шаг 3: настраиваем переменные окружения в PowerShell

Claude Code читает адрес API и ключ из переменных окружения ANTHROPIC_BASE_URL и ANTHROPIC_API_KEY. Подменив первую, вы отправляете CLI не на заблокированный адрес, а на доступный шлюз.

Ключ можно получить в AI для кода от PurpleSchool — это Anthropic-совместимый шлюз с оплатой в рублях, официальные инструкции для Claude Code там есть в том числе в варианте для Windows.

Для текущей сессии терминала переменные задаются так:

$env:ANTHROPIC_API_KEY="ваш ключ"
$env:ANTHROPIC_BASE_URL="https://app.purpleschool.ru/api-v2/public/ai-proxy/anthropic"

Здесь важная деталь, на которой спотыкаются чаще всего. Синтаксис $env: живёт только до закрытия окна PowerShell. Закрыли терминал — переменных больше нет, и Claude Code снова пойдёт на заблокированный адрес. Чтобы записать их в профиль пользователя навсегда:

[Environment]::SetEnvironmentVariable('ANTHROPIC_API_KEY','ваш ключ','User')
[Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL','https://app.purpleschool.ru/api-v2/public/ai-proxy/anthropic','User')

Область User означает, что переменная сохранится в профиле и переживёт перезагрузку. Но подхватят её только те процессы, что запустятся после — уже открытый терминал о ней не узнает. Поэтому на практике удобно сделать обе вещи: записать через SetEnvironmentVariable на будущее и продублировать через $env: для текущей сессии.

Проверить, что значение на месте:

$env:ANTHROPIC_BASE_URL

Если команда ничего не вывела — переменная не задана в этой сессии. Если вам нужно общее понимание механизма, как переменные окружения устроены и почему они не подхватываются задним числом, посмотрите разбор переменных окружения.

Автоматическая настройка одной командой

Всё то же самое умеет сделать установщик — он сам пропишет нужные значения для выбранного клиента:

npx @purpleschool/ai-for-code

Вариант для тех, кто не хочет руками править переменные и конфиги.

Шаг 4: отключаем онбординг и запускаем

При первом старте Claude Code показывает мастер первоначальной настройки, который в связке со сторонним шлюзом только мешает. Его отключают флагом в файле .claude.json в домашнем каталоге — на Windows это C:\Users<имя>.claude.json, то есть $env:USERPROFILE.claude.json. Добавьте в него:

{
  "hasCompletedOnboarding": true
}

Если файла нет — создайте его с этим содержимым. Если он уже существует, добавьте поле в существующий объект, не стирая остальные настройки.

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

cd C:\projects\my-app
claude

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

Частые ошибки на Windows

claude не распознан как команда. Каталог глобальных пакетов npm не в PATH. Лечится способом из шага 1: npm config get prefix, добавить путь в PATH, перезапустить терминал.

Переменные заданы, но агент всё равно упирается в ошибку региона. Почти всегда это $env:, заданный в другом окне терминала. Проверьте значение прямо в том окне, где запускаете claude, и при необходимости пропишите переменные через SetEnvironmentVariable с областью User.

Ошибка исчезла, но появилась другая. Установка на Windows — только часть возможных проблем: бывают истёкший токен, конфликт в settings.json, сетевые ограничения. Разбор по кодам ошибок собран в статье Claude Code не запускается: 7 частых ошибок.

Работаете в VS Code, а не в терминале. Тогда переменные прописываются не в PowerShell, а в настройках расширения — этот путь разобран отдельно в материале Claude Code и Codex в VS Code из России.

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

Доступ к шлюзу PurpleSchool оформляется подпиской с оплатой в рублях и отменой в любой момент. Тарифы: «Помощник» — 499 ₽ в месяц, «Напарник» — 1 199 ₽, «Соавтор» — 2 499 ₽. Различаются объёмом доступных токенов, актуальные лимиты смотрите на странице продукта.

Заключение

Установка Claude Code на Windows из России сводится к четырём шагам: проверить Node.js, поставить пакет глобально через npm, прописать ANTHROPIC_BASE_URL и ANTHROPIC_API_KEY в PowerShell — постоянными, а не сессионными, — и отключить онбординг в .claude.json. Два места, где Windows отличается от инструкций для macOS: PATH для глобальных пакетов npm и синтаксис переменных окружения. Если обе эти вещи настроены, дальше CLI работает ровно так же, как на любой другой системе.