Claude Codeで「Credit balance is too low」が出たら、追加購入の前に /status で現在の認証方法を確認します。
サブスクリプションを使うつもりなのにAPIキーが使われている場合と、意図して使っているConsole組織の残高が不足している場合で、対処が変わります。
Credit balance is too lowメッセージはクレジット残高の不足を示していますが、原因は大きく2つに分かれます。
サブスクリプションを使うつもりでConsole側に接続していた場合は、購入を急がず認証設定を直します。
Consoleのクレジット残高とサブスクリプションの利用枠は別に確認してください。
APIキーの設定が混ざっていないか確認する
Pro・Max・Team・Enterpriseのプランを契約しているにもかかわらずこのエラーが出る場合は、サブスクリプションではなくAnthropic ConsoleのAPIキー経由でリクエストが送信されている可能性があります。
現在の設定状況は次のコマンドで確認できます。
/status表示された情報のうち、APIキーの項目と、現在使われている認証方法を確認します。
ログインとAPIキーが併存する場合、/status は使われていない認証情報も区別して表示します。
キーの値そのものを公開したり、相談用の画像へ載せたりする必要はありません。
通常のローカル対話モードでは、環境変数 ANTHROPIC_API_KEY の使用を承認すると、サブスクリプションよりそのキーが優先されます。
変数が存在するだけで使用中とは断定せず、/status を確認します。
環境変数のキーを使うかどうかは、キーが設定されているローカル対話セッションの/configにある「Use custom API key」でも変更できます。
非対話モード（-p）では、この対話的な承認確認がありません。
クラウドセッションや組織のゲートウェイ・管理設定では認証の扱いが異なるため、同じ説明をそのまま適用しないでください。
対処手順
- サブスクリプションで使いたい場合だけ、Claude Codeを起動するシェルの ANTHROPIC_API_KEY を解除する
- 次回起動時にも不要なキーが設定される場合は、その設定元を確認する。.bashrc はBash、.zshrc はZshの例で、Windowsなどでは設定元が異なる。他のAPI処理や組織で必要な設定を一律に削除しない
- claude を起動し直す
- サブスクリプションでサインインしていない場合は /login を実行し、claude.ai側のアカウントを選ぶ。再起動後に /status で意図した認証へ戻ったことを確認する
APIキーの優先は、公式資料に挙がっている原因の1つです。
契約しているだけで原因を決めつけず、実際の認証方法とエラー文を照合してください。
APIキーを解除してもConsole側につながる場合は、/statusのProfileやapiKeyHelperなど、実際に選択されている認証元も確認します。
ConsoleにはAPIキーを作成せずにログインする方式もあるため、キーがないことだけではサブスクリプション利用を確認できません。
ConsoleのAPIクレジット残高が不足している場合
Console経由での利用が意図どおりで、その組織の前払いクレジットが不足している場合は、管理者または請求担当者が残高と購入額を確認して補充します。
Max・Teamの月次API特典クレジットはClaude Codeには使えないため、購入済みクレジットと区別してください。
サブスクリプションで使う予定なら、先に認証の切り替えを確認してください。
自動リロードの設定時点で残高が条件以下なら、設定の確定と同時に購入が発生するため、表示される金額を確認してください。
- ConsoleのBillingで、対象組織の残高と購入額を確認してからクレジットを追加する
- 自動リロードは任意の追加購入設定なので、購入を始める残高と補充後の目標残高を確認する
- Console側でワークスペースごとの上限を設定すると、1つのプロジェクトが組織全体の残高を使い切るのを防げる
支出上限（Spend limit）に関するエラーメッセージ
支出上限に達した際に表示されるプロンプトから上限変更を試みると、次の応答が返ることがあります。
Could not update your spend limit: <サーバーからの理由>エラー理由が併記されている場合は、同じ設定値のまま再試行しても成功しません。
メッセージ内に表示されたエラー理由を確認し、該当する原因を解消してください。
エラー理由が併記されず次の文面のみが表示された場合は、ネットワーク切断など一時的な通信失敗の可能性があります。
v2.1.216より前は理由のある失敗でも定型文だけになるため、古い版では通信問題と決めつけず、バージョンと請求設定を確認します。
この場合は、時間を置いて再試行すると解決することがあります。
上限変更が繰り返し失敗する場合は、ブラウザでclaude.aiの請求設定を開き、必要な上限を確認して変更してください。
Could not update your spend limit. Press Enter to retry.その他のエラーメッセージはClaudeのエラーメッセージ一覧、各種制限の仕組みについてはClaudeの利用制限まとめでそれぞれ解説しています。
2026年10月27日に公式エラーリファレンス、認証方式と優先順位、Consoleの支払い方法を照合し、認証と課金の説明を更新しました。
今回は残高不足の再現、認証の切り替え、クレジット購入の実機検証は行っていません。
Claude Codeのエラー対処は、ほかにも書いています。
よくある質問：クレジット残高の不足を示すエラー
クレジット残高の不足を示すエラーが出る原因は、何ですか？
主な切り分けは2つです。
サブスクリプションを使うつもりでConsoleのAPIキーを使っている場合と、意図して利用しているConsole組織の前払いクレジットが不足している場合です。
まず /status で使用中の認証方法を確認します。
Pro・Max・Team・Enterpriseを契約しているのに、このエラーが出るのは、なぜですか？
サブスクリプションを使うつもりで、ConsoleのAPIキーを使っている可能性があります。
通常のローカル対話モードでは、環境変数 ANTHROPIC_API_KEY の使用を承認するとキーが優先されます。
変数の有無だけで判断せず、/status で使用中の認証方法を確認してください。
APIキーが混ざっているか、どう確認しますか？
/status を実行し、APIキーの項目と使用中の認証方法を確認します。
キーの値は公開しないでください。
APIキー優先の設定を直すには？
サブスクリプションで使いたい場合は、Claude Codeを起動するシェルから不要な ANTHROPIC_API_KEY を外して起動し直します。
必要なら /login でclaude.aiのアカウントへサインインし、/status で確認します。
設定が復活する場合だけ設定元を確認し、他のAPI処理や組織で必要な設定を一律に削除しないでください。
ConsoleのAPIクレジット残高が足りないときは、どうしますか？
Console経由で使う予定であることを確認し、管理者または請求担当者がBillingで対象組織の残高と購入額を確認します。
自動リロードは任意の追加購入設定です。
サブスクリプションで使う予定なら、補充前に認証方法を見直します。
支出上限（Spend limit）に関するエラーが出たときは？
支出上限に達した際に表示されるプロンプトから上限変更を試みると、エラーの応答が返ることがあります。
エラー理由が併記されている場合は、同じ設定値のまま再試行しても成功しないので、メッセージ内の理由を確認し、該当する原因を解消します。
エラー理由が書かれていないときは？
エラー理由が併記されず、定型の文面のみが表示された場合は、ネットワーク切断など一時的な通信失敗の可能性があります。
この場合は、時間を置いて再試行すると解決することがあります。
上限変更が繰り返し失敗する場合は、ブラウザでclaude.aiの請求設定を開き、必要な上限を確認して変更してください。
記事の確認時点と、関連する情報は？
2026年10月27日に公式のエラーリファレンス・認証方式・Consoleの支払い方法を照合しています。
残高不足の再現やクレジット購入は今回実施していません。
使用中の版や組織設定による違いは、本文の公式資料で確認してください。
