Полное руководство по настройке прокси для Codex: терминал, npm, Git и WSL2

Если вы пишете код с Codex в сети с ограничениями, без настройки прокси не обойтись. Переменные окружения терминала, зеркала npm, прокси для Git, сетевые режимы WSL2 — стоит ошибиться хотя бы в одном месте, и Codex зависнет в вечном «подключении». В этом руководстве мы последовательно разберём каждый уровень настройки и покажем, как TeamoRouter заметно упрощает весь процесс.

Зачем Codex настройка прокси

Codex взаимодействует с ИИ-сервисами через API OpenAI и GitHub. Из-за сетевых ограничений в некоторых регионах прямое подключение часто нестабильно или недоступно вовсе. Поэтому прокси приходится настраивать сразу на нескольких уровнях:

Уровень терминала: переменные окружения для HTTP-запросов Codex CLI
Уровень менеджера пакетов: настройки источников npm/pip для установки зависимостей
Уровень Git: сетевые каналы, через которые Codex забирает код и отправляет изменения
Уровень IDE: сетевые настройки плагинов в редакторах вроде VS Code
Уровень WSL2: сетевой мост между Windows Subsystem for Linux и хостом

Способ проще: единый доступ к моделям через TeamoRouter

Прежде чем разбираться с каждым уровнем прокси по отдельности, стоит рассмотреть вариант аккуратнее — использовать TeamoRouter как единый API-шлюз.

TeamoRouter предоставляет API-эндпоинты, доступные напрямую из Китая. Достаточно изменить в конфигурации Codex значение baseUrl — и настраивать прокси для API OpenAI больше не нужно. Прокси для терминала, npm и Git по-прежнему понадобятся для доступа к GitHub и другим ресурсам, но уровень общения с моделью станет намного проще.

С TeamoRouter той же конфигурацией можно подключить ещё и Claude Code, и Gemini CLI — одна настройка, несколько агентных инструментов.

Ключевые преимущества:

Доля попаданий в кэш >99% — молниеносные ответы
Плавающая ставка — от 10%-20% от официальной цены
SLA 99.98% для непрерывности бизнеса
Квота 5000 QPM для частых вызовов в команде
100% совместимость с протоколами Agent API, правка конфигурации в одну строку

Почему в браузере работает, а в Codex — нет

Многие разработчики замечают: браузер спокойно открывает OpenAI, а Codex в терминале подключиться не может. Вот почему:

Браузеры используют системные настройки прокси или VPN и автоматически обрабатывают и HTTP-, и HTTPS-трафик
Codex CLI работает в терминале, который по умолчанию не наследует системные настройки прокси
У браузеров есть автоматические PAC-скрипты прокси и резервные механизмы WebRTC; у терминалов их нет
Среда выполнения Node.js в Codex использует модули http/https, которым для работы через прокси нужны переменные окружения HTTP_PROXY

Это различие и объясняет, почему явная настройка прокси в терминале обязательна.

Настройка прокси в терминале

Прокси в терминале — основа всего. Добавьте эти переменные в конфигурационный файл оболочки (~/.zshrc, ~/.bashrc или ~/.bash_profile):

bash

# HTTP/HTTPS proxy
export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890
export http_proxy=http://127.0.0.1:7890
export https_proxy=http://127.0.0.1:7890

# Bypass proxy for internal addresses
export NO_PROXY=localhost,127.0.0.1,::1,10.0.0.0/8,192.168.0.0/16
export no_proxy=localhost,127.0.0.1,::1,10.0.0.0/8,192.168.0.0/16

Примените настройки командой source ~/.zshrc и проверьте:

bash

# Verify proxy is active
curl -I https://api.openai.com

# Check current proxy settings
echo $HTTP_PROXY
echo $HTTPS_PROXY

Примечание: 127.0.0.1:7890 — порт по умолчанию для Clash, ShadowSocks и подобных прокси-инструментов. Подставьте значения своей конфигурации.

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

bash

HTTP_PROXY=http://127.0.0.1:7890 HTTPS_PROXY=http://127.0.0.1:7890 codex "your prompt"

Настройка прокси для npm

Codex автоматически устанавливает зависимости во время работы. Если npm не использует прокси, установка будет мучительно медленной или вовсе завершится ошибкой.

Глобальные настройки прокси npm:

bash

npm config set proxy http://127.0.0.1:7890
npm config set https-proxy http://127.0.0.1:7890

Просмотр и удаление настроек прокси:

bash

# View
npm config get proxy
npm config get https-proxy

# Remove
npm config delete proxy
npm config delete https-proxy

Зеркало реестра npm (рекомендуется для Китая):

bash

# Use Taobao mirror
npm config set registry https://registry.npmmirror.com

# Restore official registry
npm config set registry https://registry.npmjs.org

Проверенная конфигурация прокси npm:

bash

npm config set proxy http://127.0.0.1:7890
npm config set https-proxy http://127.0.0.1:7890
npm config set registry https://registry.npmmirror.com

Настройка прокси для Git

Прокси для Git критически важен, когда Codex нужен доступ к репозиториям GitHub.

Глобальные настройки прокси:

bash

# HTTP/HTTPS proxy
git config --global http.proxy http://127.0.0.1:7890
git config --global https.proxy http://127.0.0.1:7890

