Прокси для Codex CLI: как настроить и избежать распространённых ошибок

Основные переменные окружения для прокси

Инструменты командной строки обычно считывают стандартные переменные окружения для прокси; уточните в документации вашей версии Codex CLI, какие именно он использует. На практике хватает двух переменных — HTTPS_PROXY и NO_PROXY.

HTTPS_PROXY указывает адрес прокси для HTTPS-запросов (именно по этому протоколу работает API OpenAI). Формат значения: http://хост:порт. SOCKS5-прокси Codex CLI не поддерживает, поэтому берите IP с протоколом HTTP (у Proxy302 это порт 2222). Если прокси требует аутентификацию, логин и пароль встраиваются прямо в URL: http://логин:пароль@хост:порт.

HTTP_PROXY используется для обычных HTTP-запросов. В большинстве случаев достаточно одного HTTPS_PROXY, но если заданы обе переменные, каждая применяется к запросам своего типа.

ALL_PROXY работает как универсальный запасной вариант: если для конкретного протокола переменная не задана, используется ALL_PROXY. Это удобно, когда у вас один прокси для всего трафика.

NO_PROXY (или no_proxy) — это список хостов и доменов, к которым нужно подключаться напрямую, минуя прокси. Стандартные значения: localhost,127.0.0.1. Если у вас есть внутренние сервисы или домены корпоративной сети, добавьте их в этот список через запятую.

• Источники:
• Исходный код Codex (openai/codex): исходящий прокси

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

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

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

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

Настройка в macOS и Linux

Для временной настройки в текущей сессии терминала используйте команду export:

Настройка в macOS и Linux: пример

export HTTPS_PROXY="http://логин:пароль@прокси-хост:порт"
export NO_PROXY="localhost,127.0.0.1"

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

Настройка в macOS и Linux, продолжение

Чтобы сделать переменные постоянными, добавьте строки export в файл профиля вашей оболочки. Для Bash это ~/.bash_profile или ~/.bashrc, для Zsh — ~/.zshrc. После сохранения файла перезапустите терминал или выполните source ~/.bashrc.

Проверить, что переменные установлены, можно командой env | grep -i proxy.

Настройка в Windows PowerShell

В PowerShell текущая сессия использует синтаксис с $env::

Настройка в Windows PowerShell: пример

$env:HTTPS_PROXY = "http://логин:пароль@прокси-хост:порт"
$env:NO_PROXY = "localhost,127.0.0.1"

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

Постоянная настройка в Windows через setx

Для постоянной настройки применяйте команду setx, которая записывает переменные в реестр пользователя:

Постоянная настройка в Windows через setx: пример

setx HTTPS_PROXY "http://логин:пароль@прокси-хост:порт"
setx NO_PROXY "localhost,127.0.0.1"

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

• Источники:
• Microsoft Learn: setx

После setx: перезапуск и системные переменные

После выполнения setx перезапустите PowerShell, чтобы изменения вступили в силу. Для системных переменных (доступных всем пользователям) запустите PowerShell от имени администратора и используйте [System.Environment]::SetEnvironmentVariable().

Проверка страны выхода перед использованием

Перед отправкой запросов проверьте, какой IP и какую страну на самом деле даёт прокси: так вы убедитесь, что трафик идёт через него. Простейший способ — выполнить запрос через прокси к любому сервису геолокации IP:

Проверка страны выхода перед использованием: пример

curl -x "http://логин:пароль@прокси-хост:порт" https://ipinfo.io/json

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

Проверка страны выхода перед использованием, продолжение

В ответе поле ip — это IP выхода, который видит OpenAI, а поле country — его страна. Если адрес не тот, что вы ждали, трафик идёт мимо прокси: проверьте переменные ещё раз.

Какие страны поддерживаются, подробно описано в руководстве по странам, где работают ChatGPT, Claude и Gemini.

• руководстве по странам, где работают ChatGPT, Claude и Gemini

Почему страна выхода важна для OpenAI API

OpenAI публикует список стран и территорий, где работает её API. Запросы из неподдерживаемого региона получают ответ с кодом 403 и текстом ошибки «Country, region, or territory not supported».

Прокси меняет только сетевой адрес, видимый сервису. Решение о доступе принимает сама платформа на основе IP-адреса и других факторов, и прокси не меняет условий OpenAI. OpenAI предупреждает, что использование сервисов вне списка поддерживаемых стран может привести к блокировке или приостановке аккаунта. При входе через аккаунт ChatGPT действует список стран ChatGPT, при входе по API-ключу — список стран OpenAI API.

Для Codex CLI у Proxy302 берите IP с протоколом HTTP на порту 2222; хост, логин и пароль показаны в разделе «Мои активы».

• Источники:
• OpenAI API: поддерживаемые страны и территории
• Документация Codex: аутентификация

Аутентификация в URL прокси

Если прокси требует логин и пароль, передавайте их прямо в URL переменной окружения:

Аутентификация в URL прокси: пример

HTTPS_PROXY=http://пользователь:пароль@хост:порт

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

Аутентификация в URL прокси, продолжение

