Использование Claude Code в Windows: настройка и маршрутизация трафика

Claude Code, это терминальный инструмент от Anthropic для работы с кодом: агент запускается в консоли, читает ваш проект, правит файлы и выполняет команды. Работает через модели Claude по API. Из России основная сложность не в установке, а в доступе: запросы к серверам блокируются по региону, и вместо ответа модели вы получаете ошибку соединения или 403.

На этой странице разберём, как поставить Claude Code в Windows, какие команды и режимы у него есть, сколько это стоит, и как развести трафик так, чтобы терминал ходил через прокси, а остальные приложения на машине остались на обычном интернете. Последнюю задачу решает наш продукт Proxy Control, про него ниже отдельно.

Что такое Claude Code и зачем он в терминале

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

Работает поверх моделей семейства Claude. Внутри агента можно выбирать модель под задачу: более быстрая для рутины, более сильная (Opus) для сложной архитектурной работы. Подробнее про выбор в разделе claude code модели, а про ключи и лимиты, в материале про claude code api.

Есть и вариант работы прямо из редактора: расширение для VS Code разбирается на странице vs code claude. Механика доступа там та же, что и у терминала.

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

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

Официально Claude Code рассчитан на Unix-окружение, поэтому на Windows его обычно ставят через WSL (Windows Subsystem for Linux). Порядок такой:

1. Включите WSL и поставьте дистрибутив (например Ubuntu) командой wsl --install в PowerShell от администратора, затем перезагрузитесь.
2. Внутри WSL установите Node.js (Claude Code, это npm-пакет).
3. Поставьте сам пакет через npm install -g @anthropic-ai/claude-code.
4. Запустите claude в папке проекта и пройдите авторизацию.

Перед шагом 3 проверьте версию Node командой node -v: если она старая, npm откажется ставить пакет и выдаст ошибку про несовместимую версию. В этом случае обновите Node внутри WSL и повторите установку. Ещё одна частая заминка, права: если npm install -g падает с ошибкой доступа, значит глобальная папка npm требует прав, и её проще перенастроить на каталог внутри домашней директории, чем ставить пакет от root.

После успешной установки команда claude --version покажет номер версии, а claude без аргументов запустит агента в текущей папке. Если консоль отвечает command not found, перезапустите терминал WSL: путь к глобальным пакетам npm подхватывается при новом старте оболочки.

Ссылки на актуальные установщики и официальную документацию собраны на странице claude code скачать. Мы не дублируем чужие инструкции целиком: они меняются от версии к версии, и лучше сверяться с первоисточником.

Важный момент, который редко упоминают в гайдах: авторизация и первый же запрос уходят на серверы Anthropic. Если вы в России и без прокси, установка пройдёт, а вот запуск, скорее всего, упрётся в блокировку. То есть npm install может отработать без единой ошибки, а claude на первом запросе к модели повиснет или вернёт 403. Не тратьте время на переустановку пакета: проблема не в нём, а в маршруте трафика, и решается она отдельно, ниже по тексту.

Первые шаги с проектом и базовые команды

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

Из того, что пригодится в первые минуты:

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

Про CLAUDE.md стоит сказать отдельно: это самый простой способ задать агенту рамки один раз, а не повторять их в каждом запросе. В файл кладут стиль кода, используемый фреймворк, команды сборки и тестов, запреты вроде «не трогай папку с миграциями». Агент читает его при старте сессии и держит в контексте. Чем точнее описаны правила проекта, тем меньше правок придётся откатывать вручную.

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

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

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

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

Мы не приводим здесь конкретных цифр: у Anthropic они меняются, и любой фиксированный ценник в тексте быстро устареет. Актуальные тарифы и способы оплаты из России разбираем на странице claude code подписка. Там же про то, чем отличается оплата по API от подписки и что выгоднее при разной нагрузке.

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

