「Credit balance is too low」の意味と対処API利用の残高不足

更新 2026.10.09
公開 2026.10.09
出典 4件
約9分で読めます

Claude Codeの「Credit balance is too low」は何の残高が足りないのか。Console の前払いクレジット不足と、APIキーの取り違えの2つの原因と対処を、公式の記載に沿って整理します。

公的機関・公式資料などの一次情報と照合して作成しています。このサイトについて

Credit balance is too low とは

このエラーに関係する Claude Code の支払い方は、大きく 2 つあります。ひとつは、Pro、Max、Team、Enterprise といった claude.ai のサブスクリプションに含まれる使い方です。もうひとつは、Claude Console の API アカウントで、使った分を前払いのクレジットから差し引く使い方です。

公式のエラー一覧は、このメッセージの意味を次のように説明しています。Console の組織が前払いクレジットを使い切った。または、サブスクリプションで使うつもりだったのに、Claude Code が Console の API キーでリクエストを送っている。

Credit balance is too low

名前が似ている「利用上限」のメッセージ（You've hit your session limit など）とは別物です。後者は、サブスクリプションに含まれる、一定の時間枠で回復する利用枠（セッションや週の上限）を使い切ったときのメッセージで、リセット時刻まで待つか、追加の利用分（usage credits）を使います。こちらは利用上限に達した時の対処で扱っています。この記事は、API の残高の話です。

基本（原因は2つ。公式の対処）

公式のエラー一覧（Credit balance is too low）の内容を、表にします。

← 横にスクロールできます →

原因	確認方法	対処
Console の前払いクレジットが尽きた	Console の API で使っている	Console の請求ページでクレジットを追加する。自動チャージ（auto-reload）を有効にすることも検討する
サブスクなのに API キーが使われている	Pro、Max、Team、Enterprise なのにこの表示が出る	/status で API key の行を確認し、環境変数 ANTHROPIC_API_KEY を外して claude を起動し直す

公式が挙げている追加の対策は、次のとおりです。

クレジットは platform.claude.com/settings/billing で追加する。残高がゼロになる前に補充されるよう、auto-reload を有効にすることも検討する、とされています。
Console で、ワークスペースごとの支出上限（spend cap）を設定する。1 つのプロジェクトが組織の残高を使い切るのを防げます。
サブスクリプションで使うなら、まだ /login をしていなければ実行する。

仕組みとして重要な点が、認証情報の優先順位です。公式の Authentication によると、環境変数 ANTHROPIC_API_KEY を設定し、Claude Code に聞かれたときにそのキーの使用を承認すると、サブスクリプションのログインよりもそのキーが優先されます。サブスクリプションに加入していても、キーの側の組織の残高が不足していれば、このエラーが出ます。

具体例（場面別）

場面1: Pro や Max なのに出た

シェルの設定ファイル（~/.zshrc や ~/.bashrc など）に、以前使った API キーが export されたままになっていることがあります。まず Claude Code 内で次を実行します。

/status

API key の行に、使われているキーが表示されていれば、それが原因の可能性があります。公式の手順は、現在のシェルで変数を解除し、シェルの設定ファイルからも削除して、claude を起動し直すことです。

unset ANTHROPIC_API_KEY
claude

Windows の PowerShell では、次のようにします。

Remove-Item Env:ANTHROPIC_API_KEY

その後、/login でサブスクリプションにサインインしていなければ、サインインします。公式によると、/status は、ログインと API キーの両方が設定されているとき、使われていないほうに印を付けます。

場面2: API 利用で残高が尽きた

Console の API キーで Claude Code を使っている場合は、請求ページでクレジットを追加します。金額の目安や、どのくらいで尽きるかは、公式には一律の数字がありません。公式のコスト管理のページには、企業での平均が「1 人あたり 1 稼働日で約 13 ドル、月 150 から 250 ドル」と書かれていますが、これは企業全体の平均であり、あなたの使い方に当てはまる数字ではありません（2026年10月に確認）。

場面3: 残高の使われ方を見たい

公式のコスト管理のページによると、Console の API 利用では、Console の usage ページで使用量を確認できます。ワークスペースごとの支出上限も設定できます。Claude Code に初めて Console アカウントで認証すると、「Claude Code」という名前のワークスペースが自動で作られる、とも書かれています。

Credit balance is too low の実践ステップ

自分の支払い方を確認する。サブスクリプション（Pro、Max、Team、Enterprise）か、Console の API かを決めます。
Claude Code 内で /status を実行し、API key の行があるか見る。
サブスクリプションなのに API key の行があるなら、ANTHROPIC_API_KEY を解除する。現在のシェルで解除し、~/.zshrc、~/.bashrc、~/.profile（Windows では PowerShell のプロファイルとユーザー環境変数）にある設定も消して、claude を起動し直します。
/login で、サブスクリプションのアカウントにサインインする。
本当に API を使うなら、platform.claude.com/settings/billing でクレジットを追加する。auto-reload も検討する。
組織の API を使っている場合は、請求を管理している担当者や管理者に連絡する。
再発防止に、ワークスペースの支出上限を設定する。公式の案内は、Console での設定です。
使いすぎが原因なら、節約の方法を見直す。

