Codex CLI — лёгкий кодинг-агент OpenAI прямо в терминале

Codex CLI — официальный кодинг-агент от OpenAI, который запускается локально на вашем компьютере и выполняет задачи прямо в терминале. Это открытый проект под лицензией Apache-2.0: репозиторий github.com/openai/codex собрал более 100 тысяч звёзд и активно развивается. Если вы уже пользуетесь ChatGPT, Codex CLI становится естественным продолжением — тем же моделям можно давать доступ к вашей кодовой базе.

Что это такое

Codex CLI — это не IDE-плагин и не веб-чат, а самостоятельный инструмент командной строки. Вы запускаете codex, описываете задачу на естественном языке, и агент читает ваш репозиторий, редактирует файлы, запускает команды и показывает результат — всё в том же терминале.

У OpenAI сейчас три связанных, но разных продукта:

• Codex CLI — локальный агент, работающий в терминале
• Codex Web — облачный агент на chatgpt.com/codex
• Codex App — десктопное приложение, запускается командой codex app или с соответствующей страницы

Также Codex доступен в виде плагина для редакторов — VS Code, Cursor и Windsurf (инструкция).

Установка

Проще всего установить Codex CLI через официальный установщик. На macOS и Linux:

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

На Windows:

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

Стандартные установщики по умолчанию скачивают файлы с https://releases.openai.com/codex и переключаются на GitHub Releases, если загрузка недоступна. Чтобы принудительно использовать GitHub Releases, задайте переменную окружения:

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

$env:CODEX_INSTALLER_USE_RELEASES_OPENAI_COM='false'; irm https://chatgpt.com/codex/install.ps1 | iex

Кроме установщика, доступны пакетные менеджеры:

npm install -g @openai/codex

brew install --cask codex

После установки достаточно запустить codex — и можно начинать работать.

Сборка из релизов

Каждый релиз на GitHub содержит готовые бинарники под разные платформы:

• macOS
  • Apple Silicon / arm64: codex-aarch64-apple-darwin.tar.gz
  • x86_64 (старые Mac): codex-x86_64-apple-darwin.tar.gz
• Linux
  • x86_64: codex-x86_64-unknown-linux-musl.tar.gz
  • arm64: codex-aarch64-unknown-linux-musl.tar.gz

Архив содержит один исполняемый файл с именем платформы в названии (например, codex-x86_64-unknown-linux-musl), поэтому после распаковки его удобно переименовать в codex.

Аутентификация и планы

Codex CLI умеет работать двумя способами.

Через аккаунт ChatGPT

Запустите codex и выберите Sign in with ChatGPT. OpenAI рекомендует именно этот способ, если у вас есть подписка Plus, Pro, Business, Edu или Enterprise — агент использует те же права доступа, что уже включены в ваш план. Подробности о том, что входит в тариф, описаны в справке OpenAI.

Через API-ключ

Альтернативно можно подключиться по API-ключу OpenAI, но это потребует дополнительной настройки — инструкция в документации.

Как это устроено

Репозиторий — это большой монорепозиторий на Rust (ядро в codex-rs) с CLI-обёрткой в codex-cli, плюс SDK в каталоге sdk. Внутри также лежат docs/ с документацией, сценарии сборки на Bazel и конфигурация для nix/flake. Интересно, что у OpenAI есть открытая программа поддержки open-source: часть средств распределяется в open source fund — вклад проекта в сообщество.

Агент построен вокруг итеративного цикла: он читает файлы проекта, предлагает изменения, применяет их и сам проверяет результат. В отличие от чат-ассистента, Codex имеет реальный доступ к файловой системе и может выполнять команды в терминале, поэтому способен не только предлагать код, но и запускать сборку, тесты и исправлять найденные проблемы.

Локально, а не в облаке

Ключевое отличие Codex CLI от Codex Web — где именно исполняется агент. В CLI всё происходит локально: код уже лежит на вашем диске, агент общается с моделями API, но работает с файлами и командами прямо у вас в системе. Это удобно по нескольким причинам: нет нужды загружать репозиторий в веб-интерфейс, приватный код не покидает машину (за исключением того, что отправляется в API для генерации ответа), а привычный терминальный воркфлоу остаётся нетронутым — можно совмещать с Git, вашим редактором и другими инструментами командной строки.

Доступ в редактор и десктоп

Если терминал не самый удобный интерфейс, тот же Codex доступен и в других формах. Плагин для интегрированной среды разработки ставится в VS Code, Cursor или Windsurf и добавляет агента прямо в привычное окно редактора — с подсветкой изменений, диффами и всеми остальными удобствами IDE. А вариант codex app даёт полноценное десктопное приложение. За счёт этого один агент покрывает три сценария: консоль для минималистов, редактор для тех, кто живёт в IDE, и отдельное приложение для тех, кто хочет отдельный интерфейс.

Практические сценарии

Типичные задачи, с которыми хорошо справляется Codex CLI:

• Рефакторинг — «разбей этот модуль на несколько файлов» или «переименуй функцию по новой конвенции»
• Написание тестов — агент изучит существующий код и предложит набор тестов под текущее поведение
• Поиск и исправление багов — опишите симптом, и агент сам локализует проблему в коде
• Задачи по проекту — миграции, обновление зависимостей, генерация документации

Агентное выполнение отличается от одноразового запроса: модель строит цепочку действий — прочитать файл, понять структуру, внести правку, запустить команду для проверки и при необходимости откатиться и попробовать другой подход. Из-за этого результат удобно использовать и как «автопилот» на время, когда вы отошли от компьютера, и как подробного напарника, за каждым шагом которого можно следить в терминале и вмешиваться по ходу.

Для кого

Codex CLI особенно полезен тем, кто уже платит за ChatGPT — вход занимает одну команду и не требует отдельной настройки API. Но он одинаково удобен и для быстрых правок «на лету», и для многошаговых задач в большой кодовой базе, где важно, чтобы агент сам ориентировался в структуре проекта.

Открытый код и сообщество

Репозиторий распространяется по лицензии Apache-2.0, поэтому его можно изучать, форкать и вносить собственный вклад. У проекта есть открытый контрибьют-процесс — руководство описывает, как подключаться к разработке. Отдельно OpenAI ведёт open source fund — инициативу поддержки открытых проектов, в которую Codex может направлять часть средств. Для тех, кто хочет разобраться в устройстве агента, репозиторий послужит и учебным материалом: ядро написано на Rust, сборка организована через Bazel, а модульность позволяет следить, как код разделён между ядром, CLI и SDK.

Быстрый старт

Если коротко, путь из нуля занимает три шага: установить бинарник (установщиком или пакетным менеджером), запустить codex, выбрать способ входа — через аккаунт ChatGPT или через API-ключ. После этого можно сразу переходить к задачам в своём проекте. Дальше вглубь помогут документация, руководство по установке и сборке и инструкция для контрибьюторов выше.

Дополнительные материалы: официальная документация, руководство по установке и сборке и инструкция для контрибьюторов.