【解決方法】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) が出て、返事が来なくなることがあります。
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 のサービス側から来ると書かれています。
解決方法
関連するエラー
返事が来ないときに出るエラーには、ほかに次のものがあります。
| 表示される文 | 意味 |
|---|---|
Request timed out | Claude Code 自身が決められた時間(設定のままだと10分)待っても返事がなかった |
API Error: No response from API | 返事の最初のデータが決められた時間内に届かなかった |
API Error: 503 upstream connect error | 中継の機器が裏のサーバーにつなげなかった |
API Error: 502 Bad Gateway | 途中のプロキシやゲートウェイが返したページ |
注意点
まとめ
504 は、途中の中継の機器がサーバーの返事を待ちきれなかったときに出ます。多くはサーバー側の一時的な問題なので、ステータスページを見て、時間を置いてからやり直してみてください。
社内の回線でだけ出るときは、社内のプロキシの待ち時間が原因のこともあります。そのときは管理者に相談してみてください。
参考文献
著書
挙動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 に鍵の一覧が公開されているかも

