Hooks 在 Codex 生命周期里运行你写的脚本，用于日志、合规扫描、提示词检查、停止时验证。

Hooks：生命周期里的确定性脚本

Hooks 不能让模型变聪明，但能让模型在固定时机走固定流程。最适合做"每次都要做的事"。

文件位置

用户级：~/.codex/hooks.json 或 ~/.codex/config.toml
项目级：<repo>/.codex/hooks.json 或 <repo>/.codex/config.toml

常见事件

SessionStart / Stop
UserPromptSubmit
PreToolUse / PostToolUse
PreCompact / PostCompact
SubagentStart / SubagentStop

示例：每次 prompt 提交前打印日志

{
  "UserPromptSubmit": [
    {
      "command": "./scripts/log-prompt.sh",
      "matcher": "*"
    }
  ]
}

信任与治理

注意：非 managed hooks 需要审查后才能信任运行。企业可通过 managed configuration 把核心 hooks 统一下发。