環境変数

DEBUG

1 を設定するとデバッグモードが有効になり、--debug を付けて起動した場合と同等になる。デバッグログは ~/.claude/debug/<session-id>.txt、または CLAUDE_CODE_DEBUG_LOGS_DIR で設定されたパスに書き込まれる。デバッグモードを有効にするのは 1、true、yes、on の真値のみであり、他のツール向けに設定した DEBUG=express:* のような名前空間パターンでは有効にならない。

使い方・用途

  • Claude Code の動作に問題があり、~/.claude/debug/<session-id>.txt に出力されるデバッグログを残して調査したいときに DEBUG=1 を設定する
  • --debug フラグを付けずに起動する場合でもデバッグモードを有効にしたいときに用いる
  • 他のツール向けに設定した DEBUG=express:* のような名前空間パターンが Claude Code で誤ってデバッグモードを有効にしないことを確認したいときに、有効な値が 1, true, yes, on に限られることを踏まえて値を設定する
英語原文(公式ドキュメントより)

Set to 1 to enable debug mode, equivalent to launching with --debug. Debug logs are written to ~/.claude/debug/<session-id>.txt, or to the path set by CLAUDE_CODE_DEBUG_LOGS_DIR. Only the truthy values 1, true, yes, and on enable debug mode, so namespace patterns like DEBUG=express:* set for other tools do not trigger it

関連する変更履歴

v0.2.125(1件)