Codex CLI можно поставить тремя способами: официальным скриптом-установщиком, через npm или через Homebrew (только Mac). На Windows работает нативная установка через PowerShell без WSL. Ниже точные команды под каждую систему и разбор ошибок, которые чаще всего встречаются сразу после установки.
Установка на Mac и Linux
Официальный способ, который OpenAI рекомендует по умолчанию: скрипт-установщик через curl.
curl -fsSL https://chatgpt.com/codex/install.sh | sh
Скрипт сам определяет архитектуру процессора (Apple Silicon, x86_64 для Mac; x86_64 и arm64 для Linux) и ставит нужный бинарник. Тот же скрипт используется и для обновления: повторный запуск подтягивает свежую версию поверх старой.
Через Homebrew (только Mac)
Если вы уже пользуетесь Homebrew для управления пакетами, есть отдельная формула:
brew install --cask codex
Через npm (Mac, Linux, Windows)
Codex CLI распространяется и как npm-пакет, что удобно, если Node.js уже стоит и вы предпочитаете держать инструменты в одном менеджере:
npm install -g @openai/codex
Для этого способа нужен установленный Node.js. Версия в документации явно не зафиксирована, но актуальная LTS-ветка Node.js подходит без проблем; если npm install падает с ошибкой синтаксиса или неизвестного флага, велика вероятность, что версия Node слишком старая.
Установка на Windows
Нативный способ, без WSL: команда в PowerShell.
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
Флаг -ExecutionPolicy ByPass нужен, потому что Windows по умолчанию блокирует запуск неподписанных скриптов из интернета: без него команда завершится ошибкой политики выполнения, даже если сам скачанный файл в порядке.
Тот же npm-пакет работает и на Windows, если Node.js уже установлен:
npm install -g @openai/codex
После установки любым из способов Codex CLI доступен из обычного PowerShell или из терминала внутри VS Code: отдельно настраивать PATH не требуется, установщик делает это сам.
Скачивание бинарника напрямую
Для CI, контейнеров или ситуаций, где нежелательно тянуть скрипт из интернета, на GitHub в релизах Codex выложены готовые архивы под конкретные платформы: отдельно для Apple Silicon и Intel Mac, отдельно для Linux x86_64 и arm64. Это тот же бинарник, что ставит официальный скрипт, просто без автоматизации: архив нужно распаковать и добавить в PATH вручную.
Codex app и IDE-расширения
codex app запускает desktop-приложение, которое оборачивает тот же CLI в графический интерфейс: отдельно скачивать ничего не нужно, команда работает сразу после установки CLI.
cd /path/to/your/project
codex app
Отдельно от CLI существуют расширения для редакторов (VS Code, Cursor, Windsurf) и веб-версия Codex на chatgpt.com. Это разные точки входа к одному и тому же продукту, а не разные версии Codex.
Настройка после установки: свой API-ключ вместо подписки
Codex CLI из коробки просит войти через аккаунт ChatGPT. Но CLI поддерживает и вход по API-ключу, без привязки к подписке: тогда конфиг задаёт отдельного провайдера в ~/.codex/config.toml (на Windows это %USERPROFILE%\.codex\config.toml).
Через Claudexia тот же конфиг настраивается на модели GPT-5.6 с оплатой в рублях, без подписки ChatGPT и без входа через аккаунт OpenAI:
model_provider = "claudexia"
model_reasoning_effort = "medium"
model = "gpt-5.6-sol"
[model_providers.claudexia]
name = "claudexia"
base_url = "https://api.claudexia.tech/v1"
env_key = "CODEX_KEY"
Переменную с ключом задают в системе до запуска Codex:
# PowerShell, добавить в профиль или задать перед запуском
$env:CODEX_KEY = "ваш-ключ-claudexia"
# bash/zsh, добавить в ~/.bashrc или ~/.zshrc
export CODEX_KEY="ваш-ключ-claudexia"
Пошаговый разбор для всех трёх систем, включая создание папки .codex на Windows через PowerShell, есть в гайде «Codex». Полная настройка входа по API-ключу без подписки вообще, с выбором между sol, terra и luna под конкретную задачу, разобрана в статье «Codex CLI с API-ключом вместо подписки».
Частые ошибки после установки
«command not found: codex» после установки
Обычно значит, что PATH не подхватил новый бинарник в текущей сессии терминала. Закройте и откройте терминал заново, либо на macOS и Linux выполните source ~/.zshrc (или ~/.bashrc) вручную.
Ошибка политики выполнения в PowerShell
Если запустить установочную команду без флага -ExecutionPolicy ByPass, Windows откажется выполнять скрипт из интернета. Решение: использовать команду установки целиком, как указано выше, а не саму по себе ссылку на install.ps1.
npm install падает с ошибкой прав доступа
На Linux и Mac глобальная установка npm-пакета иногда требует sudo npm install -g @openai/codex, если Node.js стоит через системный пакетный менеджер без настроенного префикса для пользователя. Более безопасный путь: настроить npm на установку глобальных пакетов в домашнюю директорию, а не чинить симптом через sudo каждый раз.
Codex запускается, но просит войти в ChatGPT, хотя нужен только API-ключ
Значит, конфиг config.toml не подхватился или переменная с ключом не экспортирована в текущей сессии. Проверьте, что файл лежит по правильному пути для вашей ОС и что переменная из env_key действительно задана в той же оболочке, откуда запускается codex.
FAQ
Как скачать Codex на ПК с Windows без WSL?
Через PowerShell командой powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex". WSL не требуется, установка нативная под Windows.
Codex CLI и codex app это одно и то же?
Да. codex app запускает desktop-обёртку поверх уже установленного CLI, отдельного скачивания не требует и использует ту же конфигурацию и тот же аккаунт или API-ключ.
Что делать, если после установки Codex выдаёт error при первом запуске?
Сначала проверьте версию Node.js, если ставили через npm, и убедитесь, что PATH обновился в текущем терминале. Если ошибка про аутентификацию, проверьте наличие и содержимое ~/.codex/config.toml и переменной окружения с ключом.
Нужен ли отдельный установщик для приложения ChatGPT desktop и для Codex CLI?
Да, это разные программы. ChatGPT desktop это отдельное приложение для чата, а Codex CLI устанавливается собственным скриптом или через npm/Homebrew, как описано выше.
Можно ли поставить Codex CLI без интернета, из локального файла?
Да, через готовый архив с GitHub Releases: скачать заранее на другой машине, перенести и распаковать вручную, добавив путь к бинарнику в PATH.