Claude Code hooks ビルダー

使いたいイベントを選び、コマンドを 1 つ書けば、Claude Code がそのまま受け付ける settings.json の断片をコピーできます。全 33 種の hook イベントを matcher の値つきで載せ、 statusLine 設定にも対応しています。項目ごとの詳細は hooks リファレンスを参照してください。

生成しているものは何か

hook は、Claude Code がライフサイクルのイベントごとに実行するシェルコマンドです。標準入力に JSON （session_id・hook_event_name・cwd と、tool_name や notification_type などイベント固有の項目）が渡されます。ビルダーが生成する形は次のとおりです。

{
  "hooks": {
    "<イベント名>": [
      {
        "matcher": "<任意の絞り込み>",
        "hooks": [ { "type": "command", "command": "<コマンド>", "timeout": 600 } ]
      }
    ]
  }
}

• matcher は hook を発火させる対象の絞り込みです。ツール系イベントではツール名、Notification では通知の種類、といった具合です。| 区切りの名前は完全一致、正規表現の記号を含むと JavaScript の正規表現として扱われます。空なら全件に一致します。
• 全イベントで同じコマンドを使うのが一般的な形です。標準入力の hook_event_name を読んでスクリプト内で分岐します。ビルダーは選んだ各イベントに同じハンドラを書き出します。
• 終了コード 2 は、対応イベント（PreToolUse・UserPromptSubmit・PermissionRequest など）で動作をブロックし、標準エラー出力が理由として表示されます。それ以外の終了コードでは動作は続行されます。
• statusLine は別のトップレベルキーで、枠は 1 つだけです。そのコマンドには context_window.used_percentage・rate_limits・model が渡されます。これは hook には来ないデータです。