Claude Codeのhooksとは｜操作の瞬間に自動実行させる

CLAUDE.md・Skillsとの決定的な違い

設計の基準は1行で言えます。「守ってほしい」はCLAUDE.md、「守らせる」はhooks。破られると困るルールだけをhooksに昇格させれば、設定が肥大しません。

設定できるタイミング

hooksは「いつ発動するか」を選んで設定します。代表的なものを挙げます。

• ツールを使う前──ファイル編集やコマンド実行の直前。ここで止めることもできます
• ツールを使った後──編集が終わった直後。整形やチェックの実行に使います
• 作業が一区切りした時──AIが応答を終えたタイミング。通知やログ記録に
• 会話の開始時──セッションを始めたとき。環境の準備に

「使う前」で止められるのが重要な点です。単に後始末をするだけでなく、やってほしくない操作を実際にブロックできます。

実際に効く設定例

1. 編集のたびに整形ツールを走らせる──最も定番です。「整形してね」と毎回言う必要がなくなり、コードのスタイルが常に揃います
2. 編集のたびに構文チェックを走らせる──壊れた状態で次の作業へ進むのを防げます。当サイトの運用でも、書き込みのたびにHTMLの構文チェックを自動実行しています
3. 危険なコマンドをブロックする──本番環境への操作、削除系のコマンド、特定ディレクトリへの書き込みなどを検査して止めます
4. 秘密情報の混入を止める──コミット前に認証情報が含まれていないか検査する。「気をつける」ではなく機械的に止める形にできます（GitHub連携での注意）
5. 作業完了を通知する──長時間の作業を任せて別のことをしているとき、終了を知らせます

設定の書き方は、Claude Code自身に任せられる

hooksは設定ファイル（settings.json）に記述しますが、書式を覚える必要はありません。設定作業そのものを頼めます。

実際に使う頼み方はこの程度です。

• 「ファイルを保存するたびに整形コマンドを実行するhookを設定して」
• 「本番用の設定ファイルを書き換えようとしたら止まるようにして」
• 「今どんなhookが設定されているか説明して」

設定した後は、実際に動くか一度試してください。意図と違うタイミングで発動したり、逆に発動しなかったりすることがあります。「わざと該当する操作をして、発動を確認する」までを1セットにするのが安全です。