Прокси для Claude: Claude Code, приложение и claude.ai

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

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

Он не помогает, когда дело в аккаунте. Anthropic ограничивает свои продукты списком поддерживаемых стран, и политика написана про то, где находится человек и где зарегистрирована его организация, а не про то, с какого адреса пришёл пакет. За использование Claude из неподдерживаемого региона и за обход этого ограничения можно лишиться аккаунта. Прокси этого не меняет, и эта инструкция не про обход.

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

Поддерживаемые регионы Anthropic

У Claude три клиента, и общей сетевой настройки у них нет. Таблица выше даёт короткую версию, ниже разбор.

В браузере claude.ai слушается браузера. Chrome и Edge на Windows берут системную настройку, если её не перебивает расширение, и только расширение позволяет дать им SOCKS5 с паролем без дополнительных программ.

Приложение слушается системы. На Windows это поле прокси в сетевых настройках, которое ждёт HTTP-прокси с адресом и портом, поэтому SOCKS5 туда просто так не вписать.

Claude Code читает переменные окружения, и документация прямо говорит какие. Он берёт первое найденное значение в порядке https_proxy, HTTPS_PROXY, http_proxy, HTTP_PROXY. В NO_PROXY хосты перечисляются через пробел или запятую. Локальные адреса через прокси не идут никогда, их вписывать не нужно. Значения читаются один раз при запуске, и это обычная причина, по которой правка будто не действует. После смены переменных сессию надо перезапустить.

# Прокси с паролем, прямо в адресе
export HTTPS_PROXY=http://user:[email protected]:8080

Документация Claude Code по сети

В документации это одна строка: Claude Code не поддерживает SOCKS-прокси. Под запрет попадает формат, в котором прокси чаще всего и продаются, потому что по умолчанию поставщик выдаёт именно SOCKS5.

Обойти это можно двумя способами, и другой прокси для этого не нужен.

Первый способ: локальная точка входа по HTTP. На вашей машине что-то слушает 127.0.0.1 как HTTP-прокси и пересылает всё наверх в SOCKS5. Claude Code видит HTTP-прокси, поставщик по-прежнему видит SOCKS5. В Proxya Desktop это один переключатель, рецепт ниже.

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

До покупки стоит прочитать саму ошибку. Вот те, с которыми сюда приходят, и причины у них разные.

App unavailable in region или предупреждение, что Claude Code может быть недоступен в вашей стране. Это проверка региона, а не сети. Прокси её не решает, а попытка решить её так и ставит аккаунт под удар.

403 при входе. Иногда аккаунт, чаще сеть между вами и сервером. Сначала откройте claude.ai в обычном браузере на той же машине.

ECONNRESET, fetch failed, обрыв соединения. Поток рвёт что-то посередине. Так делает фильтрующая сеть, и так же ведёт себя адаптер VPN со сбитым размером пакета. Вот здесь чистый прямой адрес действительно помогает.

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

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

И ещё одна причина случайных сбоев: Claude Code нужен не только api.anthropic.com. В документации перечислены claude.ai, claude.com, platform.claude.com, sso.claude.com, downloads.claude.ai и bridge.claudeusercontent.com, а ещё github.com и реестр npm для обновлений и плагинов. Если через прокси пустить один хост, а остальные оставить, вход ломается по причинам, которые выглядят не связанными.

Proxya Desktop это наш клиент прокси для Windows и macOS. Принимает прокси любого поставщика, аккаунт Proxya не обязателен, программа бесплатная. Скачайте, установите и вставьте прокси.

Поля понимают форматы, в которых прокси выдают: host:port:login:password, полный адрес вида socks5:// и остальные. Кнопка буфера забирает хоть целый список. «Проверить» прогоняет прокси до сохранения и показывает, где на самом деле находится адрес, за сколько отвечает прокси и проходит ли через него UDP.

Оба режима ведут один и тот же трафик к одному и тому же прокси и отличаются тем, как ловят программы.

Туннель поднимает виртуальный сетевой адаптер. Он охватывает всё, включая терминал, и ему нужна небольшая служба, которую один раз ставят с запросом прав администратора. Именно в этом режиме Claude Code работает вообще без переменных.

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

