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

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

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

Что такое Claude Code и как он работает

Это CLI-инструмент для работы с кодом из командной строки. Вы описываете задачу словами, а он редактирует файлы проекта, запускает тесты, объясняет чужой код и предлагает патчи. В отличие от расширений редактора, он живёт в терминале, поэтому одинаково ложится и на локальную разработку, и на удалённый сервер по SSH.

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

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

Подробный разбор самого инструмента мы вынесли на отдельную страницу: claude code. Здесь сосредоточимся на установке, командах и сетевом доступе.

Требования и подготовка системы

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

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

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

Базовый набор команд, который встречается в любом гайде:

запуск сессии в текущем каталоге и постановка задачи обычным текстом;
анализ кодовой базы: попросить объяснить, как устроен модуль или где обрабатывается конкретный запрос;
правка файлов с показом диффа перед применением;
запуск тестов и команд сборки с разбором вывода.

Отдельно про тестовый прогон, с которого удобно начинать знакомство. Заведите небольшой проект или откройте существующий и попросите объяснить, что делает конкретный файл. Так вы проверите две вещи сразу: что инструмент видит кодовую базу и что сеть до серверов доходит. Если ответ пришёл осмысленный, доступ есть; если запрос завис, дело в маршрутизации, а не в самом CLI.

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

Настройки: settings и setup

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

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

Если вы работаете с корпоративным контуром или используете совместимый доступ, часть маршрутизации задаётся через настройки окружения. Разбор этого варианта вынесен в claude code api, там же про то, как не перепутать адрес API и не отправить трафик мимо нужного канала.

Использование из России: проблема доступа

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

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

Как Proxy Control направляет трафик терминала

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

Каналов шесть:

Дом — обычный интернет вашего провайдера.
Прокси — выход через купленный адрес.
VPN — через ваш собственный узел.
За IP — закрепление за конкретным выходным адресом: две программы получают разные адреса и выглядят снаружи как два разных человека.
Блок — соединение отклоняется.
Спросить — для новых программ: пока не решите, программа никуда не пойдёт.

Подробный разбор всех возможностей — на странице что умеет программа. Если нужно, чтобы несколько браузеров выходили с разных адресов, это отдельная тема: разные IP для разных браузеров. Важная деталь про терминал. Если вы запускаете CLI внутри WSL, для системы это отдельный процесс, и канал ему назначается по его имени. Неизвестное блокируется: приложение, которому канал не назначен, в интернет не выйдет. Новые программы появляются в списке со статусом «ожидает», и вы распределяете их вручную. Это сделано намеренно, лучше явный отказ, чем незаметная утечка мимо прокси.

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

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

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

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

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

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

Отдельно про сам Claude Code как поток трафика: канал ему назначаете вы, как и любой другой программе. Обычно это «Прокси» — на домашнем канале он упрётся в блокировку по региону.

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

Установка простая: распаковать архив и запустить Install.bat. Всё нужное уже лежит внутри архива, интернет при установке не нужен, ставить заранее ничего не требуется.

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

Состояний у программы четыре, и они независимы. Окно может быть открыто, но пока защита не включена, перехвата нет. Пока защита включена, программа видит и блокирует трафик. Канал VPN доступен, когда есть пойманные узлы; без них остальные каналы работают. И отдельно состояние доступности прокси-сервера, от которого зависит запуск Claude.

Если на старте один из 15 шагов падает, программа показывает, на каком именно этапе споткнулась. Чаще всего это ожидание адаптера или проверка прокси. В первом случае помогает перезапуск: канал соберётся заново. Во втором проверьте ключ и срок подписки, потому что доступ к прокси программа получает именно по ключу. Если проба прокси показывает домашний IP, значит трафик пока не встал на нужный канал, и запускать Claude рано.

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

Цена

Программа Proxy Control стоит 500 ₽ в месяц, оплата помесячно. Все цены на странице Услуги и цены. Что именно входит и как оформить, разобрано в claude code подписка.

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

?Нужен ли VPN на весь Windows, чтобы поднять Claude Code?

Нет, и это как раз то, чего мы стараемся избежать. Через прокси уходит только назначенный терминал, остальные приложения идут своим каналом.

?Работает ли это с WSL?

Да. Терминал внутри WSL для системы отдельный процесс, ему назначается канал по имени. Если процесс новый, он появится в списке со статусом «ожидает», назначьте ему нужный канал и нажмите «Применить маршруты».

?Что будет, если прокси отвалится посреди работы?

Прокси-приложения уйдут в блок, а не домой. Соединение прервётся явно, утечки в домашний канал не случится.

?Установка CLI прошла, а вход в аккаунт висит. В чём дело?

Это типичная картина для доступа из России: установщик скачивается, а серверы авторизации не отвечают. Лечится не настройками CLI, а маршрутизацией терминала через прокси.

?Можно ли использовать инструмент в редакторе, а не в терминале?

Про связку с редактором и расширения мы написали отдельно в vs code claude. Логика доступа та же: маршрутизируется процесс, который ходит в сеть.

Если остаётся вопрос по доступу из России именно к серверам ИИ, а не к самому CLI, посмотрите claude code в россии. Поддержка у нас в Telegram, регистрация через почту или бота.

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

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

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