Codex
Coding-agent с AGENTS.md, config.toml, subagents, hooks и plugin-проекцией
- codex
- harness
- setup
Codex — локальный coding-agent OpenAI, который работает в терминале и встраивается в project workflow. Главный договорённый файл — AGENTS.md: из него агент получает правила проекта. Остальные части setup лежат в config.toml, prompts, subagents и hooks; plugin — это упаковка, но она не отменяет нативные правила Codex.
Нативная поверхность
| Область | Что читает Codex | Как это отражается в ai-stp |
|---|---|---|
| Пользователь | $CODEX_HOME/AGENTS.md, prompts/, config.toml, agents/*.toml | Global instruction, command, setting, MCP и agent |
| Проект | .codex/config.toml, .codex/agents/*.toml, .codex/hooks.json | Проектные setting, agent и hook |
| Plugin | .codex-plugin/plugin.json и объявленные ресурсы пакета | Plugin projection без выдуманного agents/ subtree |
| Shared skills | .agents/skills/ | Portable skills, доступные нескольким harness |
Для subagent Codex важен именно формат agents/<name>.toml с обязательными полями роли. Нельзя переносить туда markdown-файл только потому, что другой harness хранит agents в .md. Аналогично, MCP распознаётся по ключу mcp_servers внутри config.toml, а не по одному факту наличия файла.
Как собирается setup
ai-stpнаходитAGENTS.md, настройки, команды, subagents и объявленные MCP только в их нативных местах.- Passport фиксирует harness, scope, component kind, версию и источник. Auth-файлы, cache и session history исключаются.
- Setup assembler проверяет, что выбранные компоненты совместимы с Codex и с выбранной областью проекта.
- Публичный
codex-setup-systemполучает exact plan и применяет его в$CODEX_HOMEили project target. Веб-каталог не пишет в рабочий Codex напрямую.
Так AGENTS.md остаётся always-on instruction, skill — переносимым workflow, subagent — отдельной ролью, hook — реакцией на событие, а MCP — конфигурацией внешнего сервиса.
Когда выбирать Codex
Codex удобен для репозиториев, где правила хочется хранить рядом с кодом в AGENTS.md, а параметры и integrations — в config.toml. Для переносимой команды используйте shared .agents/skills/; для специализированной роли оформляйте именно нативный TOML subagent.
Ссылки
- Официальная документация Codex
- Руководство по AGENTS.md
- Исходный код Codex CLI
- Публичный codex-setup-system NDDev OpenNetwork
Граница доверия
Поддержка Codex в каталоге означает поддержку declared surfaces, а не автоматическое одобрение любого AGENTS.md, plugin или команды. Проверяйте содержимое, exact version, permissions и rollback.
Наблюдение → passport → проверка графа → exact plan → запись через provider. Это защищает project rules от случайного смешения с состоянием Codex.