Codex CLI можно поставить тремя способами: официальным скриптом-установщиком, через npm или через Homebrew (только Mac). На Windows работает нативная установка через PowerShell без WSL. Ниже точные команды под каждую систему и разбор ошибок, которые чаще всего встречаются сразу после установки. Эта статья про установку CLI на конкретной ОС. Если вы выбираете между приложением, CLI и расширением для VS Code, начните со статьи «Codex скачать на ПК».
Установка на 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. Пакет @openai/codex заявляет в package.json Node.js 16 и новее, актуальная LTS-ветка подходит без проблем; если npm install падает с ошибкой синтаксиса или неизвестного флага, велика вероятность, что версия Node слишком старая.
Установка на Windows
Нативный способ, без WSL: команда в PowerShell.
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
Флаг -ExecutionPolicy ByPass взят из официальной команды установки: он задаёт политику выполнения только для этого процесса PowerShell. Групповая политика организации приоритетнее флага и флагом не отменяется.
Тот же npm-пакет работает и на Windows, если Node.js уже установлен:
npm install -g @openai/codex
После установки скриптом Codex CLI доступен из обычного PowerShell или из терминала внутри VS Code: установщик кладёт codex в %LOCALAPPDATA%\Programs\OpenAI\Codex\bin и сам добавляет эту папку в пользовательский PATH. Откройте новое окно терминала, старое путь не подхватит. На macOS и Linux скрипт ставит бинарник в ~/.local/bin.
Скачивание бинарника напрямую
Для CI, контейнеров или ситуаций, где нежелательно тянуть скрипт из интернета, на GitHub в релизах Codex выложены готовые файлы под конкретные платформы: отдельно для Apple Silicon и Intel Mac, отдельно для Linux x86_64 и arm64, и для Windows x64 и ARM64 (файлы codex-x86_64-pc-windows-msvc.exe и codex-aarch64-pc-windows-msvc.exe с вариантами .zip и .tar.gz). Это тот же бинарник, что ставит официальный скрипт, просто без автоматизации: архив нужно распаковать и добавить в PATH вручную. README репозитория перечисляет только архивы для macOS и Linux, но файлы для Windows в релизе 0.167.0 от 6 ноября 2026 есть.
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. Но CLI поддерживает и вход по API-ключу, без привязки к подписке: тогда конфиг задаёт отдельного провайдера в ~/.codex/config.toml (на Windows это %USERPROFILE%\.codex\config.toml).
Через Claudexia тот же конфиг настраивается на модели GPT-6 и GPT-5.6 с оплатой в рублях, без подписки ChatGPT и без входа через аккаунт OpenAI:
model_provider = "claudexia"
model_reasoning_effort = "medium"
model = "gpt-6-sol"
[model_providers.claudexia]
name = "Claudexia"
base_url = "https://api.claudexia.tech/v1"
wire_api = "responses"
env_key = "CODEX_KEY"
Переменную с ключом задают в системе до запуска Codex:
# PowerShell, добавить в профиль или задать перед запуском
$env:CODEX_KEY = "ваш-ключ-claudexia"
# bash/zsh, добавить в ~/.bashrc или ~/.zshrc
export CODEX_KEY="ваш-ключ-claudexia"
Пошаговый разбор для всех трёх систем есть в гайде «Codex». Полная настройка входа по API-ключу без подписки вообще, с выбором между sol, terra и luna под конкретную задачу, разобрана в статье «Codex CLI с API-ключом вместо подписки».
Частые ошибки после установки
«command not found: codex» после установки
Обычно значит, что PATH не подхватил новый бинарник в текущей сессии терминала. Закройте и откройте терминал заново, либо на macOS и Linux выполните source ~/.zshrc (или ~/.bashrc) вручную.
Ошибка политики выполнения в PowerShell
Если политика выполнения на машине строгая, запуск может остановиться. Используйте команду установки целиком, как указано выше, а не саму ссылку на 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 CLI это терминальный агент. Приложение для macOS и Windows называется ChatGPT desktop app, Codex в нём с 9 июля 2026 года отдельный раздел для кода, а команда codex app в CLI это приложение запускает.
Что делать, если после установки Codex выдаёт error при первом запуске?
Сначала проверьте версию Node.js, если ставили через npm, и убедитесь, что PATH обновился в текущем терминале. Если ошибка про аутентификацию, проверьте наличие и содержимое ~/.codex/config.toml и переменной окружения с ключом.
Нужен ли отдельный установщик для приложения ChatGPT desktop и для Codex CLI?
Да, установщики разные. ChatGPT desktop ставится как приложение для macOS или Windows, и Codex в него встроен с 9 июля 2026 года, а Codex CLI устанавливается собственным скриптом или через npm/Homebrew, как описано выше.
Можно ли поставить Codex CLI без интернета, из локального файла?
Да, через готовый архив с GitHub Releases: скачать заранее на другой машине, перенести и распаковать вручную, добавив путь к бинарнику в PATH.