Claude Codeが動かない時の対処法｜エラー原因別まとめ

Claude Codeを使っていると、「claudeコマンドが見つからない」「ログインを求められ続ける」「使用制限に達した」といったエラーに遭遇することがあります。この記事では症状別に原因と対処法を整理しました。基本的な使い方は「Claude Codeの使い方完全ガイド」をご覧ください。

まず試すこと

エラーの種類を特定する前に、次の3つを試すと多くのトラブルが解決します。

claude doctor

claude doctorは、インストール状況・設定ファイルの妥当性・認証状態をチェックし修正案を提示してくれます。セッション内なら/doctorでも診断できます。次にclaude updateで最新版にしましょう。古いバージョンが原因のバグも多く、それだけで解決することもあります。手順は「Claude Codeのアップデート方法」をご覧ください。最後にターミナルとClaude Codeを閉じて再起動しましょう。claude --resumeで同じディレクトリの会話を再開でき、作業内容は失われません。

症状1: claudeコマンドが見つからない

インストール後にclaudeを実行すると、次のようなエラーが出ます。

• Windows PowerShell: The term 'claude' is not recognized as the name of a cmdlet
• Windows CMD: 'claude' is not recognized as an internal or external command
• Mac(zsh): command not found: claude

多くの場合、インストール先がPATHに含まれていないことが原因です。インストーラーは、Windowsでは%USERPROFILE%\.local\bin\claude.exeに、Mac/Linuxでは~/.local/bin/claudeに入ります。

Windowsは次でPATHを確認します。

$env:PATH -split ';' | Select-String '\.local\\bin'

Macは次で確認します。

echo $PATH | tr ':' '\n' | grep -Fx "$HOME/.local/bin"

出力がなければPATH未設定です。Windowsはシステム環境変数の編集画面から、Macは~/.zshrcにexport PATH="$HOME/.local/bin:$PATH"を追記し反映します。変更後はターミナル再起動後にclaude --versionで確認してください。インストールから見直す方は「Windows 11にClaude Codeをインストールする手順」を参考にしてください。複数方法で重複インストールしていると古いバージョンが優先されることがあるため、which -a claudeやwhere.exe claudeで確認し不要なものは削除しましょう。

症状2: ログイン・認証エラーが出る

「ログインを求められ続ける」「403 Forbiddenになる」といった症状の多くは、次のいずれかが原因です。

• OAuthトークンの期限切れ: /loginで再認証します。改善しなければ/logout後に再起動し、再度ログインしてください。
• APIキーとの競合: 環境変数ANTHROPIC_API_KEYがあると、サブスクリプション(Pro/Max)より優先され、古いキーが残っていると「organization has been disabled」のようなエラーになります。/statusで認証方法を確認し、不要なら$env:ANTHROPIC_API_KEY = $nullで解除し、シェルのプロファイルからも削除しましょう。
• サブスクリプションが有効か: Pro/Maxならclaude.aiで、Consoleアカウントなら管理者に権限付与を確認してください。

症状3: 使用制限・レート制限に達した

「セッションの利用上限に達しました」のようなメッセージが出た場合、契約プランに応じた使用量の上限に達しています。

You've hit your session limit · resets 3:45pm
You've hit your weekly limit · resets Mon 12:00am

セッション制限と週次制限は全モデル共通のため、モデルを切り替えても復旧しません。Opusだけの制限なら/modelで別モデルに切り替えて継続できます。リセット時刻は/usageで確認でき、追加枠はPro/Maxなら/usage-creditsから購入できます(料金は公式サイトで確認してください)。

症状4: 動作が重い・応答が返ってこない

会話が長くなるとコンテキストが肥大化し、応答が遅くなったりCPU・メモリ使用率が高くなったりします。/compactで会話を要約し、大きなビルドディレクトリは.gitignoreで検索対象から外しましょう。改善しなければCtrl+Cでキャンセルし、ターミナルを再起動してください(claude --resumeで復元できます)。

応答が完全に止まる場合は、プラグインやMCPサーバー、フックが原因でないかclaude --safe-modeで確認しましょう。改善するなら設定を1つずつ有効化し切り分けます。ネットワークが不安定な環境でも応答待ちがフリーズに見えるため、接続状況も確認しましょう。

症状5: インストール・アップデートに失敗する

インストールやアップデートが止まる場合、多くは権限不足かバージョンの競合が原因です。

• 権限エラー: Mac/Linuxでは~/.local/bin/と~/.claude/への書き込み権限が必要です。sudo chown -R $(whoami) ~/.localで修正できます。
• npm版とネイティブ版の共存: npmインストール環境にネイティブインストーラーを重ねると挙動が不安定になります。npm uninstall -g @anthropic-ai/claude-codeでnpm版を削除し、ネイティブ版に一本化しましょう。
• アップデートが反映されない: claude update後もclaude --versionが古いままなら、インストーラーを再実行してください。手順は「Claude Codeのアップデート方法」で解説しています。

ログや詳細情報を確認する

上記で解決しない場合は--debugフラグで起動すると、内部の処理状況が詳しく出力されます。

claude --debug

メモリが高止まりする場合は/heapdumpで診断ファイルを出力できます。設定関連の問題は/mcpでサーバー状態を確認しましょう。解決しなければ/feedbackでAnthropicへ直接報告でき、既知の不具合はGitHubのanthropics/claude-codeのIssuesで確認できます。請求の問題はclaude.aiの左下アイコンから「Get help」を選んでください。

よくある質問

claude doctorとclaude —versionの違いは何ですか?

claude --versionはバージョン番号のみを表示します。claude doctorはPATH・認証状態・設定ファイルをチェックし修正案まで提示してくれます。迷ったらまずclaude doctorから始めましょう。

再インストールすると設定やチャット履歴は消えますか?

通常のアンインストール・再インストールでは、設定やセッション履歴が保存された~/.claudeは保持され、バイナリ本体だけが入れ替わります。完全リセットしたい場合のみ削除してください。

エラーメッセージが記事に載っていません。どうすればいいですか?

まずclaude doctorで診断し、--debugで再現させてログを確認してください。原因不明なら、OS・実行コマンド・エラー全文を添えてGitHubのIssuesか/feedbackで報告してください。

まとめ

Claude Codeのトラブルの多くは、claude doctorでの診断とアップデート、再起動という基本の3手順で解決します。それでも直らない場合は、PATH設定・APIキーとの競合・使用制限のリセット時刻・コンテキストの肥大化など、症状ごとに原因を切り分けるのが近道です。基本的な使い方は「Claude Codeの使い方完全ガイド」もあわせてご確認ください。