CLAUDE.mdに書いてもAIがたまに無視する?/hooksで「必ずやること」を強制自動実行

「コミット前に必ず検査を回して」とCLAUDE.md(クロードコードのルールファイル)に書いておいたのに、AIがたまにそのまま素通りしたことはありませんか?CLAUDE.mdはあくまで「お願い」なので、100%守られる保証はありません。本当に抜かしてはいけないルールなら、案内ではなく強制が必要です。/hooksはそれをしてくれるコマンドです。決まった瞬間に無条件で自動実行されるルールを仕掛けるのです。上級機能なので、入門段階なら「必ず守るべきルールにはこういうものがある」程度に知っておけば十分です。

定義

/hooksは特定の状況で自動実行されるように仕掛けた「フック(hook)」設定を見るコマンドです。

「フック(hook)」とは決まった時点になると無条件で実行される自動ルールです。「かぎ針」という意味そのままに、特定の瞬間(例: コミットする直前)に引っかかって、決まった命令を自動で引き出して実行します。

CLAUDE.mdと比べると違いが明確です。

• CLAUDE.md = 案内: 「こうして」というお願い。AIが状況を見て従いはしますが、たまに抜かすことがあります。
• フック = 強制: 「この時点では無条件でこれを実行する」というルール。AIの判断とは無関係に常に実行されます。

つまり「必ず守るべきこと」はフックで仕掛けてこそ確実です。

使い方(難易度別)

基礎 — フック設定を見る

チャット欄に入力します。

/hooks

入力すると現在仕掛けられているフック設定の一覧が画面に出ます。「どの時点でどの命令が自動実行されるようになっているか」を確認するわけです。最初は空のはずですが、ここでどんなフックが仕掛けられているか点検する用途で使います。

応用 — フックで仕掛けるルールを決める

フックを新しく仕掛けるのは会話でお願いできます。例えばこうです。

커밋하기 전에 항상 lint 검사를 자동으로 돌리도록 훅으로 걸어줘

こうすると「コミット直前」という時点に「lint検査実行」という命令が結びつきます。(lintはコードの形式・エラーを点検する検査です。)その後はコミットするたびにAIが忘れようが、検査が無条件で先に実行されます。/hooksでその設定がきちんと仕掛けられたか確認すればよいです。

よくある落とし穴 — /hooksは「見る」命令、仕掛けるのは設定

混同しやすいポイントです。/hooksと入力したからといってフックが新しく作られるわけではありません。/hooksは今仕掛かっているフックを見せる命令です。

• 見る: /hooks → 現在の設定確認。
• 仕掛ける: 会話で「〜をフックで仕掛けて」と依頼するか、設定ファイルに直接追加。

そしてもう一つ。フックは強制力が強い分、間違って仕掛けると毎回意図しない命令が実行されることがあります。なので本当に「常に実行されるべきこと」だけに慎重に仕掛けるのが良いです。たまに一度すればいいことは、わざわざフックにする必要はありません。

実践事例

テストを回さずコミットすることが繰り返されたので、CLAUDE.mdに「コミット前に検査実行」と書いておきました。それでもたまに素通りしました。「案内」なので100%守られなかったわけです。そこでいっそフックで仕掛けました。

커밋 전에 자동으로 검사를 실행하는 훅 걸어줘

その後は一度も検査が抜けませんでした。AIの判断に任せず「強制」で固定すると、「今回は抜かしたな」ということがなくなりました。必ず守るべきルールは案内ではなく強制であるべきだと実感しました。

こう使うともっと便利

• 自動実行ルール: 特定の時点で命令を強制的に実行させます。
• コミット前検査: 「commit前のlint・テスト」のようなものを破れないように固定。
• CLAUDE.mdと役割分担: 軽い推奨事項はCLAUDE.md(案内)、絶対に抜かしてはいけないものはフック(強制)。
• 必ずやることだけに: AIの判断に任せたくない核心ルールに取っておきます。

ヒント: すべてのルールをフックで仕掛ける必要はありません。ほとんどはCLAUDE.mdの案内で十分です。「これが抜けると事故になる」と思う一つ二つだけをフックで仕掛けるのが、管理も楽で意図しない実行も防げます。

まとめ

核心は一文です。必ず守るべきことは案内ではなくフックで強制せよ。CLAUDE.mdはお願いなのでたまに無視されることがありますが、フックは決まった時点で無条件で実行されます。「必ずやること」をAIの判断に任せたくないとき、フックが最も確実な安全装置です。

基準: Claude Code v2.1.154 (2026.05)