Как запустить Claude Code в России: пошаговая инструкция для разработчиков

Claude Code, это CLI-инструмент от Anthropic для работы с кодом прямо в терминале. Вы ставите задачу текстом, агент читает файлы проекта, правит их, запускает команды и объясняет, что сделал. Проблема для тех, кто в России, одна и она не про установку: сервис отвечает отказом по региону. Ниже разбираем, как поставить сам инструмент, как он устроен в терминале, и как развести его трафик через прокси, не ломая настройки Windows.

Что такое Claude Code и чем он отличается от чата

В отличие от веб-чата, Claude Code живёт в терминале и имеет доступ к файловой системе проекта. Он умеет читать структуру репозитория, вносить правки сразу в несколько файлов, запускать тесты и линтеры, разбирать вывод и продолжать работу по результату. Внутри он может дробить задачу и запускать подагентов на отдельные подзадачи, например один разбирает тесты, другой правит модуль.

Подагенты работают в своём контексте и возвращают результат основному агенту, за счёт этого большая задача не забивает один общий контекст целиком. На практике это значит, что вы описываете цель, а не раскладываете её на шаги вручную: агент сам решает, где выгодно распараллелить работу.

По формату это ближе к парному программированию, чем к вопросу-ответу. Про сам инструмент и его команды мы подробнее пишем на странице claude code, здесь фокус на запуске из России.

Установка Claude Code

База для запуска, это Node.js. Claude Code ставится как npm-пакет, поэтому сначала нужен установленный Node LTS.

Порядок стандартный для всех платформ:

1. Поставьте Node.js LTS с официального сайта.
2. Установите CLI глобально через npm.
3. Запустите команду claude в каталоге вашего проекта.
4. При первом запуске пройдите авторизацию в аккаунте Anthropic.

Проверить, что Node встал, можно командой node -v, она должна вернуть номер версии. Если терминал пишет, что команда не найдена, значит Node не добавился в PATH: переоткройте терминал, а на Windows перезайдите в систему, чтобы переменные окружения подхватились. После установки CLI команда claude тоже должна отзываться из любого каталога.

На Linux и macOS всё работает нативно из терминала. На Windows Anthropic исторически рекомендовал запускать инструмент внутри WSL (подсистемы Linux), хотя нативная поддержка Windows тоже развивается. Если вы работаете через WSL, помните, что это отдельное сетевое окружение: трафик оттуда идёт своим путём, и его тоже придётся учитывать при настройке доступа.

Подробный разбор установки и загрузки собрали отдельно: claude code скачать.

Работа в терминале: первые команды

После запуска claude в корне проекта вы попадаете в интерактивную сессию. Дальше общение идёт обычным текстом: описываете, что нужно сделать, агент отвечает и предлагает изменения. Перед тем как что-то записать в файлы, он показывает diff и ждёт подтверждения.

Есть и служебные команды, которые начинаются со слэша. /help показывает список доступных команд, /clear очищает контекст текущей сессии, /init помогает собрать стартовый файл памяти проекта. Выход из сессии, это /exit или сочетание для прерывания в вашем терминале.

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

Первую задачу лучше ставить узкой и проверяемой. Не "перепиши проект", а "добавь обработку ошибки в этой функции и покрой тестом". Так проще увидеть, что агент понял вас правильно. Если результат не устроил, не переписывайте всё заново: уточните формулировку и попросите поправить конкретный кусок, агент помнит предыдущий шаг.

В редакторе всё то же самое доступно через расширение, про интеграцию мы пишем на странице vs code claude. Про подключение внешних инструментов и данных, смотрите claude code mcp.

Почему из России не запускается и что с этим делать

Сам CLI ставится и работает. Упирается всё в доступ: запросы к API Anthropic из российских адресов отклоняются по региону. Обычный системный VPN эту задачу решает грубо, он заворачивает весь трафик машины, включая то, чему это не нужно. Плюс Windows по умолчанию не умеет разводить трафик по приложениям: правило одно на всю систему.

Отсюда типичная неаккуратность. Вы поднимаете VPN, часть приложений внезапно ходит через чужой узел, а если VPN отвалился, трафик молча уходит обычным путём, и вы об этом не узнаете. Для инструмента, который сам ходит в сеть и правит ваш код, такая незаметная утечка это плохой сценарий.

Как мы решаем это в Proxy Control

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

Каналов четыре:

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

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

Неизвестное блокируется

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

Fail-closed вместо тихого отката

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

Проверка, а не вера в конфиг

Мы не красим статус в зелёный по факту наличия конфига. Три собственные пробы (копии curl, прибитые к каналам) запрашивают внешний IP и показывают три разных адреса. Если IP канала совпал с домашним, программа прямо пишет про утечку. Плюс есть живая сверка через локальный API sing-box: видно, каким каналом реально идёт каждый процесс, а не что записано в правилах.

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

Установка и запуск самой программы

Установка не требует интернета. Распакуйте архив и запустите Install.bat, Python и sing-box лежат внутри, ставить заранее ничего не нужно. Работает на Windows, привязка идёт по ключу вида CPC-XXXXXX-XXXXXX, один ключ на один компьютер. По ключу программа получает срок действия и персональные реквизиты прокси.

Туннель поднимается сам при запуске программы, старт проходит 15 шагов с проверками. Логика тут простая: весь перехват и вся блокировка делаются самим TUN. Пока sing-box не запущен, программа ничего не видит и ничего не закрывает, трафик идёт мимо неё. Поэтому состояния "программа работает, но всё заблокировано" не бывает. Если туннель поднять не удалось, на главном экране написано "маршрутизация выключена, программа сейчас ничего не перехватывает", с причиной.

Первый запуск удобно проверить так. Запустите claude в терминале и посмотрите на пробы внешнего IP. Клиент уже привязан к каналу прокси, менять ему ничего не нужно. Если у канала прокси адрес не российский и не совпадает с домашним, доступ разведён верно, и claude начнёт отвечать без отказа по региону.

После того как вы сменили канал у приложения, нажмите "Применить маршруты". Появится подтверждение с отсчётом 10 секунд, соединение на пару секунд прервётся и восстановится само.

Удаление

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

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

У Claude Code своя тарификация на стороне Anthropic, она зависит от плана и модели, детали и способы оплаты разбираем на странице claude code подписка. Работу по ключу и токенам смотрите в claude code api.

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

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

Нужно ли ставить Python и sing-box отдельно? Нет. Они лежат внутри архива, интернет при установке не требуется.

Будет ли работать OpenAI-инструментарий или другие CLI через тот же механизм? Да, канал назначается любому процессу по имени, привязки к конкретному вендору у маршрутизации нет. Логика одинакова и для Claude Code, и для других приложений, включая инструменты OpenAI.

Что с WSL? WSL, это отдельное сетевое окружение Linux внутри Windows. Если вы запускаете Claude Code там, учитывайте, что трафик подсистемы идёт своим путём, и его маршрутизацию нужно проверять отдельно.

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

Меняются ли системные настройки Windows? Нет. Мы не прописываем общесистемный прокси и не трогаем сетевые параметры системы, всё делается через отдельный TUN-адаптер и правила по процессам.