Claude APIの「credit balance is too low」/ 402 insufficient_quota

このエラーはコードとは関係ありません。キーに紐付いた前払い残高が空（または月間支出上限に達した）だけです。Anthropic Consoleとゲートウェイで請求モデルがどう異なるか、そして午前2時の再発を防ぐアラームを説明します。

エラー

レスポンス（HTTP 400 / 402）

// Anthropic Console (HTTP 400):
{"type":"error","error":{"type":"invalid_request_error",
 "message":"Your credit balance is too low to access the Anthropic API..."}}

// OpenAI-compatible gateways, e.g. Kunavo (HTTP 402):
{"error":{"message":"Wallet balance is too low for this request. Top up at https://kunavo.com/app/billing",
 "type":"insufficient_quota","code":"insufficient_quota","param":null}}

原因と対処法の概要

原因	対処法
前払い残高が実際にゼロ	入金してください。AnthropicではConsole → Plans & billing。Kunavoでは/app/billing（残高に有効期限はありません）。
自動リロードがオフ（またはカードの有効期限切れ）	自動リロードを有効にするかカードを更新し、急増した利用量で気付かないうちに残高がゼロにならないようにします。
月間支出上限に到達	支出が正当なものであれば、キーまたはワークスペースごとの上限を引き上げるか解除します。
別のワークスペースのキー	キーは発行元のワークスペースの残高を使用します。残高のある組織が、別のワークスペースのキーに資金を提供することはありません。

認証ではなく残高の問題であることを確認

401 = キーの問題、400「credit balance too low」/ 402 insufficient_quota = 金銭的な問題です。請求エラーでキーをローテーションしないでください。新しいキーも同じ空のウォレットを参照します。

入金後、安価な呼び出しを1回実行して確認

AnthropicとKunavoのどちらでも、残高は直ちに反映されます。再デプロイは不要です。ワーカーの一時停止を解除する前に、最小限のリクエストで確認してください。

verify.sh

curl -s https://api.kunavo.com/v1/chat/completions \
  -H "Authorization: Bearer $KUNAVO_API_KEY" \
  -H "content-type: application/json" \
  -d '{"model":"claude-haiku-4-5","max_tokens":8,"messages":[{"role":"user","content":"ok?"}]}'

Claude Codeで表示されていますか？

Claude Codeは、Consoleの残高が空のAnthropic APIキーで実行された場合にこのメッセージを表示します。ProまたはMaxのログインでは、代わりに利用制限に達し、このメッセージは表示されません。Consoleにチャージするか、従量課金エンドポイントで作業を続けてください。Claude CodeはANTHROPIC_BASE_URLをネイティブに読み取るため、切り替えは環境変数を数個設定するだけです。4つのモデル行はそのままにしてください。Claude CodeのデフォルトモデルとopusおよびsonnetエイリアスはAnthropicの最新モデルに追従し、sonnetエイリアスはSonnet 5.5を要求しますが、Kunavoでは提供していません。

~/.zshrc

export ANTHROPIC_BASE_URL=https://api.kunavo.com
export ANTHROPIC_AUTH_TOKEN=sk-kn-...
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

次回を退屈なものにする

残高低下アラート（メール）を設定し、プロバイダーが対応していれば、妥当な月間上限を設定した自動リロードも有効にしてください。残高ゼロで停止する仕様は正しいものです。必要なのは、壁に到達する前の警告です。

Kunavo では：402 を読む、または自動でチャージさせる

Kunavo のウォレットが返す 402 は、理由を機械可読な形で示します。error.code は insufficient_balance で、error.balance_usd と error.needed_usd が不足額を示し、error.topup_url と error.auto_recharge_url は対処があらかじめ選択された請求ページを開きます。どちらのリンクも課金は行いません。オプションの自動チャージを有効にすると、残高（処理中のリクエストやタスクの確保額を差し引く前の額）が設定したしきい値を下回り、チャージの制限（設定した月間上限など）にもかからない場合に、選んだ金額（$10 以上）が保存済みのカードからウォレットにチャージされます。ウォレットでリクエストをまかなえないときは、Kunavo がこのチャージを行い、応答する前にそのリクエストをもう一度試します。チャージが行われないか、チャージしても足りない場合、リクエストは拒否されたままなので、自動チャージが有効でも 402 が返ることがあります。チャージの処理中は 402 に Retry-After が付きます。その時間を待って再試行し、Retry-After の付かない 402 では再試行をやめてください。

Kunavo経由で呼び出している場合

Kunavoは残高がゼロになると、曖昧な500ではなく明示的な402 insufficient_quotaで処理を停止します。失敗したリクエストには課金されません。アクティブなアカウントには、残高が尽きる前に、各アカウント固有の消費ペースに基づく残りの利用可能期間を記載した残高低下通知メールを送ります。残高は$10からチャージできる前払いウォレットで、有効期限はありません。/app/billingでカード、インド国外ではApple Pay、Google Pay、Link、またはPix、WeChat Pay、UPI、KakaoPayなどStripeが通貨に応じて表示する現地決済手段でチャージできます。入金額がどれだけ持つかは、指定するモデルに完全に依存します。モデルごとの料金は Anthropic Claude API料金表。

よくある質問

入金したのに、なぜまだエラーが表示されるのですか？

キーを発行したのと同じアカウントまたはワークスペースに入金したこと、そして月間支出上限が本当のブロッカーではないことを確認してください。残高の反映自体は、AnthropicとKunavoのどちらでも直ちに行われます。

Claude APIには無料枠がありますか？

ありません。Anthropicは最初のトークンからすべてのAPI呼び出しに課金します（Claude.aiの個人向けプランはAPIクレジットとは別です）。ゲートウェイも従量課金制で、Kunavoは$10の入金から始まり、料金は定価を下回ります。

Claude Codeで「Credit balance is too low」と表示されますが、Proには支払っています。なぜですか？

Claude CodeがサブスクリプションではなくAPIキーを使用しているためです。ANTHROPIC_API_KEYまたはANTHROPIC_AUTH_TOKENが設定されている間、Claude Codeはそのキーに課金し、ProまたはMaxのログインを保留します。そのキーは別の前払いConsole残高を使用します。/statusを実行して現在有効な認証情報を確認してください。プランに戻るには変数の設定を解除するか、キーの残高に入金します。

OpenClawに「API provider returned a billing error」と表示されます。これは同じ問題ですか？

はい。これはモデルプロバイダーからの請求拒否を表すOpenClawの文言です。APIキーのクレジットがなくなったか、残高が不足しています。そのプロバイダーに入金するか、OpenClawを別のプロバイダーに切り替えてください。関連ガイドでは選択肢を比較しています。