К содержимому

Claude Code прокси в WSL и Windows: HTTPS_PROXY, NO_PROXY

Claude Code чаще игнорирует прокси из-за того, что переменная задана не там, чем из-за самого прокси. Здесь — где её задавать в Windows и WSL и как проверить каждый шаг.

Три самые частые причины

Причина 1: переменная задана не там. Claude Code, запущенный в терминале WSL, — процесс Linux, поэтому переменная из Windows PowerShell до него не доходит, если не передать её через WSLENV. Верно и обратное. Переменные, экспортированные в оболочке, читаются один раз при запуске, а фоновые агенты запускает один общий процесс, поэтому надёжнее всего settings.json.

Причина 2: адрес действует только в Windows. В режиме NAT, который WSL использует по умолчанию, 127.0.0.1 внутри WSL — это сам WSL, так что прокси-клиент, слушающий 127.0.0.1 в Windows, там недоступен. Используйте IP хоста Windows или переключите WSL в режим mirrored, где 127.0.0.1 достаёт до серверов Windows.

Причина 3: URL в неподходящей форме. SOCKS не поддерживается, а URL без http:// останавливает запуск с ошибкой, в которой названа переменная.

Где задавать переменные

Где задавать переменные
ПунктГде задать переменнуюКак достать прокси-клиент в Windows
Windows напрямую (PowerShell)$env:HTTPS_PROXY на одну сессию или блок env в %USERPROFILE%\.claude\settings.json127.0.0.1 и порт прокси-клиента
WSL, режим NAT (по умолчанию)export в оболочке WSL или блок env в ~/.claude/settings.json внутри дистрибутива127.0.0.1 — это сам WSL; берите IP хоста Windows и разрешите клиенту принимать подключения с него
WSL, режим mirroredТо же127.0.0.1 достаёт до серверов Windows (Windows 11 22H2 и новее)
Значение из Windows в WSLWSLENV или autoProxy=true, чтобы скопировать сведения о HTTP-прокси WindowsДля внешнего прокси-хоста не требуется

По страницам Claude Code о сети и настройках и странице Microsoft о сети WSL, прочитано 15 ноября 2026. В новых версиях поведение может меняться.

Проверяйте в таком порядке

  1. Шаг 1: проверьте прокси без Claude Code

    В том же терминале, где запускаете claude, выполните curl -x с URL прокси к https://ipinfo.io/json. Если не работает, неверен адрес, порт, протокол или логин, и Claude Code тоже не подключится.

  2. Шаг 2: используйте HTTP-URL

    Пишите http://USERNAME:PASSWORD@HOST:PORT. Claude Code не поддерживает SOCKS. Если в пароле спецсимволы, закодируйте их через процентное кодирование.

  3. Шаг 3: задайте переменные там, где работает claude

    Используйте команды ниже для WSL или PowerShell. Добавьте NO_PROXY с локальными адресами, к которым обращаются ваши инструменты, например localhost и 127.0.0.1.

  4. Шаг 4: сделайте постоянно

    Запишите те же значения в блок env файла settings.json в этой системе. Если переменная уже задана в окружении запуска, значение из settings игнорируется, поэтому не задавайте разные значения в двух местах.

  5. Шаг 5: подтвердите, что использует Claude Code

    Запустите claude и выполните /status: в строке Proxy виден активный URL прокси. Для подробностей запустите claude --debug и прочитайте журнал.

WSL: переменные и проверка прокси

# Inside the WSL terminal, before you start claude
export HTTPS_PROXY="http://USERNAME:PASSWORD@HOST:PORT"
export HTTP_PROXY="$HTTPS_PROXY"
export NO_PROXY="localhost,127.0.0.1"

# What does the proxy show? (a wrong login or port fails here, not in Claude Code)
curl -sS -x "$HTTPS_PROXY" https://ipinfo.io/json

claude

Только пример. Замените USERNAME, PASSWORD, HOST и PORT своими.

Windows PowerShell

# Windows PowerShell, native Claude Code on Windows
$env:HTTPS_PROXY = "http://USERNAME:PASSWORD@HOST:PORT"
$env:HTTP_PROXY  = $env:HTTPS_PROXY
$env:NO_PROXY    = "localhost,127.0.0.1"
claude

Только пример. Действует в текущем окне PowerShell.

settings.json для любой системы

{
  "env": {
    "HTTPS_PROXY": "http://USERNAME:PASSWORD@HOST:PORT",
    "HTTP_PROXY": "http://USERNAME:PASSWORD@HOST:PORT",
    "NO_PROXY": "localhost,127.0.0.1"
  }
}

Только пример. Файл — ~/.claude/settings.json; в Windows это %USERPROFILE%\.claude\settings.json.

Режим mirrored и сведения о прокси Windows

# C:\Users\<you>\.wslconfig   (Windows 11 22H2 or later)
[wsl2]
networkingMode=mirrored
autoProxy=true

Только пример, со страницы Microsoft о WSL. После изменения перезапустите WSL.

Передача переменных из Windows через WSLENV

# PowerShell: pass variables from Windows into a WSL process
$env:HTTPS_PROXY = "http://USERNAME:PASSWORD@HOST:PORT"
$env:NO_PROXY    = "localhost,127.0.0.1"
$env:WSLENV      = "HTTPS_PROXY:NO_PROXY"
wsl claude

# WSL in the default NAT mode: the Windows host as seen from WSL
ip route show | grep -i default | awk '{ print $3}'

Иллюстрация. Последняя строка — команда из документации Microsoft для поиска IP хоста Windows из WSL.

Симптомы и решения

Claude Code запускается, но запросы зависают

