🎯 О чём этот конспект: Разбор возможностей и настройки OpenAI Codex — продвинутого AI-агента для кодинга. В видео демонстрируется работа с CLI и расширением для IDE, использование протокола MCP для расширения контекста и автоматизация рутинных задач (рефакторинг, документация, код-ревью).

👤 Кому будет полезно: Вайбкодерам, разработчикам и тимлидам, которые хотят делегировать AI-агенту написание кода, поддержку документации и автоматизацию CI/CD процессов.

✨ Что получите: Пошаговую инструкцию по установке, настройке контекста через agents.md, подключению внешних инструментов через MCP и созданию кастомных команд для ускорения разработки.

1. Установка и базовая настройка Codex

Контекст: Codex — это не просто чат-бот, а полноценный агент, который может работать в терминале (CLI), в IDE (VS Code) и даже в облаке. CLI позволяет запускать задачи в фоновом режиме, а расширение для IDE дает привычный UI. Важно использовать актуальные версии, так как обновления выходят несколько раз в неделю.

Выгода: Быстрый старт в любой среде разработки и доступ к самым мощным моделям (GPT-4o, Codex Max).

Как применить:

• Шаг 1: Установка CLI — [npm/brew] — Используйте терминал для установки:

# Через npm (рекомендуется для актуальности)
npm install -g @openai/codex
 
# Или через Homebrew
brew install openai/codex/codex

• Шаг 2: Установка в IDE — [VS Code] — Найдите в маркетплейсе расширение "OpenAI Codex". Включите "Auto Update", чтобы получать фиксы мгновенно.
• Шаг 3: Авторизация — [CLI] — Выполните команду для входа через Enterprise аккаунт:

codex login

• Шаг 4: Проверка статуса — [CLI] — Внутри сессии используйте команду /status, чтобы увидеть текущую модель, лимиты контекста и режим песочницы.

Результат: Полностью рабочая среда с подключенным AI-агентом.

2. Управление контекстом через Agents.md

Контекст: AI-агенты «забывают» детали проекта между сессиями. agents.md — это файл-инструкция (аналог Readme для AI), который Codex считывает автоматически при запуске в директории. Это позволяет передать агенту структуру проекта, правила кодинга и команды для запуска тестов.

Выгода: Агент перестает галлюцинировать и начинает использовать специфичные для вашего проекта инструменты и подходы.

Как применить:

• Шаг 1: Инициализация — [CLI] — Создайте базовый файл в корне проекта:

codex init

• Шаг 2: Наполнение контентом — [Markdown] — Добавьте в agents.md следующие разделы:
  • Обзор проекта и стек технологий.
  • Команды для сборки и запуска тестов (например, npm run test).
  • Ссылки на другие файлы документации (Progressive Discovery).
• Шаг 3: Создание шаблонов планов — [Markdown] — Для больших задач создайте plans.md. Codex будет использовать его как чек-лист, отмечая выполненные шаги в процессе 10-часовых рефакторингов.

Результат: Codex понимает специфику вашего репозитория без лишних промптов.

3. Настройка конфигурации через config.toml

Контекст: Все глобальные настройки Codex хранятся в файле config.toml. Здесь можно задать модель по умолчанию, уровень «рассудительности» (reasoning effort) и правила безопасности (sandbox).

Выгода: Экономия времени на настройку каждой сессии и адаптация агента под разные задачи (быстрые правки vs глубокий анализ).

Как применить:

• Шаг 1: Редактирование конфига — [TOML] — Откройте файл конфигурации (обычно в ~/.config/codex/config.toml) и настройте профили:

[profiles.fast]
model = "gpt-4o-mini"
reasoning_effort = "low"
 
[profiles.heavy]
model = "o1-preview"
reasoning_effort = "high"
 
[features]
web_search = true
terminal_notifications = true

• Шаг 2: Использование профилей — [CLI] — Запускайте Codex с нужным пресетом:

