Credit balance is too low
weekly limit ではない。Console の前払い残高がゼロ
Claude Code のエラー表(2026-08-30 確認)は Credit balance is too low を Usage limits に置く。Anthropic Console 組織の prepaid usage credits が尽きた、という意味。リトライでは戻らない。platform.claude.com/settings/billing でチャージするか、サブスク認証 / 別の前払い経路に切り替える。
単独で引用できる 4 点
検索される原文そのもの
Claude Code のエラー表は Usage limits にこの英文を載せている。5 時間枠や weekly limit の文書より先に、この文字列を見る。
Console 組織の残高
Anthropic ヘルプ:Claude API / Workbench / API 課金の Claude Code は prepaid usage credits を消費する。0 になると API を呼べない。失敗リクエストは課金されない。
429 でも weekly でもない
retry-after 付きのレート 429 ではない。サブスクの 5 時間枠でも weekly limit でもない。SDK の自動リトライは同じ残高チェックを繰り返すだけ。
公式の次の手
エラー表:platform.claude.com/settings/billing で credits を買い、auto-reload を検討。Pro / Max / Team / Enterprise なら Claude Code をサブスク認証に戻せる。
この一文が指している台帳
Credit balance is too low は Anthropic Console 組織の prepaid usage credits であり、claude.ai の 5 時間枠でも weekly limit でも、月次上限 enforced_spend_limit_reached でもない。ヘルプセンターは「先に credits を買い、0 なら API も Workbench も止まる」と書いている。API 課金の Claude Code はこの台帳を使う。
Pro / Max でも出る理由
「Pro を払っているのにこの文が出る」はよくある読み違い。Claude Code はサブスクログインか API key を選べる。ANTHROPIC_API_KEY が残っていると Console の credits を引き、プラン枠は見ない。ヘルプセンターも HN も、この二つを別システムとして書いている。プラン枯渇の文面は別。
タイムライン
How do I pay for my Claude API usage:API / Workbench / API 課金 Claude Code は prepaid usage credits。Billing で購入し、閾値以下で auto-reload できる。
Credit balance is too low:Console 組織の前払いが尽きた。チャージ、auto-reload、(プランがあるなら)サブスク認証へ。workspace の spend limit で一プロジェクトが組織残高を吸い尽くすのを止められる。
チャージ後もクライアントがゼロをキャッシュする例、orphan key でも同じ原文になる例がある。公式表がカバーするのは残高 0。Billing に残高があり新規セッションでも失敗するなら、再ログインはコミュニティ側の追加手順。
確認済み vs 混同
確認済み
原文 Credit balance is too low は公開エラー表にあり、Console の prepaid usage credits 枯渇を指す。次の手は Billing チャージ / auto-reload、またはサブスク認証。失敗リクエストは無料。weekly limit・5 時間枠・月次 429 とは別規則。
よくある混同
「モデルを変えれば直る」——請求単位は組織。「数分待てば戻る」——retry-after はなく、credits は自然回復しない。「Pro なら出ない」——API key なら credits を見る。
チャージか、認証の切り替えか
Console API を続ける:credits を買う
platform.claude.com/settings/billing で購入し、必要なら auto-reload。チャージ後も原文が出るなら新規セッションを開き、キャッシュされた残高を更新する。
もともとプランがある:サブスク認証へ
Pro / Max / Team / Enterprise は Claude Code をサブスクログインに戻し、プラン枠を使う。制限の文面は別なので、この原文で weekly limit を説明しない。
3 ステップ(公式の仕組み。プラットフォームを変えなくても使える)
第一に原文が Credit balance is too low か。You've hit your weekly limit や enforced_spend_limit_reached と混ぜない。第二に Claude Code が API key かサブスクか。第三に API を続けるなら Billing、プランを続けるなら /login。本ページは Anthropic 認証の迂回、アカウント共有、請求状態の偽装を説明しない。
この台帳は QCode の前払いではない
Credit balance is too low が指すのは Anthropic Console の usage credits。QCode は公式価格 × サービス料で自前の前払い残高から引く、別経路。QCode に残高エラーが絶対出ないとは書かない。Console が空でジョブを止められないなら、すでに開通している別の API キーで販売中モデルを叩ける。暗号通貨入金が必要なら USDT の説明がある。
FAQ
Credit balance is too low と weekly limit の違いは?
weekly limit はサブスクのローリング週枠。Credit balance is too low は Console 前払いが 0。前者は claude.ai / サブスク Claude Code、後者は API key。一方は窓待ち、他方はチャージ。
Pro / Max なのにこの文が出るのは?
環境変数や設定の API key を使っていると Console credits を消費し、プラン枠は見ない。ヘルプは「プラン制限」と「API credits」を分けている。/login でサブスクに戻すと、文面はプラン制限側に変わることが多い。
チャージしたのに Credit balance is too low のまま。
エラー表もコミュニティも、Claude Code が残高をキャッシュすると書いている。新規セッションを開く。Billing に残高があり、それでも失敗するなら古いキー、別 workspace、認証は通るが課金できない key を疑う。
リトライ、モデル変更、max_tokens 縮小は効く?
効かない。トークン課金の前に拒否される。別の Claude モデルでも同じ組織残高。回復はチャージ、認証切替、またはこの Console 組織以外の課金経路。
enforced_spend_limit_reached と同じ?
違う。月次上限はティアのドル天井で HTTP 429、retry-after なし、error_code が enforced_spend_limit_reached。Credit balance is too low は前払い 0。一方は翌月 1 日かティア上げ、他方は credits 購入。
QCode で Console に credits を足せる?
足せない。QCode は販売済みモデル向けの別前払い API で、公式価格 × サービス料。Console が空で止められないときに使う。Anthropic の Billing ページには入金されない。
情報源
原文と対処は Claude Code 公開エラー表 Usage limits「Credit balance is too low」(2026-08-30 取得)。prepaid usage credits、auto-reload、失敗無料はヘルプセンター How do I pay for my Claude API usage(同日)。プランと API credits の分離は Use Claude Code with your Pro or Max plan。orphan key の issue は公式メカニズムとしては扱わない。
関連
Claude usage limit reached
サブスクの 5 時間枠と週枠。本ページの Console 前払いとは別規則。
enforced_spend_limit_reached
ティア月次ドル上限の 429。retry-after なし。credits = 0 でもない。
USDT で Claude Code credits
暗号資産で前払い API に入金する話であり、Console への入金ではない。
Anthropic の公開エラー表とヘルプセンターの技術的整理であり、Anthropic の見解ではない。残高・auto-reload・認証は Claude Console と Claude Code の表示が正。QCode は Anthropic の認証・不正対策・課金制御を迂回しない。