Claude Code トラブルシューティング完全ガイド｜–debugフラグ・よくあるエラーの解決方法まとめ

# ターミナルから実行
claude doctor

# Claude Codeのセッション内でも使える
/doctor

# 全カテゴリのデバッグログを表示
claude --debug

# 特定のカテゴリのみ表示（api と mcp だけ）
claude --debug "api,mcp"

# 特定のカテゴリを除外（statsig と file 以外を表示）
claude --debug "!statsig,!file"

# MCPのトラブル調査に絞り込む
claude --debug "mcp"

# API呼び出しのトラブル調査
claude --debug "api"

# デバッグログをファイルに保存（デバッグ自動有効）
claude --debug-file /tmp/claude-debug.log

# 特定カテゴリのログのみファイルに保存
claude --debug "api,mcp" --debug-file ./claude-debug.log

# 別ターミナルでリアルタイムに確認
tail -f /tmp/claude-debug.log

# セッション外からログイン
claude auth login

# セッション内でログイン
/login

# ログイン状態の確認
claude auth status

# MCPサーバーの一覧と接続状態を確認
claude mcp list

# MCPのデバッグログ付きで起動
claude --debug "mcp"

# 特定のMCPサーバーのステータス確認
claude mcp get <server-name>

# 許可リストをインタラクティブに管理
/permissions

# 特定のBashコマンドを常に許可する設定を追加（settings.jsonに直接追記する方法）
# .claude/settings.json:
# {
#   "permissions": {
#     "allow": ["Bash(npm run *)", "Bash(git *)"]
#   }
# }

# デバッグで権限チェックの詳細を確認
claude --debug "permissions"

# macOS / Linux: ~/.local/bin を PATH に追加
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# zshの場合
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# Windows: ユーザー環境変数に %USERPROFILE%\.local\bin を追加
# PowerShell で確認
$env:PATH -split ";"

# インストール状況を確認
which claude    # Mac/Linux
where claude    # Windows

# 手動でclaudeをインストール（最新版）
npm install -g @anthropic-ai/claude-code