Claude Code実践ガイド
Claude Codeが動かない時の対処法｜症状別の切り分け
Claude Codeの不調は、原因が「Anthropic側の障害」「利用枠の上限」「手元の環境」の3つのどれかにほぼ収まります。やみくもに再インストールする前に、この順で切り分けるのが最短です。このページは、毎日使う中で実際に踏んだトラブルを症状別に引ける形でまとめた、いわば筆者自身の対処メモの公開版です。
このサイトは Anthropic や Claude の公式サイトではありません。Claudeの基本的な使い方、ChatGPTとの違い、文章作成・長文整理・仕事での活用を初心者向けに整理する非公式ガイドです。機能・料金・提供状況は変更される可能性があるため、重要な判断ではAnthropic公式情報も確認してください。
最初の30秒──3つの切り分け
- 障害か？──Anthropicのステータスページ（status.anthropic.com）を見る。障害中なら手元で何をしても直りません。待つのが正解です（チャット版の障害情報はClaudeのエラー一覧も参照）
- 上限か？──「usage limit」「rate limit」の表示が出ていないか。出ていれば故障ではなく利用枠です。
/usageで確認できます（仕組みは料金ページ） - 手元か？──上の2つでなければ環境の問題です。
claude /doctorで自己診断を実行し、以下の症状別へ
症状別の対処一覧
| 症状 | よくある原因 | 対処 |
|---|---|---|
| 起動しない・コマンドが見つからない | PATH未設定、Node.jsが古い | ターミナルを開き直す→node -v（18以上か）→再インストール。Windows特有の話はWindowsページ |
| ログインできない | ブラウザが別アカウントでログイン中 | ブラウザ側のClaudeアカウントを確認してから /login をやり直す |
| 応答しない・止まったように見える | 大きな処理の途中（正常）／ネットワーク断 | まず数分待つ。長時間の作業では沈黙時間は普通にあります。Escで中断して指示を小さく分けるのも有効 |
| 途中で止まる・出力が切れる | 会話が長くなりすぎて限界に近い | /compact で会話を要約して続行。区切りが付くなら /clear |
| 遅い | 重いモデルで軽い作業をしている／読ませる範囲が広すぎる | /model で作業に見合うモデルへ。「フォルダ全部」ではなく対象ファイルを指定する |
| 429・レート制限 | 利用枠の上限 | 故障ではありません。/usage で状況確認→枠が明けるのを待つか、モデルを落として節約（上限の仕組み） |
| 401・認証エラー | 認証の期限切れ、APIキーの設定ミス | /login のやり直し。APIキー利用なら環境変数 ANTHROPIC_API_KEY の値を確認 |
| 接続できない | 社内プロキシ・ファイアウォール | 環境変数 HTTPS_PROXY を設定。会社の環境なら情シスに確認（法人利用ページ） |
| 日本語が文字化けする | ターミナルの文字コード | UTF-8対応のターミナルへ（WindowsはWindows Terminal推奨） |
| アップデート後におかしい | 更新の不整合 | npm update -g @anthropic-ai/claude-code をもう一度。駄目ならアンインストール→再インストール |
「ファイルを消された・変えられすぎた」を戻す
不調とは違いますが、検索されるトラブルの筆頭なので独立して書きます。対処は使っている保険によって変わります。
- gitを使っている場合──慌てる必要はありません。「さっきの変更を全部元に戻して」とClaude Code自身に頼むか、
git checkout／git resetで任意の時点に戻せます。コミットをこまめに打っていればいるほど、戻れる地点が細かくなります - gitを使っていない場合──Claude Codeの会話ログには変更内容が残っているので、「今日変更したファイルと変更内容を一覧して」と頼んで手掛かりにします。復元できる保証はないので、これを機にgit導入を最優先で。設定はClaude Code自身に頼めば数分です（Git連携ページ）
- 予防──大きな作業の前はプランモード（Shift+Tab）で計画を確認してから実行する習慣が、この種の事故をほぼゼロにします（プランモードの解説）
それでも直らない時
claude /doctor──インストール状態・更新状態・設定の問題を自己診断してくれます。まだ実行していなければここから- 完全に入れ直す──
npm uninstall -g @anthropic-ai/claude-codeのあと再インストール。設定を疑う場合はホームフォルダの.claudeを退避してから試すと、設定起因かどうかも切り分けられます - バグとして報告する──再現手順が明確なら
/bugコマンドで開発チームに直接報告できます。修正が早いプロダクトなので、報告する価値はあります - 最新情報を確認する──既知の問題は公式ドキュメントやGitHubのIssueに載ります。同じ症状の報告があれば、対処もそこにあることが多いです
不調を減らす日常の習慣
- 更新をさぼらない──不具合の多くは既に直っています。「おかしい」と思ったらまず更新、が結果的に一番の時短です
- 会話を引っ張りすぎない──1つの会話で何時間も作業を続けると、遅くなり、指示の通りも悪くなります。作業の区切りで
/clearする習慣を - エラーメッセージを読まずに捨てない──英語でも、そのままClaude Code（またはチャット版Claude）に貼れば日本語で解説してくれます。エラー文はAIに読ませる時代です
AIガイド群
FAQ
上限のリセットは何時ですか？
固定時刻ではなく、使い始めから5時間の窓が個人ごとに動く方式です。/usage で自分の状況を確認するのが確実です。
「Claude codeが重い」のはパソコンのスペックのせいですか？
ほとんどの場合違います。処理はAnthropic側のサーバーで行われるため、体感速度を決めるのはモデルの選択・読ませる量・回線です。まず /model と指示の範囲を見直してください。
障害情報はどこで確認できますか？
Anthropicのステータスページ（status.anthropic.com）が一次情報です。障害時の一般的な確認手順は使えない時のチェックページにもまとめています。
エラー文をチャットAIに貼って相談しても良いですか？
有効です。その際、社外秘のコードやAPIキーなど秘密情報が混ざっていないかだけ確認してから貼ってください。