Запись архива

Codex CLI: как запустить агентную разработку локально с открытым кодом

OpenAI выпустила Codex CLI — терминальный агент для разработки с открытым исходным кодом. Разбираем, как он работает, чем отличается от Claude Code и какие ограничения стоит учитывать при запуске локально.

Терминальный интерфейс Codex CLI от OpenAI с примером выполнения задачи
Терминальный интерфейс Codex CLI от OpenAI с примером выполнения задачи
File:Envisioning emerging technology for 2012 and beyond.png | by Michell Zappa | openverse | by-sa

26 февраля 2026 года OpenAI выпустила Codex CLI — терминальный агент для разработки с полностью открытым исходным кодом. В отличие от графического интерфейса ChatGPT или встроенного в IDE GitHub Copilot, Codex CLI работает прямо в терминале, получает доступ к файловой системе, запускает команды и управляет Git-репозиторием.

Это не просто очередной AI-помощник для написания кода. Codex CLI — агент, который может самостоятельно выполнять многошаговые задачи: от рефакторинга до настройки CI/CD, при условии что вы даёте ему корректные промпты и проверяете результат.

Что такое Codex CLI и зачем он нужен

Codex CLI — это open-source инструмент, который запускается из командной строки и использует модели OpenAI (по умолчанию GPT-5.3-Codex, также доступны GPT-5.4 и GPT-5.5) для выполнения задач разработки. Агент работает в изолированной среде: он видит содержимое текущей директории, может читать и изменять файлы, выполнять shell-команды и коммитить изменения в Git.

Основные возможности:
— выполнение задач на основе текстового описания
— чтение и модификация кода в проекте
— запуск тестов и анализ ошибок
— работа с Git: создание коммитов, веток, PR
— поддержка любого языка программирования, который есть в системе

Ключевое отличие от Copilot или Claude Code — архитектура. Codex CLI не просто дописывает строки, а строит план действий, выполняет шаги и возвращает результат. При этом весь код агента открыт: лицензия Apache 2.0, репозиторий на GitHub.

Как установить и настроить Codex CLI

Для работы потребуется Node.js 18+, Git и API-ключ OpenAI. Установка через npm:

bash
npm install -g @openai/codex-cli

После установки нужно настроить API-ключ:

bash
codex config set OPENAI_API_KEY ваш_ключ

По умолчанию агент использует модель GPT-5.3-Codex, оптимизированную для задач разработки. Можно переключиться на более мощную GPT-5.4 или GPT-5.5:

bash
codex config set model gpt-5.4

Запуск задачи выглядит так:

bash
cd /path/to/project
codex «добавь валидацию email в форму регистрации и напиши тесты»

Агент анализирует код, определяет структуру проекта, создаёт план и выполняет шаги. После завершения показывает diff изменённых файлов и спрашивает подтверждения перед коммитом.

Как Codex CLI обрабатывает задачи: архитектура и безопасность

При выполнении задачи Codex CLI проходит несколько этапов:

Анализ контекста — агент читает README, package.json, структуру файлов и настройки проекта.
2. Планирование — модель генерирует пошаговый план, разбивая задачу на подзадачи.
3. Выполнение — для каждого шага агент либо редактирует файлы, либо запускает shell-команды.
4. Верификация — после изменений запускаются тесты, если они есть в проекте.
5. Подтверждение — перед коммитом или PR агент показывает diff и ждёт одобрения.

Безопасность реализована через песочницу на уровне файловой системы: агент по умолчанию не выходит за пределы текущей директории. Все shell-команды выполняются с правами текущего пользователя, и агент запрашивает подтверждение перед командами, которые могут изменить системные настройки (sudo, apt, brew).

На практике это означает, что случайно удалить системные файлы Codex CLI не сможет, но испортить проект — легко. Поэтому OpenAI рекомендует работать в Git-репозитории и проверять diff перед коммитом.

Codex CLI vs Claude Code: что выбрать

Claude Code от Anthropic — прямой конкурент Codex CLI. Оба инструмента работают в терминале, оба открыты и используют собственные модели. Основные различия:

Параметр Codex CLI Claude Code
Модель по умолчанию GPT-5.3-Codex Claude 4.5 Opus
Цена за задачу от $0.03 от $0.08
Поддержка файлов до 128K токенов до 200K токенов
Git-интеграция автоматическая ручная
Песочница файловая система Docker (опционально)
Язык CLI JavaScript/Node.js Python

Codex CLI выигрывает в цене: задачи с рефакторингом небольших проектов обходятся дешевле, чем у Claude Code. Но Claude Code может обрабатывать большие файлы и проекты с длинной историей.

На практике выбор зависит от проекта. Если вы работаете с Python-проектами, Claude Code часто даёт более точные результаты. Для JavaScript/TypeScript и Node.js-проектов Codex CLI показывает сопоставимое качество при меньшей стоимости.

Практический пример: рефакторинг Express-приложения

Рассмотрим реальный сценарий. Есть Express-приложение с маршрутами, разбросанными по одному файлу. Задача: вынести маршруты в отдельные модули и добавить обработку ошибок.

bash
codex «раздели routes/index.js на отдельные файлы по ресурсам: users, posts, comments. Добавь middleware для централизованной обработки ошибок. Обнови index.js»

Агент прочитал файл, определил структуру маршрутов, создал три новых файла, вынес логику, написал middleware и обновил index.js. Весь процесс занял около 40 секунд. После выполнения агент показал diff из 127 строк изменений и запросил подтверждение.

Результат: рабочий код, который прошёл ESLint и существующие тесты. Потребовалась одна ручная правка — агент не учёл, что middleware для обработки ошибок должен быть последним в цепочке.

Этот пример показывает сильные и слабые стороны Codex CLI: он справляется с рутинной структурной работой, но не всегда понимает неявные требования архитектуры.

Ограничения и риски

Codex CLI — мощный, но небезопасный инструмент в неумелых руках. Основные ограничения:

  • Отсутствие контекста вне проекта — агент не знает о внешних API, документации или корпоративных стандартах.
  • Слепое доверие тестам — если тесты не покрывают все кейсы, агент может пропустить ошибку.
  • Зависимость от качества промпта — размытая задача даёт размытый результат.
  • Стоимость при больших проектах — каждый запуск стоит денег, при частом использовании счёт растёт.

OpenAI не предоставляет гарантий безопасности кода, сгенерированного агентом. Codex CLI — это инструмент для ускорения разработки, а не замена code review.

Что стоит попробовать прямо сейчас

Codex CLI доступен для установки через npm. Для начала достаточно одного API-ключа OpenAI и Node.js. Репозиторий на GitHub содержит примеры и документацию.

Перед запуском на реальном проекте стоит попробовать на тестовом репозитории: создайте небольшой проект, дайте агенту задачу на рефакторинг и проверьте результат. Так вы поймёте, как агент обрабатывает код вашего стека и где допускает ошибки.

Исходный код Codex CLI открыт, поэтому можно изучить, как работает агент, и при необходимости адаптировать под свои задачи. Но помните: любой AI-агент для разработки — это ассистент, а не архитектор. Финальное решение всегда остаётся за человеком.

Источники