Claude Code Hooks完全ガイド

CLAUDE.mdの指示は「助言的（advisory）」— AIが無視できる。Hooksは「確定的（deterministic）」— 必ず実行される。この違いが、AIの行動品質を根本的に変える。

Hooksの3つの活用パターン

1. SessionStart: 起動時リマインダー

{
  "hooks": {
    "SessionStart": [{
      "matcher": "startup",
      "hooks": [{
        "type": "command",
        "command": "echo 'BOOT_CHECK必須。省略は脳の起動失敗。'"
      }]
    }]
  }
}

2. PreToolUse: 実装前レビューゲート

Edit/Write前にReviewer通過を確認。物理的にレビューなしの実装を阻止。

3. Stop: 学習フェーズ強制

セッション終了時に学習フェーズの実行を検証。未実行なら停止を阻止。

実績

• BOOT_CHECK省略: Hookで0回に（以前は1回/セッション）
• Reviewer未実行: PreToolUseで検出→ブロック
• 学習フェーズ省略: Stop hookで強制実行

関連記事

• Claude Code 2026年4月アップデート
• Brain Approximation Score
• サブエージェントは別の脳

実践のポイント

比較表

項目	従来	AI統合
速度	数時間	数分
品質	変動あり	一定
コスト	人件費	API費用

ベストプラクティス

1. 小さく始める
2. 測定する
3. 改善する
4. 共有する