Claude Codeが使えない時の診断コマンドと復旧手順

【結論】使えない時は診断Commandで原因を分離する

起動不能の原因を課金不足やNode.jsだけに決めつけず、Install path、Version、認証、Network、Provider、Service状態、Project permissionを順番に確認します。

Native版ではNode.jsが必須ではありません。

# ターミナルで実行：実体とVersionを確認
command -v claude && claude --version
# ターミナルで実行：診断を実行
claude doctor
# ターミナルで実行：更新を試す
claude update

具体的な手順・設定方法

1. command -v claudeで複数Installの競合を確認し、Native、Homebrew、npmのどれかに統一します。
2. 起動できる場合は/statusでProviderとAccountを確認します。
3. TimeoutはProxy、Certificate、Firewall、DNS、公式Statusを切り分け、402やCredit errorは利用中ProviderのBillingを確認します。

実践プロンプト / 活用テクニック

環境診断のPromptです。

# 起動後のセッション内で実行
ファイルは変更せず、現在のClaude CodeのVersion、認証Provider、作業Directory、利用可能Toolを確認し、問題候補を優先順で報告してください。

診断結果をIssueへ貼れる形式にするとSupport依頼が容易です。

注意点・よくあるエラーと対処法

API Keyが設定されているとSubscription認証より優先される場合があるため、env | grep ANTHROPICの出力を共有する時は値を必ずMaskします。

再Install前に設定Directoryを削除するとSessionや設定を失う可能性があるため、無闇に消去しません。

Service障害時はLocal変更を保存し、同じPromptの連打を避けます。