【解決方法】Claude Code で出る「API Error (503 no healthy upstream)」の原因と対処: 手元をいじっても直らない
2026年10月31日
Claude Code が API Error (503 no healthy upstream) を出して止まると、ログインや設定を疑いたくなります。でも、手元をいじっても直りません。
このエラーは、手元ではなく Anthropic のサーバー側で起きています。
出たときの表示と、直るまでにしたことを残しておきます。
環境
- Claude Code 2.1.309
- 2026年10月31日に確認
発生したエラー
古いバージョンでは、次のように表示されていました。
terminalAPI Error (503 no healthy upstream)
今のバージョンでは、500 番台(5xx)のエラーは API Error: 503 のように番号が出て、そのあとに返ってきた文やページの名前が続きます(公式のエラー一覧による)。
原因
API の手前にある中継の機器から見て、使える裏のサーバー(upstream)が1台もなかったときの 503 です。手元の設定やアカウントが原因ではありません。障害か手元の問題かは、Claude Code の障害の見分け方で見分けられます。
公式のエラー一覧の「Server errors」の節にも、5xx のエラーの多くは Anthropic のサービス側から来ると書かれています。
解決方法
関連するエラー
同じくサーバー側や、途中の機器から返るエラーには、次のものがあります。
| 表示される文 | 意味 |
|---|---|
API Error (503 upstream connect error) | 中継の機器が裏のサーバーにつなげなかった。同じくサーバー側 |
API Error: 500 Internal server error. This is a server-side issue, usually temporary — try again in a moment. If it persists, check https://status.claude.com. | サーバー側の予期しないエラー |
API Error: Repeated 529 Overloaded errors | サーバーの混雑 |
API Error: 502 Bad Gateway | 途中のプロキシやゲートウェイが返したページ。社内のプロキシのことがある |
注意点
まとめ
API Error (503 no healthy upstream) は、手元ではなく Anthropic のサーバー側で起きるエラーです。ログインや設定をいじっても直らないので、まずはステータスページで障害が出ていないかを見て、少し時間を置いてみてください。
同じエラーが続くときは、Claude Code の障害の見分け方で、本当にサーバー側なのかを確かめられます。
参考文献
著書
挙動Codex 画面を閉じても実は動いてた?常駐プロセスの動きについて検証してみた
挙動Homebrew で入れた Claude Code。更新しているつもりが、古いまま使ってませんか?
使い方Claude Code の拡張機能 2.1.312、2.1.313 は偽物。皆さんの Cursor は大丈夫ですか?
使い方知らぬ間に追加された大量のプラグインやフックが、毎回実行され続けていない? 皆さんの Claude Code は大丈夫ですか?
使い方npm のマルウェアが18日で1,753件! 気づいたら、あなたの GitHub に鍵の一覧が公開されているかも
使い方パスワードが GitHub で丸見えに? 原因は、Claude Code の確認で選んだ「Yes, and don't ask again」
使い方その OpenCode、脆弱性の告知がないからと安心してない? 今のままだと乗っ取られるかも
挙動Codex 画面を閉じても実は動いてた?常駐プロセスの動きについて検証してみた
挙動Homebrew で入れた Claude Code。更新しているつもりが、古いまま使ってませんか?
使い方Claude Code の拡張機能 2.1.312、2.1.313 は偽物。皆さんの Cursor は大丈夫ですか?
使い方知らぬ間に追加された大量のプラグインやフックが、毎回実行され続けていない? 皆さんの Claude Code は大丈夫ですか?
使い方npm のマルウェアが18日で1,753件! 気づいたら、あなたの GitHub に鍵の一覧が公開されているかも