# Verify
git config --global --get http.proxy
git config --global --get https.proxy

Прокси для конкретного домена (только GitHub):

bash

git config --global http.https://github.com.proxy http://127.0.0.1:7890
git config --global https.https://github.com.proxy http://127.0.0.1:7890

Удаление прокси:

bash

git config --global --unset http.proxy
git config --global --unset https.proxy

Настройка прокси в WSL2

У WSL2 особая сетевая архитектура, которая требует отдельного подхода.

Способ 1: проброс прокси с хоста

Запустите прокси-инструмент (например, Clash) на хосте Windows, затем получите IP хоста в WSL2:

bash

# In WSL2
export host_ip=$(cat /etc/resolv.conf | grep nameserver | awk '{print $2}')
export HTTP_PROXY=http://$host_ip:7890
export HTTPS_PROXY=http://$host_ip:7890

Добавьте автоматическую настройку в ~/.bashrc внутри WSL2:

bash

# WSL2 auto proxy
function set_proxy() {
    export host_ip=$(cat /etc/resolv.conf | grep nameserver | awk '{print $2}')
    export HTTP_PROXY=http://$host_ip:7890
    export HTTPS_PROXY=http://$host_ip:7890
    export http_proxy=http://$host_ip:7890
    export https_proxy=http://$host_ip:7890
    echo "Proxy set to $HTTP_PROXY"
}

function unset_proxy() {
    unset HTTP_PROXY HTTPS_PROXY http_proxy https_proxy
    echo "Proxy unset"
}

Способ 2: запуск прокси прямо в WSL2

Установите Clash или другой прокси-инструмент внутри WSL2 — так конфигурация получается проще:

bash

# Install clash in WSL2
wget https://github.com/Dreamacro/clash/releases/...
# After configuration
export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890

Настройка прокси в IDE

Настройки прокси VS Code:

Пропишите в settings.json VS Code:

json

{
    "http.proxy": "http://127.0.0.1:7890",
    "http.proxyStrictSSL": false,
    "http.proxySupport": "on"
}

Либо найдите «proxy» в интерфейсе настроек VS Code.

Настройка base URL в Codex

Независимо от настроек прокси убедитесь, что Codex корректно подключается к API-эндпоинту. С TeamoRouter это ещё проще:

bash

# Set baseUrl to TeamoRouter endpoint
export CODEX_BASE_URL=https://api.teamorouter.com/v1

# Set API Key
export CODEX_API_KEY=your-teamorouter-key

Так отпадает необходимость в отдельной настройке прокси для API OpenAI: эндпоинты TeamoRouter доступны из Китая напрямую.

Устранение типичных ошибок

Ошибка	Вероятная причина	Решение
`connect ETIMEDOUT`	Тайм-аут подключения к прокси	Проверьте адрес и порт прокси
`connect ECONNREFUSED`	Прокси-сервис не запущен	Запустите прокси-инструмент
`self signed certificate`	Ошибка SSL-сертификата	Задайте `NODE_TLS_REJECT_UNAUTHORIZED=0` (только для тестов)
`network read timeout`	Нестабильная сеть	Переключитесь на более стабильный прокси-узел
`getaddrinfo ENOTFOUND`	Сбой разрешения DNS	Задайте `export NODE_OPTIONS=--dns-result-order=ipv4first`

Итоги

Настройка прокси — базовый навык для работы с Codex в сетях с ограничениями. Настройте все пять уровней — терминал, npm, Git, WSL2 и IDE, — чтобы разработка шла без заминок. TeamoRouter кардинально упрощает прокси-уровень общения с моделью, и вы можете сосредоточиться на коде, а не на борьбе с сетевыми настройками.

FAQ

В: Я настроил прокси, но тайм-ауты остались. Что делать? О: Сначала убедитесь, что прокси-инструмент запущен (curl -I https://www.google.com), затем проверьте, что порт в HTTP_PROXY совпадает с портом вашего прокси-инструмента.

В: npm install работает слишком медленно. Что можно сделать? О: Настройте зеркало реестра командой npm config set registry https://registry.npmmirror.com и проверьте, что настройки прокси npm заданы верно.

В: Нужны ли мне эти прокси, если я использую TeamoRouter? О: TeamoRouter решает задачу доступа к API моделей из Китая. Прокси для терминала, npm и Git по-прежнему нужны для доступа к GitHub и другим ресурсам. Зато настройку прокси специально для API OpenAI можно полностью пропустить.

В: Могут ли WSL2 и Windows использовать один и тот же прокси? О: Напрямую — нет. WSL2 нужна собственная настройка прокси: обычно через проброс IP хоста (способ 1) либо запуск прокси внутри WSL2 (способ 2).

В: Как проверить, что baseUrl в Codex настроен правильно? О: Выполните codex "hello" --verbose и посмотрите в логе, совпадает ли URL API-запроса с заданным baseUrl.

С чего начать

Зарегистрируйтесь в TeamoRouter и получите API-ключ
Следуйте руководству по установке Codex, чтобы настроить baseUrl и API-ключ
Запустите свою первую задачу в Codex

Настроить Codex бесплатно →

Стабильный доступ к Codex, Claude Code и Gemini CLI через TeamoRouter.

Готовы подключиться?Войдите в консоль, пополните баланс и создайте API-ключ.

Получить API-ключ Открыть документацию