【保存版】Claude Codeエラー逆引き図鑑｜「動かない」を症状別に自力で直す対処法とコピペ復帰プロンプト

「Claude Codeが急に動かなくなった」「赤い英語のエラーが出て固まった」。非エンジニアがいちばん心細くなるのが、この瞬間ではないでしょうか。でも安心してください。Claude Codeのエラーは、9割が「あなたの操作ミス」ではなく、サーバー混雑や利用制限といった“待てば直る／一手で直る”ものです。この記事は、よく出るエラーを症状別に引ける「逆引き図鑑」です。エラー文の意味と原因、そして今すぐ打てる対処コマンドとコピペ復帰プロンプトをセットでまとめました。ブックマークして、詰まったときに開いてください。

エラーが出ても、まず落ち着く｜9割は「あなたのせい」じゃない

最初にいちばん大事なことをお伝えします。Claude Codeで出るエラーの多くは、あなたの書き方やパソコンの問題ではありません。サーバーが混んでいる、今日の利用枠を使い切った、ログインの期限が切れた。この3つがほとんどで、いずれも待つか、コマンドを一つ打つだけで元に戻ります。赤い英語の画面を見ると身構えてしまいますが、9割は“事故”ではなく“想定内”です。

しかもClaude Codeは、あなたに見せる前に自分で何度もやり直してくれています。サーバーの一時的な不調や通信の切断は、最大10回まで自動で再試行してから、やっと画面にエラーを出す仕組みです。つまり画面にエラーが出た時点で「自動リトライでも直らなかった」状態なので、まずは一呼吸おいて、この記事で症状を探すのが正解です。

そして、原因がまったく分からないときの「万能の健康診断」が /doctor というコマンドです。チャット欄に /doctor と打つだけで、インストール状態・ログイン・通信・設定などを自動でチェックし、赤（要対処）・黄（注意）・緑（正常）で結果を見せてくれます。何から手をつければいいか分からないときは、まず /doctor。これだけ覚えておけば、たいていの入口が見つかります。

「Overloaded／API Error」が出た｜サーバー混雑の対処法

いちばんよく遭遇するのがこれです。API Error: Repeated 529 Overloaded errors のように「Overloaded」「529」という文字が出たら、意味は一つ。「今、世界中からアクセスが集中していて、サーバーが一時的に満員です」ということです。あなたのコードも、アカウントも、まったく悪くありません。この混雑エラーは利用枠（あとで説明する制限）も一切消費しないので、慌てず待って大丈夫です。

対処は3つあります。ひとつめ、数分待ってもう一度送る。多くはこれで直ります。会話はそのまま残っているので、長い依頼を貼り直す必要はなく、チャット欄に「try again」または「さっきのをもう一度」と打てば同じ依頼を再送できます。ふたつめ、/model と打ってモデルを切り替える。混雑は「モデルごと」に起きるので、混んでいるモデルから別のモデルに変えるだけで動くことがよくあります。実際、片方が特に混んでいるときはClaude Code自身が「別のモデルに切り替えて」と案内してくれます。みっつめ、本当に大きな障害が起きていないかを status.claude.com で確認する。ここが公式の稼働状況ページで、全体障害ならここに掲示されます。

ひとつだけ注意点を。混雑エラーが出たときに、焦って何度も連打で送り直すのは逆効果です。混んでいる列にさらに並び直すようなもので、余計に詰まります。「数分待つ」「モデルを変える」。この2枚のカードで、たいていの混雑はやり過ごせます。

「制限に達しました」と出た｜利用枠を回復・節約する

You've hit your session limit や You've hit your weekly limit、あるいは Opus limit といったメッセージは、サーバー混雑とはまったく別ものです。これは「あなたのプランの今の利用枠を使い切りました」というお知らせで、5時間ごとに区切られる枠（セッション）と、1週間ごとの枠（ウィークリー）があります。メッセージには「resets 3:45pm」のようにリセット時刻が一緒に表示されるので、その時間を過ぎればまた使えるようになります。

対処はシンプルです。基本は「リセット時刻まで待つ」。今どれくらい使っていて、いつ回復するかを正確に知りたいときは /usage と打つと、プランの上限とリセット時刻が一覧で見られます。どうしても今すぐ続きをやりたいときは /usage-credits で追加の利用分を購入できます（ProやMaxで利用可能・従量課金）。ちなみに2026年7月7日から、最上位モデルのFable 5はサブスクの枠ではなくこの従量課金（クレジット）で動く形に変わったので、Fable 5を多用する人は /usage-credits の存在を覚えておくと安心です。

