起動警告に--debug-file案内を追加

デバッグ手法

Ctrl+O を押すとトランスクリプトビューが開き、フックの実行結果を確認できます。

• 成功時: systemMessage や Stop フックのフィードバックなど、フックの JSON が何かを表示しない限り、何も表示されません。
  • フックが実行されたことを確認するには、ファイルの再フォーマットのような効果を確認するか、以下で説明するデバッグログを有効にしてフックをもう一度発火させます
• ブロッキングエラー: ほとんどのイベントでは、フックからのフィードバックが表示されます。フックの JSON がブロッキングの判断をした場合、フィードバックにはその判断の理由が表示され、そうでない場合はフックの stderr が表示されます。ConfigChange や Elicitation など一部のイベントでは、ブロックされてもメッセージは表示されません。
• 非ブロッキングエラー: 処理は続行され、<hook name> hook error という通知に短い説明が添えられて表示されます。たとえば Failed with non-blocking status code: が先頭に付いた stderr の 1 行目や、JSON の検証・パースに関するメッセージなどです。

どの終了コードと JSON の組み合わせがどの結果を生むかは、イベントごとの例外も含めてリファレンスの終了コードによる出力セクションで定義されています。

どのフックが一致したか、それぞれの終了コード、stdout、stderr を含む完全な実行詳細を確認するには、デバッグログを読んでください。claude --debug-file /tmp/claude.log で Claude Code を起動すると、既知のパスに書き込まれるので、別のターミナルで tail -f /tmp/claude.log を実行します。このフラグを付けずに起動した場合は、セッションの途中で /debug を実行すると、ログが有効になり、ログのパスが確認できます。