「Could not update spend limit」の対処 — Claude Codeの支出上限エラー

Could not update your spend limit: <reason from the server> — Pro / Maxプランで支出上限を上げようとしたとき、サーバー側がその変更を拒否するとこう出ます。表示にはコロン以降に理由が付く形と、理由が付かない汎用形の2種類があり、どちらが出ているかで取るべき対処が変わります。

このエラーが出るまでの流れ

エラーが出るのは、上限に達したあとにClaude Codeが出す確認プロンプトの中です。Pro / Maxプランで使用量クレジットが有効なとき、CLIは支出上限に達すると、CLIを離れずに上限を引き上げるか外すかを尋ねてきます。

上限に達したときのメッセージは、上限の持ち主によって文面が変わります。individual spend limitは管理者に引き上げを頼む形です。org's monthly spend limitはclaude.ai/admin-settings/usageで引き上げます。channel's monthly spend limitはSlackチャンネル単位の予算に当たった形です。グループに割り当てられた共有予算はteam's shared budgetと出ます。従量課金の組織ではspend limitの代わりにusage limitと表示され、You've hit your individual usage limitのようになります。

プランの利用枠が尽きた場合は、· your session limit resets 3:45pmのようにリセット時刻が付きます。v2.1.239以降は、この時刻が表示されます。時刻になれば、誰も上限を上げなくてもアクセスが戻ります。

組織側の上限に当たっているなら、CLIでの再入力は的外れです。上限を変えられる人に、メッセージが指す画面で変更してもらいます。

表示で分かれる対処

ブラウザ側で変更する手順

CLIでの変更が通らないときは、claude.aiの設定画面から同じ操作ができます。Pro / Maxの個人契約なら、Settings > Usageの「Usage credits」欄で、使用量クレジットのオン・オフ、残高、今月の支出、月間の支出上限を確認・変更できます。Claude Codeの中からは/usage-creditsでこの画面を開けます。

/usage-credits

/usage-creditsはclaude.aiのサブスクリプションで/login済みのときだけ使え、APIキー認証では使えません。ブラウザを開けないSSH先のような環境では、開く代わりにURLが表示されます。

開く画面は役割で変わります。

請求権限を持たないメンバーの場合、確認ステップが出るのは対話セッションだけです。非対話モード(-pフラグ)やRemote Control経由では、リクエストは送信されず、対話セッションで実行するよう案内されます。

管理者へのリクエストは重複送信されません。送信済みで管理者の確認待ちのうちに/usage-creditsを再実行すると、Claude Codeは「すでに送信済み」と伝えます。

上限を引き上げるか、外すか

プロンプトは、上限を引き上げるか、上限そのものを外すかを選ばせる形です。引き上げは新しい金額を入力するだけで済みます。

上限を設定していないとき、/usageの使用量クレジット行はUnlimitedの表示になり、支出額の数字は出ません。上限を設定している間は、その月の支出が上限に対する割合で表示されます。

Team / Enterpriseの/usageでは、自分の今月の支出が、自分に適用される上限に対する割合で表示されます。組織全体にかかる上限はこの行に出ません。使用量クレジットがオフの間は、行そのものが出ません。

月ごとの支出と残高、現在の上限額はSettings > Usageでいつでも確認できます。変更がエラーで通らないときは、今の上限額を先に確かめると、次に試す値を決めやすくなります。

「spend limit」が指す別の上限

「Could not update your spend limit」を見て、組織のAPI利用に対する管理上限を思い浮かべる人もいますが、それは別物です。Claude Codeまわりで「spend limit」と呼ばれるものは、設定場所も表示も異なる4つの仕組みに分かれます。

ゲートウェイの上限は日・週・月の単位で設定できます。上限を超えると429が返ります。spend limit unavailableは、ゲートウェイが支出記録を読めずに予防的に止めた状態で、あなたの上限超過ではありません。多くの場合は自然に解消し、続くときはゲートウェイの運用者に伝えます。ゲートウェイ経由の開発者は、/usageの「Spend limit」バーで自分の上限に対する使用率とリセット時刻を見られます。このバーはClaude Code v2.1.251以降で、ゲートウェイ側はv2.1.225以降が前提です。

Console経由でAPIキー認証を使っている組織では、初めてConsoleアカウントで認証した時点で、組織専用の「Claude Code」ワークスペースが自動で作られます。このワークスペースはClaude Code専用で、他のAPIキーの発行には使えません。

この記事が扱うのは、最初の個人のPro / Maxで、使用量クレジットの月間支出上限を変更しようとして失敗する場面です。

利用枠そのものの仕組みや、使用量クレジットを使うかどうかの判断はClaude Maxプランとはにまとめています。

429やレート制限との違い

支出上限の変更失敗は、レート制限や使用量上限の失敗とは性質が異なります。後者は「今は送れない」という一時的な状態ですが、こちらは「設定変更そのものが通らない」状態です。理由付きの拒否は、同じ値での再試行では通りません。

支出上限に達した状態そのもの、つまりリクエストが止まる状態への対処や、使用量クレジットの基本はClaude rate limitエラーの対処で扱っています。上限に当たってから変更を試みるまでの流れ全体が、合わせて読むとつながります。

エラーメッセージ全般の見取り図が欲しい場合はClaude Codeでよくあるエラー10選から探す方法もあります。

支出上限まわりで変わったバージョン

このエラーの周辺は、バージョンごとに挙動が変わってきました。古いClaude Codeで症状が合わないときは、次の節目に当たっていないかを見てください。

よくある質問

「Credit balance is too low」とは違いますか

違います。「Credit balance is too low」は、Consoleの組織で前払いクレジットが尽きたとき、またはサブスクリプションのつもりがConsoleのAPIキーで送信されているときに出ます。「Could not update your spend limit」は、支出上限の変更操作そのものが拒否されたときのエラーで、残高切れとは別です。

Pro / Max契約なのに前者が出た場合は、/statusでAPI key欄を確認してください。承認済みのANTHROPIC_API_KEYが環境変数に残っていると、サブスクリプションではなくそのキー経由でリクエストが送られます。シェルでキーを外してからclaudeを起動し直し、まだなら/loginでサブスクリプションにサインインします。

「Unknown command: /usage-credits」と出ます

Claude Codeのバージョンが古い可能性があります。セルフサーブのEnterprise組織、Enterpriseトライアル、AWS Marketplace経由で請求されるEnterprise組織では、/usage-creditsはv2.1.248以降が必要です。それ以前のバージョンでは、このコマンドが拒否されます。

まとめ

エラーに理由が付いていれば値を見直し、汎用形ならまずEnterでの再試行です。通らないときはSettings > Usageで変更します。上限に達したメッセージがorg's monthly spend limitのように組織側を指しているなら、CLIでの再入力ではなく、メッセージが指す管理画面で上限を変えてもらう必要があります。