T-CREATOR

<div />

【解決方法】Claude Code で出る「API Error (api.anthropic.com | 504: Gateway time-out)」の原因と対処: 多くはサーバー側の一時的な問題

2026年11月1日
【解決方法】Claude Code で出る「API Error (api.anthropic.com | 504: Gateway time-out)」の原因と対処: 多くはサーバー側の一時的な問題

Claude Code で API Error (api.anthropic.com | 504: Gateway time-out) が出て、返事が来なくなることがあります。

504 は、途中の中継の機器がサーバーの返事を待ちきれなかったときのエラーで、多くはサーバー側の一時的な問題です。

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

環境

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

発生したエラー

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

terminalAPI Error (api.anthropic.com | 504: Gateway time-out)

api.anthropic.com | 504: Gateway time-out は、中継の機器が返したページの名前です。今のバージョンでは、ページが返ってきたときは API Error: 504 Gateway Time-out のように、番号とページの名前だけが出ます(公式のエラー一覧による)。

原因

api.anthropic.com の手前の中継の機器が、裏のサーバーの返事を待ちきれずに 504 を返しています。手元の設定やアカウントが原因ではありません。障害か手元の問題かは、Claude Code の障害の見分け方で見分けられます。

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

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

解決方法

関連するエラー

返事が来ないときに出るエラーには、ほかに次のものがあります。

表示される文意味
Request timed outClaude Code 自身が決められた時間(設定のままだと10分)待っても返事がなかった
API Error: No response from API返事の最初のデータが決められた時間内に届かなかった
API Error: 503 upstream connect error中継の機器が裏のサーバーにつなげなかった
API Error: 502 Bad Gateway途中のプロキシやゲートウェイが返したページ

注意点

まとめ

504 は、途中の中継の機器がサーバーの返事を待ちきれなかったときに出ます。多くはサーバー側の一時的な問題なので、ステータスページを見て、時間を置いてからやり直してみてください。

社内の回線でだけ出るときは、社内のプロキシの待ち時間が原因のこともあります。そのときは管理者に相談してみてください。

参考文献

著書

とあるクリエイター

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

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