В обоих режимах выбор программ один и тот же: все, все кроме выбранных или только выбранные. Чтобы через прокси шёл один Claude, возьмите «Только выбранные» и добавьте файлы программ. На Windows приложение называется Claude.exe, консольная утилита claude.exe. «Сайты через прокси» добавляет claude.ai, claude.com и anthropic.com по имени, и тогда они идут через прокси, даже если запросившая их программа не в списке.

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

С туннелем настраивать нечего. Подключились, открыли терминал, запустили Claude Code.

С системным прокси и SOCKS5 включите «Локальный прокси» в настройках. Приложение откроет 127.0.0.1:2080, этот порт принимает и HTTP, и SOCKS5, а наверх по-прежнему уходит SOCKS5. Дальше укажите Claude Code локальный адрес. На нашем ISP-прокси запрос через этот порт ушёл с адреса прокси, а api.anthropic.com ответил примерно за 1,2 секунды.

Переменные читаются при запуске, поэтому задавайте их до старта сессии. Если хочется, чтобы они пережили перезагрузку, те же значения кладутся в блок env файла настроек Claude Code.

# macOS и Linux, в той оболочке, где запускаете Claude Code
export HTTPS_PROXY=http://127.0.0.1:2080
export NO_PROXY="localhost,127.0.0.1,::1,*.local"

claude

# Windows PowerShell, для текущего окна
$env:HTTPS_PROXY = "http://127.0.0.1:2080"
$env:NO_PROXY = "localhost,127.0.0.1,::1,*.local"

claude

{
  "env": {
    "HTTPS_PROXY": "http://127.0.0.1:2080",
    "NO_PROXY": "localhost,127.0.0.1,::1,*.local"
  }
}

DNS. «Разрешает прокси» стоит по умолчанию и оставляет разрешение имён внутри соединения с прокси, поэтому имена за вас не разрешает ваш провайдер. Выбор Cloudflare, Google, Quad9 или AdGuard переключает на DNS over HTTPS через тот же прокси, и в наших замерах это добавляет около 0,6 секунды на первый запрос к новому сайту.

Маскировка. Соединение с SOCKS5 или HTTP-прокси не шифруется, и некоторые сети читают оттуда две вещи: адрес назначения в рукопожатии и имя сайта в первом пакете внутри потока. Маскировка разрезает и то и другое на два пакета со случайной паузой, так что целиком не уходит ничего. Включена по умолчанию. Шифрованием она не является, а замеры мы снимали на Телеграме и Instagram в фильтрующей сети, не на Claude.

Kill Switch. Пока он взведён, трафик мимо адаптера туннеля блокируется, и упавший движок означает отсутствие связи, а не тихий выход напрямую. Только Windows.

IPv6 выключен по умолчанию. Включать его стоит, только если прокси везёт IPv6, иначе половина соединений уходит в никуда.

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

ISP-прокси, которые в другом месте продают как статические резидентские, подходят ровно под это. Адрес зарегистрирован на интернет-провайдера и остаётся вашим весь срок, оплата идёт за прокси, трафик не считают, цена от $2.50/прокси в мес. у нас. Для аккаунта, в который вы входите каждый день, берите этот тип.

Резидентские прокси меняют адреса через домашние подключения и оплачиваются за гигабайт, от $2.40/ГБ у нас. Они хороши для сбора данных по многим странам и плохи для того, чтобы оставаться в сессии: адрес меняется под вами.

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

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

ISP-проксиРезидентские проксиДокументация по подключению

Сборки для Windows x64 и macOS на Apple Silicon выложены вместе с контрольными суммами SHA-256. Установщик для Windows пока без сертификата подписи, поэтому SmartScreen покажет неизвестного издателя. Сверьте сумму, потом выберите «Подробнее» и «Выполнить в любом случае».

Kill Switch есть только на Windows. Сборка для macOS не поддерживает компьютеры на Intel. Туннелю нужна служба, которую ставят один раз с запросом прав администратора, системному прокси не нужно ничего.

Пароли прокси и сессия аккаунта лежат на диске зашифрованными, ключ хранится в диспетчере учётных данных Windows или в связке ключей macOS, поэтому копия папки на другой машине не даёт ни того, ни другого.

Скачать Proxya Desktop