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

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

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 их требует. Проще перенастроить её на папку внутри своей домашней, чем ставить пакет от администратора.

После успешной установки команда 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 перехватывает весь исходящий трафик компьютера и раздаёт его по вашим правилам. То есть вы решаете для каждой программы отдельно, каким путём ей выходить в сеть.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Если после настройки Claude Code молчит, начните с проверок в самой программе. Посмотрите, показывает ли проверка прокси адрес, отличный от домашнего. И сверьте в списке, каким каналом программа идёт на самом деле. Чаще всего причина видна там.

Proxy Control для Windows

Программа разводит трафик по приложениям: ИИ-инструменты идут через прокси, остальное напрямую. Подписка от 395 ₽ в месяц при оплате за год.

Скачать для Windows