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

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

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

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

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

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 — отдельная сетевая среда, и канал ему назначается отдельно от программ хоста.

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

Запускается 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: он снимает туннель, правило брандмауэра, задания планировщика, ярлык и папку продукта. Лицензия при этом остаётся привязанной к компьютеру.

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

Программа Proxy Control стоит 500 ₽ в месяц, оплата помесячно. Все цены на странице Услуги и цены. Регистрация через почту или Telegram-бота, поддержка в Telegram.

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

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

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

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