Claude Codeの/doctorコマンドとトラブル診断

トラブル1: 「認証エラー」が発生する

症状: セッション中に認証エラーが表示され、応答が返らない

解決フロー

1. /doctor で認証状態を確認
2. 認証エラーの場合 → /login で再認証
3. それでも解決しない場合 → /logout してから /login
4. APIキーを使用している場合 → キーの有効期限を確認
5. 環境変数 ANTHROPIC_API_KEY が正しく設定されているか確認

# 認証状態の確認と再認証
/doctor
/logout
/login

# APIキーの確認（環境変数）
echo $ANTHROPIC_API_KEY

トラブル2: 応答が非常に遅い・タイムアウトする

症状: プロンプトを送信しても応答が返らない、または非常に長い時間がかかる

解決フロー

1. /doctor でネットワーク接続を確認
2. ネットワーク問題の場合 → インターネット接続を確認
3. プロキシ環境の場合 → プロキシ設定を確認
4. コンテキストが大きすぎる場合 → /compact で圧縮
5. APIサービスの状態を確認（status.anthropic.com）

トラブル3: ツール（Bash/Edit等）が動作しない

症状: ファイル編集やコマンド実行が拒否される、またはエラーになる

解決フロー

1. /permissions で現在の権限設定を確認
2. 拒否リストに含まれていないか確認
3. .claude/settings.json の内容を確認
4. 権限モード（--permission-mode）を確認
5. 必要に応じて権限設定を修正

# 権限の確認
/permissions

# 設定ファイルの確認
cat .claude/settings.json

トラブル4: Claude Codeが起動しない

症状: claude コマンドを実行してもエラーが出て起動しない

解決フロー

1. PATHが正しく設定されているか確認: which claude（Mac/Linux）または where claude（Windows）
2. OSバージョンを確認: macOS 13 (Ventura) 以上、Windows 10以上が必要
3. Windowsの場合: Git for Windowsがインストールされているか確認: git --version
4. 再インストールを試行:

   # Mac/Linux
   curl -fsSL https://claude.ai/install.sh | bash
   
   # Windows (PowerShell)
   irm https://claude.ai/install.ps1 | iex
   
   # またはwingetを使用
   winget install Anthropic.ClaudeCode

# 診断コマンドの実行
claude --version
which claude  # Mac/Linux
where claude  # Windows

# 再インストール（Mac/Linux）
curl -fsSL https://claude.ai/install.sh | bash

# 再インストール（Windows PowerShell）
irm https://claude.ai/install.ps1 | iex

トラブル5: 設定が反映されない

症状: .claude/settings.json や CLAUDE.md の変更が反映されない

解決フロー

1. 設定ファイルのJSON構文を検証（jq . .claude/settings.json）
2. ファイルが正しい場所にあるか確認
3. 設定の優先順位を確認（コマンドライン > local > project > global）
4. セッションを再起動（設定はセッション開始時に読み込まれる）

効果的なバグ報告に含めるべき情報

1. Claude Codeのバージョン: claude --version の出力
2. OS情報: 使用しているOS名とバージョン
3. インストール方法: ネイティブインストーラー / Homebrew / winget のいずれか
4. /doctorの結果: 診断結果の全文
5. 再現手順: 問題を再現するための具体的な手順
6. 期待される動作: 本来どう動くべきか
7. 実際の動作: 実際に何が起きたか（エラーメッセージを含む）
8. ログファイル: 関連するログの抜粋（機密情報は除去）