codex -p fast

Результат: Мгновенное переключение между «быстрым» и «умным» режимами работы.

4. Использование MCP (Model Context Protocol)

Контекст: MCP позволяет подключать Codex к внешним данным: Jira, Figma, документации библиотек или вашим собственным API. Это превращает кодинг-агента в полноценного сотрудника, который видит тикеты и актуальные спецификации.

Выгода: Codex получает доступ к данным в реальном времени, которые не входили в его обучение.

Как применить:

• Шаг 1: Добавление сервера — [CLI] — Подключите, например, сервер для получения свежей документации:

codex mcp add context7 --command "npx -y @context7/mcp-server"

• Шаг 2: Использование в промпте — [Prompt] — Теперь можно просить агента использовать свежие доки:

Реализуй интеграцию с OpenAI Responses API, используя актуальную спецификацию из context7.

• Шаг 3: Автоматизация в agents.md — [Markdown] — Добавьте инструкцию в глобальный agents.md, чтобы Codex всегда проверял документацию через MCP перед написанием кода.

Результат: Код всегда соответствует последним версиям библиотек.

5. Продвинутые фишки: Скриншоты, Mermaid и Кастомные команды

Контекст: Codex поддерживает мультимодальность и специфические форматы вывода. Вы можете скинуть ему скриншот бага, и он поправит CSS, или попросить визуализировать архитектуру.

Выгода: Сокращение времени на описание визуальных правок и создание схем.

Как применить:

• Инсайт 1: Правка по скриншоту — [IDE/CLI] — Просто вставьте скриншот в чат с промптом:

Сделай эти кнопки оранжевыми как на макете и выровняй их по центру.

• Инсайт 2: Генерация диаграмм — [Mermaid] — Попросите визуализировать логику:

Создай Mermaid sequence diagram для процесса авторизации в этом проекте.

• Инсайт 3: Кастомные команды — [Markdown] — Создайте файл ~/.config/codex/prompts/test.md с инструкцией по написанию тестов. Теперь в CLI доступна команда @test:

# Внутри файла test.md:
Сгенерируй unit-тесты для всех измененных файлов, используя Jest.

Результат: Ускорение рутинных операций (тесты, схемы, верстка) в разы.

FAQ

В: Чем Codex отличается от обычного ChatGPT в браузере?

О: Codex имеет прямой доступ к вашей файловой системе, терминалу и контексту всего репозитория. Он может сам запускать тесты, читать логи ошибок и вносить правки в несколько файлов одновременно, соблюдая иерархию проекта.

В: Безопасно ли давать агенту доступ к записи файлов (Workspace Write)?

О: По умолчанию Codex работает в режиме песочницы. Вы можете настроить approval_policy = "on_requests" в config.toml, тогда агент будет запрашивать разрешение на каждое потенциально опасное действие или выполнение команд в терминале.

В: Как заставить Codex делать код-ревью по моим правилам?

О: Создайте файл code-review-guidelines.md, опишите в нем стандарты вашей команды и сошлитесь на него в agents.md. При запуске команды codex review агент будет использовать эти правила как приоритетные.

В: Можно ли использовать Codex для очень больших задач (на 5-10 часов)?

О: Да, для этого используется связка agents.md и plans.md. Агент составляет план, записывает его в файл и итеративно выполняет шаги, сохраняя прогресс. Даже если сессия прервется, её можно возобновить командой codex resume.

В: Что такое Headless режим (codex exec)?

О: Это запуск Codex без интерактивного чата. Вы подаете команду и получаете структурированный JSON-ответ. Это идеально для встраивания Codex в CI/CD пайплайны для автоматической проверки качества кода или генерации чейнджлогов.

Конспект создан на основе видео «Getting Started with Codex» канала OpenAI. Все права на оригинальный материал принадлежат авторам. Источник: https://www.youtube.com/watch?v=px7XlbYgk7I