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

10 мин чтенияобновлено 7 ноября

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

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

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

Claude Code больше не ставится через npm, и Node.js ему не нужен: у него свой установщик. На Windows 10 версии 1809 и новее он работает нативно — подсистема Linux не требуется.

Установка одной командой

В PowerShell:

irm https://claude.ai/install.ps1 | iex

В командной строке (cmd):

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Есть и установка через WinGet. На macOS и Linux — через Homebrew или curl -fsSL https://claude.ai/install.sh | bash.

После установки откройте новое окно терминала и проверьте:

claude --version

Если оболочка отвечает, что команда не найдена, каталог установки ещё не попал в PATH — обычно помогает перезапуск терминала.

Следить за версией не нужно: Claude Code обновляется сам, в фоне.

Что нужно от системы

• Windows 10 1809 и новее или Windows Server 2019+; macOS 13+; Ubuntu 20.04+, Debian 10+, Alpine 3.19+;
• 4 ГБ оперативной памяти, процессор x64 или ARM64;
• оболочка Bash, Zsh, PowerShell или CMD.

На нативной Windows стоит поставить Git for Windows: с ним Claude Code пользуется bash, без него — PowerShell.

Не только терминал

Claude Code работает на четырёх поверхностях: терминал, расширения для VS Code и JetBrains, настольное приложение и веб. Настольное приложение есть для Windows, macOS и Linux — если терминал не ваш способ работы, начните с него.

Про WSL

Раньше Claude Code советовали ставить в WSL: он был npm-пакетом, рассчитанным на Unix. Сейчас в этом нет нужды — ставьте нативно. WSL осмыслен, только если вы и так в нём работаете.

Для маршрутизации трафика это важно: процесс внутри WSL для Windows — отдельная сетевая среда, и канал ему назначается отдельно от программ хоста.

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

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

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

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

where.exe claude

Пустой ответ означает, что дело именно в PATH. Добавьте каталог установки через «Параметры → Переменные среды» и перезапустите оболочку — после правки PATH перезапуск обязателен.

Третья: вы в другой оболочке, чем думаете. Если PowerShell ругается на &&, вы набрали команду для cmd. Если cmd не знает irm, вы набрали команду для PowerShell. Отличить просто: в PowerShell приглашение начинается с PS C:\, в cmd — просто C:\.

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

В директории проекта наберите 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, инструмент для точечной маршрутизации трафика по названию программы. Он поднимает внутренний канал, забирает в него весь трафик машины и раздаёт по правилам, привязанным к конкретной программе.

Каналы и режим fail-closed

Каналов шесть:

• Дом — обычный интернет вашего провайдера.
• Прокси — выход через купленный адрес.
• VPN — через ваш собственный узел.
• За IP — закрепление за конкретным выходным адресом: две программы получают разные адреса и выглядят снаружи как два разных человека.
• Блок — соединение отклоняется.
• Спросить — для новых программ: пока не решите, программа никуда не пойдёт.

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

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

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

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

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

Установка Proxy Control

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

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

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

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

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

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

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

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

Тарифы Proxy Control

Программа Proxy Control стоит 500 ₽ в месяц, оплата помесячно. Все цены на странице Услуги и цены. Это плата за доступ к маршрутизации, а не за сам Claude Code: подписку или API у Anthropic вы оплачиваете отдельно.

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

Proxy Control: что это и сколько стоит

Программа для Windows: Claude, ChatGPT и другие зарубежные сервисы работают из России через ваш прокси, а банк и Госуслуги идут напрямую. Программа стоит 500 ₽ в месяц, прокси и VPN у нас по 300 ₽, установим бесплатно.

Услуги и ценыУстановим бесплатно