Пароль может содержать специальные символы (@, :, /, ?, #, %), которые имеют смысл в URL. Их нужно экранировать в кодировке URL (процентное кодирование): @ превращается в %40, : в %3A, / в %2F и так далее. Например, если пароль my@pass:123, в URL он должен выглядеть как my%40pass%3A123.

Распространённые ошибки и их исправление

Ошибка 407 Proxy Authentication Required. Прокси получил запрос, но не принял учётные данные. Проверьте правильность логина и пароля в URL, убедитесь, что специальные символы экранированы. Если проблема остаётся, уточните у администратора прокси, какой тип аутентификации он требует.

Ошибки сертификатов. Если корпоративный прокси подменяет сертификаты, укажите путь к PEM-файлу с корневым сертификатом компании в переменной CODEX_CA_CERTIFICATE до запуска codex login, например export CODEX_CA_CERTIFICATE="$HOME/certs/corp-root.pem". Если переменная не задана, Codex использует SSL_CERT_FILE.

Таймауты. Если запросы висят и не завершаются, скорее всего прокси не настроен или адрес указан неверно. Проверьте переменные командой env | grep -i proxy, убедитесь, что в URL указана схема (http://), а порт и хост доступны.

Ошибка «Country, region, or territory not supported». Код 403 означает, что OpenAI не поддерживает регион, из которого приходит запрос; прокси это не меняет. OpenAI предупреждает, что использование сервисов вне списка поддерживаемых стран может привести к блокировке или приостановке аккаунта.

Подробная настройка под OpenAI API описана на странице «Прокси для OpenAI API». Для Claude Code действует тот же подход, см. руководство «Настройка прокси для Claude Code».

• странице «Прокси для OpenAI API»
• руководство «Настройка прокси для Claude Code»

• Источники:
• Документация Codex: аутентификация
• OpenAI API: поддерживаемые страны и территории

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

MCP добавляет Codex CLI новые инструменты. Сервер proxy302-mcp позволяет получить прокси Proxy302 и открывать страницы через него. Добавьте его одной командой или впишите ту же запись в ~/.codex/config.toml.

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

Это отдельная настройка, не связанная с переменными прокси на этой странице. HTTPS_PROXY определяет, как сам Codex CLI выходит к OpenAI; у инструментов MCP-сервера свои настройки, и установка сервера не меняет подключение самого Codex. Список инструментов, другие клиенты и ограничения — в руководстве по MCP-серверу Proxy302.

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

• Источники:
• Codex docs: Model Context Protocol
• README proxy302-mcp (официальный MCP-сервер Proxy302)

Прокси-инструмент для Codex CLI через MCP: codex mcp add

codex mcp add proxy302 --env PROXY302_API_KEY="<key id>:<secret>" -- npx -y github:proxy302/proxy302-mcp

Замените <key id>:<secret> на ваш API-ключ Proxy302.

• Источники:
• Codex docs: Model Context Protocol

Прокси-инструмент для Codex CLI через MCP: config.toml

[mcp_servers.proxy302]
command = "npx"
args = ["-y", "github:proxy302/proxy302-mcp"]
env = { PROXY302_API_KEY = "<key id>:<secret>" }

Та же запись в файле настроек. Замените <key id>:<secret> на ваш API-ключ Proxy302.

• Источники:
• Codex docs: Model Context Protocol

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

Аренда статического ISP подходит для такого порядка работы: IP фиксирован на весь срок аренды и не ротируется, поэтому один адрес остаётся за одним аккаунтом или инструментом. На странице прокси для OpenAI API есть готовые пресеты и полная настройка, а на странице статического ISP описан сам продукт.

• прокси для OpenAI API
• странице статического ISP

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

1. Шаг 1

   Откройте страницу статического ISP, выберите страну, срок, количество и протокол — HTTP или SOCKS5. Протокол фиксируется для каждого IP при покупке.

2. Шаг 2

   Создайте IP, затем откройте «Мои активы» (раздел консоли со всем, что вы купили) и скопируйте HOST, PORT, USERNAME и PASSWORD. На странице «Инструменты» есть готовый пример с вашими данными.

3. Шаг 3

   Введите данные в профиль браузера, программу или телефон, которые будут использовать этот IP.

4. Шаг 4

   Проверьте выход через прокси с помощью https://ipinfo.io/json. Поле country должно соответствовать выбранной вами стране.

5. Шаг 5

   Из материкового Китая сначала запустите программу «Proxy302 Быстрое подключение» на странице «Инструменты» и держите её открытой, пока работает прокси.

   • Руководство по программе «Proxy302 Быстрое подключение»

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

Статический ISP-IP стоит $0,50 за один день и $7,99 за 30 дней, около $0,27 в день, во всех странах одинаково. Доступность меняется ежедневно и отображается на странице заказа. Бесплатного пробного периода нет, а минимальная покупка — один IP на один день. IP не снимает ограничений, не отменяет блокировки и не повышает лимиты.

• Ограниченный бюджет? Выберите обычный статический резидентный IP

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

Proxy302 коротко

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

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

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

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

Прокси для OpenAI API

Россия не входит в список стран OpenAI API. Фиксированный дата-центровый IP в поддерживаемой стране: прокси в Python или Node SDK и постоянный адрес для белого списка IP.

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

Прокси для Claude Code: настройка

Как запустить Claude Code за HTTP-прокси: HTTPS_PROXY, NO_PROXY, settings.json для фоновых агентов и проверка, что всё работает.

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

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

Статические ISP-прокси

Фиксированные статические ISP-прокси: IP резидентного уровня, неизменный весь срок. Для аккаунтов в соцсетях, магазинов и AI-сервисов. HTTP и SOCKS5.

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

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

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