Как настроить прокси для Claude Code: HTTPS_PROXY, NO_PROXY и settings.json

Переменные окружения, которые считывает Claude Code

В таблице перечислены переменные и то, что о каждой сказано в документации. Строчные названия тоже работают. Claude Code использует первую найденную из установленных в таком порядке: https_proxy, HTTPS_PROXY, http_proxy, HTTP_PROXY. Его WebSocket-соединения с localhost, ::1 и 127.0.0.0/8 никогда не проходят через прокси, поэтому отдельной записи для петлевого интерфейса в NO_PROXY не требуется.

• Источники:
• Документация Claude Code: корпоративная сетевая конфигурация

Переменные окружения, которые считывает Claude Code: сравнение

Сводка по странице документации Claude Code, указанной ниже, прочитана 22 октября 2026. Фразы в кавычках взяты из документации.

Только HTTP-прокси, без SOCKS

Документация говорит об этом прямо: Claude Code не поддерживает SOCKS-прокси. Адрес SOCKS5 здесь не подойдёт, поэтому используйте прокси с протоколом HTTP. Если прокси требует расширенной аутентификации, например NTLM или Kerberos, документация советует использовать вместо него сервис LLM-шлюза.

URL прокси с логином и паролем

При базовой аутентификации учётные данные указываются прямо в URL, как в примере ниже.

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

URL прокси с логином и паролем: пример

export HTTPS_PROXY=http://username:[email protected]:8080

Только пример: замените значения-заглушки своими.

Установите переменные перед запуском

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

В командной строке Windows (cmd) для текущего сеанса используйте set HTTPS_PROXY=http://username:[email protected]:8080.

Установите переменные перед запуском: macOS, Linux, WSL

# macOS, Linux, WSL
export HTTPS_PROXY=http://username:[email protected]:8080
claude

Только пример: замените значения-заглушки своими.

Установите переменные перед запуском: Windows PowerShell

# Windows PowerShell
$env:HTTPS_PROXY = "http://username:[email protected]:8080"
claude

Только пример: замените значения-заглушки своими.

Сделайте настройку постоянной в settings.json

Каждую переменную окружения из документации можно также задать в settings.json. Это важно для фоновых агентов. Процесс-супервизор для каждого пользователя обслуживает сеансы, запущенные через claude agents, --bg и /background. Он живёт дольше вашего шелла и наследует окружение того шелла, из которого был запущен первым, поэтому переменная, экспортированная только в вашем шелле, попадёт к фоновым агентам лишь случайно. В документации сказано, что только настройки доходят до каждого фонового сеанса.

Добавьте блок ниже в ~/.claude/settings.json или в управляемые настройки (managed settings), если их развёртывает администратор.

• Источники:
• Документация Claude Code: корпоративная сетевая конфигурация

Сделайте настройку постоянной в settings.json: пример

{
  "env": {
    "HTTPS_PROXY": "http://username:[email protected]:8080"
  }
}

Только пример: замените значения-заглушки своими.

Дополнительные центры сертификации

По умолчанию Claude Code доверяет встроенным сертификатам Mozilla и хранилищу сертификатов вашей операционной системы. В документации сказано, что корпоративные прокси с инспекцией TLS работают без дополнительной конфигурации, если их корневой сертификат установлен в хранилище доверенных сертификатов системы и Claude Code может его прочитать. Нативный установщик всегда это умеет. Для установок через npm нужен Node версии 22.15 или новее. В противном случае укажите путь к файлу сертификата через NODE_EXTRA_CA_CERTS, как показано ниже.

Это нужно только прокси, которые инспектируют трафик. Обычному прокси без инспекции это не требуется.

Дополнительные центры сертификации: пример

export NODE_EXTRA_CA_CERTS=/path/to/ca-cert.pem

Только пример: замените значения-заглушки своими.

Проверка того, что действительно использует Claude Code

Claude Code не проверяет большинство сетевых настроек при их чтении. Единственное исключение — URL прокси: если Claude Code не может разобрать значение, например из-за отсутствия http://, он останавливается при запуске и сообщает, какую переменную нужно исправить. Для проверки остального:

• Запустите /status в интерактивном сеансе. Строка Proxy показывает активный URL прокси и помечает значение, которое не может разобрать, как недействительное и игнорируемое.

• Запустите claude --debug. Журнал сохраняется в ~/.claude/debug/<session-id>.txt или по пути, который вы задали через --debug-file.

