Claude Code Hooks入門

HooksはClaude Codeのライフサイクルの各ポイントで実行されるユーザー定義のシェルコマンドです。

通知、自動整形、ログ記録、フィードバック、カスタム権限など多様なユースケースをサポートします。

設定はユーザー設定やプロジェクト設定のsettings.jsonにmatcherとhooksの配列で構成されます。

主要なフックイベントはPreToolUse、PostToolUse、Notification、Stopの4種類です。

フックはstdinでJSON入力を受け取り、終了コードやstdout/stderr、JSON出力でClaude Codeへ制御指示を返します。

使用時はシェルコマンドの安全性に注意し、入力検証や変数のクォート、絶対パス使用などのベストプラクティスを守る必要があります。

フックの実行は60秒のタイムアウト制限があり、並列で実行されます。