Настройка сетевого доступа для Claude Code CLI

5 мин чтенияобновлено 19 августа

Claude Code работает в терминале и выходит в интернет сам по себе. Из России он упирается в отказ по стране: запросы уходят, ответ не приходит.

Решать это включением VPN на весь компьютер неудобно: следом за терминалом туда уедут браузер, обновления Windows и рабочие сервисы, которым в прокси не нужно. Задача другая: пустить через прокси только терминал. Ниже, как поставить сам Claude Code и как развести его доступ отдельно от всего остального.

Установка Claude Code CLI на Windows

Claude Code CLI ставится через npm, поэтому сначала нужен Node.js. Скачайте LTS-версию с nodejs.org и поставьте обычным инсталлятором, он сам пропишет node и npm в PATH. Проверить можно командой node -v в новом окне терминала.

Сам CLI ставится глобально:

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

После установки в PATH появляется команда запуска. Если терминал её не видит, перезапустите окно: переменная PATH подхватывается при старте оболочки.

WSL или нативный Windows

Часть разработчиков ставит Claude Code в WSL, а не в нативный Windows. Это законный вариант: внутри WSL у вас полноценный Linux, и установка идёт как на Ubuntu (та же команда, тот же npm install -g). Но с точки зрения сети WSL создаёт отдельный стек, и трафик из него не всегда очевидно совпадает с тем, что вы видите в проводнике Windows. Если планируете разводить доступ по приложениям, проще держать CLI в нативном Windows: там процесс называется предсказуемо и его легко привязать к каналу.

Запуск и первые команды

Запускается CLI из каталога проекта. Перейдите в рабочую директорию и выполните команду запуска (команда claude), при первом старте он попросит авторизацию. Дальше вы работаете с ним в диалоге: просите разобрать код, внести правку, написать тест. Claude Code видит файлы проекта, умеет работать с Git и выполнять команды в вашем окружении.

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

Если на этом шаге запросы к API не проходят, а сам CLI установлен корректно, дело почти всегда в доступе по региону. Здесь и подключается маршрутизация трафика.

Почему общий VPN мешает работе

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

Windows сам так не умеет. У системы нет штатного механизма развести исходящий трафик по именам процессов, есть только маршрутизация по адресам и интерфейсам, а это не про приложения.

Как мы разводим трафик по приложениям

Proxy Control перехватывает весь исходящий трафик компьютера и раздаёт его по вашим правилам. У каждого приложения свой канал:

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

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

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

Защита от утечек трафика

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

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

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

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

Установка простая: распакуйте архив и запустите Install.bat. Всё нужное уже лежит внутри архива, интернет при установке не нужен, ставить заранее ничего не требуется. Для работы нужен ключ вида CPC-XXXXXX-XXXXXX, один ключ на один компьютер: по нему программа получает срок действия и персональные реквизиты прокси.

Туннель поднимается сам при запуске программы, старт проходит 15 шагов с проверками. После того как вы поменяли канал у приложения, нажмите «Применить маршруты»: появится подтверждение с отсчётом 10 секунд. Соединение на пару секунд прервётся и восстановится само.

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

Подписка и поддержка

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

Если ещё выбираете инструмент, посмотрите смежные материалы: где скачать Claude Code, работа с API, варианты подписки и связка с VS Code.