【重複購入のご注意】この記事は「AI開発者の手帖」がnoteで販売している同名記事（コーディングエージェントにAPIキーを渡す前に：止まる上限と通知だけの上限を見分け、上限到達で再試行を止める）と同じ内容です。すでにnoteで購入・閲覧できる方は重複購入にご注意ください。
Claude Code や Codex、自作のエージェントに、従量課金の API キーやクラウドの権限を渡している個人開発者と小規模チームに向けて書きます。支払いを請求書払いで契約している組織、個別契約で上限を取り決めている組織、クラウド事業者経由でモデルを使う場合の扱いは対象外です。
筆者は AI 開発ツールの仕様と安全な使い方を公式資料と照らして追い、有料記事でも扱ってきました。本稿は、Anthropic・OpenAI・Google（Gemini API と Google Cloud）・AWS の公式ドキュメントと発表を2026年10月6日（JST）に取得し、上限の仕組みを突き合わせたものです。金額などの値は取得日のもので、変わりえます。発表や論評の日付は原文の表記のまま書きます。公式の記述と筆者の整理は分けて書きます。
何が問題か
Simon Willison は10月3日の論評で、従量課金のサービスには「月に X ドルを超えたら止めてエラーを返す」硬い上限が既定で必要だと書いています。警告のメールを送るだけの柔らかい上限では足りない、という主張です。理由として、コーディングエージェントは有料の API やホスティングを使うコードを簡単に作れてしまい、寝ている間に数百〜数千ドルを使われる、という状況を挙げています。
上限を置いても、エージェント側の作りで効き目が変わります。Anthropic のレート制限のページによると、利用段階（usage tier）ごとの月額上限に達すると HTTP 429 が返り、エラーの型はレート制限と同じ rate_limit_error です。この応答は、SDK の自動再試行を含めて、再開まで何度送っても失敗し続けます。OpenAI のレート制限のページでも、硬い上限（hard spend limit）に達した要求は 429 で返ります。
429 を「待てば通る」として扱うループは、上限に達しても止まらずに失敗を繰り返し、上限に達したという事実が再試行のログに埋もれます（筆者の整理）。
上限の種類の違い
各社の上限は、少なくとも次の点で違います。
- 止まるか、通知だけか：OpenAI の支出上限のページによると、spend alert は通知を送るだけで通信は続き、要求を失敗させるには上限の設定で「Enforce a hard limit」をオンにします。Anthropic の利用段階のうち Start・Build・Scale には、設定しなくても月額上限がかかっています
- かかる単位：Anthropic は組織とワークスペース、OpenAI は組織とプロジェクト、Gemini API は請求先アカウントとプロジェクト、Google Cloud の Spend Caps は1つのプロジェクトの1つのサービス、AWS の spend limit はプロジェクトです
- 到達時の応答：429 で返るもの、400 で返るもの、サービスやプロジェクトごと一時停止されるものがあります。同じ 429 でも、レート制限と見分ける手がかりは各社で違います
- 解除の仕方：翌月に自動で戻るもの、上限を上げれば戻るもの、手で解除すると同じ月にはもう発動しないものがあります
2026年10月6日に取得した各社の公式ページをもとに、上限を「止まる上限」と「通知だけ」に筆者が分けたものです。図には上限の名前とかかる単位だけを入れ、取得日の値で変わりうる金額は入れていません。Google Cloud の Spend Caps は Public Preview、AWS の spend limit は段階提供中、Gemini API のプロジェクトの上限は Experimental で、対象の範囲も変わりえます。図に挙げたのは各社の段階・予算の上限です。有料部では、Claude Code ワークスペースの利用者ごとの上限、OpenAI の月額の利用上限と前払いの残高、Gemini API の前払い残高も止まる上限として扱います。
1社分の見本：AWS の spend limit
有料部では、各社の上限をこの4点で並べています。AWS の分です。
- 止まるか：止まります。AWS のドキュメントによると、上限に達するとプロジェクトを一時停止し、すべてのリソースを止めます。データは保持されます。ただし同じページの冒頭には、新しい体験を一部の顧客に段階的に提供しているところで、まだ使えないことがある、と書かれています
- かかる単位：プロジェクトです。上限を付けるプロジェクトと付けないプロジェクトを分けられます
- 到達時の応答：プロジェクトの一時停止です。AWS の発表（9月16日）は、上限に達したプロジェクトはその月のあいだ一時停止される、と書いています
- 解除の仕方：AWS Settings で上限を引き上げると再開します。リソースによっては手で起動し直す必要があります。一時停止から90日のあいだ何もしないと、プロジェクトのデータは完全に削除されます。ドキュメントには、月が替わると自動で再開するとは書かれておらず、発表の「その月のあいだ」とは読みが分かれます。翌月に戻る前提で放置せず、一時停止したら AWS Settings でプロジェクトの状態と上限を確かめます
関連する記事
エージェントに何を許すかを、権限とサンドボックスの層で決める既刊です。キーの上限が「お金の上限」なら、こちらは「操作の上限」で、止めたいものを止めたつもりで終わらせず、実際に止まるかを確かめる考え方が共通します。
参考になったら、記事下部のライクとXの共有ボタンから応援してもらえるとうれしいです。
続きで読めるのは、Anthropic・OpenAI・Gemini API・Google Cloud の上限を同じ4点で並べたもの（到達時のステータスとエラーの見分け方、解除の仕方と落とし穴を含む）、エージェント用のキーを上限付きの単位に分ける手順、上限到達をレート制限と見分けて再試行を止める Python のコード例（Anthropic・OpenAI・google-genai の公式 Python SDK の自動再試行の切り方を含む）、上限が無いか届かないサービスで代わりに置く手段、キーごとの点検の手順、応答を分類する判断図です。コード例が分類するのは、到達時の応答の形を公式ページが示している上限だけです。Anthropic は段階の上限（見分けられるのは Messages API の応答だけです）と自分で設定した上限、OpenAI はエラーコードのページに載っている4つのコード、Gemini API は前払い残高の 402 です。Google Cloud の Spend Caps、Gemini API の段階とプロジェクトの上限、AWS の spend limit は、応答の形で見分けずに単位の分け方と代わりの手段で守ります。再試行の作りを変えられない Claude Code や Codex をそのまま使う場合の守り方も書いています。では、エージェントに渡すキーごとに、どの単位の上限で止め、届いた応答をどう見分ければ、上限に達したときに再試行を繰り返さずに止まるのか。
この記事の販売者
