Read the book: «Codex в деле. Практическое руководство для разработчиков по работе с ИИ-агентом OpenAI Codex»
Предисловие
Эта книга — о том, как перестать «спрашивать нейросеть» и начать работать с ИИ-агентом как с членом команды. Codex от OpenAI умеет гораздо больше, чем подсказывать строку кода: он читает репозиторий, правит десятки файлов, запускает тесты, сам находит свои ошибки, работает в облаке, пока ваш ноутбук закрыт, и встраивается в CI. Но чтобы всё это приносило пользу, а не хаос в истории Git, нужны навыки: правильно ставить задачу, ограничивать права, проверять результат и выстраивать повторяемые процессы.
Для кого эта книга
• Для backend-, frontend- и fullstack-разработчиков, которые хотят ускорить рутину: багфиксы, тесты, рефакторинг, миграции.
• Для тимлидов и техлидов, которым нужно внедрить агентов в команду так, чтобы не пострадали качество кода и безопасность.
• Для DevOps- и SRE-инженеров, которым интересна автоматизация через codex exec, CI и работу на серверах.
• Для QA-инженеров и аналитиков, которые пишут скрипты и хотят доверить агенту черновую работу.
• Для студентов и начинающих — при условии, что вы готовы читать код, который пишет агент, а не просто копировать его.
Как читать книгу
Книга разбита на пять частей. Первая объясняет, что такое Codex, как его установить и как устроена безопасность. Вторая — ежедневная работа: постановка задач, файл AGENTS.md, планирование, ревью, управление сессиями. Третья — расширение возможностей: скиллы, MCP, плагины, хуки, субагенты и конфигурация. Четвёртая — автоматизация: скрипты, CI, Codex Cloud и десктоп-приложение. Пятая — практика: готовые рецепты, типичные ошибки, экономика лимитов и внедрение в команду. В приложениях собраны шпаргалки, шаблоны и чек-листы, к которым удобно возвращаться.
Если вы уже пользуетесь Codex, начните с глав 5, 6 и 8 — они дают наибольший прирост качества. Если только начинаете — читайте по порядку и повторяйте примеры на учебном репозитории.
Важная оговорка о версиях
Codex развивается очень быстро: новые модели выходят раз в несколько месяцев, команды и флаги CLI меняются от релиза к релизу. Материал книги соответствует состоянию продукта на октябрь 2026 года (после конференции OpenAI DevDay 2026). Названия моделей, тарифы и лимиты обязательно сверяйте с актуальной официальной документацией, а для своей установленной версии используйте codex --help и codex <команда> --help. Принципы работы — постановка задач, контроль прав, ревью, автоматизация — меняются гораздо медленнее, и именно на них сделан главный упор.
Обратите внимание. Книга не является официальным изданием OpenAI. Все упомянутые названия продуктов и товарные знаки принадлежат их правообладателям.
Часть I. Основы
Первая часть закладывает фундамент: что такое Codex, как он устроен, как его установить, какую модель выбрать и как настроить безопасность так, чтобы агент помогал, а не создавал риски.
Глава 1. Что такое Codex и чем агент отличается от чат-бота
От автодополнения к агенту
За последние годы инструменты ИИ для программистов прошли три стадии. Сначала было автодополнение: модель предлагала продолжение строки. Затем — чат: вы копировали кусок кода в окно, получали ответ и вставляли его обратно. Третья стадия — агенты. Агент получает цель, сам решает, какие файлы прочитать, какие команды выполнить и что изменить, проверяет результат и сообщает о проделанной работе.
Codex — агент OpenAI для разработки. Его ключевое отличие от чата в том, что у него есть «руки»: доступ к файловой системе проекта, терминалу, Git, браузеру и внешним сервисам через подключаемые инструменты. Поэтому меняется и роль разработчика: вы меньше пишете код руками и больше ставите задачи, задаёте рамки и проверяете результат.
Цикл работы агента
Почти любая задача в Codex проходит один и тот же цикл:
1. Вы описываете желаемый результат и критерий готовности.
2. Codex изучает проект: читает файлы, ищет по коду, смотрит историю Git, инструкции в AGENTS.md.
3. Агент вносит изменения и запускает команды: сборку, тесты, линтеры.
4. Агент проверяет результат и, если что-то сломалось, исправляет.
5. Вы просматриваете diff, принимаете, просите доработать или откатываете.
Хорошая новость: каждый шаг этого цикла можно настроить. Плохая: если пропустить первый (нечёткая постановка) или последний (отсутствие ревью), агент быстро превратится в генератор технического долга.
Где живёт Codex: поверхности продукта
Один и тот же агент доступен в нескольких интерфейсах. Они используют общую конфигурацию (~/.codex/config.toml), поэтому настройки, сделанные в одном месте, работают и в другом.
• Codex CLI — Работа в терминале, на удалённых серверах по SSH, скрипты и CI через codex exec
• Десктоп-приложение — Режим Codex внутри приложения ChatGPT для macOS, Windows и Linux: панели diff, терминала, файлов, встроенный браузер, worktrees, задачи по расписанию
• Расширение для IDE — Работа от открытого в редакторе кода и выделенного фрагмента
• Codex Cloud — Длинные задачи на виртуальных машинах OpenAI, пока ваш компьютер выключен; несколько попыток решения одной задачи
• Интеграции — Ревью пулл-реквестов на GitHub, запуск задач из Slack и Microsoft Teams в корпоративных тарифах
• SDK и CI — Встраивание агента в собственные инструменты и пайплайны
CLI — проект с открытым исходным кодом, написанный на Rust (репозиторий openai/codex на GitHub). Это удобно: можно читать исходники, следить за изменениями и сообщать об ошибках.
Модели под капотом
Codex — это «обвязка» (harness), а интеллект ему дают модели OpenAI. На момент написания книги основной моделью для Codex является GPT-6.1 Sol, представленная на DevDay 29 сентября 2026 года. Для самых сложных задач есть более мощная и дорогая GPT-6 Astra, для простых повторяющихся задач — быстрая и экономная GPT-6 Luna. Подробно о выборе модели и уровня рассуждений — в главе 3.
Доступ и тарифы
Codex входит в планы ChatGPT. Бесплатные и самые дешёвые тарифы дают доступ к Codex в десктоп-приложении с облегчённой моделью; планы уровня Plus и выше добавляют CLI, расширение IDE, облачные функции и основные модели; дорогие планы Pro, а также Business и Enterprise расширяют лимиты и открывают самые мощные режимы. Лимиты Codex общие с остальной работой в ChatGPT и сбрасываются по скользящим окнам.
Альтернатива — вход по ключу OpenAI API: тогда вы платите за токены по тарифам API, а не из лимитов подписки, но часть облачных функций, привязанных к аккаунту ChatGPT, недоступна. Для CI и автоматизации ключ API обычно удобнее.
Чем Codex не является
Codex не заменяет инженерное мышление. Агент не знает бизнес-контекста, который не записан в коде или документации; не несёт ответственности за продакшен; может уверенно ошибаться. Относитесь к нему как к очень быстрому и начитанному, но новому в проекте коллеге: ему нужно объяснять контекст, его работу нужно проверять, а доступы выдавать по принципу минимально необходимых.
Итоги главы
• Codex — агент: он сам читает код, меняет файлы и запускает команды.
• Один агент доступен в CLI, десктоп-приложении, IDE, облаке и CI с общей конфигурацией.
• Качество результата определяется постановкой задачи и проверкой, а не только моделью.
Глава 2. Установка и первый запуск
Установка CLI
Самый быстрый способ на macOS и Linux — официальный скрипт установки. Эта же команда обновляет уже установленную версию:
curl -fsSL https://chatgpt.com/codex/install.sh | sh
Альтернативы — Homebrew или npm (если у вас уже стоит Node.js):
brew install --cask codex
npm install -g @openai/codex
На Windows установка выполняется из PowerShell:
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
Проверьте результат и запомните две полезные команды:
codex --version # какая версия установлена
codex update # обновиться тем же способом, каким установлено
codex doctor # диагностика установки, конфига, входа и окружения
Песочница на Linux опирается на bubblewrap; если ваш пакетный менеджер не поставил его автоматически, установите отдельно. На macOS песочница использует встроенный механизм Seatbelt и ничего дополнительно не требует.
Вход в аккаунт
При первом запуске codex предложит выбрать способ входа:
• Вход через ChatGPT — используются лимиты вашей подписки. Вариант по умолчанию для большинства.
• Вход по коду устройства — для машин без браузера, например сервера, к которому вы подключились по SSH. Код вводится на другом устройстве.
• Собственный ключ API — оплата за токены по тарифам OpenAI API.
Войти можно и без запуска сессии:
codex login # обычный вход через браузер
codex login --device-auth # вход по коду на сервере
printenv OPENAI_API_KEY | codex login --with-api-key
codex login status # каким способом вы сейчас вошли
Совет. Передавайте ключ API через переменную окружения и конвейер, как в примере выше, а не прямо в командной строке. Так он не попадёт в историю оболочки.
Подготовка учебного проекта
Для экспериментов заведите маленький репозиторий, который не жалко сломать. Обязательно инициализируйте Git и сделайте первый коммит: Git — ваша кнопка «отменить» при работе с агентом, а многие функции Codex (просмотр diff, ревью, codex exec) опираются на него.
mkdir codex-lab && cd codex-lab
git init
# ... создайте пару файлов с кодом и тестами ...
git add . && git commit -m "Initial commit"
Первая сессия
Запустите codex в папке проекта. Первый вопрос, который вы увидите, — «доверять ли этой папке». Доверие разрешает Codex загружать проектные настройки из .codex/, хуки и правила, которые могут автоматически выполнять код. Для своего проекта отвечайте «да». Для только что склонированного чужого репозитория — сначала посмотрите, что лежит в .codex/.
Первый запрос делайте «только для чтения» — так вы увидите, как агент понимает проект, ничего не рискуя:
Объясни, что делает этот проект и как он устроен. Ничего не меняй.
В ленте над полем ввода вы увидите каждый прочитанный файл и каждую выполненную команду. Это важная привычка: смотрите не только на итоговый ответ, но и на ход работы.
Три специальных символа в поле ввода
• @ — упомянуть файл: начните вводить имя, выберите из списка, и путь попадёт в запрос.
• ! — выполнить команду оболочки самому, не выходя из Codex, например !npm test. Команда исполняется с теми же ограничениями песочницы.
• $ — вызвать скилл по имени (подробнее в главе 10).
Картинки тоже работают: вставьте скриншот ошибки или макет в поле ввода или передайте файл при запуске:
codex -i error.png "Объясни ошибку на скриншоте и предложи минимальное исправление"
Первое изменение
Теперь попросите агента что-то изменить и проверить:
Добавь в функцию parseDate обработку пустой строки: она должна возвращать null.
Допиши тест на этот случай и запусти тесты.
Codex откроет нужные файлы, внесёт правку, добавит тест и запустит тестовый набор. Каждое изменение отображается как diff. С настройками по умолчанию агент не спрашивает разрешения на редактирование файлов внутри проекта и запуск тестов, но остановится и спросит, если ему понадобится сеть (например, чтобы установить пакет).