Credit balance is too low の注意点

請求や契約に関わる判断は、公式サポートや社内の担当部門に相談してください。
残高の追加や自動チャージの金額・条件の詳細は、公式のコスト管理のページには書かれていません。Console の画面で確認してください。
Amazon Bedrock、Google Cloud、Microsoft Foundry で使っている場合の支出管理は、各クラウドの請求コンソールにあります。公式は、Claude Code がクラウド側の指標を Anthropic に送らないとしています。
/usage-credits コマンドは、claude.ai のサブスクリプションでサインインしているときの追加利用分のための機能です。公式によると、API キー認証では使えません。API の残高とは別の仕組みです。
非対話モード（-p）では、ANTHROPIC_API_KEY がある場合、常にそのキーが使われます。自動化では特に注意してください。

Credit balance is too low でよくあるミス

サブスクリプションの上限だと思って、サブスクの料金ページを見に行く。このメッセージは Console の残高です。
古い API キーが .zshrc などに残っているのに気づかない。以前の職場や別のプロジェクトのキーが原因になることがあります。
現在のシェルだけ解除して、設定ファイルを直さない。次に開いたシェルでまた設定されます。
/login を行えば API キーが置き換わると思い込む。承認済みの ANTHROPIC_API_KEY は、/login のログインより優先されます。
クレジットを足すだけで、支出上限や auto-reload を検討しない。

Credit balance is too low のチェックリスト

サブスクリプションか、Console の API か、自分の支払い方を確認した。
/status で API key の行を確認した。
意図しない ANTHROPIC_API_KEY を、現在のシェルと設定ファイルの両方から外した。
サブスクリプションで /login を済ませた。
API 利用なら、Console の請求ページでクレジットを追加した。
auto-reload とワークスペースの支出上限を検討した。
組織の API なら、管理者に連絡した。

Credit balance is too low のFAQ（よくある質問）

Q. サブスクリプションなのにこのエラーが出るのはなぜですか。
A. 公式は、承認済みの ANTHROPIC_API_KEY がサブスクリプションより優先されるためと説明しています。キーの組織の残高が足りないと、このメッセージになります。

Q. 追加料金を払えば、サブスクリプションで続けられますか。
A. このメッセージは Console の残高の話です。サブスクリプションの上限に達した場合の追加利用分は別の機能です。詳しくは上限を超えて使う方法を見てください。

Q. いくらチャージすればよいですか。
A. 公式には、推奨の金額は記載が確認できませんでした。使い方で大きく変わります。コストの考え方はサブスクとAPI従量課金の違いにあります。

Q. 残高が尽きるのを防ぐ方法はありますか。
A. 公式は、Console の auto-reload を有効にすること、ワークスペースごとの支出上限を設定することを案内しています。

筆者の見解（Credit balance is too low）

私見では、このエラーで最初にやるべきことは、クレジットを買い足すことではなく、「今どの認証情報で動いているか」を /status で確かめることだと考えます。メッセージが残高の話に見えるため、サブスクリプションの人ほど慌てて Console の請求ページを開きがちですが、本文で見たとおり、承認済みの ANTHROPIC_API_KEY が残っているだけなら、チャージは問題の解決にならず、意図しない組織に支払いを増やすだけになりかねません。順番としては、/status で使われている認証情報を確認し、次にシェルの設定ファイルや環境変数を見直し、それでも API 利用だと確認できてから残高を足す、という流れが安全だと考えます。特に避けたいのは、出どころの分からない API キーを使い続けることです。前の職場や別プロジェクトのキーであれば、請求先も管理者も自分ではない可能性があり、筆者の考えでは、その場合は自分でチャージせず、キーの持ち主や社内の担当者に確認するのが筋です。また、-p を使う自動化ではキーが常に優先されるため、手元の対話セッションで直ったように見えても、スクリプト側では同じエラーが続くことがあります。直したあとは、対話と自動化の両方で確かめておくとよいと考えます。

Credit balance is too low の関連項目

出典（一次情報）

本記事は一般的な情報の提供を目的としています。Claude Code の料金・利用上限・機能・エラーメッセージ・コマンドは頻繁に更新されるため、最新の内容は Anthropic の公式ドキュメントとお使いのバージョンで必ずご確認ください。契約・請求・セキュリティに関する判断は、公式サポートや社内の担当部門にご相談ください。「筆者の見解」は一つの考え方です。