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

Codex network proxy: что это и как настроить в config.toml

Network proxy в Codex не предназначен для выбора страны выхода. Здесь — что это, какие ключи им управляют и что проверить, если команда не открывает сайт.

Два разных явления называются прокси

Первое — network proxy Codex: слушатель на вашем компьютере (по умолчанию http://127.0.0.1:3128, SOCKS5 — на 8081), который стоит между командами в песочнице и интернетом и сверяет каждый адрес назначения с вашими правилами доменов.

Второе — внешний прокси-сервер, например статический ISP IP: трафик идёт через него и выходит с другого адреса. Это задаётся переменными окружения вроде HTTPS_PROXY, а не features.network_proxy. Дальше речь только о первом.

Какая настройка за что отвечает

Какая настройка за что отвечает
ПунктНастройкаЧто меняет
Сеть для команд[sandbox_workspace_write] network_access = true или permissions.<имя>.network.enabled = trueРазрешает командам в песочнице пользоваться сетью вообще. В песочнице workspace-write она по умолчанию выключена.
Правила доменовfeatures.network_proxy с enabled = true и domainsРазрешает или запрещает адреса, когда сеть уже включена. Сам прокси доступ не открывает.
Внешний прокси для запросов CodexHTTPS_PROXY в окруженииНаправляет запросы через прокси-сервер. К features.network_proxy не относится.
Страна выходаПрокси-сервер, через который вы идётеЭто не настройка Codex. Страну определяет IP внешнего прокси.

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

Как сочетаются сеть и прокси

Как сочетаются сеть и прокси
ПунктСетьNetwork proxyРезультат
Случай 1Выкл.Вкл.Сеть остаётся выключенной, прокси ничего не делает
Случай 2Вкл.Выкл.Команды достигают любых адресов, правила доменов не применяются
Случай 3Вкл.Вкл.Трафик идёт по вашим правилам доменов, неразрешённые адреса отклоняются

Со страницы о подтверждениях, прочитано 15 ноября 2026. Без единого правила allow внешние адреса не разрешены.

Включите и проверьте

  1. Шаг 1: разрешите сеть для команд

    Задайте network_access = true в [sandbox_workspace_write] или включите сеть в профиле разрешений, который используете.

  2. Шаг 2: включите прокси и перечислите хосты

    Добавьте [features.network_proxy] с enabled = true и карту domains. Можно писать точные хосты, *.example.com только для поддоменов, **.example.com для домена и его поддоменов. Если хост попал и в allow, и в deny, побеждает deny.

  3. Шаг 3: перезапустите Codex и проверьте

    Начните новую сессию, выполните в ней три проверки ниже и сравните ответы со своими правилами.

  4. Шаг 4: держите правила узкими

    Справочник допускает глобальное *, но страница о подтверждениях советует правила с ограниченной областью. Добавляйте хосты по мере реальной нужды.

Пример config.toml

# ~/.codex/config.toml

# 1) Let commands in the workspace-write sandbox use the network at all
[sandbox_workspace_write]
network_access = true

# 2) Start the network proxy so domain rules are enforced (experimental)
[features.network_proxy]
enabled = true
domains = { "api.openai.com" = "allow", "*.github.com" = "allow", "example.com" = "deny" }

Только пример. Ключи взяты из справочника конфигурации Codex; хосты — заглушки, подставьте свои.

Проверка из сессии

# Inside a Codex session, ask it to run these and read the answers:
curl -sS -o /dev/null -w "%{http_code}\n" https://api.openai.com/v1/models   # 401 = reachable (no key sent)
curl -sS -o /dev/null -w "%{http_code}\n" https://example.org/               # blocked if not on the allow list
curl -sS https://ipinfo.io/json                                               # which exit IP do commands use?

Только пример. Ответ 401 от api.openai.com без ключа значит, что хост доступен; третья строка показывает IP выхода, который используют команды.

Если команда не открывает сайт

Прокси включён, а все запросы падают

Проверьте Возможно, сама сеть выключена: прокси доступ не открывает. Проверьте network_access или network.enabled профиля.

Решение Включите сеть, перезапустите Codex и проверьте снова.

Когда остановиться Если сеть включена, хост разрешён, а ошибка остаётся, проверьте тот же хост без прокси, чтобы исключить свою сеть.

Отклоняется один хост

Проверьте В domains нет правила allow для него, либо под него подходит deny, а deny приоритетнее.

Решение Добавьте точное правило allow или сузьте шаблон deny.

Когда остановиться Не добавляйте глобальное allow * ради одного хоста.

Отклоняется localhost или локальный адрес

Проверьте allow_local_binding по умолчанию false и блокирует loopback и частные адреса.

Решение Добавьте точное правило allow для нужного локального адреса или включайте allow_local_binding, только понимая, что это открывает.

Когда остановиться На общих машинах оставьте выключенным.

Веб-поиск или инструмент MCP игнорирует правила

Проверьте Правила доменов не охватывают веб-поиск, приложения, MCP и другие размещённые инструменты.

Решение Управляйте ими их собственными настройками.

Когда остановиться Не рассчитывайте, что правила доменов их ограничат.

Где нужен внешний прокси

Если вы входите в Codex под аккаунтом ChatGPT и хотите стабильный, чистый выход, это делается внешним прокси, а не этой настройкой. Статический ISP IP остаётся неизменным весь срок аренды и не ротируется, так что у одного аккаунта один адрес. Прокси не меняет условия OpenAI: используйте Codex только там, где OpenAI его поддерживает, — OpenAI предупреждает, что использование сервисов из других мест может привести к блокировке или приостановке аккаунта. Если появится проверка, пройдите её честно.

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

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

Что такое network proxy в Codex?

Экспериментальный, по умолчанию выключенный локальный прокси для команд в песочнице. Он применяет правила allow и deny, которые вы пишете в features.network_proxy.

Скрывает ли Codex network proxy мой IP или меняет страну?

Нет. Он фильтрует адреса назначения. IP выхода определяется сетью компьютера или внешним прокси, который вы задали через HTTPS_PROXY.

Нужен ли он, чтобы использовать внешний прокси?

Нет. Задайте HTTPS_PROXY для запросов самого Codex, как в руководстве. Network proxy нужен только для правил доменов для команд.

Почему мои правила доменов ничего не делают?

Правила применяются, только когда прокси включён, а прокси имеет смысл, только когда включена сеть для команд. Проверьте оба пункта.

Управляет ли он веб-поиском и трафиком MCP?

Нет. Справочник указывает, что правила доменов не охватывают веб-поиск, приложения, MCP и другие размещённые инструменты.

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

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

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

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

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

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

    Прочитано 15 ноября 2026: features.network_proxy помечен как экспериментальный и выключен по умолчанию; enabled, domains (allow или deny, deny приоритетнее, точные хосты, *.example.com, **.example.com, *), proxy_url по умолчанию http://127.0.0.1:3128, socks_url по умолчанию http://127.0.0.1:8081, allow_local_binding по умолчанию false, allow_upstream_proxy по умолчанию true; permissions.<name>.network.enabled не запускает network proxy; правила доменов не охватывают веб-поиск, приложения, MCP и другие размещённые инструменты.

  3. Документация Codex: подтверждения и безопасность

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

    Прочитано 15 ноября 2026: сеть в песочнице workspace-write выключена, пока не задано network_access = true; features.network_proxy сам по себе доступ в сеть не даёт; сеть включена и прокси выключен — без ограничений; сеть и прокси включены — трафик идёт по политике доменов.

  4. OpenAI API: поддерживаемые страны и территории

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

    Прочитано 15 ноября 2026: использование сервисов в странах и на территориях вне списка поддерживаемых может привести к блокировке или приостановке аккаунта.

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

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