本文へスキップ
AI活用

Codexのhooksの使い方。Claude Codeと同じ「公開前に止めるhook」をCodexにも入れた

公開 約7分で読めます

TL;DRこの記事の要点

  • Codexにも、コマンドの実行前に止めるhook(PreToolUse)があり、Claude Code用のスクリプトがそのまま動いた
  • Codexでは/hooksで信頼するまで、エラーも出ずに素通りする
  • hooks.jsonが読まれないときは、config.tomlの[hooks]の欄を見る
  • ルール(prefix_rule)は先頭一致なので、sshやphp8.3が前に付くとすり抜ける
目次9項目
  1. ルールの文面はそろっていた。止めるしくみはそろっていなかった
  2. Codexのhooksとは
  3. 入れたもの
  4. 信頼するまで、素通りする
  5. hooks.jsonは読まれなかった
  6. 本番のスクリプトで止まるか確かめた
  7. ルール(prefix_rule)ではダメだった
  8. hookのほうの副作用
  9. 入れるときに見ておくこと

Claude CodeとCodexには、同じルールの文面を読ませています。
でも、公開の前に止めるhookは、Claude Codeにしか入っていませんでした。

🎥 この記事の内容は動画でも解説しています。

Codexにもhookがあったので、同じものを入れました。

先に結論です。

  • Codexにも、コマンドの実行前に止めるhook(PreToolUse)がある。止め方はClaude Codeとほぼ同じ
  • 自分のClaude Code用のスクリプトが、Codexからもそのまま動いた。スクリプトは1か所のまま、両方から呼んでいる
  • Codexでは、作ったhookを/hooksで「信頼」するまで動かない。信頼していないと、エラーも出ずに素通りする
  • Codexの「ルール」(prefix_rule)はコマンドの先頭しか見ないので、自分の使い方だとすり抜ける

ルールの文面はそろっていた。止めるしくみはそろっていなかった

このブログやYouTubeの作業は、Claude CodeとCodexにやってもらっています。
ルールの原本は1か所にしていて、Claude Codeが原本を編集したら、Codex用のAGENTS.mdを自動で作り直しています(AGENTS.mdとCLAUDE.mdを共通にする方法)。

ただ、記事を作るコマンドと動画をアップするコマンドの前で止めるhookは、Claude Codeの設定にだけ入っていました(Claude Codeのhooksの使い方)。
「確認が終わった」という印のファイルがないと、コマンドが動かないしくみです。

Codexで同じ作業をするときは、手順に書いた文章だけが頼りでした。
Codex用のルールにも「Claude Codeのhookは、Codexには一切作用しない」と書いてありました。

noteのルール記事に「3つのAIに同じルールを読ませている」というコメントをもらって、そういえば止めるほうはそろってないな、と思ったのがきっかけです。

Codexには、hookはないの?

ないと思い込んでた。調べてもらったら、公式のページにちゃんとあった。

Codexのhooksとは

Codexのhooksは、Codexが決まったタイミングで、自分で用意したコマンドを動かす機能です。
公式のドキュメントでは、コマンドの実行前(PreToolUse)・実行後(PostToolUse)・会話の始まり(SessionStart)などのタイミングが用意されています。

コマンドの実行前に止めるなら、PreToolUseを使います。

  • 置き場所: 全体なら~/.codex/config.tomlの[hooks]か~/.codex/hooks.json。プロジェクトごとなら.codex/hooks.json(そのプロジェクトの.codexを信頼しているときだけ読み込まれる)
  • hookには、実行しようとしているコマンドがJSONで渡される(tool_input.command)
  • 止めるときは、終了コード2で終わる(理由は標準エラーに出す)か、hookSpecificOutput.permissionDecisionを"deny"にしたJSONを返す

Claude Codeのhookと、ほぼ同じ形です。

入れたもの

自分のClaude Code用のスクリプトは、渡されたJSONのtool_input.commandを読んで、止めるときはpermissionDecision: "deny"のJSONを返す作りでした。
Codexも同じ形を受け付けるので、スクリプトはそのまま使えました。

Codexの~/.codex/config.tomlに、こう足しています。

[[hooks.PreToolUse]]
matcher = "^Bash$"

[[hooks.PreToolUse.hooks]]
type = "command"
command = "bash /path/to/qa_gate.sh"
timeout = 10

[[hooks.PreToolUse.hooks]]
type = "command"
command = "bash /path/to/eyecatch_gate.sh"
timeout = 10

matcher = "^Bash$"で、シェルのコマンドを動かすときだけに絞っています。
1つ目が、確認の印がないと公開のコマンドを止めるもの。
2つ目が、余白や文字の大きさを測っていないアイキャッチを記事に設定させないものです。

