Установка и настройка Claude Code на Windows: пошаговое руководство

Claude Code, это терминальный инструмент для работы с кодом. Он ставится в командную оболочку и запускается командой claude из любой директории проекта. На Windows у него две сложности: сам процесс установки через Node.js и доступ к сети, потому что из России функции ИИ отдают ошибку по региону.

Ниже разберём установку по шагам, типичные ошибки вроде «claude не является внутренней или внешней командой», первый запуск с авторизацией и файл CLAUDE.md. Отдельно опишем, как мы решаем проблему доступа через выборочное проксирование, чтобы в прокси уходил только нужный процесс, а не весь трафик машины.

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

До установки самого Claude Code нужен Node.js. Официальный клиент распространяется как npm-пакет, поэтому без Node команда npm работать не будет. Ставьте LTS-версию с сайта nodejs.org, при установке галочка «Add to PATH» должна быть включена, иначе оболочка не найдёт ни node, ни npm.

Проверьте, что всё встало, в новом окне PowerShell:

node --version
npm --version

Если обе команды печатают номер версии, окружение готово. Если PowerShell отвечает, что команда не распознана, значит PATH не подхватился: перелогиньтесь или перезапустите терминал, старое окно держит прежние переменные окружения.

Отдельно проверьте номер версии Node: слишком старая LTS может не подойти под свежий пакет, тогда npm install завершится предупреждением про несовместимость. В этом случае обновите Node до актуальной LTS и повторите установку. Права администратора для установки самого пакета обычно не нужны, npm кладёт глобальные бинарники в пользовательскую папку, а не в системную. Если у вас несколько версий Node через менеджер версий, убедитесь, что активна именно та, где вы ставили claude, иначе команда пропадёт после переключения.

Про сам доступ к сети скажем сразу, чтобы не тратить время: Claude Code при первом запуске обращается к серверам Anthropic, и из России ответ может не прийти. Как это обходить точечно, разберём в разделе про Claude Code в России.

Как установить Claude Code на Windows

Основной способ один, через npm. Всё остальное, что встречается в статьях, это вариации вокруг него.

Обычная установка через npm

Откройте PowerShell и поставьте пакет глобально:

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

После установки в PATH появляется команда claude. Проверьте:

claude --version

Дальше переходите в папку своего проекта и запускайте:

cd C:\projects\my-app
claude

При первом запуске Claude Code попросит авторизоваться, об этом ниже. На экране во время установки вы увидите строку загрузки пакета и, при удачном исходе, короткую сводку с числом добавленных зависимостей. Если вместо неё появился красный текст с EACCES или EPERM, это про права доступа к папке npm: закройте лишние процессы, которые могут держать файлы, и повторите. При ошибке сети во время загрузки самого пакета (ETIMEDOUT, ECONNRESET) дело обычно не в регионе, а в нестабильном соединении, тогда достаточно просто запустить команду ещё раз.

Про WSL и Linux

Исторически Claude Code задумывался под Unix-окружение, и часть инструкций советует ставить его в WSL (Ubuntu поверх Windows). Это рабочий вариант: внутри WSL вы получаете bash, привычные пути и меньше пограничных случаев с экранированием. Но с нативной поддержкой Windows это стало опцией, а не обязанностью. Если вы уже живёте в WSL, ставьте там; если нет, разворачивать Linux-подсистему только ради claude смысла мало, PowerShell справляется.

Выбор между bash в WSL и powershell влияет только на то, как вы набираете команды и передаёте переменные окружения. Логика самого инструмента одна. Стоит помнить о разнице путей: в PowerShell это C:\projects\my-app, а внутри linux-окружения WSL тот же проект виден как /mnt/c/projects/my-app. Если держать код внутри файловой системы самого WSL, работа с файлами идёт заметно быстрее, чем через /mnt/c.

«claude не является внутренней или внешней командой»

Самая частая ошибка сразу после установки. Оболочка не видит claude, хотя npm отработал без ошибок. Причин обычно три.

Первая: команду набрали в том же окне, где ставили пакет. PATH обновляется для новых процессов, старое окно про свежую команду не знает. Закройте терминал и откройте новый.

Вторая: путь к глобальным пакетам npm не попал в PATH. Посмотрите, куда npm кладёт бинарники:

npm config get prefix

Путь из вывода (папка с claude.cmd) должен присутствовать в переменной PATH. Если его там нет, добавьте вручную через «Параметры → Переменные среды» и снова перезапустите оболочку. После правки PATH перезапуск нужен обязательно, иначе изменения не подтянутся в текущую сессию.

Третья: политика выполнения скриптов PowerShell блокирует .cmd-обёртку. Тогда помогает запуск через полный путь либо смягчение политики для текущего пользователя. Меняйте её осознанно, это настройка безопасности, а не косметика. Проверить текущее значение можно командой Get-ExecutionPolicy, а посмотреть, куда именно указывает claude, командой where.exe claude: она печатает полный путь к обёртке, если та вообще видна оболочке. Пустой ответ where.exe означает, что проблема именно в PATH, а не в политике.

