OpenAI Codex

Что это

Codex — кодинг-агент от OpenAI. Это фирменный харнес (agent harness) компании: обвязка вокруг моделей OpenAI, которая даёт им доступ к вашему коду, терминалу и инструментам. Если общая идея харнеса вам ещё не знакома, начните со страницы «Харнес».

Codex существует в нескольких форм-факторах, объединённых одним аккаунтом:

Codex CLI — агент в терминале. Открытый исходный код (лицензия Apache-2.0, написан на Rust), репозиторий — github.com/openai/codex. Это основной способ работы с Codex на своей машине.
Облачные задачи (Codex Cloud) — вы ставите задачу, она выполняется в изолированном контейнере на серверах OpenAI, результат приходит в виде готовых изменений или pull request. Несколько задач могут идти параллельно; запускать их можно из терминала, браузера или ChatGPT.
IDE-расширение — тот же агент внутри VS Code и совместимых редакторов.

Дальше речь в основном про CLI: он лучше всего показывает, как устроен Codex.

Ключевые возможности

Инструменты и песочница

Базовый набор инструментов стандартный для кодинг-агентов: чтение и редактирование файлов, запуск команд в терминале, работа с git.

Отличительная черта Codex — песочница (sandbox) по умолчанию. Команды агента выполняются с ограничениями на файловую систему и сеть, а вы выбираете режим одобрения действий (approval mode): от «только чтение» (агент спрашивает разрешение на любое изменение) через автоматический режим (правит файлы в рабочей папке сам, но спрашивает про выход за её пределы и доступ в сеть) до полного доступа. Режим переключается командой /permissions прямо в сессии или в конфигурации (~/.codex/config.toml). Это удобная реализация принципов, о которых мы говорили на странице «Безопасность».

Память

Роль памяти проекта играет файл AGENTS.md. Codex был одним из инициаторов этого формата, который затем стал общепринятым. Файл в корне репозитория описывает структуру проекта, соглашения и команды сборки; поддерживаются вложенные AGENTS.md в подпапках и глобальный файл в ~/.codex/. Команда /init создаёт заготовку автоматически.

MCP, скилы, субагенты

MCP поддерживается: команда codex mcp подключает локальные и удалённые MCP-серверы, их инструменты становятся доступны агенту.
Прямого аналога скилов нет. Частично их роль выполняют пользовательские промпты-команды (сохранённые инструкции, вызываемые по имени) и AGENTS.md.
Встроенных субагентов тоже нет. Потребность в параллельной работе закрывают облачные задачи: несколько независимых задач в отдельных контейнерах.

Модели

Codex привязан к моделям OpenAI. По умолчанию используется актуальная модель семейства GPT, дообученная под агентную работу с кодом (на июль 2026 года это поколение GPT-5.x с отдельными Codex-вариантами); сменить модель можно командой /model. Подключить модели других провайдеров штатно нельзя: это цена интеграции с экосистемой OpenAI. Единственное исключение — экспериментальный режим работы с открытыми моделями OpenAI (gpt-oss) через локальный запуск.

Оплата двумя способами:

Подписка ChatGPT (Plus, Pro, Business, Enterprise) — вход через аккаунт ChatGPT, использование Codex входит в лимиты подписки. Для большинства это основной вариант.
API-ключ — оплата за токены, удобно для автоматизации и CI.

Сильные стороны и ограничения

Сильные стороны:

Использование в рамках уже оплаченной подписки ChatGPT: отдельный бюджет не нужен.
Песочница и режимы одобрения из коробки: один из самых аккуратных подходов к безопасности среди кодинг-агентов.
Открытый исходный код CLI: можно посмотреть, как всё устроено.
Связка «терминал + IDE + облако» с общим аккаунтом; облачные задачи хорошо подходят для параллельной фоновой работы.

Ограничения:

Только модели OpenAI: если лучшая модель для вашей задачи у другого провайдера, Codex её не подключит.
Нет встроенных скилов и субагентов: механизмов кастомизации меньше, чем у некоторых конкурентов.
Экосистема расширений и сообщество скромнее, чем у самых популярных харнесов.

Кому подойдёт

Тем, у кого уже есть подписка ChatGPT: агент достаётся почти «бесплатно» в рамках существующего тарифа.
Командам, работающим в экосистеме OpenAI (API, ChatGPT Enterprise).
Тем, кому важно запускать агента с осторожными правами по умолчанию: песочница здесь одна из лучших.
Тем, кто хочет делегировать задачи в облако и получать готовые pull request.

Как попробовать

Установка (любой из вариантов):

npm install -g @openai/codex

brew install --cask codex

Первый запуск делается из папки проекта:

codex

Codex предложит войти через аккаунт ChatGPT (или указать API-ключ). После входа выполните /init, чтобы создать AGENTS.md, и сформулируйте первую задачу, например попросите агента объяснить структуру проекта.

Что дальше

OpenCode: открытый харнес без привязки к одному провайдеру моделей.
Обзор харнесов: если хотите сравнить варианты ещё раз.

Автор учебника — Шахматов Алексей