Claude Codeのフック（hooks）とは？できること・設定方法【2026年】

Claude Codeのフック（hooks）を非エンジニア目線で解説。「必ず実行される自動ルール」としての位置づけ、PreToolUse/PostToolUseなど代表イベント、settings.jsonへの最小設定例、exit 2でのブロックまで。CLAUDE.mdとの使い分けも整理しました。

Claude Codeに「このフォルダは触らないで」とCLAUDE.mdに書いても、ごくたまに守られないことがあります。公式ドキュメントも「CLAUDE.mdはコンテキストであって強制ではない」という立場です。そこで用意されているのがフック（hooks）。動作の節目（ライフサイクルの特定時点）で実行される、ユーザー定義のシェルコマンドです。AIの気分に左右されず決定論的に（＝毎回必ず同じように）動くのが最大の特徴です。

フック（hooks）とは

フックは、Claude Codeのライフサイクル（セッション開始、ツール実行の前後、応答完了など）の特定時点で自動実行されるユーザー定義のシェルコマンドです。ポイントは、実行するかどうかをLLMの判断に頼らないこと。条件に合えば必ず動きます。

💡 イメージは「職場の入退室ゲート」。口頭ルール（CLAUDE.md）は破られる可能性がありますが、ゲート（フック）は物理的に通さない。この確実さが違いです。

フックでできること

公式が挙げている代表的な使い道は次のとおりです。

• 編集後の自動フォーマット：ファイルを編集するたびにフォーマッターを自動でかける
• コマンドのブロック：危険な操作や触ってほしくないファイルへの変更を実行前に止める
• 通知：作業の節目に音やメッセージで知らせる
• コンテキスト注入：セッション開始時などに環境情報を自動で読み込ませる

イベントは約30種類。代表はこの7つ

フックを差し込めるイベント（タイミング）は約30種類ありますが、まず覚えるのは代表的なものだけで十分です。

matcherを使うと、対象のツールを名前で絞り込めます。たとえば "Edit|Write" と書けば「ファイル編集か書き込みのときだけ」フックが動きます。

設定方法：settings.jsonのhooksブロック

フックはsettings.jsonのhooksブロックに書きます。置き場所は3つです。

最小の例を1つ。「ファイルを編集・書き込みするたびに、確認用のコマンドを1つ実行する」設定はこう書きます。

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "echo 'ファイルが変更されました' >> ~/claude-edits.log"
          }
        ]
      }
    ]
  }
}

これで、Claudeがファイルを編集するたびにログへ1行追記されます。ここを自動フォーマットのコマンドに差し替えれば「編集後に必ず整形」が実現します。設定済みのフックは /hooks コマンドで一覧できます（閲覧は読み取り専用）。すべてのフックを一時停止したいときは、設定に disableAllHooks: true を入れます。

ブロックの仕組み：exit 0とexit 2

フックのコマンドには、イベントのデータがJSONでstdin（標準入力）から渡されます。そしてコマンドの終了コードで挙動が決まります。

• exit 0 … そのまま続行
• exit 2 … その操作をブロック。stderr（標準エラー出力）に書いた内容が、Claudeへのフィードバックとして渡される

つまりPreToolUseフックで「条件に合ったらexit 2で終了する」スクリプトを用意すれば、危険な操作を実行される前に確実に止められます。

重要な性質がもうひとつ。PreToolUseのdeny（拒否）は、bypassPermissionsモードでも有効です。フックは権限の制限を強めることはできても、緩めることはできない設計になっています。

typeは5種類（commandだけ覚えればOK）

フックの実行方法（type）は5種類あります。ほとんどの用途は command で足ります。

prompt は「機械的な条件では書きにくいが、軽いAI判断で足りる」場合の選択肢です。それぞれの詳細な書式は公式ドキュメントを参照してください。

CLAUDE.mdとの使い分け

なお、フックで縛る前に「そもそも指示が曖昧で暴走している」ケースも多いです。指示文そのものを整えたい方は、無料のAIプロンプトビルダーで依頼文を組み立ててから投げるのもおすすめです。

まとめ

• フックはライフサイクルの特定時点で必ず実行される自動ルール。LLMの判断に頼らず決定論的に動く。
• 用途は自動フォーマット・コマンドブロック・通知・コンテキスト注入など。
• 設定はsettings.jsonのhooksブロック（ユーザー／プロジェクト／ローカルの3箇所）。閲覧は /hooks、全停止は disableAllHooks: true。
• exit 0で続行、exit 2でブロック（stderrがClaudeへのフィードバック）。PreToolUseのdenyはbypassPermissionsでも有効。
• お願いはCLAUDE.md、強制はフック。フックは制限を強められるが緩められない。

関連記事：Claude Codeの全体像は Claude Codeとは？、“お願い”側の整え方は CLAUDE.mdの書き方、権限まわりは Plan modeと権限モード6種 もどうぞ。カテゴリ一覧は AI活用・ノウハウ へ。