Первый запуск и авторизация

В директории проекта наберите claude. Инструмент откроет процесс входа: он предложит авторизацию через аккаунт и отправит вас в браузер подтвердить доступ. После подтверждения токен сохраняется локально, и следующие сессии стартуют без повторного входа.

Здесь всплывает региональная проблема. Шаг авторизации и последующие запросы уходят на серверы Anthropic, и если они недоступны из вашей сети, вы получите таймаут или ошибку соединения вместо экрана входа. Именно на этом шаге большинство и упирается в блокировку. Разбор с доступом дальше по тексту и на странице Claude Code в России.

Когда авторизация прошла, вы окажетесь в интерактивной сессии: пишете задачу текстом, инструмент читает файлы проекта, предлагает правки и команды. Про то, как настроить контекст проекта, ниже.

CLAUDE.md: первое, что стоит настроить в проекте

CLAUDE.md, это файл памяти проекта. Его кладут в корень репозитория, и инструмент подхватывает его в начале каждой сессии. Туда пишут то, что иначе пришлось бы повторять руками: стек, команды сборки и тестов, соглашения по стилю, что трогать нельзя.

Минимальный пример:

# Проект: my-app

- Пакетный менеджер: pnpm, не npm
- Тесты: pnpm test, запускать перед коммитом
- Не менять файлы в src/generated, они генерируются
- Стиль: 2 пробела, точки с запятой обязательны

Файл читается как обычный markdown, держите его коротким и по делу. Раздутый CLAUDE.md съедает контекст. Подробнее про рабочие приёмы, команды старта и MCP, смотрите в разборах claude code и claude code mcp.

Команды, которые пригодятся на старте

Внутри сессии работают служебные команды со слэшем. Самые ходовые:

• /help, список доступных команд
• /clear, сбросить контекст текущей сессии, когда разговор ушёл не туда
• /init, сгенерировать заготовку CLAUDE.md по текущему проекту

Сессия (session) держит историю в рамках одного запуска. Когда контекст переполнен или вы сменили задачу, чистите его через /clear вместо того, чтобы продолжать в замусоренном диалоге. Если поведение изменилось после обновления (changed, fixed в чейнджлоге), сверяйтесь с /help: набор команд иногда правят между версиями (version).

Сколько стоит Claude Code

Claude Code работает на платном доступе. Есть два пути: подписка на тарифный план и оплата по API за токены. Подписка удобнее для регулярной работы с фиксированной суммой и лимитами; оплата через API (api) гибче, но считается по потреблению. Точные цены и лимиты меняются, поэтому сверяйтесь с актуальными условиями на стороне Anthropic, а не с цифрами из статей.

Мы разбираем варианты и подводные камни оплаты из России отдельно: смотрите claude code подписка и claude code api. Готовые чужие аккаунты с маркетплейсов советовать не будем, это риск блокировки без возможности что-то вернуть.

VS Code вместо терминала

Если вам ближе редактор, есть расширение для VS Code, оно даёт тот же движок, но с интерфейсом внутри IDE. Требования по версии редактора и настройка описаны на странице vs code claude. Под капотом это тот же доступ к сети, а значит, та же региональная проблема, что и в терминале.

Доступ из России: выборочное проксирование

Теперь про то, из-за чего установка часто застревает. Сам claude ставится и запускается нормально, но его запросы к серверам Anthropic из России не проходят. Общий VPN на всю машину лечит это грубо: под него уезжает весь трафик, включая то, что должно идти домашним каналом. Windows не умеет разводить трафик по приложениям штатно, поэтому «пустить в прокси только один процесс» средствами системы не выйдет.

Мы сделали Proxy Control, инструмент для точечной маршрутизации трафика по имени процесса. Он поднимает виртуальный сетевой адаптер (TUN) на sing-box, забирает в него весь трафик машины и раздаёт по правилам, привязанным к конкретной программе.

Четыре канала и режим fail-closed

Каждому приложению назначается один из четырёх каналов:

• Дом, обычный интернет вашего провайдера
• VPN, ваш собственный узел
• Прокси, через HTTP CONNECT
• Блок, соединение отклоняется

Неизвестное блокируется по умолчанию. Новая программа появляется в списке со статусом «ожидает» и в сеть не выходит, пока вы вручную не назначите ей канал. Это сделано намеренно: явный отказ лучше незаметной утечки.

Claude всегда идёт через прокси, и этот канал у него сменить нельзя. Так исключается ситуация, когда процесс случайно ушёл домой или в VPN. Работает принцип fail-closed: если прокси недоступен, Claude и прокси-приложения уходят в блок, а не домашним каналом. То же самое с VPN: мёртвый узел означает блок для VPN-приложений, а не тихий откат на домашний интернет.

