Как установить Codex CLI на Windows, macOS и Linux
Codex CLI ставится четырьмя способами: скриптом (curl на macOS и Linux, PowerShell на Windows), через npm, через Homebrew или готовым архивом из GitHub Releases. Результат один: команда codex. Работать с Relay она начнёт после того, как в пользовательском config.toml появится провайдер с вашим ключом.
Коротко
Скрипт ставит и обновляет Codex на macOS, Linux и Windows.
npm подходит, если Node.js уже есть. Архив нужен CI и закрытым сетям.
Вход через ChatGPT необязателен: Codex принимает ключ API, а провайдер Relay описывается в
~/.codex/config.toml.
Какой способ выбрать
| Способ | Где работает | Когда брать |
|---|---|---|
| Скрипт-установщик | macOS, Linux, Windows | по умолчанию, он же обновляет |
| npm | всюду, где есть Node.js | npm уже часть вашей среды |
| Homebrew | где установлен brew | всё остальное вы ведёте через brew |
| Архив из GitHub Releases | macOS (arm64, x86_64), Linux (x86_64, arm64) | CI, контейнеры, сети без доступа к скрипту |
Я брал бы скрипт и менял его на другой способ только по делу: на машине единый менеджер пакетов или нужна установка без запуска чужого скрипта. Все команды ниже взяты из README репозитория openai/codex и справочника OpenAI на 14 октября 2026.
Установка на macOS и Linux
curl -fsSL https://chatgpt.com/codex/install.sh | shДля Homebrew это cask, а не формула:
brew install --cask codexЧерез npm:
npm install -g @openai/codexВерсия Node.js для npm в описании установки не названа. Её видно в реестре: у пакета @openai/codex версии 0.162.1 в поле engines указано node >=16. Если npm install падает с синтаксической ошибкой, начните с node --version.
Установка на Windows
В README для Windows дана такая команда, её копируют целиком вместе с -ExecutionPolicy ByPass:
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"Пакет npm выкладывается и под Windows, поэтому npm install -g @openai/codex работает и в PowerShell. Здесь встречается своя ловушка: если PowerShell отвечает running scripts is disabled on this system, политика выполнения блокирует .ps1-оболочки, которые создаёт npm. Разрешите локальные скрипты для своего пользователя командой Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser или вызывайте npm.cmd.
Архив без скрипта
Для CI и контейнеров на странице релизов лежат архивы с одним исполняемым файлом: codex-aarch64-apple-darwin.tar.gz и codex-x86_64-apple-darwin.tar.gz для macOS, codex-x86_64-unknown-linux-musl.tar.gz и codex-aarch64-unknown-linux-musl.tar.gz для Linux. После распаковки файл переименовывают в codex и кладут в каталог из PATH. Архива под Windows в README нет, там используют скрипт или npm.
Скрипты по умолчанию скачивают сборки с releases.openai.com/codex и при сбое переходят на GitHub Releases. Принудительно взять GitHub можно переменной CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false.
Первый запуск: ChatGPT или ключ
При первом запуске codex предлагает войти через ChatGPT. По README это основной путь для тарифов Plus, Pro, Business, Edu и Enterprise. Ключ API тоже поддерживается: ключ OpenAI тарифицируется по стандартным ценам API, а не по тарифу ChatGPT. Часть возможностей, завязанных на рабочее пространство ChatGPT и облачные сервисы, с ключом ограничена или недоступна.
Войти по ключу и проверить режим можно так:
printenv OPENAI_API_KEY | codex login --with-api-key
codex login statusДля Relay вход не нужен. Достаточно описать провайдера в пользовательском ~/.codex/config.toml: base_url с /v1, env_key = "RELAY_API_KEY" и wire_api = "responses". Проектный .codex/config.toml провайдеров не читает. Ключ выпускается по инструкции как получить API-ключ Claude: шаги для кабинета те же, модель выбирается позже. Готовый конфиг и ограничения Responses API я не повторяю здесь, они разобраны в статье Codex CLI через Relay, на странице интеграции и в описании Responses API. Выбор между Codex, Cursor и Claude Code описан в сравнении.
Как убедиться, что установка удалась
Установка считается успешной, когда оболочка находит команду. На macOS и Linux это command -v codex, в PowerShell Get-Command codex: обе печатают путь к файлу. Затем запустите codex login status. До настройки провайдера она показывает, как Codex авторизован сейчас.
После того как провайдер Relay описан в config.toml, проверка другая: codex exec "ping" возвращает ответ модели, а запись о запросе появляется в журнале кабинета. Запускайте команду в каталоге Git-репозитория. Для разовой пустой папки добавьте флаг --skip-git-repo-check, он разрешает работу вне репозитория. Страница интеграции Relay сверена с Codex CLI версии 0.159.3, а в реестре npm на 14 октября 2026 лежит 0.162.1. Если после обновления изменилось поведение конфига, сверяйтесь со справочником конфигурации OpenAI и страницей интеграции.
Типичные ошибки после установки
| Симптом | Причина | Что сделать |
|---|---|---|
codex: command not found | окно терминала открыто до установки и не видит свежий PATH | откройте новое окно или выполните source ~/.zshrc |
EACCES при npm install -g | глобальный каталог npm принадлежит системе | не используйте sudo, задайте префикс в домашней папке: npm config set prefix ~/.npm-global и добавьте ~/.npm-global/bin в PATH |
running scripts is disabled on this system | политика выполнения PowerShell блокирует оболочки npm | Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser или npm.cmd |
| Codex просит вход в ChatGPT, хотя ключ готов | в config.toml не выбран model_provider, и Codex работает со встроенным openai | задайте model_provider и поместите блок в пользовательский файл |
Шлюз отвечает 401 с кодом invalid_api_key | переменная из env_key не задана в оболочке, из которой запущен codex | экспортируйте её в том же окне и проверьте ключ запросом GET /v1/key |
Обновление
Скрипт-установщик обновляет повторным запуском той же команды. Команда codex update проверяет и применяет обновление, если установленный релиз поддерживает самообновление. Для Homebrew и npm остаются их штатные команды.
Нужен ли аккаунт ChatGPT, чтобы пользоваться Codex CLI?
Нет. Вход через ChatGPT рекомендован в README, но ключ API тоже поддерживается. Через Relay Codex работает с ключом кабинета, а ChatGPT при этом не нужен.
Чем отличаются codex и codex exec?
codex открывает интерактивный терминальный интерфейс. codex exec (псевдоним codex e) выполняет задачу без диалога и подходит для скриптов. Для проверки подключения хватает codex exec "ping" в каталоге Git-репозитория.
Что делает команда codex app?
Она запускает десктопное приложение ChatGPT из терминала на macOS и Windows. Для работы CLI через Relay это приложение не нужно.
Источники
Команды установки сверены с README репозитория openai/codex, справочник команд и режимы входа с документацией Codex CLI reference и Authentication на 14 октября 2026. Требование к Node.js взято из метаданных пакета в реестре npm на ту же дату.