Claude Code のエラー

Credit balance is too low

結論

Consoleの前払いクレジット切れ。サブスク契約中でも API キー混入で起きる。

確認した版 Claude Code v2.1.214
確認日 2026年8月21日
文言の照合 Claude Code v2.1.238
最終更新 2026年8月21日
根拠 一次情報で確認

エラー文字列

Claude Code
Credit balance is too low

何が起きているか

Console 組織の前払いクレジットが尽きています。

⚠️ ここで最も多いのが「Pro や Max を契約しているのに、なぜクレジットの話が出るのか」という混乱です。

原因は次の2つのどちらかで、2番目が圧倒的に多くあります。

# 原因 状況
1 本当にクレジットが尽きた Console の API キーを意図して使っている
2 意図せず API キーで接続している サブスクリプションで使うつもりが、環境変数の ANTHROPIC_API_KEY が優先されている

ANTHROPIC_API_KEY/login で保存した資格情報より優先されます。 そのため、昔試したときに設定した API キーがシェルの設定ファイルに残っていると、サブスクリプションを契約していても API キー側(=クレジット払い)で課金されようとし、残高が無ければこのエラーになります。

直し方

1. まず「何で接続しているか」を確認する

/status

Authentication のパネルに、いま使われている資格情報の出どころが表示されます。API キーになっていたら、それが原因です。

2. 意図しない API キーを探して外す(原因 2)

macOS / Linux

env | grep ANTHROPIC

Windows(PowerShell)

Get-ChildItem Env: | Where-Object Name -match 'ANTHROPIC'

見つかったら、まず今のセッションで外して確認します。

unset ANTHROPIC_API_KEY
claude
Remove-Item Env:ANTHROPIC_API_KEY
claude

これで直るなら、恒久的に消す必要があります。 次の場所を全部確認してください。

OS 確認する場所
macOS / Linux ~/.zshrc / ~/.bashrc / ~/.bash_profile / ~/.profile / プロジェクトの .env
Windows ユーザー環境変数、PowerShell プロファイル($PROFILE)、システム環境変数
共通 ~/.claude/settings.json.claude/settings.jsonenv セクション

Windows で恒久的に消す

[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", $null, "User")

PowerShell プロファイルを確認する

if (Test-Path $PROFILE) { Select-String -Path $PROFILE -Pattern 'ANTHROPIC' }

settings.json を確認する

grep -n "ANTHROPIC" ~/.claude/settings.json .claude/settings.json 2>/dev/null

外したあと、保存済みのログインが無ければ認証し直します。

/login

3. 本当にクレジットを使う場合(原因 1)

Console の請求設定からクレジットを追加します。

  • 自動リロードを有効にする。 作業中に突然止まるのを防げます
  • ワークスペース単位の上限(spend cap)を設定する。 想定外の消費を止められます

⚠️ チームで1つの組織を共有している場合、誰か1人の大量実行で全員が止まります。 ワークスペースを分けて上限をかけておくと、影響範囲を閉じられます。

4. 似たエラーとの区別

表示 原因 対処
Credit balance is too low Console の前払いクレジット切れ 入金するか、API キーを外す
spend limit reached ゲートウェイ運営者が設定した上限 運営者に相談
You've hit your session limit プランの利用量切れ リセットまで待つ
Usage credits required for 1M context 1Mコンテキスト版を選んでいる 通常版に切り替える
Request rejected (429) レート制限 同時実行を減らす

どれも「使えない」という結果は同じですが、原因も対処も違います。 メッセージを正確に読んでください。

再発防止

  • 試用で発行した API キーを、環境変数に置きっぱなしにしない。 これがこのエラーの最大の発生源です
  • サブスクリプションで運用するなら、ANTHROPIC_API_KEY は「設定しない」がチームの標準であることを明文化しておく
  • プロジェクトごとにキーを切り替える必要があるなら、シェルの設定ファイルに直接書かず、direnv などでディレクトリ単位に閉じる
  • Console を使う運用なら、自動リロードとワークスペースの上限を最初に設定しておく。止まってから気づくと作業が中断します
  • 困ったらまず /status「何で繋がっているか」を確認する習慣があるだけで、この系統のエラーはほぼ即座に切り分けられます

この手順で直りませんでしたか?

環境を添えて報告いただければ、追加の原因を検証してこのページに反映します。

エラーを報告する