Claude Codeのログ・デバッグ完全ガイド【2026年最新】：--debugフラグ・トランスクリプト・OTelまで徹底解説

# 全デバッグ情報を出力
claude --debug

# 特定カテゴリのみ出力（APIとMCPの情報のみ）
claude --debug "api,mcp"

# 特定カテゴリを除外して出力（statsigとfile以外）
claude --debug "!statsig,!file"

# ログをファイルに書き出す
claude --debug-file /tmp/claude-debug.log

# もしくは任意のパスに
claude --debug-file ~/Desktop/claude-debug-$(date +%Y%m%d).log

# 環境変数で指定
export CLAUDE_CODE_DEBUG_LOGS_DIR=/var/log/claude-code

# または起動時のみ指定
CLAUDE_CODE_DEBUG_LOGS_DIR=/tmp/debug-logs claude

# セッションを保存しないプリントモード
claude -p --no-session-persistence "コードをレビューして"

# .envファイルのDEBUG=trueをコメントアウトか削除
# DEBUG=true  ← これがClaude Codeのデバッグ出力を誘発する

# または一時的に無効化
DEBUG=false claude

# OTelを有効化
export CLAUDE_CODE_ENABLE_TELEMETRY=1

# エクスポーター設定
export OTEL_METRICS_EXPORTER=otlp
export OTEL_LOGS_EXPORTER=otlp

# OTLPエンドポイント（GrafanaやDatadog等に送る）
export OTEL_EXPORTER_OTLP_PROTOCOL=grpc
export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317

# 認証が必要な場合
export OTEL_EXPORTER_OTLP_HEADERS="Authorization=Bearer your-token"

{
  "env": {
    "CLAUDE_CODE_ENABLE_TELEMETRY": "1",
    "OTEL_METRICS_EXPORTER": "otlp",
    "OTEL_LOGS_EXPORTER": "otlp",
    "OTEL_EXPORTER_OTLP_PROTOCOL": "grpc",
    "OTEL_EXPORTER_OTLP_ENDPOINT": "http://collector.example.com:4317",
    "OTEL_EXPORTER_OTLP_HEADERS": "Authorization=Bearer example-token"
  }
}

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "echo \"$(date): $TOOL_NAME - $TOOL_INPUT\" >> ~/claude-tool-log.txt",
            "async": true
          }
        ]
      }
    ]
  }
}

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "mcp__memory__.*",
        "hooks": [
          {
            "type": "command",
            "command": "echo 'Memory operation initiated' >> ~/mcp-operations.log",
            "async": true
          }
        ]
      }
    ]
  }
}

{
  "hooks": {
    "PostToolUseFailure": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "echo \"ERROR $(date): Tool failed\" >> ~/claude-errors.log",
            "async": true
          }
        ]
      }
    ]
  }
}

# 認証状態の確認
claude auth status

# テキスト形式で確認したい場合
claude auth status --text