Codex CLI: установка на Windows, Ubuntu и macOS

Codex CLI — официальный кодинг-агент OpenAI, который работает прямо в терминале: читает проект, пишет код, запускает тесты. Разбираем все способы установки — Windows, Ubuntu, macOS — и вход через подписку ChatGPT.

Что это такое

Codex CLI — локальный агент: он запускается на вашей машине и работает с файлами проекта. Кроме него у OpenAI есть Codex в редакторе (расширения для VS Code, Cursor, Windsurf), десктоп-приложение (запускается командой codex app) и облачный Codex Web на chatgpt.com/codex. Для сервера и терминала нужен именно CLI.

Установка

curl -fsSL https://chatgpt.com/codex/install.sh | sh

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

# npm (нужен Node.js)
npm install -g @openai/codex

# Homebrew (macOS)
brew install --cask codex

tar -xzf codex-x86_64-unknown-linux-musl.tar.gz
mv codex-x86_64-unknown-linux-musl codex
chmod +x codex && sudo mv codex /usr/local/bin/

Первый запуск и вход

cd ~/my-project
codex

Агент предложит войти. Два пути:

• Sign in with ChatGPT — используется ваша подписка Plus, Pro, Business, Edu или Enterprise;
• API-ключ — работает, но требует дополнительной настройки (см. документацию OpenAI по авторизации Codex).

Проверить версию можно командой codex --version.

Ubuntu: что учесть

• Никаких дополнительных репозиториев не нужно — установщик install.sh сам определяет архитектуру.
• Если сервер за прокси и releases.openai.com не открывается, ставьте из GitHub Releases вручную (шаг 4).
• Для работы Node-варианта нужен Node.js 18+; проверьте node -v.
• В контейнерах без /usr/local/bin в PATH кладите бинарник в ~/.local/bin.

Обновление

Обновление — повторный запуск установщика или команда пакетного менеджера:

npm install -g @openai/codex@latest

Codex CLI или Claude Code

Оба — терминальные агенты, разница в экосистеме: Codex бесплатно идёт в комплекте с подпиской ChatGPT, которую многие уже платят, а Claude Code требует отдельного Pro/Max либо API-ключа. Если у вас уже есть ChatGPT Plus — логичнее начать с Codex, чтобы не платить дважды. Если нужен именно Claude и его модели — см. гайд по Claude Code.

Частые проблемы

• Скрипт не запускается в Windows — добавьте -ExecutionPolicy ByPass, как в шаге 2.
• codex: command not found — бинарник не в PATH; перезапустите терминал или положите файл в /usr/local/bin.
• Ошибка авторизации по API-ключу — для ключевого режима нужна отдельная настройка, вход через ChatGPT проще.

Читайте дальше

Частые вопросы