Hooks で Claude Code に pre-commit 相当の品質ゲートを組み込む

Claude Code の Hooks は CLAUDE.md と違い「必ず実行される」決定論的な仕組み。lint・型チェック・migration ファイルへの書き込みブロックなど、忘れたら困る動作を強制できる。本稿は公式の Hooks Guide を元に、実務で効く 5 つのフック設定例と運用上の注意点を整理する。

CLAUDE.md と Hooks は性質が違う

CLAUDE.md の指示は「推奨」。Claude は基本守るが、時々忘れる。Hooks はシェルコマンドが実際に走る「強制」。公式は次のように使い分けを推奨している：

Use hooks for actions that must happen every time with zero exceptions.

設定の場所

`.claude/settings.json` の `hooks` フィールド