hooks / async-and-limits · 約 7 分

async と出力上限

背景実行、8並列、2500トークン、SessionEnd の短い timeout を読みます。

学習目標

timeout は秒です。省略時は多くの hook が 600 秒です。SessionEnd と Interrupt は既定 1 秒、最大 3 秒です。どちらも常に同期で、async: true でも同期です。 ^{[codex-hooks]}

背景実行は "async": true です。ブロックや deny、rewrite はできません。セッションあたり最大 8 本です。

additionalContext は既定およそ 2,500 トークンでディスクへ退避します。additionalContextLimit で変えられます。0 は無制限で、context を食い潰す危険があります。 ^{[codex-hooks]}

Windows 上書きは commandWindows / command_windows です。 ^{[codex-config-ref]}

stdin の共通フィールドは session_id、transcript_path、cwd、hook_event_name、model です。ターン内は turn_id もあります。permission_mode の値一覧は公式記述をそのまま使います。

前提

hooks.json があること。

なぜ必要か

長いログをそのままモデルへ返すと、性能が落ち、秘密が残ることがあります。

実行場所

読み物と JSON 確認です。破壊的な無制限出力は試しません。

成功結果

hooks.json に timeout と Stop があります。

失敗対処

背景 hook で deny しようとしても効きません。ポリシーは同期の PreToolUse に置きます。 ^{[codex-hooks]}