Codex CLI. Agentic Engineering from First Principles
Codex CLI — это практико‑ориентированное руководство по созданию, настройке и масштабированию интеллектуальных CLI‑агентов для разработки ПО. Материал выстроен так, чтобы дать читателю не только теорию, но и прикладные техники, которые можно сразу внедрять в рабочие процессы команды или индивидуальной разработки.
Руководство охватывает полный цикл работы с агентной инженерией на базе OpenAI Codex CLI — от базовых принципов до сложных системных конфигураций. Читателя ждут:
AGENTS.md для различных сценариев;Каждая глава сопровождается четкими целями обучения, понятными примерами и практическими заданиями. Такой подход обеспечивает глубокое понимание того, как агенты работают «под капотом» и как извлечь из них максимум пользы в реальной разработке.
Книга написана Дэниелом Воном (Daniel Vaughan) — практикующим инженером и автором множества технических материалов по агентным системам. Его опыт работы с производственными средами и обратная связь от широкого ИТ‑сообщества сделали это руководство максимально прикладным и ориентированным на реальные задачи.
Агентная инженерия быстро становится ключевой компетенцией в современном цикле разработки. Владение Codex CLI дает конкурентное преимущество: вы сможете автоматизировать рутину, повышать качество кода, ускорять релизы и внедрять ИИ‑оркестрацию в масштабах команды или компании.
Помогаю организациям превращать инвестиции в ИИ в работающие промышленные системы, которые функционируют корректно с самого первого дня. Мой приоритет — не просто ускорение разработки, а принципиально более высокое качество решений при тех же затратах.За моими плечами 25 лет опыта в корпоративном секторе, стартапах и академической среде. Сегодня мой фокус полностью сосредоточен на самом масштабном технологическом сдвиге, который я когда-либо виде
21 June 2026
First, an apology. If you have been reading along, you will have noticed the
updates went quiet over the last few weeks. I want to explain why, because the
silence was deliberate, not neglect.
The book had started to behave like a changelog. Codex CLI ships weekly, often
more than once, and an automated, always-updating book ended up chasing every
release: new flags, renamed commands, features that arrived and were revised a
fortnight later. That produced a lot of motion but not much you could rely on. A
handbook that changes under you every few days is not a handbook; it is a feed.
So I stopped, and rewrote. I wanted something more stable: a book that
concentrates on the core, durable features of Codex CLI and the mental models
behind them, rather than the week's release notes. The architecture, the agent
loop, the context window, the approval and trust model, `AGENTS.md`, hooks,
sub-agents, orchestration, the practitioner workflows: these are the parts that
hold their shape while the surface details churn. Where a specific flag or
surface is genuinely in flux, the book now says so plainly rather than pretending
it is settled.
This is that stable version. It has been substantially revised, reviewed, and
restructured into a single coherent narrative you can read cover to cover or keep
on the desk as a reference. It is meant to be useful in six months, not just this
week.
Thank you for your patience through the quiet stretch. I think the result is
worth it.
Daniel Vaughan
Дата: 30 мая 2026 г.
Главное в этом обновлении: Книга приведена в соответствие с тремя стабильными релизами Codex CLI (v0.133.0, v0.134.0, v0.135.0), которые вышли с момента последнего обновления от 24 мая.
🚀 Крупные изменения и новые функции
Goal Mode GA (v0.133.0)
Что нового: Появились постоянные цели (objectives), которые сохраняются после компактизации и перезапуска сессий. Они работают на базе выделенного хранилища и отслеживаются между активными шагами. Это самое масштабное изменение модели взаимодействия со времен Smart Approvals.
В книге: Добавлен новый раздел в главу 3.
Appshots (v0.133.0, macOS)
Что нового: Двойное нажатие клавиши Command делает снимок активного окна (скриншот + структурированный текст) и автоматически вставляет его в текущую ветку обсуждения.
В книге: Добавлены новые разделы в главы 3 и 15.
TUI-команда /permissions (v0.135.0)
Что нового: Позволяет инспектировать активные именованные и кастомные профили, наглядно показывая происхождение каждого правила.
В книге: Добавлен новый раздел в главу 9.
⚠️ Критические изменения (Breaking Changes) и миграция
Изменение логики работы с профилями (v0.134.0)
Что изменилось: Флаг --profile теперь стал единственным способом активации. Старый синтаксис [profiles.*] и [profile.*] больше не поддерживается и вызывает ошибку.
Обновление в книге:
Примеры в главе 9 переведены на раздел [permissions.] для профилей разрешений.
Примеры в главе 11 переведены на конфигурацию для конкретных файлов ~/.codex/.config.toml для полноценных именованных профилей (которые содержат model, model_reasoning_effort, approval_policy, sandbox_mode).
Добавлено подробное руководство по миграции.
Устаревание wire_api = "chat"
В книге: В главу 11 добавлено предупреждение об отключении этого параметра (удален в феврале 2026 года).
🛠 Улучшения CLI и внутренняя архитектура
Расширенный codex doctor (v0.135.0)
Что нового: Более глубокая диагностика окружения, Git, терминала, app-сервера и инвентаризации потоков (threads).
В книге: Новый раздел в главе 10.
Миграция памяти в SQLite (v0.135.0)
Что нового: Состояние рантайма из оперативной памяти перенесено в выделенную базу данных SQLite.
В книге: Отмечено в главе 15.
Поиск по истории диалогов (v0.134.0)
Что нового: Добавлен регистронезависимый поиск по локальным сессиям.
В книге: Новый раздел в главе 15.
🔌 Интеграция с MCP (Model Context Protocol) и Схемы
Параллельные read-only инструменты MCP (v0.134.0)
Что нового: Инструменты, передающие флаг readOnlyHint, теперь автоматически выполняются параллельно.
В книге: Новый раздел в главе 12.
Надежность схем коннекторов (v0.134.0)
Что нового: Директивы $ref/$defs теперь сохраняются локально, а слишком громоздкие схемы автоматически сжимаются.
В книге: Новый раздел в главе 12.
Тестирование MCP-серверов
В книге: В главы 12 и 23 добавлено руководство по тестированию (юнит-тесты, интеграционный уровень и слой проверки на соответствие спецификации — conformance layer).
📦 Развитие экосистемы и SDK
Независимое версионирование Python SDK
Что нового: Пакет openai-codex 0.1.0b2 опубликован на PyPI. Представлен вспомогательный класс Sandbox (Sandbox.read_only, workspace_write, full_access) для работы с thread/turn API.
В книге: Новые разделы в главе 29.
Google ADK & MCP сервера
Что нового: Релиз Google ADK Python 2.0 GA (19 мая 2026), а также ADK Go 1.0 (23 марта 2026) и ADK Java 1.0 (30 марта 2026). Более 50 управляемых MCP-серверов перешли в статус GA.
В книге: Обновлено в главе 5.
Интеграция инфраструктуры
В книге: В главу 20 добавлены разделы по интеграции с Bazel monorepo и использованию Dagger Container-Use MCP.
🌐 Новости индустрии и партнеров (Обновления в Главе 5)
Динамические воркфлоу Claude Code: Добавлен разбор работы с Opus 4.8 (до 1000 агентов на один запуск через оркестратор).
Управление A2A v1.2: Проект перешел под эгиду Linux Foundation (более 150 организаций уже используют его в продакшене).
Ребрендинг Google: Отмечено переименование платформы Vertex AI в Gemini Enterprise Agent Platform.