Codex Guide

Тема

Rules и hooks ​

Проверено: 20 июля 2026 года по официальной документации OpenAI.

Rules управляют решениями для команд вне sandbox, а hooks запускают ваши проверочные команды на событиях жизненного цикла Codex. Это разные механизмы: rule отвечает «разрешить ли команду», hook — «какую дополнительную проверку выполнить».

Что выбрать ​

МеханизмНазначение
Rulesallow, prompt или forbidden для точного префикса команды
HooksПроверка, уведомление или аудит до/после события Codex
AGENTS.mdТекстовые правила работы в каталоге
Managed requirementsОбязательные ограничения организации

Инструкция в AGENTS.md не заменяет техническое ограничение, а hook не является полной границей безопасности.

Rules ​

Rules считаются экспериментальной возможностью. Пользовательские файлы обычно находятся рядом с активной конфигурацией, например ~/.codex/rules/default.rules; проектные — в доверенном каталоге .codex/rules/.

python
prefix_rule(
    pattern = ["gh", "pr", "view"],
    decision = "prompt",
    justification = "Чтение pull request требует явного сетевого доступа",
    match = ["gh pr view 42"],
    not_match = ["gh issue view 42"],
)

Правило сопоставляет точный префикс аргументов, а не произвольную строку shell. Если совпало несколько правил, действует наиболее строгий результат. Составные shell-команды могут анализироваться по частям только тогда, когда это безопасно и однозначно.

После изменения перезапустите Codex. В поддерживающих это версиях правило можно проверить до использования:

bash
codex execpolicy check --pretty --rules ~/.codex/rules/default.rules -- gh pr view 42

Сначала проверьте наличие execpolicy в своей версии CLI.

Hooks ​

Пользовательские hooks задаются в ~/.codex/hooks.json, проектные — в .codex/hooks.json или проектном config.toml. Проект должен быть доверенным. Минимальная форма hook:

json
{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "/absolute/path/to/project/scripts/codex-verify.sh",
            "timeout": 120,
            "statusMessage": "Проверка результата"
          }
        ]
      }
    ]
  }
}

Замените абсолютный путь на реальный и храните сам скрипт в Git. Не добавляйте в hook токены или команды публикации.

Полезные события включают SessionStart, UserPromptSubmit, PreToolUse, PermissionRequest, PostToolUse, PreCompact, PostCompact, SubagentStart, SubagentStop и Stop. На дату проверки выполняются command-handlers; объявленные типы prompt/agent и асинхронное выполнение могут быть распознаны конфигурацией, но не исполняться.

Все совпавшие hooks могут запускаться, в том числе параллельно. Поэтому скрипты должны быть идемпотентными и не конфликтовать за один файл.

Доверие и диагностика ​

Команда /hooks показывает найденные hooks и позволяет управлять доверием или отключением. Codex учитывает содержимое доверенного hook; после изменения файла доверие может потребоваться подтвердить снова. При необходимости hooks можно глобально отключить параметром features.hooks = false.

PreToolUse и другие tool hooks полезны как guardrail, но не заменяют sandbox, approvals и системную политику доступа.

Источники ​