T-CREATOR

<div />

【解決方法】Claude Code で出る「API Error (503 upstream connect error)」の原因と対処: 手元をいじっても直らない

2026年10月31日
【解決方法】Claude Code で出る「API Error (503 upstream connect error)」の原因と対処: 手元をいじっても直らない

Claude Code が API Error (503 upstream connect error) を出して止まると、ログインや設定を疑いたくなります。でも、手元をいじっても直りません。

このエラーは、手元ではなく Anthropic のサーバー側で起きています。

出たときの表示と、直るまでにしたことを残しておきます。

環境

  • Claude Code 2.1.309
  • 2026年10月31日に確認

発生したエラー

古いバージョンでは、次のように表示されていました。

terminalAPI Error (503 upstream connect error)

今のバージョンでは、500 番台(5xx)のエラーは API Error: 503 のように番号が出て、そのあとに返ってきた文やページの名前が続きます(公式のエラー一覧による)。

原因

API の手前にある中継の機器が、裏のサーバー(upstream)につなげなかったときの 503 です。手元の設定やアカウントが原因ではありません。障害か手元の問題かは、Claude Code の障害の見分け方で見分けられます。

公式のエラー一覧の「Server errors」の節にも、5xx のエラーの多くは Anthropic のサービス側から来ると書かれています。

公式のエラー一覧の Server errors の節。Most of these errors come from the inference provider: Anthropic’s service on the Anthropic API と書かれている

解決方法

関連するエラー

同じくサーバー側や、途中の機器から返るエラーには、次のものがあります。

表示される文意味
API Error (503 no healthy upstream)中継の機器から見て、使える裏のサーバーがない。同じくサーバー側
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 upstream connect error) も、手元ではなく Anthropic のサーバー側で起きるエラーです。ログインや設定をいじっても直らないので、まずはステータスページで障害が出ていないかを見て、少し時間を置いてみてください。

同じエラーが続くときは、Claude Code の障害の見分け方で、本当にサーバー側なのかを確かめられます。

参考文献

著書

とあるクリエイター

フロントエンドエンジニア Next.js / React / TypeScript / Node.js / Docker / AI Coding

とあるクリエイターのプロフィール