Как настроить прокси для 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: корпоративная сетевая конфигурация

Если HTTP-прокси не подключается

У некоторых провайдеров соединение с HTTP-прокси (порт 2222) обрывается ещё до ответа шлюза, а SOCKS5 (порт 3333) работает. Протокол задаётся при покупке или создании прокси.

Claude Code принимает только HTTP, поэтому SOCKS5 подключают через локального посредника. Возьмите прокси с протоколом SOCKS5, добавьте его в Clash Verge Rev как узел type: socks5 и укажите в HTTPS_PROXY локальный адрес Clash, например http://127.0.0.1:7897 (это mixed-port из примера Clash Verge Rev, у вас он может быть другим). Тогда Claude Code обращается по HTTP только к вашему компьютеру, а до Proxy302 соединение идёт по SOCKS5.

• Настройка Clash Verge Rev

Переменные окружения, которые считывает 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. Разрешите их в правилах прокси.

Прокси-инструмент для Claude Code через MCP

MCP добавляет Claude Code новые инструменты. Сервер proxy302-mcp позволяет получить прокси Proxy302 и открывать страницы через него прямо из чата, не переключаясь в консоль. Команда ниже подключает его для всех ваших проектов.

proxy302-mcp — официальный MCP-сервер Proxy302 с открытым кодом на GitHub, его поддерживает команда Proxy302. Proxy302 также держит его по адресу https://proxy302.com/v1/mcp: клиенты, которые умеют передавать заголовок Authorization, например Claude Code, Cursor и VS Code, подключаются по API-ключу без установки.

Это отдельная настройка, не связанная с остальной частью страницы. Прокси, через который сам Claude Code выходит к Anthropic, задаётся переменной HTTPS_PROXY, как описано выше; у инструментов MCP-сервера свои настройки, и установка сервера не меняет подключение самого Claude Code. Список инструментов, другие клиенты и ограничения — в руководстве по MCP-серверу Proxy302.

• Руководство по MCP-серверу Proxy302

• Источники:
• Claude Code docs: Connect Claude Code to tools via MCP
• README proxy302-mcp (официальный MCP-сервер Proxy302)

Прокси-инструмент для Claude Code через MCP: команда

claude mcp add proxy302 -s user -e PROXY302_API_KEY="<key id>:<secret>" -- npx -y github:proxy302/proxy302-mcp

Замените <key id>:<secret> на ваш API-ключ Proxy302. -s user делает сервер доступным во всех проектах; без него Claude Code добавит его только в текущий проект.

• Источники:
• Claude Code docs: Connect Claude Code to tools via MCP

Как это сделать с 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
• Ограниченный бюджет? Выберите обычный статический резидентный IP

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

Proxy302 коротко

Цены указаны в PTC и списываются с кошелька; 1 PTC = 1 доллар США. Бесплатного пробного периода нет: минимальная покупка — 1 ГБ ротируемого резидентного трафика или один IP на один день. Проверено 4 ноября 2026 г.

• Источники:
• Факты о продуктах и прайс Proxy302
• Proxy302 ISP for AI subscriptions: public catalog

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

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

Прокси для Claude

Прокси для Claude — это ISP для Claude: выделенный нативный IP в США, Франкфурте, Японии или Лондоне, 15 PTC за 30 дней, HTTP для Claude Code — и правила Anthropic.

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

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

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

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

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

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

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

Прокси MCP-сервер

Что такое прокси MCP-сервер, чем отличаются локальные и удалённые MCP-серверы, как установить его в Claude Code, Codex CLI и Cursor и как направить собственный трафик сервера через прокси.