節約のコツも一つ。制限に早く当たる大きな原因は「重いモデルの使いすぎ」です。軽い作業までいちばん重いモデルで回していると枠の減りが早いので、次に紹介する「モデルの使い分け」を意識すると、同じプランでも一日にできる作業量がぐっと増えます。

「Sonnetのはずが枠が減る／Opusが使えない」｜モデルのズレを直す

「軽いモデルにしたのに、なぜか枠がどんどん減る」「Opusを使おうとしたら弾かれた」。これはエラーというより“モデルのすれ違い”です。原因の多くは、今どのモデルで動いているかを把握できていないことにあります。まず /status と打つと、今つながっているアカウントと認証情報が確認できます。ここで意図しないAPIキーが優先されていると、思っていたのと違う枠で課金されることがあるので要注意です。

モデルそのものを変えたいときは /model です。打つとモデルの一覧が出るので、その場で切り替えられます。日常の指示出しや文章整理はSonnetのような標準モデルで十分速く、難しい設計や込み入った修正だけ上位モデルに上げる。この使い分けだけで、枠の減りも待ち時間も変わります。なお Claude Opus is not available with the Claude Pro plan のように「このプランでは使えない」と出た場合は、モデルの権限の問題なので、/model で使えるモデルに切り替えるか、プランを見直すのが解決の道です。

「重い作業を軽いモデルに投げて失敗する」「軽い作業を重いモデルで回して枠を溶かす」。この両方を防ぐのがモデル選びです。どのモデルを何に使うかは別記事で詳しくまとめているので、迷ったらそちらも参考にしてください。

「急に遅い・話が噛み合わない」｜会話が長くなりすぎたサイン

エラー文は出ていないのに、返事が急に遅くなった、さっき言ったことを忘れている、Prompt is too long（依頼が長すぎます）や Conversation too long（会話が長すぎます）と出た。これは多くの場合、故障ではなく「会話が長くなりすぎて、Claudeの“記憶の机”がいっぱいになった」サインです。人間でも、何時間も続いた打ち合わせの終盤は集中力が落ちますよね。それと同じで、一つの会話に情報を詰め込みすぎると動きが鈍くなります。

直し方は2つ。ひとつめ、/compact と打つ。今までの会話を要点だけに圧縮して、話の流れを保ったまま机の上を片付けてくれます。作業の続きをしたいときはこちらです。ふたつめ、/clear と打つ。会話を一度まっさらにして、新しい気持ちで始め直します。別の作業に移るときや、話がこじれてどうにもならないときは /clear が効きます。

コツは「一つの会話に何でも詰め込まない」こと。テーマが変わったら /clear で区切る、長くなってきたら /compact で整える。この習慣があるだけで、「急に賢くなくなった」という体感トラブルの大半は防げます。

「権限で止まる／勝手に進むのが怖い」｜確認モードと許可設定

「作業の途中で“このコマンドを実行していいですか？”と何度も聞かれて進まない」「逆に、勝手にファイルをどんどん触られるのが怖い」。これはエラーではなく、Claude Codeの安全装置（権限の仕組み）が働いている状態です。Claude Codeは、あなたのパソコンで実際にコマンドを動かせる道具なので、どこまで自動で任せ、どこで確認を挟むかを自分で設定できます。

止まりすぎて困るときは、毎回聞かれる操作を「これは許可」と登録しておくと、次から確認なしで進みます。逆に、勝手に進むのが不安なときは、確認を挟む「都度たずねるモード」にしておけば、実行前に必ず一声かけてくれます。また、はじめてのフォルダで作業すると「このworkspaceはまだ信頼されていません」という趣旨の警告が出て、設定の一部が無視されることがあります。これは安全のための仕組みなので、自分のフォルダなら「信頼する」を選べば通常どおり動きます。

大事なのは、権限で止まるのは“不具合”ではなく“守ってくれている”ということ。急ぎのときは許可を広げ、慎重にいきたいときは確認モードにする。アクセルとブレーキを自分で握れるのがClaude Codeの安心設計です。詳しい設定手順は安全設定の記事にまとめています。

「ログインできない／認証エラー」｜/loginで作り直す

Not logged in · Please run /login（ログインしていません）や、しばらく使っていなかったら認証が切れていた、というのもよくあるケースです。ログイン情報には期限があり、時間が経つと切れることがあります。これも故障ではなく、期限切れの“定期券をもう一度買い直す”イメージで捉えてください。