Пока туннель пересобирается, ставится блокирующее правило брандмауэра. Трафик не утекает мимо маршрутов, он встаёт на несколько секунд и продолжается по новым правилам.

Как убедиться, что трафик реально в прокси

Мы не красим статус в зелёный по факту «конфиг записан». Три собственные пробы (копии curl, прибитые к каналам) запрашивают внешний IP и показывают три разных адреса. Если IP канала совпал с домашним, программа пишет про утечку, а не рапортует об успехе.

Живая сверка идёт через локальный API sing-box: видно, каким каналом идёт каждый процесс на самом деле, а не что написано в настройках. Для приложений на прокси мы заблокировали UDP и IPv6, иначе QUIC ушёл бы мимо HTTP-прокси. DNS работает по DoH.

Установка Proxy Control

Скачайте архив, распакуйте целиком (папки должны лежать рядом) и запустите Install.bat, он попросит подтверждение администратора. Ставить что-либо заранее не нужно: Python и sing-box лежат внутри архива, интернет при установке не требуется. Установщик копирует всё в служебную папку продукта, распакованный архив после этого можно удалить.

Важный момент про распаковку: если открыть Install.bat прямо из окна архиватора, без полного извлечения, установщик не найдёт соседние папки и остановится с ошибкой. Распакуйте архив целиком в отдельную папку и только потом запускайте. Если Windows SmartScreen попросит подтверждение при запуске .bat, это ожидаемо для файла из интернета, выберите «Подробнее» и «Выполнить в любом случае».

Доступ включается по ключу вида CPC-XXXXXX-XXXXXX, один ключ на один компьютер. По нему программа получает срок действия и персональные реквизиты прокси. Регистрация через почту или Telegram-бота.

Запуск и первый старт

Туннель поднимается сам при запуске программы, старт проходит 15 шагов с проверками: собирается конфиг, проверяется, стартует sing-box, программа ждёт появления адаптера, проверяет прокси и VPN, запускает Claude и убеждается, что его трафик реально ушёл в прокси. Пока идёт старт, кнопка «Запустить Claude» погашена и показывает номер шага, например Запускаю… 11/15. Не открывайте Claude вручную в этот момент, иначе получите два запуска.

Если прокси не отвечает, кнопка неактивна: запускать Claude в такой момент бессмысленно, он ходит именно через прокси. Причина написана рядом с кнопкой, при этом маршрутизация остальных приложений продолжает работать.

После смены канала у приложения нажмите «Применить маршруты»: появится подтверждение с отсчётом 10 секунд. Claude переживает паузу и восстанавливается сам. Кнопки «Остановить Claude» и «Закрыть программу» гасят туннель и закрывают Claude, после этого сеть работает обычным образом. Это же аварийный выход, если что-то пошло не так.

Удаление, Uninstall.bat: снимает туннель, правило брандмауэра, задания планировщика, ярлык и папку продукта. Лицензия при этом остаётся привязанной к компьютеру, отвязать её можно кнопкой в кабинете.

Тарифы Proxy Control

Подписка стоит 495 ₽/мес при помесячной оплате и от 395 ₽/мес при оплате за год. Есть тарифы на 2, 3, 6 и 12 месяцев. Это плата за доступ к маршрутизации, а не за сам Claude Code: подписку или API у Anthropic вы оплачиваете отдельно.

Частые вопросы

Claude Code бесплатный, его можно скачать бесплатно? Сам npm-пакет ставится бесплатно, но работа с ИИ платная: нужна подписка или оплата по API на стороне Anthropic.

Нужен ли WSL или хватит PowerShell? Хватает PowerShell на актуальной Windows. WSL с bash (linux-окружение) уместен, если вы уже в нём работаете, разворачивать его только ради claude необязательно.

После установки пишет «claude не является внутренней или внешней командой». Закройте терминал и откройте новый. Если не помогло, проверьте, что путь из npm config get prefix есть в PATH.

Что делать, если npm install падает с ошибкой прав? Ошибки EACCES или EPERM означают, что npm не смог записать файлы в свою папку. Закройте процессы, которые могут держать эти файлы, и повторите установку. Менять владельца системных папок не нужно, глобальные пакеты кладутся в пользовательский профиль.

Можно ли пустить в прокси только Claude Code, не весь трафик? Да, это и есть задача Proxy Control: канал назначается по имени процесса, остальные приложения продолжают ходить домашним каналом.

Что будет, если прокси отвалится посреди работы? Сработает fail-closed: Claude и прокси-приложения уйдут в блок, а не на домашний интернет. Утечки на провайдерский IP не произойдёт.

Куда писать, если что-то не работает? Поддержка в Telegram. Регистрация через почту или бота.