スクリプトはコピーせず、Claude Codeと同じファイルを呼んでいます。
直すときは1か所で済みます。

信頼するまで、素通りする

ここが、Claude Codeといちばん違うところでした。

Codexでは、自分で作ったhookは、Codexの画面で/hooksを開いて「信頼する」を選ぶまで動きません。
中身を書き換えたら、また信頼し直しです。

最初に、テスト用のフォルダで「BLOCKMEという文字が入ったコマンドを止める」hookを置いて試してもらいました。

  • 信頼する前: echo BLOCKMEがそのまま実行された。エラーも警告も出ない
  • 信頼したあと: 「Command blocked by PreToolUse hook」で止まった
  • 前に別のコマンドが付いたcd /tmp && echo BLOCKMEも止まった(hookにはコマンド全体の文字列が渡る)
  • 画面を開かずに動かすcodex execでも止まった

信頼の操作は、Codexの画面を開いて自分でやりました。
Claude Codeが代わりにできないところです(信頼を飛ばすオプションもありますが、名前に「DANGEROUS」と付いていて、今回は使っていません)。

hooks.jsonは読まれなかった

もう一つ詰まったところがあります。

最初は~/.codex/hooks.jsonに書きました。
でも、信頼の画面に出てこなくて、コマンドも止まりませんでした。

config.tomlを見ると、テストで信頼した記録が[hooks]の欄に入っていました。
定義をconfig.tomlの[[hooks.PreToolUse]]に移したら、信頼の画面に2つ出てきて、動くようになりました。

同じ場所に2つあると、片方が読まれないのかもしれません(公式の説明では確かめられていないので、自分の環境ではこうだった、という話です)。
止まらないときは、config.tomlに[hooks]の欄がないか見てみてください。

本番のスクリプトで止まるか確かめた

入れたあと、Codexに「echo "wp post create test.html"を実行して」と頼みました(投稿を作るコマンドの名前が入っているだけの、無害なコマンドです)。

  • 確認の印がないとき: 「QAゲート: 公開直前のQA済みマーカーが見つかりません」で止まった
  • 印を作ってから同じことを頼んだとき: 通って、印は消えた

Claude Codeとまったく同じ動きです。

ただ、確かめているのは印があるかどうかだけで、チェックの中身までは見ていません。
印を作るのもAIなので、そこはClaude Codeのときと変わりません。
公式のドキュメントでも、hookは「完全に止めきるしくみではなく、ガードレールとして扱う」ように書かれています。

ルール(prefix_rule)ではダメだった

Codexには、hookとは別に「ルール」という止め方もあります。
prefix_ruleでコマンドの形を書いて、forbiddenにすると実行させません。

こちらもcodex execpolicy checkで試してもらいました。
テスト用にpublish-postというコマンドを止めるルールを書くと、こうなりました。

コマンド 結果
publish-post a.html 止まる
php8.3 publish-post a.html 止まらない
bash -lc "publish-post a.html" 止まらない
ssh host "publish-post a.html" 止まらない

ルールは、コマンドの先頭が一致したときに働きます。
今回書いたルールでは、前にphp8.3やsshが付いた形には一致しませんでした。
自分の本番の投稿は、sshでサーバーに入ってphp8.3で動かす形なので、文字列全体を見られるhookにしました。

hookのほうの副作用

文字列全体を見るぶん、関係ないときにも止まります。

この作業をしていた日だけで、Claude Code側のhookが3回止まりました。
どれも、作業記録を書き足すコマンドの中に「post create」や、アイキャッチを設定するオプションの名前が入っていただけでした。
そのたびに、書く内容をファイルに分けてから動かしてもらっています。

じゃまじゃない?

じゃま。でも、止まらないよりはいいかな。

入れるときに見ておくこと

  1. Claude Code用のhookがあるなら、Codexでもそのまま動くか試す(渡されるJSONと止め方がほぼ同じ)
  2. 入れたら、Codexの/hooksで信頼する。中身を変えたら信頼し直す
  3. 止めたいコマンドを、無害な形(echoなど)で頼んで、本当に止まるか見る
  4. 止まらないときは、config.tomlに[hooks]の欄がないか見る
  5. ルール(prefix_rule)を使うなら、実際のコマンドの形でcodex execpolicy checkを試す(先頭にsshなどが付くと一致しないことがある)

ルールの文面をそろえたら、止めるしくみも同じものを置けないか、一度見てみてください。
自分は、ないと思い込んでいただけでした。

出典

この記事が参考になったら、応援クリックをお願いします

Cat's Handこの記事を書いた人

Web制作歴10年以上。WordPressのテーマカスタマイズやコーディングを中心に、副業・本業ともにweb制作に携わっています。このブログでは、実際に手を動かして分かったことを書いています。