1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

Claudeは上限未到達でも止まった。支出上限の誤判定に、リトライだけでは備えられない

1
Last updated at Posted at 2026-10-25

モデルを切り替える前に、課金で止められていないか確認したい。

2026年10月7日、Claudeで支出上限の誤判定による障害が起きた。上限に達していない一部の組織が停止扱いとなり、Claude API、Claude.ai、Claude Code、Claude Security、Claude Coworkで要求が拒否された。

この停止は、モデルの混雑を待つ話とは違う。支出上限による停止は、同じ要求を繰り返しても解除されない場合がある。本番で必要なのは、再試行の回数を増やすことより、止まった理由を見分けることだ。

要求が拒否されたのに、記録は「none」

この障害のステータスAPIには、impact: "none"、components: [] と記録されている。

これは利用者への影響がなかった証明にはならない。同じ記録の本文には、5製品で要求が拒否されたと書かれている。コンポーネントの状態だけを見張る監視では、この記録を拾えない。

一方、被害を受けた組織数、実際の停止時間、返されたHTTPエラーは公表されていない。掲載時刻と解決時刻の差を、そのまま停止時間として扱うこともできない。

支出上限の停止は、モデルの変更だけでは解消できないことを示す概念図

図:支出上限とモデルの処理は、分けて考える必要がある。公開資料に基づく概念図であり、Anthropicの内部実装を示したものではない。

「429だから待つ」では直らない

Claude APIには、一定時間あたりの要求量を制限するレート制限と、月間の利用額を制限する支出上限がある。公式ドキュメントでは、支出上限でも400や429が返る。

止まる理由 応答の手がかり 復旧の条件
ティアの月間支出上限 429。error.details.error_code が enforced_spend_limit_reached 原則、翌月1日0時UTCのリセット、または上限引き上げ
自分で設定した支出上限 400。メッセージが You have reached your specified で始まる 上限の変更、または応答に記載された再開日時

月間支出上限の429には、retry-after が付かない。SDKの自動リトライも、アクセスが再開するまでは失敗する。通常のレート制限と同じHTTPステータスでも、必要な対応は違う。

400も同様だ。「リクエストの書き方が悪い」と決めつけると、支出上限による停止を見落とす。ステータスコードだけでなく、エラー本文まで扱う必要がある。

この表は現在の仕様であり、10月7日の障害で実際にどの応答が返ったかを示すものではない。

別モデルへ逃がせばよい、とは限らない

Claude Codeのフォールバックモデルは、過負荷や利用不可などに備える機能だ。公式仕様では、課金エラーは切り替えの対象に含まれない。

自分でモデル切り替えを実装していても、同じ組織の支出上限で止まっているなら、モデル名を変えるだけで復旧するとは限らない。モデルの選択と、課金・利用可否の判定は別の問題だからだ。

予備経路を持つなら、どの契約・アカウント・請求に依存するかまで確認したい。たとえばAmazon Bedrock経由のClaude Codeという選択肢がある。ただし、10月7日にBedrockが無影響だったと公表されたわけではない。同じモデルを使う以上、モデル側の障害まで独立する保証もない。

今日やるべき3つのこと

1. 本番の支出上限と、対応する担当者を確認する

本番APIキーが属する組織・ワークスペースを確認し、ConsoleのBillingで設定した上限と、ティアの上限を調べる。実際に止まったとき、誰が利用額を確認し、誰が上限変更を判断するかまで決めておく。

残高があることと、すべての上限に余裕があることは同じではない。上限ごとの設定と現在の利用状況を一緒に確認する。

2. 課金・支出上限のエラーを、独立したアラートにする

自分のリクエストの成功率と、400・429の内訳を監視する。月間支出上限のエラーコード、自分で設定した上限のメッセージを、それぞれ通常の入力エラーや短時間のレート制限から分けて記録する。

障害調査用には、発生時刻、HTTPステータス、エラーの型・コード、リクエストIDを残す。APIキーや入力本文は載せない。上限停止を検知したら、無制限の再試行を続けず、担当者へ通知する。

3. 予備経路を1本だけ用意し、切り替えを試す

Bedrockなどの別経路を使うなら、認証、モデルへのアクセス、必要な機能、予備側の上限を事前に確認する。「契約はあるが呼び出したことがない」では、障害時に使えるか分からない。

自動切り替えには予備側の予算と承認条件も設ける。本当に使いすぎて止まった場合まで、別の請求へ無条件に流してはいけない。 誤判定を疑うときも、まず利用状況と設定を確認し、予備側の許容予算内で対応する。

まずは、本番で返る400・429を理由ごとに見分けられるか。それを確認するところから始めたい。

参考資料

Issue with spend limits / Claude Status
https://status.claude.com/incidents/vmys9qn874h4

Rate limits / Claude Platform Docs
https://platform.claude.com/docs/en/api/rate-limits

Model configuration / Claude Code Docs
https://code.claude.com/docs/en/model-config

Claude Code on Amazon Bedrock / Claude Code Docs
https://code.claude.com/docs/en/amazon-bedrock

1
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?