Полный гайд по Codex CLI — кодинг-агенту OpenAI. Установка, вход через ChatGPT, работа в песочнице, конфигурация, headless-режим для скриптов и CI, подключение MCP.
Codex CLI — это официальный терминальный агент OpenAI, который не просто отвечает на вопросы, а самостоятельно выполняет задачи: читает репозиторий, пишет код, запускает тесты и применяет правки. Это эволюция того самого Codex, который когда-то был плагином для VS Code — теперь он работает как автономный агент в командной строке.
Главные отличия от обычного ChatGPT:
Для установки нужен Node.js 18+. Пакет ставится глобально через npm:
# Установка Codex CLI npm install -g @openai/codex # Проверка версии codex --version
Обновление до свежей версии — той же командой с флагом:
npm update -g @openai/codex
Авторизация через ChatGPT-подписку (Plus, Pro или Business) — самый простой путь. При первом запуске откроется браузер для входа:
# Интерактивный вход через браузер (ChatGPT OAuth) codex login # Выход из аккаунта codex logout
Для headless-режима и автоматизации используйте API-ключ. Он задаётся переменной окружения:
# API-режим — оплата по использованию export OPENAI_API_KEY="sk-..."
Запуск без аргументов открывает интерактивный TUI. Для разовой задачи передайте промпт прямо в команду:
# Интерактивный режим codex # Разовое задание codex "Добавь в проект healthcheck-эндпоинт /health"
Полезные слеш-команды в TUI:
/help # список команд /clear # очистить сессию /model # сменить модель /approvals # политика подтверждений /mcp # управление MCP-серверами
Codex CLI по умолчанию запускает команды в песочнице. Режим задаётся через approval_policy в конфиге:
Песочница изолирует файловую систему и сеть. Для работы с реальным проектом разрешите запись в рабочую директорию:
# Полностью автономный запуск (headless-скрипты) codex --yolo "Почини все падающие тесты"
Настройки лежат в ~/.codex/config.toml. Ключевые параметры — модель, провайдер и политика подтверждений:
# ~/.codex/config.toml model = "gpt-5-codex" model_provider = "openai" approval_policy = "on-request" [sandbox_workspace_write] network_access = true
Ключевая фича Codex CLI — команда exec для неинтерактивного запуска. Она возвращает код выхода, поэтому отлично встраивается в пайплайны:
# Headless-режим для скриптов codex exec "Сгенерируй unit-тесты для src/parser.py" # Восстановить прерванную сессию по ID codex --resume SESSION_ID
Пример авторевью PR в GitHub Actions:
name: codex-review on: [pull_request] jobs: review: runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 - run: npm install -g @openai/codex - run: codex exec "Сделай code review изменений PR" env: OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
Codex CLI поддерживает MCP для подключения внешних инструментов — от баз данных до браузерной автоматизации:
# Добавить MCP-сервер (интерактивно) codex mcp add github -- npx -y @modelcontextprotocol/server-github # Список подключённых серверов codex mcp list
Codex читает весь репозиторий, но для точечных задач контекст можно сузить через символ @. Это ускоряет ответ и повышает точность на больших кодовых базах:
# Сфокусировать на одном файле codex "Объясни @src/main.py" # Сравнить два файла codex "Сравни @README.md и @docs/api.md"
Codex CLI автоматически читает файл AGENTS.md из корня репозитория — это аналог CLAUDE.md. Опишите в нём команды сборки, стиль кода и соглашения, чтобы каждый разработчик получал одинаковый результат от агента:
# AGENTS.md — корень проекта # Сборка: make build # Тесты: make test # Стиль: black + mypy, без TODO в проде
Типовые проблемы и их устранение:
# Ошибка 1: не проходит login codex login # повторить, проверить подписку ChatGPT # Ошибка 2: сеть недоступна в песочнице # → в config.toml выставить network_access = true # Ошибка 3: session lost — продолжить с места codex --resume <SESSION_ID>
| Критерий | Codex CLI | Gemini CLI | Claude Code |
|---|---|---|---|
| Песочница | встроенная | встроенная | частичная |
| Headless/CI | codex exec | gemini -p | claude -p |
| Бесплатный тариф | нет (Plus/API) | да (AI Studio) | нет (Pro/API) |
| MCP | есть | есть | есть |
Codex сильнее всего проявляет себя в задачах, которые требуют многошаговой работы. Починка падающих тестов — классика: агент запускает тесты, читает вывод и итеративно правит код, пока всё не станет зелёным:
# Починить тесты и довести до зелёного статуса codex "Запусти pytest, найди причины падений и исправь"
Генерация тестов под существующий код — вторая по популярности задача: агент сам определит граничные случаи и напишет покрытие. Миграция кодовой базы (например, JavaScript в TypeScript или Python 2 в Python 3) идёт быстрее, если поручать агенту по одному модулю за прогон:
# Сгенерировать unit-тесты codex "Напиши unit-тесты для @src/parser.py с покрытием граничных случаев" # Миграция модуля codex "Переведи @src/legacy.js на TypeScript, сохрани API"
Разбор чужого legacy-кода без документации — ещё один сценарий, где автономность агента экономит часы: он проследит вызовы, найдёт мёртвый код и предложит план рефакторинга.
Для долгих задач запускайте Codex в tmux — агент продолжит работать, даже если вы отключитесь от сессии. Полезно для массовых рефакторингов, которые идут десятки минут:
# Долгая задача в tmux tmux new-session -s codex codex "Проведи рефакторинг всего модуля auth, обнови тесты"
Чейнинг сессий через codex --resume позволяет разбивать большую работу на этапы: сначала анализ, затем — реализация с тем же контекстом. А для командной разработки встройте Codex в pre-commit хук или CI — авторевью каждого пулл-реквеста без участия человека:
# Продолжить сессию по ID codex --resume abc123def
Ключевой вывод: Codex раскрывается не на разовых вопросах, а на задачах с чёткой целью и правом самостоятельно выполнять шаги. Чем больше рутины вы ему отдадите, тем выше отдача.
Чтобы Codex CLI приносил пользу всей команде, а не только энтузиастам, пройдите по этому списку при внедрении:
Главная ошибка при внедрении — пускать агента на прод без песочницы и без код-ревью его правок. Codex ускоряет рутину, но ответственность за корректность остаётся на человеке: проверяйте диффы, как если бы их прислал джуниор.
Codex CLI — самый зрелый автономный агент OpenAI для терминала. Встроенная песочница, headless-режим codex exec и глубокая интеграция с ChatGPT-подпиской делают его лучшим выбором для разработчиков, которые уже платят за OpenAI. Если нужен бесплатный старт — берите Gemini CLI, а для максимальной автономности сравните с Claude Code.
[ Подписка и оплата из России ]
Новые гайды и обзоры — в канале @qantcore