• Протестируйте сам прокси из терминала командой ниже: так вы увидите выходной IP, страну и сеть, которые увидят сайты.

Поля ip, country, city и org разобраны в руководстве по проверке IP, страны и провайдера вашего прокси.

• проверке IP, страны и провайдера вашего прокси

• Источники:
• Документация Claude Code: корпоративная сетевая конфигурация

Проверка того, что действительно использует Claude Code: пример

curl -x http://username:[email protected]:8080 https://ipinfo.io/json

Только пример: замените значения-заглушки своими.

Если соединение не устанавливается

• Claude Code останавливается при запуске: в URL прокси отсутствует схема. Укажите полный URL в формате http://....

• Ошибка 407 Proxy Authentication Required: прокси отклонил логин или пароль. Скопируйте их заново, не вводите вручную.

• Указан адрес SOCKS5: не поддерживается. Используйте HTTP-прокси.

• Работает в вашем шелле, но не в фоновом агенте: задайте переменную в settings.json.

• На пути стоит межсетевой экран: в документации перечислены хосты, которые нужны Claude Code, включая api.anthropic.com, claude.ai и platform.claude.com. Разрешите их в правилах прокси.

Как это сделать с Proxy302

Для этой задачи подходит статический ISP-прокси: IP выделяется вам на весь срок аренды и не меняется, а при покупке вы выбираете HTTP — протокол, который нужен Claude Code. Пресет Claude в консоли по умолчанию использует SOCKS5, поэтому перед генерацией переключите «Протокол» на HTTP. На странице прокси для Claude есть готовый пресет и полная инструкция по настройке. Таблица ниже — наши последние почасовые проверки Claude через выходы в семи странах, с указанием сети каждого выхода и времени ответа сайта.

• прокси для Claude

Измеренные выходы: Claude из семи стран

Почасовая проверка зонда Proxy302, 22 октября 2026, 14:18 UTC: по одному запросу к Claude из каждой страны через динамический резидентный выход, по публичной точке входа Proxy302. Публично показаны только первые три октета IP. Один замер на страну, не среднее; следующие проверки будут отличаться.

• Источники:
• Почасовая проверка связности Proxy302

Как это сделать с Proxy302: шаги

1. Шаг 1

   Откройте страницу статических ISP-прокси, выберите страну, укажите «Протокол» HTTP, «Срок» и «Количество», затем нажмите «Проверить цену и создать».

2. Шаг 2

   Откройте «Мои активы» и скопируйте HOST, PORT, USERNAME и PASSWORD. На странице «Подключение» показан готовый пример с вашим собственным эндпоинтом.

3. Шаг 3

   Задайте HTTPS_PROXY=http://USERNAME:PASSWORD@HOST:PORT в вашем шелле или в блоке env в ~/.claude/settings.json.

4. Шаг 4

   Запустите claude, выполните /status и проверьте выход через команду curl выше.

Цены и ограничения

Стоимость одного статического ISP-IP составляет $0,50 за один день и $7,99 за 30 дней, примерно $0,27 в день, при этом цена одинаковая во всех странах. Доступность меняется ежедневно и показывается на странице заказа. Бесплатного пробного периода нет, минимальная покупка — один IP на один день. Прокси меняет только сетевой выход: правила Anthropic по поддерживаемым регионам всё равно применяются к вам, как объясняется в руководстве по поддерживаемым странам для Claude, ChatGPT и Gemini.

• поддерживаемым странам для Claude, ChatGPT и Gemini

• Источники:
• Факты о продуктах и прайс Proxy302

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

Читайте дальше

Прокси для Claude

Прокси для Claude Code и Claude: статический ISP-IP, настройка HTTP для Claude Code (без SOCKS), один IP на человека — и что правила Anthropic значат для России.

Посмотреть параметры и цену

Где работают ChatGPT, Claude и Gemini

Сравнили четыре официальных списка: Россия и Беларусь не входят ни в один. Ошибки, проверка IP и наши ежечасные проверки из 7 стран.

Как проверить прокси: IP, страна, провайдер

Как за 30 секунд проверить IP, страну и провайдера прокси, почему сервисы расходятся в городе и что значит «чистота» IP. С нашей проверкой трёх сервисов.

Прокси в Cursor: настройка

Прокси в Cursor через http.proxy, спецсимволы в пароле, переключение на HTTP/1.1, если зависает стриминг, и проверка через Run Diagnostics.