🎯 О чём этот конспект: Разбор возможностей и настройки 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.Результат: Ускорение рутинных операций (тесты, схемы, верстка) в разы.
OpenAI Codex: ответы на частые вопросы
В: Чем 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