Claude Hooks

Claude Hooks はユーザー定義のシェルコマンドで、Claude Code がライフサイクルの決まった地点で実行します。公式ドキュメントはスキルとの違いを強調します。フックは決定的です。フォーマッタ、通知、保護ファイルのブロック、権限の自動承認は、モデルが思い出すのを待たず必ず走ります。判断が要るときはプロンプトベースやエージェントベースのフックも使えます。リモート向けの HTTP フックもあります。

現行ガイドの例は、入力待ちのデスクトップ通知、編集後の自動フォーマット、保護ファイルへの書き込みブロック、圧縮後の文脈再注入、設定変更の監査、ディレクトリ変更時の env 再読み込みです。マッチャでツール名と引数を絞れます。フックは設定ファイル（ユーザーまたはプロジェクト）に書き、チャットには書きません。

主な機能

• ライフサイクルシェル：UserPromptSubmit、PreToolUse、PostToolUse、Stop、通知系フック。
• 入出力契約：stdin の JSON を読み、構造化 JSON か終了コードを返す。
• マッチャ：1 つのツールや引数パターンに制限。
• プロンプト／エージェントフック：正規表現では足りないルールにモデルを使う。
• スキルではない：スキルは教え、フックは強制する。

使いどころ

• 編集のたびに format と lint。
• 秘密や生成ファイルへの書き込みを止める。
• エージェント待ちを通知してターミナルを離れられるようにする。

料金

フックは Claude Code に含まれ、単独 SKU はありません。セッションを動かす Claude プランまたは API を払います。claude.com/pricing を再確認してください。

はじめ方

1. Automate actions with hooks を読む。
2. 最初のウォークスルーどおり設定ファイルに hooks を足す。
3. 通知フックから始め、次に PostToolUse フォーマッタ。
4. スキーマはガイドからリンクされる hooks reference を使う。

よくある質問

フックは Claude を止められますか？

はい。公式例には編集ブロックと特定権限の自動承認があります。ブロックに頼る前に終了コードと JSON 出力を読んでください。

フックとスキルは？

スキルは必要時の手順。フックはイベントで必ず発火。両方使う：スキルが手続き、フックがゲート。

どこに置く？

設定ファイル。 プラグイン に梱包もできる。

代替案

• Claude Skills：手続きであり強制ではない。
• Claude Plugins：フックの配布。
• Claude Code：ホスト。

ヒント

1. フックは短く退屈に。長い LLM フックは第二のエージェントになる。
2. フック失敗をログする。黙ったフォーマッタはセッションを無駄にする。
3. イベント名を reference で見直す。初期の 5 イベント記事より増えている。

まとめ

フックは Claude Code にリポジトリを守らせる方法です。hooks ガイド から始め、通知とフォーマッタを足してから残りを梱包してください。