Claude Codeが落ちている? 障害か手元の問題かを見分ける方法
まずstatus.claude.comを確認し、次にエラーを読みます。500、529 Overloaded、使用制限、429、接続エラーそれぞれの意味と対処法。
- CLI
- 0.2.17
- プレビュー ref
- a2c45c8
要点
まずstatus.claude.comを開きます。Claude CodeやAPIに進行中のインシデントがあれば、他の人にとっても落ちているので、待つのが対処法です。
ステータスページが正常なら、エラーの文言を正確に読みます。Anthropicのエラーリファレンスでは、いくつかの系統に分かれています。
| 表示 | 主な意味 | 最初の一手 |
|---|---|---|
API Error: 500 Internal server error | サーバー側の問題 | 再試行し、ステータスページを確認 |
API Error: Repeated 529 Overloaded errors | APIが容量の上限 | 待つ。クォータには計上されない |
Server is temporarily limiting requests (not your usage limit) | サーバー側の短時間の制限 | 少し待つ |
You've hit your session limit · resets … | プランの使用制限 | リセットを待つか、制限のガイドを参照 |
Request rejected (429) | APIキーやクラウドプロジェクトのレート制限 | ペースを落とすか、上限を上げる |
Unable to connect to API とその派生 | ネットワーク、VPN、プロキシ、DNS | curl -I https://api.anthropic.com |
Claude Codeは一時的な失敗をバックオフ付きで最大10回まで自動で再試行してからエラーを表示します。つまりエラーが見えている時点で、再試行は尽きています。
問題
Claude Codeが応答しなくなる、あるいは作業の途中で赤いエラーが出る。「Claude Code 落ちてる」と検索するのは自然な反応ですが、実際にはサービスは正常で、使用制限、プロキシ、VPN、ログインの期限切れなど、手元に原因があることも多くあります。この2つは対処が正反対です。待ってもプロキシは直らず、再インストールしても障害は直りません。
ステップ1:Claudeのステータスページを確認する
status.claude.comには、Claude Codeが使うAPIを含むClaudeのサービスのインシデントが載っています。Anthropicのエラーメッセージもここを案内しています。v2.1.198以降では、529の過負荷が原因の場合、再試行のカウントダウンにステータスの確認先が表示されます。
Amazon Bedrock、Google CloudのAgent Platform、Microsoft Foundry、またはゲートウェイを使っている場合、エラーにはそのプロバイダーやホストの名前が出ます。Anthropicではなく、そのプロバイダーのステータスページを確認してください。
ステップ2:エラーメッセージを読む
API Error: 500 Internal server error
Anthropicはこれをサーバー側の問題で、通常は一時的なものと説明しています。少し待って再試行し、続くようならステータスページを確認します。
API Error: Repeated 529 Overloaded errors
APIが容量の上限に達しています。Anthropicのリファレンスによると、529は使用制限ではなく、クォータにも計上されません。Opus is experiencing high load のようなメッセージも同じ系統です。負荷が引くまでの間、/model で別のモデルに切り替えると作業を続けられます。
Server is temporarily limiting requests (not your usage limit)
プランとは関係のない短時間の制限です。v2.1.199以降、Claude Codeは表示する前に自動で再試行します。少し待ってからもう一度試してください。
You've hit your session limit または weekly limit
障害ではありません。プランの利用枠を使い切っており、メッセージにリセット時刻が出ています。Claude Codeの使用量はいつリセットされる?と制限に達したときの対処法を参照してください。
Request rejected (429)
APIキー、Bedrockプロジェクト、またはGoogle Cloudプロジェクトに設定されたレート制限に達しています。プロキシやゲートウェイが独自の429ページを返した場合は、そのタイトルが · の後に表示されます。
Unable to connect to API
APIへの接続に失敗しています。最近のバージョンでは原因が表示され、ConnectionRefused、ENOTFOUND、EHOSTUNREACH などのエラーコードが括弧内に残ります。メッセージの例:
Unable to connect to API. Check your internet connection
Couldn't connect through your proxy (ERR_PROXY_TUNNEL)
Connection dropped (ECONNRESET)Anthropicはよくある原因として、インターネットに接続していない、VPNが api.anthropic.com をブロックしている、社内プロキシが未設定、を挙げています。
ステップ3:同じシェルから接続をテストする
curl -I https://api.anthropic.comWindows PowerShellでは、組み込みのエイリアスを避けるため curl.exe -I https://api.anthropic.com を使います。
curlが失敗する: このマシンのネットワークの問題です。Wi-Fi、VPN、DNSを確認します。社内プロキシの内側なら、Claude Codeを起動する前にHTTPS_PROXYを設定します。curlは通るがClaude Codeは動かない: ランタイムとネットワークの間に何かがあります。ゲートウェイを使っているならANTHROPIC_BASE_URLを、さらにAnthropicのネットワーク設定ページにあるファイアウォールの許可ホストを確認します。
ステップ4:ローカルのインストールを切り分ける
ステータスページが正常で、ネットワークにも問題がない場合:
- 更新する:
claude update - 想定どおりのアカウントでログインしているか確認する:Claude Code内で
/status - 環境に紛れ込んだ
ANTHROPIC_API_KEYがないか確認する。これはサブスクリプションのログインより優先されます。 - エラーではなくハングやCPU高負荷の場合は、Anthropicのトラブルシューティングページに主な原因がまとまっています。
無人で実行する場合
CIなど誰も見ていないジョブ向けに、Anthropicは CLAUDE_CODE_RETRY_WATCHDOG=1 を案内しています。通常の再試行で失敗する代わりに、429と529の容量エラーを無期限に再試行します。支出上限による429はすぐに失敗します。長い障害でランナーを占有し続けないよう、ジョブのタイムアウトと組み合わせてください。
離れているときに、プロバイダーの問題とコンピューターの問題を見分ける
座っていないコンピューターでセッションが動いている場合、「Claude Codeが落ちている」には3つの意味がありえます。プロバイダーに問題がある、セッションが制限に達した、コンピューター自体がオフラインになった、のいずれかです。
これをスマートフォンから見分けたいなら、HappierはClaude Code、Codexなどのエージェントをスマートフォン、デスクトップ、Webからクロスデバイスで実行・オーケストレーションできるオープンソースアプリです。
表示される内容:
- 各マシンの状態が「オンライン」(online)か「オフライン」(offline)で表示され、最終確認時刻も出ます。コンピューターがオフラインなら、復帰するまでプロバイダーの状態は関係ありません。
- 使用制限はセッション内のバナー「使用制限に達しました(Usage limit reached)」として、プロバイダーが示したリセット時刻とともに表示されます。これでクォータによる停止と障害を区別できます。
コンピューター上では、happier daemon status でバックグラウンドサービスが動いているかを確認できます。Happierはプロバイダーの障害、ネットワークの切断、電源の切れたコンピューターを直すものではありません。セットアップはスマートフォンからHappierを使う方法にあります。GitHubで公開されており、こちらからダウンロードでき、Discordもあります。
よくある質問
Claude Codeは今落ちている?
status.claude.comを確認してください。Anthropic自身のエラーメッセージが案内している情報源です。
529エラーで使用量は減る?
減りません。Anthropicのエラーリファレンスによると、529は使用制限ではなく、クォータにも計上されません。
Claudeのチャットは動くのにClaude Codeは動かないのはなぜ?
アカウントは共通でも、経路が同じとは限りません。Claude CodeはAPIキー、プロキシ、ゲートウェイ、クラウドプロバイダーを使っている場合があります。/status と環境変数を確認してください。
「Connection lost while your computer was asleep」で止まるのはなぜ?
リクエストの途中でコンピューターがスリープしました。Claude Codeは切れた接続を再試行しますが、それでもターンが終わってしまったら、メッセージをもう一度送ってください。