Проверьте Переменная прокси не видна процессу или адрес работает только в Windows.

Решение Выполните /status и посмотрите строку Proxy. Если она пуста, задайте переменную там, где работает claude. Если значение есть, проверьте тот же URL через curl в этом же терминале.

Когда остановиться Если curl тоже не работает, чините сначала прокси: дело не в Claude Code.

Запуск останавливается с ошибкой с именем переменной

Проверьте URL прокси не разбирается, например в начале нет http://.

Решение Запишите полный URL: схема, логин, пароль, хост и порт.

Когда остановиться Не пробуйте socks5://: Claude Code не поддерживает SOCKS.

В PowerShell работает, в WSL нет

Проверьте Переменная не попала в WSL.

Решение Задайте её в оболочке WSL, в settings.json внутри дистрибутива или передайте через WSLENV.

Когда остановиться Проверьте, что одна и та же переменная не задана в двух местах с разными значениями.

После включения прокси сломались локальные инструменты

Проверьте Запросы к локальным серверам уходят на прокси.

Решение Добавьте локальные хосты в NO_PROXY, например localhost,127.0.0.1.

Когда остановиться Значение * используйте, только если ни один запрос не должен идти через прокси.

Proxy302 для Claude Code

Claude Code нужен URL HTTP-прокси, и его даёт HTTP-прокси Proxy302: хост proxy.proxy302.com, порт 2222, логин и пароль — в «Мои активы». Статический ISP IP остаётся неизменным весь срок аренды и не ротируется, так что у одного аккаунта один адрес. Прокси не меняет условия Anthropic: используйте Claude только там, где он поддерживается, — политика ограничивает использование людьми, физически находящимися в неподдерживаемом регионе. Если появится проверка, пройдите её честно; если страницы не открываются, сначала проверьте сеть и сам IP, затем создайте обращение с номером заказа.

Статический ISP IP стоит $0,50 за день и $7,99 за 30 дней, одинаково во всех странах, протокол выбирается для каждого IP при покупке. Автопродление необязательное, его можно выключить в «Мои активы». Бесплатного пробного периода нет, минимальная покупка — один IP на один день.

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

Поддерживает ли Claude Code прокси SOCKS5?

Нет. В сетевой документации Claude Code сказано, что SOCKS-прокси не поддерживаются, поэтому используйте URL HTTP-прокси.

Откуда Claude Code в WSL читает settings.json?

Из ~/.claude/settings.json в домашнем каталоге Linux того дистрибутива, где запущен claude. В Windows — из %USERPROFILE%\.claude\settings.json.

Обязательно ли задавать NO_PROXY?

Только для адресов, которые не должны идти через прокси, например локальных серверов. Принимается список через пробел или запятую, а * означает все запросы.

Почему прокси работает в curl, а в Claude Code нет?

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

Нужен ли режим mirrored?

Нет. Он позволяет достать Windows из WSL по 127.0.0.1 и требует Windows 11 22H2 или новее. Без него используйте IP хоста Windows.

Ссылки и источники

6
  1. Данные о продуктах и цены Proxy302

    Наблюдение за продуктом · Проверено:

    Файл фактов о продуктах сайта (значения сверены с консолью, бэкендом и прайсом 18-19 октября 2026): цены в долларах (1 PTC = $1), сроки аренды, протоколы и порты, бесплатного пробного периода нет.

  2. Документация Claude Code: сетевая конфигурация

    Официальная документация · Проверено:

    Прочитано 15 ноября 2026: Claude Code читает HTTPS_PROXY, HTTP_PROXY и NO_PROXY (через пробел или запятую, «*» — для всех) и их варианты в нижнем регистре; SOCKS-прокси не поддерживаются; логин и пароль указываются в URL прокси; переменные, экспортированные в оболочке, читаются один раз при запуске; те же переменные можно задать в settings.json; фоновые агенты обслуживает один общий процесс, поэтому переменные нужно задавать в блоке env файла ~/.claude/settings.json; в /status есть строка Proxy; URL прокси, который не разбирается (например, без http://), останавливает запуск; если переменная уже задана в окружении запуска, значение из файла настроек игнорируется.

  3. Документация Claude Code: файлы настроек и приоритет

    Официальная документация · Проверено:

    Прочитано 15 ноября 2026: пользовательский файл настроек — ~/.claude/settings.json; в Windows ~/.claude означает %USERPROFILE%\.claude; /status показывает, какие файлы настроек загружены; блок env в файле настроек — обычный ключ.

  4. Microsoft Learn: доступ к сетевым приложениям в WSL

    Официальная документация · Проверено:

    Прочитано 15 ноября 2026: WSL по умолчанию использует NAT; из Linux хост Windows доступен по своему IP, который показывает ip route show | grep -i default | awk '{ print $3}'; при networkingMode=mirrored (Windows 11 22H2 и новее) Linux обращается к серверам Windows по 127.0.0.1; autoProxy=true заставляет WSL использовать сведения о HTTP-прокси Windows.

  5. Блог Microsoft: общие переменные окружения для WSL и Windows

    Официальная документация · Проверено:

    Прочитано 15 ноября 2026: WSLENV — список имён переменных через двоеточие, которые передаются между процессами Windows и WSL; флаги /u (только при запуске WSL из Windows) и /w меняют направление.

  6. Anthropic: поддерживаемые регионы

    Официальная документация · Проверено:

    Прочитано 15 ноября 2026: политика ограничивает использование людьми, физически находящимися в неподдерживаемом регионе.

Готовы попробовать?

Создайте аккаунт, пополните баланс и выберите ротируемый резидентный, статический ISP или дата-центр IP — настроить его в браузере можно за несколько минут.