特定カテゴリだけデバッグログを見たい
16. トラブルシューティングコマンド / 機能
--debug "api,mcp"カテゴリ指定デバッグ / --debug-file
概要
--debug にカテゴリをカンマ区切りで指定すると、そのカテゴリに関するデバッグログだけを出力できます。すべてのログを見ると情報過多になる場合に、api や mcp などピンポイントで絞り込めます。--debug-file <path> でログを標準エラーではなくファイルに書き出すこともできます。
設定例
# API関連とMCP関連のログだけ出力
claude --debug "api,mcp"
# ログをファイルに保存
claude --debug "api" --debug-file ./claude-debug.log
# 主なカテゴリ例
# api - APIリクエスト/レスポンス
# mcp - MCPサーバーとの通信
# hooks - フックの実行
# tools - ツール呼び出しこんな時に使う
- MCPサーバーとの通信だけを詳しく見たい時
- APIリクエストの内容を確認したい時
- ログをファイルに残して後で解析したい時
使い方
- 1--debug "カテゴリ1,カテゴリ2" のようにカンマ区切りで指定
- 2--debug-file <path> でファイル出力先を指定
- 3カテゴリを省略した --debug は全カテゴリのログを出力
Tips
- 無指定の --debug よりノイズが減り、目的のログを見つけやすい
- --debug-file と組み合わせるとバグ報告時にログを添付しやすい
- /debug スキルを使うと会話内でデバッグログを有効にして調査できる