対処は、メッセージのとおり /login と打ってログインし直すだけです。ブラウザが開いて認証すれば、たいていは元どおりになります。それでも直らないときは /status で「今どの認証情報が使われているか」を確認してください。会社のパソコンなどで、環境変数に古いAPIキーが残っていると、そちらが優先されてうまくログインできないことがあります。その場合は不要なキーを外すか、正しいアカウントで /login し直すのが確実です。

認証まわりは、原因が「期限切れ」か「別のキーが混ざっている」かのどちらかがほとんどです。まず /login、直らなければ /status。この順番で見れば、ほぼ解決します。

困ったときの万能プロンプト｜エラーは「意味を聞いて、全部貼る」

症状別の対処を紹介してきましたが、どれにも当てはまらない、あるいは英語のエラー文の意味がまったく分からないときの“最後の切り札”があります。それは、Claude自身にエラーの意味と直し方を聞いてしまうことです。Claude Codeはエラー対応も得意なので、次のプロンプトをコピペして、そのあとにエラー文を全文そのまま貼り付けてください。

「このエラーの意味を、専門用語なしで初心者にもわかるように説明してから、直し方を教えてください。もし自動で直せるなら、直したあとに動くかどうかの確認までしてください」

ポイントは「意味の説明→原因→直し方→確認」までを一度に頼むことと、エラー文を要約せずに“現物のまま全部貼る”ことです。人間が親切に短くまとめるより、そのままコピペしたほうが正確に伝わります。それでも解決しないときの追加の一手として、/doctor で環境の健康診断、/feedback でAnthropicに状況を報告、という手段もあります。まずは「意味を聞いて、全部貼る」。これがいちばん確実な復帰ルートです。

よくある質問（Claude CodeのエラーFAQ）

赤いエラーが出たらやり直さないとダメですか、という質問をよくいただきます。多くの場合、やり直す必要はありません。会話はそのまま残っているので、混雑や一時的な不調なら「try again」や「もう一度お願いします」と打つだけで、同じ依頼をまた実行してくれます。長い依頼を貼り直す手間はいりません。

エラーの英語が読めなくて不安です、という声も多いです。読めなくて大丈夫です。この記事のとおり、まずは「混雑（Overloaded）」「制限（limit）」「未ログイン（Not logged in）」の3つの単語だけ見分けられれば十分で、それでも分からなければ万能プロンプトでエラー文を丸ごとClaudeに貼って聞けば、意味から直し方まで日本語で教えてくれます。

待っても直らないときはどうすればいいですか、という質問もあります。数分待っても、モデルを切り替えても直らない混雑エラーは、全体障害の可能性があります。status.claude.com を開いて障害情報が出ていれば、こちら側でできることはないので、復旧を待つのが正解です。障害でもないのに続くなら /doctor で環境を確認してみてください。

同じエラーを何度も繰り返さない方法はありますか、という相談もあります。あります。うまくいった直し方や避けたい操作は、CLAUDE.mdという“引き継ぎメモ”に書いておくと、次回から自動で気をつけてくれます。「二度と同じエラーを出さないよう、注意点をCLAUDE.mdに書いておいて」と頼めば、あなた専用のエラー予防メモが育っていきます。

まとめ｜症状→原因→一手で直す、を手元に置く

Claude Codeのエラーは、こわい“事故”ではなく、ほとんどが“想定内のサイン”です。混雑（Overloaded）は待つかモデル切替、制限（limit）はリセット待ちか追加購入、未ログインは /login、遅い・噛み合わないは /compact／/clear、権限で止まるのは設定で調整。この対応表さえ手元にあれば、赤い画面を見ても慌てなくなります。

そして、どうにも分からないときの合言葉は2つだけ。まず /doctor で健康診断、それでもダメなら「エラー文を全部貼って、意味と直し方を聞く」。この記事をブックマークしておけば、次に詰まったときも症状から引いてすぐ戻れます。エラーを自力でいなせるようになると、Claude Codeはぐっと頼れる相棒になります。

料金や制限の仕組み、どのモデルを何に使うかといった土台の話は、あわせて読むと、そもそもエラーに詰まりにくくなります。関連記事もぜひ参考にしてください。

 Claude Codeのつまずきポイントや実践ノウハウは、X（@ai_hack_dx）でも毎日発信しています。非エンジニアでも今日から使える具体ネタを中心に届けているので、よければのぞいてみてください。