Что такое кодекс OpenAI?

Codex — это агент для кодирования от OpenAI. Он считывает репозиторий, планирует изменения, редактирует файлы, выполняет команды в песочнице и предоставляет вам разницу для проверки — из четырех платформ, использующих одну и ту же конфигурацию: приложение Codex, расширение IDE, интерфейс командной строки и облачная/веб-среда для длительных или фоновых задач. Потому что все четыре платформы считывают один и тот же код. ~/.codex В настройках сервера MCP или плагина, который вы однажды установили, он сохраняется между терминалом и IDE.

Суммируя: Codex — это не столько отдельный инструмент, сколько среда выполнения — место, где навыки, подключения приложений и серверы MCP объединяются вокруг задачи программирования, вместо того чтобы вам приходилось заново создавать одну и ту же конфигурацию в каждом проекте.

Почему разработчики внедряют Codex

Большинство сравнений «помощников по программированию на основе ИИ» сосредоточены на качестве модели, но более интересным является структурный сдвиг. Codex разделяет три вещи, которые раньше находились в одном большом системном запросе: инструкции (AGENTS.md), многоразовые процедуры (навыки), и доступ к инструментам (приложения и серверы MCP). Именно это разделение делает возможным создание плагинов — плагин представляет собой просто набор из этих трех компонентов, которые можно установить и удалить как единое целое, вместо того, чтобы вставлять стандартный код в каждый новый чат.

Практический результат: команда может стандартизировать процесс проверки запросов на слияние, чтения проблем в Sentry или составления документации в рамках Codex и распространять этот стандарт в виде устанавливаемого пакета, а не в виде вики-страницы, которую никто не читает.

Установка и настройка Codex

