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-ветка подходит без проблем. Если 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, контейнеры и другие места, где тянуть скрипт из интернета не хочется, обходятся готовыми архивами из релизов Codex на GitHub. Есть отдельные сборки для Apple Silicon и Intel Mac, для Linux x86_64 и для arm64. Бинарник тот же, что ставит официальный скрипт, просто без автоматики: архив распаковывают и добавляют в PATH вручную.
Codex app и IDE-расширения
Команда codex app запускает приложение ChatGPT для macOS и Windows (справка по командам Codex CLI). Отдельного приложения Codex больше нет: по словам OpenAI, 9 июля 2026 года Codex app влился в ChatGPT desktop app и остался в нём отдельным разделом для кода рядом с Chat и Work (What's new). Поэтому свежие гайды называют это приложение ChatGPT desktop app, а прежнее имя Codex app теперь встречается разве что в названиях релизов.
cd /path/to/your/project
codex app
Помимо CLI есть расширения для редакторов (VS Code, Cursor, Windsurf) и веб-версия Codex на chatgpt.com. Это разные входы в один и тот же продукт, а не разные версии Codex.
Настройка после установки: свой API-ключ вместо подписки
Из коробки Codex CLI просит войти через аккаунт ChatGPT. Но он умеет и вход по API-ключу без привязки к подписке: тогда отдельный провайдер задаётся в ~/.codex/config.toml (на Windows это %USERPROFILE%\.codex\config.toml).
Через codexkey тот же конфиг подключает модели GPT-5.6 с оплатой в рублях, без подписки ChatGPT и без входа через аккаунт OpenAI:
model_provider = "codexkey"
model_reasoning_effort = "medium"
model = "gpt-5.6-sol"
[model_providers.codexkey]
name = "codexkey"
base_url = "https://api.codexkey.ru/v1"
env_key = "CODEX_KEY"
Переменную с ключом нужно задать в системе до запуска Codex:
# PowerShell, добавить в профиль или задать перед запуском
$env:CODEX_KEY = "ваш-ключ-codexkey"
# bash/zsh, добавить в ~/.bashrc или ~/.zshrc
export CODEX_KEY="ваш-ключ-codexkey"
Пошаговый разбор для всех трёх систем, включая создание папки .codex на Windows через PowerShell, лежит в гайде по Codex. Вход по API-ключу без подписки целиком, с выбором между sol, terra и luna под конкретную задачу, описан в статье «Codex CLI с API-ключом вместо подписки».
Частые ошибки после установки
«command not found: codex» после установки
Обычно терминал просто не увидел новый бинарник в PATH текущей сессии. Закройте терминал и откройте заново. На macOS и Linux можно вместо этого выполнить source ~/.zshrc (или source ~/.bashrc).
Ошибка политики выполнения в PowerShell
Без флага -ExecutionPolicy ByPass Windows откажется выполнять скрипт из интернета. Берите команду установки целиком, как показано выше, а не одну ссылку на install.ps1.
npm install падает с ошибкой прав доступа
На Linux и Mac глобальная установка пакета иногда требует 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 не нужен, установка нативная.
Codex CLI и codex app это одно и то же?
Нет. Codex CLI это терминальный агент. Приложение для macOS и Windows называется ChatGPT desktop app, Codex в нём с 9 июля 2026 года идёт отдельным разделом для кода, а команда codex app в CLI это приложение запускает.
Что делать, если после установки Codex выдаёт error при первом запуске?
Если ставили через npm, сначала проверьте версию Node.js и убедитесь, что PATH обновился в текущем терминале. Когда ошибка про аутентификацию, посмотрите, есть ли ~/.codex/config.toml и что лежит в переменной окружения с ключом.
Нужен ли отдельный установщик для приложения ChatGPT desktop и для Codex CLI?
Да, установщики разные. ChatGPT desktop ставится как приложение для macOS или Windows, и Codex встроен в него с 9 июля 2026 года. Codex CLI ставится собственным скриптом или через npm/Homebrew, как описано выше.
Можно ли поставить Codex CLI без интернета, из локального файла?
Можно, из готового архива с GitHub Releases: скачайте его заранее на другой машине, перенесите и распакуйте вручную, а путь к бинарнику добавьте в PATH.