「Could not update spend limit」の対処 — Claude Codeの支出上限エラー
Claude Codeで「Could not update your spend limit」が出たときの対処。理由付きと理由なしで対応が分かれる点、ブラウザ側で変更する代替手順、他の「spend limit」表示との違いをまとめます。
Could not update your spend limit: <reason from the server> — Pro / Maxプランで支出上限を上げようとしたとき、サーバー側がその変更を拒否するとこう出ます。表示にはコロン以降に理由が付く形と、理由が付かない汎用形の2種類があり、どちらが出ているかで取るべき対処が変わります。
「Could not update your spend limit」が出る場面
このエラーは、Pro / Maxプランで使用量クレジットが有効な状態で支出上限に達したときに出る、CLI内のプロンプトから発生します。Claude Codeは支出上限に達すると、CLIを離れずに上限を引き上げるか外すかをその場で確認してきます。そこで入力した変更をサーバーが拒否すると、このエラーになります。
表示は2種類に分かれます。サーバーが理由を返せた場合はコロンの後ろにその理由が続き、同じ値で再試行しても同じ理由で失敗します。理由を返せなかった場合(接続が切れた場合など)はCould not update your spend limit. Press Enter to retry.という汎用形になり、こちらは再試行で成功することがあります。
表示形式で対処を分ける
| 表示形式 | 意味 | 対処 |
|---|---|---|
Could not update your spend limit: <理由> | 意味サーバーが変更を拒否した理由を返した | 対処理由に合う値(たとえばより低い金額)に変更して再試行 |
Could not update your spend limit. Press Enter to retry. | 意味理由なしの失敗。接続断など一時的な要因の可能性 | 対処そのままEnterで再試行。改善しなければブラウザ側で操作 |
理由付きの失敗で同じ値を入れ直しても、サーバー側の判定基準が変わらない限り同じ結果になります。まず理由の文面を読み、上限額を下げる、あるいは他の条件を満たす値に変えてから再試行してください。汎用形の失敗は、繰り返しても改善しない場合に限って、claude.aiの請求設定画面から直接操作する方法に切り替えます。
ブラウザ側で操作する代替手順
CLIでの変更がどうしても通らないときは、claude.aiの設定画面から同じ操作ができます。Pro / Maxの個人契約なら、Settings > Usageの「Usage credits」欄で支出上限の確認と変更が可能です。Claude Codeの中からは/usage-creditsでこの画面を直接開けます。
/usage-credits/usage-creditsはclaude.aiのサブスクリプションで/login済みのときだけ使え、APIキー認証では使えません。役割によって開く画面が変わります。
| 利用形態 | /usage-creditsが開くもの |
|---|---|
| Pro / Maxの個人契約者 | /usage-creditsが開くものclaude.aiのSettings > Usage(使用量クレジットの有効化・残高・月間支出上限を確認・変更) |
| 請求権限を持つTeam / Enterpriseメンバー | /usage-creditsが開くもの組織のAdmin settings > Usage |
| 請求権限を持たないTeam / Enterpriseメンバー | /usage-creditsが開くもの確認のうえ、組織の管理者へリクエストを送信 |
請求権限を持たないメンバーの場合、確認ステップが出るのは対話セッションだけです。非対話モード(-pフラグ)やRemote Control経由では、リクエストは送信されず、対話セッションで実行するよう案内されます。
管理者へのリクエストは重複送信されません。すでに送ったリクエストが管理者の確認待ちの間に/usage-creditsをもう一度実行しても、Claude Codeは新しいリクエストを送らず「すでに送信済み」と伝えます。管理者がリクエストを却下したあとに再実行すれば、そこで初めて新しいリクエストが送られます。
「引き上げる」か「外す」かの選択
支出上限のプロンプトは、上限を引き上げるか、上限そのものを外すかを選ばせる形になっています。引き上げは新しい金額を入力するだけですが、外す場合は月間の支出に上限が無い状態になり、使用量クレジットが有効な限り請求が続きます。予算の見通しを立てたい場合は、外すのではなく具体的な金額へ引き上げるほうが、意図しない高額請求を避けやすくなります。
月ごとの支出と残高、現在の上限額はSettings > Usageでいつでも確認でき、必要ならそこから上限を下げることもできます。上限の変更自体がこのエラーで失敗しているときは、今の値がいくらかを確認したうえで、次にどの値を試すかを決めてください。
「spend limit」という言葉が指すものは1つではない
「Could not update your spend limit」という表示だけを見て、組織のAPI利用に対する管理上限を思い浮かべる読者もいますが、それは別物です。Claude Codeまわりで「spend limit」と呼ばれるものは、少なくとも3つの異なる仕組みに分かれます。
| 文脈 | 対象 | 上限の設定場所 | 関連する表示 |
|---|---|---|---|
| 個人のPro / Max | 対象使用量クレジットの月間支出 | 上限の設定場所claude.aiのSettings > Usage、CLIのプロンプト | 関連する表示Could not update your spend limit |
| Team / Enterpriseの組織 | 対象メンバーごとの使用量クレジット支出 | 上限の設定場所組織のAdmin settings > Usage | 関連する表示(組織側の画面で完結、CLIプロンプトは経由しない) |
| 自社ホストのClaude apps gateway | 対象ゲートウェイ経由の開発者ごとの支出上限 | 上限の設定場所運用者がAdmin APIで設定 | 関連する表示spend limit reached / spend limit unavailable |
| Claude Console(APIキー利用) | 対象ワークスペース単位の支出上限 | 上限の設定場所Consoleのワークスペース設定 | 関連する表示Credit balance is too low |
Console経由でAPIキー認証を使っている組織は、さらに別の仕組みです。Claude Codeで初めてConsoleアカウントを認証すると、その組織専用の「Claude Code」ワークスペースが自動で作られ、そこにワークスペース単位の支出上限を設定できます。このワークスペースはClaude Code専用で、他のAPIキーを発行する用途には使えません。上限に達したときの表示は「Could not update your spend limit」ではなく「Credit balance is too low」になり、対処もConsoleの請求設定でクレジットを追加する形になります。
この記事が扱う「Could not update your spend limit」は、表の一番上、個人のPro / Maxプランで使用量クレジットの月間支出上限を変更しようとしたときの失敗です。組織のAdmin settings側で上限を変更する操作や、自社ゲートウェイの429 spend limit reachedとは、エラーの出どころも直し方も別になります。組織のメンバーとしてこの上限を管理したい場合は、CLIのプロンプトではなくAdmin settings > Usageから操作してください。
利用枠そのものの仕組みや、使用量クレジットを使うべきかの判断はClaude Maxプランとはにまとめています。
429やレート制限との違い
支出上限に関する失敗は、レート制限や使用量上限の失敗とは性質が異なります。後者は「今は送れない」という一時的な状態ですが、支出上限の変更失敗は「設定変更そのものが通らない」という状態です。待てば自動的に解消するものではありません。
支出上限に達した状態そのもの(このエラーではなく、上限到達によってリクエストが止まる状態)への対処や、使用量クレジットの基本的な仕組みはClaude rate limitエラーの対処で扱っています。合わせて読むと、上限に当たってから変更を試みるまでの流れ全体が見えます。
エラーメッセージ全般の見取り図が欲しい場合はClaude Codeでよくあるエラー10選から探す方法もあります。
よくある質問
同じ値で何度も再試行しても平気ですか
表示形式によります。理由付きのCould not update your spend limit: <理由>は、同じ値を入れ直しても同じ理由で失敗します。理由なしの汎用形Press Enter to retry.は、接続断のような一時的な要因である可能性があるため、再試行で成功することがあります。
APIキー認証でもこのプロンプトは出ますか
出ません。支出上限のプロンプトと/usage-creditsコマンドは、claude.aiのサブスクリプションで/loginしている場合に限られます。APIキー認証を使っている場合は、Consoleのワークスペース単位の支出上限を確認してください。
組織の管理者ですが、メンバーの支出上限をこのプロンプトから設定できますか
できません。このプロンプトは個人のPro / Maxプランの支出上限を対象にしています。組織のメンバーごとの支出上限は、Admin settings > Usageから設定します。請求権限を持たないメンバーが上限に達した場合は、/usage-creditsで管理者へのリクエスト送信を選べます。
「Credit balance is too low」とは違いますか
違います。「Credit balance is too low」は、ConsoleのワークスペースやAPIキー利用で支払い残高そのものが尽きたときのエラーで、Consoleの請求設定でクレジットを追加して解決します。「Could not update your spend limit」は、Pro / Maxプランで支出上限の変更操作自体が拒否されたときのエラーで、残高の枯渇とは別の話です。Pro / Max契約なのに「Credit balance is too low」が出た場合は、/statusでAPI key欄を確認してください。承認済みのANTHROPIC_API_KEYが環境変数に残っていると、サブスクリプションではなくそのキー経由でリクエストが送られ、無関係な残高不足として扱われることがあります。
自社のClaude apps gatewayを使っていますが関係ありますか
このエラーとは別の仕組みです。自社ホストのゲートウェイ経由で支出上限に達するとspend limit reachedまたはspend limit unavailableという429エラーになり、上限はゲートウェイの運用者がAdmin APIで設定します。「Could not update your spend limit」はPro / Maxの個人契約者がCLIから直接上限を変更しようとしたときの失敗で、ゲートウェイの設定とは無関係です。
まとめ
「Could not update your spend limit」は、Pro / Maxプランで使用量クレジットの月間支出上限をCLIのプロンプトから変更しようとして、サーバーに拒否されたときの表示です。理由が付いていれば値を見直して再試行し、理由がない汎用形なら再試行を試したうえで、改善しなければclaude.aiのSettings > Usageからブラウザで操作します。同じ「spend limit」という言葉でも、組織のAdmin settings側の上限や自社ゲートウェイの支出上限とは仕組みが別なので、自分がどの立場でこのエラーに遭遇したかを最初に切り分けてください。