Отдельная проблема для России, это сама оплата: карты российских банков Anthropic не принимает. Это не тема доступа к сети, а вопрос платёжного средства, и решается он иначе, чем маршрутизация трафика.

Почему из России Claude Code не отвечает

Типичная картина: установка прошла, claude запускается, но на первом же запросе виснет или отдаёт ошибку. Часто это HTTP 403 или обрыв соединения. Причина в блокировке по региону: серверы Anthropic не обслуживают запросы из России.

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

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

Как развести трафик по приложениям через Proxy Control

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

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

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

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

Claude всегда идёт через прокси, и этот канал у него сменить нельзя. Так мы защищаемся от ситуации, когда агент случайно уходит в канал Дом или в VPN и отдаёт запрос по адресу, который заблокирован.

Fail-closed вместо тихой утечки

Если прокси недоступен, Claude и прокси-приложения уходят в блок, а не домой. Если умер узел VPN, то же самое для VPN-приложений. Мы считаем, что лучше явный обрыв, чем запрос, ушедший мимо нужного маршрута.

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

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

Проверка, а не покраска в зелёный

Маршрут можно назначить, а по факту трафик пойдёт не туда. Поэтому в продукте есть проверки, а не просто галочка «настроено».

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

Запуск Claude Code под контролем маршрутов

Туннель поднимается сам при запуске программы. Старт проходит 15 шагов с проверками: сборка конфига, его проверка, старт sing-box, ожидание появления адаптера, проверка прокси и VPN, запуск Claude и контроль, что его трафик действительно ушёл в прокси.

Пока идёт старт, кнопка запуска погашена и показывает номер шага, например Запускаю… 11/15. В этот момент не запускайте Claude вручную: программа откроет его сама, иначе получите два процесса.

Если вы поменяли канал у какого-то приложения, нажмите «Применить маршруты». Появится подтверждение с отсчётом 10 секунд. Claude на это время теряет соединение и восстанавливается сам, закрывать его не нужно.

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

Установка и лицензия Proxy Control

Ставится продукт без интернета. Распакуйте архив и запустите Install.bat. Python и sing-box лежат внутри, ничего доустанавливать заранее не нужно.

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

Подписка: 495 ₽/мес при помесячной оплате, от 395 ₽/мес при оплате за год. Есть тарифы на 2, 3, 6 и 12 месяцев. Регистрация через почту или бота, поддержка в Telegram.

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

Нужен ли системный VPN, если стоит Proxy Control? Нет. Смысл продукта в том, чтобы через прокси шёл именно Claude Code и другие назначенные вами приложения, а остальной трафик оставался на обычном интернете провайдера. Системный VPN заворачивает всю машину целиком, здесь этого не происходит.

Что будет с Claude Code, если прокси отвалится? Запросы уйдут в блок, а не в канал Дом. Это защита от утечки: лучше явный обрыв, чем запрос, ушедший на заблокированный адрес открытым каналом. Когда прокси восстановится, запуск снова станет доступен.

Можно ли назначить Claude другой канал? Нет. Claude жёстко привязан к прокси, сменить канал у него нельзя. Это сделано осознанно, чтобы агент не ушёл случайно домой или в VPN.

Windows 10 и Windows 11 поддерживаются? Продукт рассчитан на Windows. Сам Claude Code на Windows обычно запускают через WSL, механика доступа при этом не меняется: трафик процесса всё равно проходит через TUN-адаптер и раздаётся по правилам.

Аналоги Claude Code существуют? Да, есть другие терминальные агенты для работы с кодом. Проблема доступа из России у них общая: если сервис блокирует запросы по региону, помогает именно маршрутизация трафика конкретного приложения через прокси, а не выбор другого инструмента.

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

Если после настройки Claude Code всё равно не отвечает, начните с проверок внутри Proxy Control: посмотрите, показывает ли проба прокси внешний IP, отличный от домашнего, и сверьте по локальному API, каким каналом реально идёт процесс. Чаще всего причина видна там.