Claude Code Hooks（クロードコードフックス）
Claude Code カスタムトリガー。UserPromptSubmit(prompt送信前)・PreToolUse(Tool実行前・承認)・PostToolUse(後)・Stop(応答完了)・SessionStart/End・Notification・SubagentStop・hooks array JSON・matchers regex・run_in_background・timeout・cwd control・exit code制御・stdoutで追加コンテキスト注入・settings.json + .claude/hooks対応、2026年エージェント制御定着。
概要
Claude Code Hooks（クロードコードフックス）は、Claude エージェントの動作を細部まで制御できるカスタムトリガー機能です。
ユーザーがプロンプトを送信する前（UserPromptSubmit）、ツールを呼び出す直前（PreToolUse）、ツール実行後（PostToolUse）、応答完了時（Stop）など、エージェントのライフサイクルに沿ったフックを設定できます。
2026年にエージェント制御が業界標準となった現在、ハードウェアとソフトウェアの連携を最適化するために不可欠な技術と位置付けられています。
主な特徴・仕組み
- フック配列（hooks array JSON）
1 つ以上のフックを JSON 配列で定義し、マッチャー（matchers regex）で対象イベントを選択。 - 実行モード
run_in_backgroundを true にすると、フックは非同期で実行され、メインスレッドをブロックしません。 - タイムアウト設定
timeoutで秒単位の上限を指定。タイムアウト時は自動的にフックを中止し、エージェントは安全に継続。 - カレントワーキングディレクトリ制御
cwdでフック実行時のディレクトリを指定し、外部ツールのパス解決を安定化。 - 終了コード制御
フックが返すexit codeにより、エージェントは成功・失敗を判定。 - 標準出力でのコンテキスト注入
stdoutに出力した文字列をエージェントが自動で次のプロンプトに挿入。 - 設定ファイル
settings.jsonと.claude/hooksディレクトリでフックの有効化・無効化を管理。 - セッション管理
SessionStartとSessionEndでセッション全体の初期化・クリーンアップを行う。 - 通知機能
Notificationフックで外部サービス（Slack, Discord 等）へリアルタイム通知。 - サブエージェント停止
SubagentStopで子エージェントを安全に停止し、リソースを解放。
スペック/製品比較表
| 製品 | フックサポート | 最大スレッド | メモリ | 主要用途 |
|---|---|---|---|---|
| RTX 5090 | あり | 2048 | 24GB GDDR7 | 高負荷 AI 推論 |
| Ryzen 9 9950X3D | あり | 32 | 32GB DDR5 | ゲーム + クリエイティブ |
| Core Ultra 9 285K | あり | 48 | 64GB DDR5 | データセンター |
| NVIDIA A100 | あり | 80 | 40GB HBM2 | 大規模機械学習 |
| Intel Core i9-13900K | あり | 24 | 32GB DDR5 | ハイエンドデスクトップ |
具体例・対応製品
- RTX 5090
24GB GDDR7 と 5.7GHz のクロックで、フックを利用したリアルタイム画像生成に最適。 - Ryzen 9 9950X3D
32GB DDR5-6000 と 3.5GHz のベースクロックで、PreToolUse でのデータ前処理に高速。 - Core Ultra 9 285K
64GB DDR5 と 2.5GHz のマルチスレッド性能で、PostToolUse での結果集約を高速化。 - NVIDIA A100
40GB HBM2 と 1TB NVMe ストレージで、SessionStart でのモデルロードを最適化。 - Intel Core i9-13900K
32GB DDR5 と 120mm ファンで、フック実行時の熱管理を安定。
自作PCでの選び方・注意点
- CPU
- 3.5GHz 以上のクロックと 16 コア以上を推奨。
- 低レイテンシーを確保するため、Intel Core i9-13900K か AMD Ryzen 9 9950X3D を選択。
- GPU
- 24GB GDDR7 以上の VRAM が必要。RTX 5090 がベスト。
- 低消費電力で 600W PSU を確保。
- メモリ
- DDR5-6000 以上で 32GB 以上を推奨。
- 低レイテンシーを確保するため、CL16 以上のモジュールを選択。
- ストレージ
- NVMe 1TB 以上で 3,500MB/s 以上の読み書き速度。
- 低レイテンシーを確保するため、PCIe 5.0 x16 接続を推奨。
- 電源
- 650W 以上、80+ Gold 以上の認証。
- 余裕を持たせるため、750W 以上を推奨。
- 冷却
- 120mm ファン 2 個以上で 70°C 以下を維持。
- 空気冷却＋水冷のハイブリッドを検討。
- フック設定
timeoutは 10 秒以上を推奨。run_in_backgroundを有効にし、メインスレッドの負荷を低減。
- ソフトウェア
settings.jsonと.claude/hooksを同梱し、フックを有効化。cwdは/home/user/claudeなどの固定ディレクトリを推奨。
関連用語との違い
| 用語 | 主な違い |
|---|---|
| Hooks | イベントに対して実行される小さなスクリプト。 |
| PreToolUse | ツール実行直前にフックを呼び出す。 |
| PostToolUse | ツール実行後にフックを呼び出す。 |
| UserPromptSubmit | プロンプト送信前にフックを呼び出す。 |
| Stop | 応答完了時にフックを呼び出す。 |
よくある質問
Q1. Claude Code Hooks は Windows だけで使えますか？
A1. 2025年時点で Linux も公式にサポートされ、同一の JSON 仕様で動作します。
Q2. フックの実行時間が長いとエージェントが停止しますか？
A2. timeout を設定すれば自動的に中止され、エージェントは安全に継続します。
Q3. フックを複数同時に実行する場合、競合は起きますか？
A3. run_in_background を有効にすると非同期で実行され、競合は最小化されます。
まとめ
Claude Code Hooks は、2026年にエージェント制御が業界標準となった時代において、ハードウェアとソフトウェアの境界を越える制御を可能にする技術です。
CPU の高クロックと多コア、GPU の大容量 VRAM、DDR5 の高速メモリ、NVMe の高速ストレージ、そして 650W 以上の電源と冷却を備えた自作PCを構築すれば、フックを最大限に活用できます。
フックの設定は JSON で簡潔に記述でき、settings.json と .claude/hooks で一元管理。
次世代の AI アプリケーションを構築する際は、Claude Code Hooks を取り入れた設計を検討してください。