Настройка Anthropic Claude Code и маршрутизация трафика в Windows

Claude Code, это CLI-инструмент от Anthropic для работы с моделями Claude прямо из терминала. Он ставится через npm, запускается в консоли и общается с API по сети. На Windows у него две отдельные сложности: аккуратно поставить окружение (Node.js, npm, при желании WSL) и обеспечить доступ к API, который в России упирается в блокировку по региону.

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

Что такое Claude Code и что ему нужно от системы

Это консольный клиент. Вы даёте ему задачу текстом, он читает файлы проекта, предлагает правки, запускает команды. Всё это работает поверх обращений к API Anthropic, поэтому без стабильного сетевого доступа инструмент бесполезен.

Модельный ряд включает семейство Opus и более лёгкие модели. Opus тяжелее и дороже по токенам, его обычно берут под сложные задачи, где важнее качество рассуждения, чем скорость. Выбор модели на установку не влияет, но влияет на расход по API.

Минимальные требования по окружению: установленный Node.js актуальной LTS-версии и npm, который идёт вместе с ним. На Windows работает как нативный запуск через PowerShell или cmd, так и вариант внутри WSL.

Установка Node.js

Claude Code ставится пакетным менеджером npm, а npm приходит вместе с Node.js. Поэтому первым делом ставим Node.

Скачайте LTS-сборку с nodejs.org и пройдите обычный установщик. После установки проверьте версии в терминале:

node -v
npm -v

Обе команды должны вернуть номер версии. Если node не распознан, перезапустите терминал, чтобы подхватился обновлённый PATH, либо перезайдите в систему.

Несоответствие версии Node.js

Частая причина ошибок при запуске, слишком старый Node. Если npm ругается на движок (engine) или инструмент падает сразу после старта, обновите Node до текущей LTS. Если на машине несколько версий, используйте менеджер версий (nvm-windows) и переключитесь на LTS перед установкой.

Установка Claude Code через npm

Пакет ставится глобально, одной командой:

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

После установки проверьте, что бинарь доступен:

claude --version

Если команда не находится, проверьте, что каталог глобальных пакетов npm попал в PATH. Путь можно узнать через npm config get prefix. На Windows глобальные бинарники npm лежат в этом каталоге, и именно он должен быть в переменной окружения.

Не запускайте установку под sudo или из-под администратора без необходимости: глобальный каталог npm при этом может встать в системную папку, и потом права будут мешать обновлениям.

Настройка Windows: нативно или через WSL

Есть два рабочих пути.

Нативно в Windows. Node ставится в систему, Claude Code запускается из PowerShell или cmd. Проще в настройке, работает с файлами проекта напрямую по путям Windows.

Через WSL. Внутри дистрибутива Linux (обычно Ubuntu) вы получаете привычное Unix-окружение: bash, привычные пути, инструменты сборки. Многим удобнее держать проект и Node именно в WSL. Учтите, что WSL, это отдельная сетевая среда со своим стеком, и доступ к API там настраивается отдельно от хоста.

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

Настройка аутентификации

После установки инструмент нужно связать с аккаунтом или ключом. При первом запуске claude проведёт вас через вход. Дальше всё упирается в одно: запрос на серверы Anthropic должен дойти. Из России прямое обращение к API часто блокируется по региону, и тогда вход просто виснет или отдаёт ошибку сети, а не проблему авторизации.

Именно здесь чаще всего застревают: окружение поставлено правильно, а инструмент не может достучаться до API. Разводкой трафика мы и займёмся ниже.

Тестовые команды и запуск

Запуск из каталога проекта:

cd path\to\project
claude

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

Доступ к API из России без системного VPN

Обычный способ решить блокировку, включить VPN на весь компьютер. Но тогда через удалённый узел идёт весь трафик, включая то, чему это не нужно: другие сервисы, обновления, локальные сервисы разработки. Мы сделали Proxy Control, чтобы разводить трафик по приложениям, а не гнать всё в один туннель.

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

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

Для Claude в программе канал зафиксирован на прокси, сменить его нельзя. Это защита от ситуации, когда трафик инструмента случайно уходит домой или в VPN и запрос палит регион. Живая сверка через локальный API sing-box показывает, каким каналом реально идёт каждый процесс, а не что написано в конфиге.

Почему неизвестное блокируется

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

Если прокси недоступен, прокси-приложения уходят в блок, а не домой (fail-closed). Пока туннель пересобирается, ставится блокирующее правило брандмауэра: трафик встаёт на несколько секунд, но не утекает мимо маршрутов. Для приложений на прокси заблокированы UDP и IPv6, иначе QUIC ушёл бы мимо HTTP-прокси; DNS работает по DoH.

Как проверить, что нет утечки

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

Установка и запуск Proxy Control

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

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

После смены канала у приложения нажмите «Применить маршруты»: появится подтверждение с отсчётом 10 секунд. Запущенный Claude Code переживёт короткую паузу и восстановит соединение сам.

Удаление

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

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

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

Работает ли это в WSL? WSL, это отдельная сетевая среда. Планируя доступ, учитывайте, что маршрутизация процессов Windows и процессов внутри WSL настраивается по-разному.

Почему инструмент не выходит в сеть после установки Proxy Control? Скорее всего процесс ещё в статусе «ожидает» и ему не назначен канал, либо прокси недоступен и сработал fail-closed. Проверьте статус процесса в списке и состояние проб.

Сколько стоит подписка? Помесячно 495 ₽/мес, при оплате за год от 395 ₽/мес. Есть тарифы на 2, 3, 6 и 12 месяцев.

Вопросы по установке и доступу разбираем в поддержке в Telegram, регистрация через почту или бота.