Интерфейс командной строки (CLI) — это самый быстрый способ увидеть, как настройки вступают в силу. Codex хранит настройки в ~/.codex/config.toml по умолчанию (можно переопределить с помощью CODEX_HOME (для профиля, специфичного для конкретного проекта).

# Откройте браузер плагинов в CLI codex /plugins # Добавьте MCP-сервер непосредственно из CLI codex mcp add context7 -- npx -y @upstash/context7-mcp # Просмотрите активные MCP-серверы в запущенной сессии /mcp

Для более точного контроля — тайм-аутов, списков разрешенных инструментов, режимов утверждения для каждого инструмента — отредактируйте config.toml напрямую. Вот минимальный, реалистичный блок для потокового HTTP-сервера MCP:

[mcp_servers.figma] url = "https://mcp.figma.com/mcp" bearer_token_env_var = "FIGMA_OAUTH_TOKEN" [mcp_servers.figma] startup_timeout_sec = 20 tool_timeout_sec = 45

Плагины против навыков против приложений против MCP

В маркетинговых текстах эти четыре термина используются взаимозаменяемо, именно поэтому новички часто сталкиваются с трудностями. Вот различие, которое действительно имеет значение при принятии решения о том, что устанавливать.

Поэтому, когда кто-то говорит «установите плагин GitHub», на ваш компьютер фактически устанавливается навык, подключение к приложению, сервер MCP или все три сразу — плагин является лишь оболочкой, которая делает его устанавливаемым и доступным для совместного использования.

Каталог плагинов

Codex разделяет плагины на три группы, независимо от того, просматриваете ли вы их в приложении или в командной строке:

• Подборка от OpenAI — проверенные плагины, доступные всем пользователям Codex.
• Поделился с вами — плагины, опубликованные внутри вашей рабочей области ChatGPT другим участником.
• Создано вами — плагины, которые вы создали и добавили в свою рабочую область.

Установка везде одинакова: откройте страницу с подробной информацией о плагине, выберите «Установить» (или Установите плагин (через CLI), подключите любое необходимое внешнее приложение, когда появится соответствующий запрос, а затем создайте новый поток перед его использованием. Ваши существующие настройки подтверждения по-прежнему будут определять, что разрешено делать плагину после его запуска — установка не предоставляет общих разрешений.

Чтобы отключить плагин, не удаляя его, измените его запись в config.toml:

[plugins."gmail@openai-curated"] enabled = false

Экосистема плагинов Codex

На момент написания этой статьи, тщательно отобранный каталог OpenAI сосредоточен на конкретном наборе инструментов, а не на обширном каталоге приложений из магазинов приложений — это сделано намеренно, поскольку каждый отобранный плагин прошел проверку. Сторонние плагины и плагины, созданные в рамках рабочих пространств, выходят далеко за рамки этого списка, но они имеют разные гарантии надежности, поэтому стоит знать, какой из них к какой относится.

Как читать карту плагина

В этом руководстве для каждого плагина указано, за каким типом границы доверия он находится:

Разработка

Документация и дизайн

Производительность

Отладка

Развертывание

Интеграция с GitHub

GitHub получает особое отношение, поскольку Codex поставляется как с тщательно отобранным плагином, так и с более глубокой интеграцией с собственными компонентами, а также со специальным действием GitHub Action для запуска в рамках CI. На практике это означает три отдельных точки входа: назначение Codex к задаче из пользовательского интерфейса GitHub, вызов из командной строки для репозитория, находящегося в репозитории, или запуск из файла рабочего процесса при каждом запросе на слияние. Команды, стандартизирующие использование Codex для проверки кода, обычно начинают с действия Action, поскольку это не требует от каждого участника локальной настройки Codex.

Интеграция Figma

Figma подключается к Codex через собственный сервер MCP, а не через интеграцию со стороны Codex, как в локальном (настольное приложение), так и в удаленном (хостинг) варианте. Это хорошая иллюстрация модели плагинов в лучшем её проявлении: OpenAI не нужно было создавать инструменты, специфичные для Figma, ей нужно было лишь хорошо поддерживать MCP, а сервер Figma делает всё остальное. Компромисс заключается в том, что поведение сервера, ограничения скорости и надежность находятся вне контроля OpenAI.

Интеграция понятий

Этот специально разработанный плагин для Notion объединяет функции чтения/записи страниц и базы данных с возможностями, оптимизированными для преобразования результатов работы инженеров — журналов коммитов, сводок запросов на слияние, хронологий инцидентов — в структурированный контент Notion. Это одно из очевидных преимуществ для команд, которые уже используют Notion в качестве источника достоверной информации для принятия решений, поскольку оно устраняет необходимость «вручную обновлять документ».

Интеграция со Slack

Как и GitHub, Slack имеет как специально разработанный плагин, так и более глубокую встроенную интеграцию. Практическое различие проявляется в рабочих процессах, чувствительных к задержкам: встроенные интеграции, как правило, поддерживают более сложные триггеры (запуск Codex, инициированный сообщением в Slack, а не просто публикация Codex в Slack), тогда как плагин сам по себе обычно обеспечивает одностороннюю связь между Codex и каналом.

Интеграция Sentry

Sentry, пожалуй, является наиболее эффективным плагином для команды, которая и так быстро выпускает новые продукты, поскольку он сводит процесс "заметил ошибку → нашел трассировку стека → нашел коммит → предложил исправление" к единому диалоговому циклу. Подвох в том, что Codex с удовольствием предложит исправление для устаревшей или дублирующейся проблемы, если вы не зададите конкретную область запроса (открытые проблемы, последние 24 часа, конкретный проект), поэтому конкретность запроса здесь важнее, чем почти в любом другом месте этого руководства.

Автоматизация браузера

Для всего, что работает в браузере, а не через API — визуальной проверки изменений пользовательского интерфейса, парсинга страницы, не имеющей общедоступного API, управления процессом авторизации — Codex использует серверы MCP для браузеров, а не специальный «плагин для браузера». В документации чаще всего упоминаются Playwright и Chrome DevTools, оба управляются через MCP. Приложение Codex также включает в себя собственный встроенный браузер и расширение для Chrome, обеспечивающее более тесную связь между «просмотром страницы» и «редактированием кода».

Рабочий процесс терминала

В командной строке (CLI) осуществляется фактическая настройка плагинов и MCP. Несколько команд, которые стоит запомнить:

/plugins # просмотр, установка и переключение плагинов по маркетплейсу /mcp # список активных MCP-серверов в этой сессии codex mcp add # добавление нового MCP-сервера из командной строки codex mcp --help

В вкладках «Магазин плагинов» браузера плагинов нажмите Космос Включение или выключение установленного плагина на текущий сеанс — полезно, когда вы хотите исключить плагин как причину неожиданного вызова инструмента, не удаляя его полностью.

AGENTS.md

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

# AGENTS.md ## Требования к репозиторию - Запустите `npm run lint` перед созданием запроса на слияние. - Документируйте общедоступные утилиты в docs/ при изменении их поведения.

Вложенный AGENTS.override.md Файлы позволяют конкретной подкаталогу (например, платежному сервису со строгими правилами) полностью заменить приведенные выше указания, а не добавлять к ним что-либо — это полезно в монорепозиториях, где "запустить тесты" означает что-то разное в каждом пакете.

Память

Система локальной памяти Codex отделена от веб-памяти ChatGPT и по умолчанию отключена. После включения Codex может преобразовывать контекст из неактивных, доступных прошлых сессий в локальные файлы памяти. ~/.codex/memories/при этом секреты удаляются по ходу дела, а короткие беседы пропускаются, чтобы не сводиться к подведению итогов работы, которая еще не завершена.

[функции] воспоминания = true

Стоит знать о двух параметрах: воспоминания.использовать_воспоминания контролирует, будут ли прошлые воспоминания внедряться в новые сессии, и memories.disable_on_external_context Это позволяет полностью исключить генерацию памяти для чатов, которые полагались на веб-поиск или вызовы инструментов MCP — удобно, если вы не хотите, чтобы сеанс обработки запросов в Sentry засорял память трассировкой стека другого пользователя.

Проектирование подсказок, контекста и циклов

Три взаимосвязанных, но различных навыка отличают разработчиков, которые борются с Кодексом, от разработчиков, которые быстро справляются с бэклогом, используя его.

Оперативное проектирование

Скажите, что именно вы хотите изменить и как это будет выглядеть в итоге, а не просто опишите симптом. Фраза «Исправить нестабильный тест оформления заказа» звучит слабее, чем «тест оформления заказа периодически дает сбой при проверке кода скидки — воспроизведите его, найдите состояние гонки и добавьте регрессионный тест».

Контекстная инженерия

Речь идёт о том, к чему имеет доступ Codex, а не о том, что вы вводите: правильная область действия AGENTS.md, правильные включённые серверы MCP, правильные открытые файлы. Даже идеально сформулированный запрос не сработает, если Codex не видит файл конфигурации, который фактически управляет поведением, о котором вы спрашиваете.

Проектирование циклов

Практика проектирования повторяющихся циклов «предложить → запустить → проверить → повторить» вместо одноразовых запросов — например, настройка Codex на запуск набора тестов после каждого изменения и продолжение итераций до тех пор, пока результат не станет положительным, вместо ручной проверки каждой попытки. В руководстве Codex этот шаблон описан непосредственно для итеративных циклов исправления.

Многоагентные и субагентные рабочие процессы

Codex поддерживает субагентов — экземпляры агентов с ограниченной областью действия, которым основная сессия Codex может делегировать определенные части работы. Практическое применение — распараллеливание независимой работы: один субагент запускает набор тестов и отчитывается, пока основная сессия продолжает редактирование, вместо того, чтобы один агент выполнял все последовательно. Это более новая и продвинутая платформа, чем плагины или MCP, и ее стоит рассматривать как оптимизацию после того, как ваш рабочий процесс с одним агентом уже станет надежным, а не как отправную точку.

Реальные рабочие процессы, шаг за шагом.

1. Создайте приложение React с помощью Codex.

Сначала создайте шаблон с четко определенным файлом AGENTS.md (менеджер пакетов, команда тестирования), а затем запросите добавление функции в виде результата. Запросите тесты одновременно с компонентом, а не как нечто второстепенное.

2. Устранение ошибок в рабочей среде с помощью плагина Sentry.

Определите область запроса, выясните первопричину проблемы, прежде чем вносить исправления, и потребуйте проведения регрессионного тестирования в той же самой ситуации.

3. Генерация пользовательского интерфейса непосредственно из Figma.

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

4. Пишите документацию на основе коммитов GitHub.

5. Рефакторинг устаревшего кода.

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

6. Автоматическая проверка запросов на слияние.

В данном случае GitHub Action — это правильная отправная точка: запускайте проверку Codex для каждого запроса на слияние, вместо того чтобы полагаться на то, что кто-то вспомнит запросить это вручную.

7. Сгенерируйте миграции SQL.

Без специализированного плагина для базы данных миграция обычно выполняется через сервер MCP, выделенный для вашего проекта, при этом миграция всегда проверяется и применяется вручную, а не выполняется автоматически.

8. Развертывание в Vercel

Даже после того, как развертывание в предварительной версии станет привычным делом, необходимо продолжать использовать этап ручного утверждения для развертывания в производственной среде.

Передовые методы

Принадлежащий

• Необходимо четко и конкретно определить область действия файла AGENTS.md — одно ясное правило лучше пяти расплывчатых.
• Запуск новых плагинов в быстрый режим подтверждения перед переключением на авто.
• Удаляйте плагины, которые вы не используете активно — каждый установленный инструмент является поверхностью для атаки.
• Ограничьте объем учетных данных сервера MCP до минимума, необходимого для выполнения задачи.

Не следует

• Не полагайтесь на память при определении правил, которые должны применяться всегда — используйте файл AGENTS.md.
• Не предоставляйте плагину права на запись в рабочую среду "для сохранения шага" — сохраненный шаг — это тот, который выявляет ошибки.
• Не следует объединять в одну сессию несвязанные серверы MCP только потому, что они установлены — каждый из них добавляет токены в контекст и увеличивает вероятность путаницы между инструментами.

Ошибки, которые допускают новички

• Рассматривать установку плагина как разовое решение, а не пересматривать его права доступа по мере развития проекта.
• Задания для написания текстов, описывающие симптом, а не желаемое конечное состояние.
• Полностью пропускаем файл AGENTS.md и заново объясняем правила работы с проектом в каждом запросе.

Контрольный список для организации хранилища

• Файл AGENTS.md корневого уровня, содержащий команду тестирования, менеджер пакетов и список запрещенных действий.
• Вложенный файл AGENTS.override.md используется только в тех случаях, когда подкаталог действительно отличается.
• Проект в рамках .codex/config.toml для серверов MCP, использующих данный репозиторий
• Краткий список плагинов, одобренных для этого репозитория, и причины их использования.

Часто задаваемые вопросы

Заключение

Система плагинов превращает Codex из просто хорошего автозаполнения в агента, который действительно может интегрироваться в основные инструменты вашей команды — GitHub, Figma, Sentry, Slack, Notion — без необходимости написания дополнительного кода. Всё это не заменяет здравого смысла: проверяйте изменения, определяйте режимы утверждения и следите за корректностью файла AGENTS.md. Начните с одного плагина, который устранит реальную ежедневную проблему, освойте его настройки утверждения и расширяйте функционал. Рабочий процесс, который экономит вам больше всего времени, редко бывает самым сложным — это тот, который вы действительно продолжаете использовать.