Codex のフックが動かないとき：確認・信頼とフック機能のスイッチ

1. 確認して信頼しましたか

Codex はフックのいまのハッシュに対して信頼を記録します。そのため新しく追加されたフックや変更されたフックは「確認が必要」と表示され、信頼するまでスキップされます。起動時に確認待ちのフックがあると、/hooks を開くよう警告が出ます。プラグインのフックも同じで、プラグインの更新で同梱のスクリプトが変わると、フックの定義が同じでも改めて確認が必要です。

直し方：そのプロジェクトで codex を起動し、セッションの中で /hooks と入力して出どころとコマンドを確認してから信頼します（シェルで codex /hooks と打つコマンドではありません）。デスクトップアプリでは入力欄の Review hooks か Settings › Hooks で行います。すでに開いていたセッションは新しく始め直すのが確実です。

--dangerously-bypass-hook-trust は、その 1 回の実行に限り、信頼の記録なしで有効なフックを動かします。自分で書いたフックを試すときだけ使い、中身を読んでいないフックには使わないでください。

2. フック機能そのものがオフになっていませんか

フックは初期設定でオンですが、~/.codex/config.toml の [features] に hooks = false があると、すべてのフックが動きません。古い名前の codex_hooks も、まだ同じ意味で読まれます。この状態では Codex がフックを読み込まないので、/hooks に信頼する項目も出てきません（codex-cli 0.163・0.166 で確認）。

直し方：その行を消すか hooks = true に変えて、Codex を起動し直します。CODEX_HOME を別に使っているなら、そのフォルダの config.toml を見てください。信頼の記録もその Codex ホームの設定に残るので、別の CODEX_HOME では改めて確認が必要です。

3. 組織のポリシーで止められていませんか

管理者が requirements.toml に allow_managed_hooks_only = true を設定すると、ユーザー・プロジェクト・セッション・プラグインのフックはスキップされ、管理フックだけが読み込まれます。管理フックはポリシーで信頼されており、ユーザーのフック画面からはオフにできません。この場合は手元で直す方法がないので、管理者に問い合わせてください。

4. プロジェクトのフックなら

<リポジトリ>/.codex/hooks.json のフックは、そのプロジェクトの .codex/ レイヤーを信頼したときだけ読み込まれます。信頼していないプロジェクトでも、ユーザーとシステムのフックはそのまま動きます。同じレイヤーに hooks.json と config.toml の [hooks] が両方あると、Codex は両方をまとめ、起動時に警告します。

Codex がまったく起動しないとき

config.toml に approval_policy = "untrusted" が残っていると、いまの Codex は approval_policy = "untrusted" is no longer supported; remove this setting というエラーですぐに終了します（codex-cli 0.163・0.166 で確認）。その行を消すか、on-request に変えてください。

Lidnight なら

Lidnight で Codex を連携すると、Codex が実際に動かす Lidnight のフック（コマンド・タイムアウト・ハッシュ）をそのまま表示し、ボタンを押したときだけ、そのフックだけを信頼します（公式の codex app-server を使用し、ほかのツール・プロジェクト・プラグインのフックには触れません）。フック機能がオフなら理由を表示し、確認のうえでその 1 行だけをオンにします（元に戻せます）。管理ポリシーが原因ならそう伝えます。Codex が設定エラーで起動できないときは、そのエラーの 1 行目を画面に表示します。

確認：2026-11-07、OpenAI の Codex ドキュメント「Hooks」（learn.chatgpt.com/docs/hooks）と codex-cli 0.163・0.166 の実行に基づきます。変わっている可能性があるので、ドキュメントを確認してください。