起動警告に--debug-file案内を追加
CHANGELOG 原文(英語)
Improved the cross-session messaging startup warning to explain that --debug-file writes a debug log to a path you choose 公式の変更履歴を開く ↗ 日本語での補足
セッション間メッセージングの起動時警告を改善し、--debug-fileで選んだパスにデバッグログを書き出せることを説明するように。
ドキュメント
ドキュメントの抜粋(参考訳)
フックをデバッグする
フックの実行の詳細は、デバッグログファイルに書き込まれます。claude --debug-file <path> で Claude Code を起動して既知の場所にログを書き込むか、claude --debug を実行して ~/.claude/debug/<session-id>.txt のログを読んでください。--debug フラグはターミナルには出力しません。
たとえば、コマンドが hook-ran を出力する Write に対する PostToolUse フックでは、次のようなエントリが記録されます。
2026-07-19T02:03:24.382Z [DEBUG] Hook output does not start with {, treating as plain text
2026-07-19T02:03:24.382Z [DEBUG] "Hook PostToolUse:Write (PostToolUse) success:\nhook-ran"
遅いフックを見つけるには、ログ内で所要時間で終わる Hooks: の行を検索します。Claude Code v2.1.296 以降では、ツールイベント、UserPromptSubmit、SessionStart、Stop、その他いくつかのイベントに対する各コマンドフックが、何を出力したかにかかわらず、終了時にこの行を 1 行残します。この行には、イベント名とフックがマッチしたツール名などの値をコロンでつないだもの、角かっこで囲んだフックのコマンド、フックの提供元プラグイン(ある場合)、実行の終わり方、所要時間が順に示されます。例: Hooks: PostToolUse:Write [.claude/hooks/log-write.sh] finished with status 0 (31ms)。実行が timed out after <N>ms、cancelled、moved to the background、failed to start として終わることもあります。Notification、SessionEnd、PreCompact など一部のイベントでは、コマンドフックは代わりに所要時間のない completed with status の行を残します。
フックのマッチングについてさらに詳しく確認するには、CLAUDE_CODE_DEBUG_LOG_LEVEL=verbose を設定すると、フックのマッチャー数やクエリのマッチングなどの追加のログ行が表示されます。
フックが発火しない、Stop フックがブロックし続ける、設定エラーなどのよくある問題のトラブルシューティングについては、ガイドの制限事項とトラブルシューティングを参照してください。/context、/doctor、設定の優先順位を含む、より広範な診断手順については、設定をデバッグするを参照してください。
取得日 · 2026-11-20