OpenAI Codex CLI: AI-агент прямо в терминале

Что такое Codex CLI?

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

Написан на Rust — быстрый, лёгкий, open source.

Codex входит в планы ChatGPT Plus, Pro, Business, Edu и Enterprise. Также доступен через API.

Установка

1. Установи через npm:

   npm i -g @openai/codex

   Или через Homebrew (macOS):

   brew install --cask codex

2. Запусти первый раз:

   codex

   При первом запуске — авторизация через ChatGPT аккаунт или API ключ.

3. Обновление:

   npm i -g @openai/codex@latest

Заметка

Codex работает на macOS и Linux. Поддержка Windows — экспериментальная; для Windows лучше использовать WSL.

Интерактивный режим (TUI)

Запускаешь codex и попадаешь в полноэкранный терминальный интерфейс (TUI):

codex
# или с начальным промптом:
codex "Объясни мне эту кодовую базу"

В TUI доступно:

• Отправка промптов, кода и скриншотов прямо в чат
• Просмотр плана Codex’а перед тем как он делает изменения — можно принять или отклонить
• Подсветка синтаксиса в markdown и диффах
• /theme — смена цветовой темы
• /clear или Ctrl+L — очистить терминал
• /copy — скопировать последний ответ
• Ctrl+C или /exit — выйти

Модели

По умолчанию и для большинства задач — GPT-5.4. Это флагманская модель с сильными кодовыми возможностями, reasoning и computer use.

Переключение моделей прямо в сессии:

/model
# или при запуске:
codex --model gpt-5.4

Для Pro подписчиков доступен GPT-5.3-Codex-Spark — ультрабыстрая модель для простых задач.

Ключевые команды

Команда	Что делает
codex	Запустить интерактивный TUI
codex "промпт"	Запуск с начальным сообщением
codex --model gpt-5.4	Выбор модели
codex -i screenshot.png "Fix this"	С изображением
codex resume	Продолжить предыдущую сессию
codex resume --last	Продолжить последнюю сессию
codex exec "промпт"	Автоматический режим без UI
codex features list	Посмотреть доступные флаги
codex features enable unified_exec	Включить фичу

Режимы выполнения (Approval Modes)

Codex предлагает три уровня контроля:

• Suggest — Codex предлагает изменения, ты всё одобряешь вручную
• Auto-Edit — автоматически редактирует файлы, но спрашивает перед запуском команд
• Full Auto — работает полностью самостоятельно (доверяй только в проверенных проектах!)

codex --approval-mode auto-edit "Add error handling to all API calls"

Изображения и скриншоты

Можно отправлять скриншоты прямо в запрос:

codex -i design.png "Реализуй этот UI компонент"
codex --image mockup1.png,mockup2.jpg "Сравни эти дизайны"

Codex прочитает картинки и учтёт их в своей работе.

Возобновление сессий (Resume)

Codex сохраняет историю сессий локально. Можно продолжить с того места:

codex resume          # выбор из списка сессий
codex resume --last   # сразу последняя сессия
codex resume --all    # показать сессии из всех директорий

Это особенно ценно для длинных рефакторингов — не нужно повторять контекст.

Multi-agent режим

Экспериментальная фича — запуск нескольких Codex агентов параллельно для сложных задач:

~/.codex/config.toml

[agents]
review_agent = { role = "reviewer", model = "gpt-5.4" }
impl_agent   = { role = "implementer", model = "gpt-5.4" }

codex --profile multi "Реализуй новую фичу и сразу сделай код ревью"

MCP интеграция

Codex поддерживает Model Context Protocol для подключения внешних инструментов:

codex --mcp github "Check open PRs and summarize them"

Подробнее об MCP серверах →

Code Review без CI

Крутая фича — локальный code review перед коммитом:

codex review

Отдельный агент просматривает твои изменения и даёт фидбек как будто это PR ревью — до того как ты вообще запушил.

Автоматизация (Scripting)

Можно автоматизировать Codex в скриптах:

# Автоматически исправить все найденные баги
codex exec "Find and fix all TypeScript errors"

# Продолжить предыдущую задачу
codex exec resume --last "Now write tests for what you built"

Практические советы

Начинай с AGENTS.md

Положи в корень проекта файл AGENTS.md — объясни в нём архитектуру, правила и контекст. Codex читает его автоматически.

Используй resume

Не начинай каждый раз заново. codex resume --last сохраняет время и контекст.

Approve mode = Auto-Edit

Для рутины — auto-edit. Для критичного кода — suggest. Full auto только если доверяешь на 100%.

Скриншоты работают

Скопируй ошибку как скриншот и отправь. Codex прочитает и разберётся.

Сравнение с Claude Code

	Codex CLI	Claude Code
Компания	OpenAI	Anthropic
Язык	Rust	Node.js
Модели	GPT-5.4, GPT-5.3-Codex	Claude Opus 4, Sonnet 4.5, Haiku
MCP	✅	✅
Multi-agent	Экспериментальный	✅ (до 10 параллельных)
Plugin система	Нет	✅ Skills/Hooks/Plugins
Цена	Включён в ChatGPT Plus+	API billing
Open source	✅	✅

Оба инструмента мощные. Codex — если ты в экосистеме OpenAI. Claude Code — если нужны продвинутые hooks, skills и кастомизация.

Официальные ресурсы

• OpenAI Codex — страница продукта
• Codex CLI на GitHub — исходный код (open source)
• Документация Codex — API документация