Claude Codeの429エラーとは原因の見分け方と対処法

更新 2026.10.09
公開 2026.10.09
出典 2件
約6分で読めます

Claude Codeの「429」エラーの意味と原因を、公式のエラー一覧で整理。サーバー側の一時的な制限とAPIキーのレート制限の違い、自動再試行の仕組み、/status での確認、並列実行を減らす対処を解説します。

公的機関・公式資料などの一次情報と照合して作成しています。このサイトについて

Claude Codeの429エラーとは

429 は、HTTP のステータスコードの一つで、「短時間に要求が多すぎる」ことを示します。Claude Code の公式エラー一覧で、429 に関係して見分けたい表示は2種類あります。ひとつは「API Error: Server is temporarily limiting requests (not your usage limit)」（短時間の制限。公式の該当節に 429 という数字は書かれていません）、もうひとつは「API Error: Request rejected (429) · this may be a temporary capacity issue」です。

この2つは、原因も対処も違います。前者は、サーバー側の短い制限で、待てば解消します。後者は、使っている API キーやクラウドのプロジェクトのレート制限に達したことを示します。まず、どちらが出ているかを見分けることが、対処の出発点です。

基本（2種類の429）

表示	原因	対処
Server is temporarily limiting requests (not your usage limit)	サーバー側の短時間の制限。自分の利用上限とは無関係	少し待って再送する。続くなら status.claude.com を確認する
API Error: Request rejected (429) · this may be a temporary capacity issue	API キー、Bedrock のプロジェクト、Google Cloud のプロジェクトのレート制限に達した	認証と制限を確認し、並列実行を減らす

公式のエラー一覧には、Claude Code は一時的な障害（サーバーエラー、過負荷、一時的な 429、タイムアウトなど）を、指数的に待ち時間を伸ばしながら、最大10回まで自動で再試行すると書かれています。そのため、短時間の 429 は、画面に出る前に解消していることも多いと考えられます。ただし、ゲートウェイの支出上限による 429 は一時的な制限ではないため、再試行の対象外とされています。

具体例（原因の候補）

後者の 429（API キーなどの制限）が出たときの原因の候補と、確認方法です。

原因の候補	確認する場所
低い上限のキーで動いている	`/status` で、有効な認証の種類を確認する
環境変数 ANTHROPIC_API_KEY が残っている	端末の環境変数や、シェルの設定ファイルを確認する
ツールの並列実行や、サブエージェントが多い	同時に走らせている作業の数を確認する
組織全体の制限に、他の利用者の分も含まれている	Console やクラウドの管理画面で、制限と使用状況を確認する

公式のコスト管理のページには、チームの人数別に、1人あたりの TPM（1分あたりのトークン数）と RPM（1分あたりのリクエスト数）の推奨値が示されています。レート制限は、組織全体にかかり、個人の割り当てを一時的に超えて使うこともできるとされています。

Claude Codeの429エラーの実践ステップ

表示された文言を読み、どちらの 429 かを判断する。
「Server is temporarily limiting requests」なら、数十秒から数分待つ。
「Request rejected (429)」なら、/status を実行して、有効な認証を確認する。
意図しない ANTHROPIC_API_KEY が設定されていたら、解除する。
並列の作業を減らす。同時に動かすサブエージェントを減らし、環境変数 CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY を小さくします。
自動の処理（スクリプト）の場合は、小さいモデルを使うか、実行の間隔を空ける。
改善しない場合は、Console やクラウドの管理画面で、制限の引き上げを依頼する。

Claude Codeの429エラーの注意点

429 は、サブスクリプションの上限（セッション上限や週間上限）とは別のものです。上限メッセージは、「You’ve hit your session limit」のような別の文言で表示されます。
CI など無人の環境では、環境変数 CLAUDE_CODE_RETRY_WATCHDOG を 1 にすると、429 と 529 を無期限に再試行します。ただし、無限に待つ可能性があるため、時間制限と合わせて使います。
再試行の回数は CLAUDE_CODE_MAX_RETRIES（既定は10）で変えられます。スクリプトで早く失敗させたいときは、小さくします。
429 を避けるために、無秩序に再試行を重ねると、状況が悪化します。

Claude Codeの429エラーでよくあるミス

429 を、利用上限のメッセージと混同する。
API キーの環境変数が残っていることに気づかず、低い上限のキーで動いている。
多数のサブエージェントを並列に走らせる。
一時的な 429 に、ただちにやり直し続ける。自動の再試行に任せて待つほうが、安定します。

Claude Codeの429エラーのチェックリスト

表示された429の種類を判断したか。
/status で、有効な認証を確認したか。
環境変数 ANTHROPIC_API_KEY を確認したか。
並列の作業を減らしたか。
無人の環境では、再試行の設定を確認したか。

Claude Codeの429エラーのFAQ（よくある質問）

Q. 429 が出ると、利用上限を消費しますか。
A. 公式のエラー一覧には、429 が利用上限に数えられるとは書かれていません。サーバー側の一時的な制限は、自分の利用上限とは無関係と説明されています。

Q. 429 はどのくらい待てば解消しますか。
A. 公式に具体的な時間は示されていません。Claude Code が指数的に待ち時間を伸ばして自動で再試行します。

Q. 組織のレート制限は引き上げられますか。
A. Console やクラウドの管理画面から、制限の確認と、引き上げの依頼ができます。具体的な手順は、各サービスの案内に従ってください。

筆者の見解（Claude Codeの429エラー）

私見では、429 で最初にすべきことは、文言に「Request rejected (429)」とあるかどうかを見ることです。この表示が繰り返し出る場合は、待つより先に /status で認証を確かめる価値があると考えます。サブスクリプションのつもりで、上限の低い古い API キーで動いていた、という取り違えは、本人が最も気づきにくい原因だからです。一方、CI などで CLAUDE_CODE_RETRY_WATCHDOG を使って無期限に再試行させる設定は便利ですが、設定ミスによる 429 まで待ち続けてしまう恐れがあり、ジョブ全体の時間制限とセットで使うべきだと考えます。並列のサブエージェントを増やすほど速くなるとは限らず、制限に当たって全体が遅くなるトレードオフも意識しておくとよいと考えます。

Claude Codeの429エラーの関連項目

出典（一次情報）

本記事は一般的な情報の提供を目的としています。Claude Code の料金・利用上限・機能・エラーメッセージ・コマンドは頻繁に更新されるため、最新の内容は Anthropic の公式ドキュメントとお使いのバージョンで必ずご確認ください。契約・請求・セキュリティに関する判断は、公式サポートや社内の担当部門にご相談ください。「筆者の見解」は一つの考え方です。