Руководство по установке Codex CLI: macOS / Windows / Linux (2026)

Codex CLI — консольный ИИ-инструмент для программирования от OpenAI: с ним разработчики пишут, изменяют и отлаживают код на естественном языке прямо в терминале. Но у разработчиков из регионов с сетевыми ограничениями установка часто превращается в череду проблем: npm install зависает намертво, загрузки из GitHub Release обрываются по тайм-ауту, а успешно установленный инструмент не может подключиться к API. В этом руководстве — полное прохождение установки на всех платформах и объяснение того, как TeamoRouter одним шагом снимает сетевое узкое место.

Почему в Китае установка Codex CLI часто не удаётся

Загрузка зависимостей и вызовы API в Codex CLI завязаны на зарубежные сервисы. В условиях китайской сети вы столкнётесь с несколькими типичными препятствиями:

• Ограничение скорости реестра npm: реестр по умолчанию registry.npmjs.org работает из Китая ненадёжно — npm install -g @openai/codex может раз за разом падать по тайм-ауту.
• Медленная загрузка из GitHub Release: готовые бинарные файлы размещены на GitHub, где скорость скачивания нередко падает до десятков КБ/с.
• Недоступные зависимости с CDN: Codex CLI динамически подтягивает зависимости JS-рантайма с CDN вроде esm.sh и deno.land, которые тоже ограничены.
• Нет соединения с API после установки: по умолчанию CLI подключается к api.openai.com, а прямые подключения из Китая часто заканчиваются потерей пакетов или ETIMEDOUT, так что успешная установка оказывается бесполезной.

Эти проблемы накладываются друг на друга: вы всё установили, но подключиться не можете, а настройка прокси нередко конфликтует с локальным портом CLI. Разберём их по порядку, начиная с основ.

Что понадобится

Проверьте, установлен ли Node.js

node --version
# Должно вывести v18.x.x или выше
npm --version
# Должно вывести 9.x.x или выше

Если Node.js не установлен, скачайте LTS-версию с nodejs.org.

Установка на macOS

Способ 1: глобальная установка через npm (рекомендуется)

# Задаём зеркало реестра npm (необходимо в китайских сетях)
npm config set registry https://registry.npmmirror.com

# Устанавливаем Codex CLI глобально
npm install -g @openai/codex

# Проверяем установку
codex --version

Если npm install -g выдаёт ошибку прав доступа EACCES, исправьте глобальный путь npm или используйте вместо этого npx: npx @openai/codex --version.

Способ 2: Homebrew

brew install openai/codex/codex

В Китае сначала настройте зеркала Homebrew:

export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.ustc.edu.cn/brew.git"
brew update
brew install openai/codex/codex

Способ 3: GitHub Release

Скачайте подходящий .tar.gz со страницы GitHub Releases, распакуйте и установите:

# Пример для codex-darwin-arm64.tar.gz
tar xzf codex-darwin-arm64.tar.gz
mv codex /usr/local/bin/
codex --version

Установка в Windows PowerShell

Способ 1: глобальная установка через npm

# Задаём зеркало реестра npm
npm config set registry https://registry.npmmirror.com

# Глобальная установка
npm install -g @openai/codex

# Проверка
codex --version

Способ 2: Scoop

# Устанавливаем Scoop, если он ещё не установлен
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
irm get.scoop.sh | iex

# Добавляем бакет openai
scoop bucket add openai https://github.com/openai/scoop-bucket

# Устанавливаем Codex CLI
scoop install codex

Способ 3: winget

winget install --id OpenAI.Codex

Установка на Linux / WSL2

Ubuntu / Debian

npm config set registry https://registry.npmmirror.com
npm install -g @openai/codex

# Или из GitHub Release
wget https://github.com/openai/codex/releases/latest/download/codex-linux-x64.tar.gz
tar xzf codex-linux-x64.tar.gz
sudo mv codex /usr/local/bin/

Arch Linux

yay -S codex-cli

WSL2 (Windows Subsystem for Linux)

В WSL2 шаги те же, что и при установке на обычный Linux:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
nvm install 20
nvm use 20
npm install -g @openai/codex

npm, Homebrew или GitHub Release

Частые ошибки установки

EACCES: permission denied

npm ERR! Error: EACCES: permission denied, mkdir '/usr/local/lib/node_modules/@openai/codex'

Решение:

# Вариант 1: исправить глобальный путь npm (рекомендуется)
npm config set prefix ~/.npm-global
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc

# Вариант 2: использовать nvm
nvm install 20
nvm use 20

npm ERR! code ETIMEDOUT

npm ERR! code ETIMEDOUT
npm ERR! errno ETIMEDOUT
npm ERR! network request to https://registry.npmjs.org/@openai%2fcodex failed

Решение: задайте зеркало npm:

npm config set registry https://registry.npmmirror.com

Не пройдена проверка целостности SHA-256

# После загрузки из GitHub Release
Error: integrity check failed

Решение: скачайте архив заново или перейдите на установку через npm.

Команда codex не найдена после установки

npm bin -g
echo $PATH
# Убедитесь, что глобальный каталог bin есть в PATH

Рекомендуемая сетевая конфигурация для пользователей в Китае

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

export OPENAI_BASE_URL="https://api.teamorouter.com/v1"
export OPENAI_API_KEY="sk-teamo-xxxxxxxx"

codex

Или сохраните конфигурацию на постоянной основе:

echo 'export OPENAI_BASE_URL="https://api.teamorouter.com/v1"' >> ~/.zshrc
echo 'export OPENAI_API_KEY="sk-teamo-xxxxxxxx"' >> ~/.zshrc
source ~/.zshrc

FAQ

Какая версия Node.js нужна для Codex CLI?

Рекомендуется Node.js v20 LTS или выше. v18 тоже работает, но v20 даёт лучшую производительность и стабильность.

npm install завис на «sill idealTree buildDeps» — что делать?

npm не может достучаться до реестра по умолчанию. Задайте зеркало и повторите попытку:

npm config set registry https://registry.npmmirror.com
npm cache clean --force
npm install -g @openai/codex

Codex CLI установлен, но показывает «connection refused»?

По умолчанию Codex CLI подключается к api.openai.com. Используйте TeamoRouter как шлюз:

export OPENAI_BASE_URL="https://api.teamorouter.com/v1"
export OPENAI_API_KEY="sk-teamo-xxxxxxxx"

Нужно ли ставить Codex отдельно в WSL2 и в Windows?

WSL2 — самостоятельное Linux-окружение. Если вы разрабатываете в основном в WSL2, установите Codex там один раз. К файлам Windows можно обращаться через \\wsl.localhost\.

Есть ли разница между версиями из GitHub Release и npm?

Функционально они идентичны. GitHub Release — это готовый бинарный файл, который работает без Node.js, а версия из npm зависит от рантайма Node.js.

С чего начать

После установки подключите Codex CLI к TeamoRouter — и можно сразу писать код:

1. Зарегистрируйтесь в TeamoRouter и получите API-ключ
2. Следуя руководству по установке Codex, настройте baseUrl и API-ключ
3. Запустите codex для интерактивного режима или codex "your task" для разовых задач

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

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