Claude Codeの実行時に、次のエラーメッセージが表示される場合があります。
Credit balance is too lowメッセージはクレジット残高の不足を示していますが、原因は大きく2つに分かれます。
一方は課金不足ではなく、認証設定の取り違えが原因です。
APIキーの設定が混ざっていないか確認する
Pro・Max・Team・Enterpriseのプランを契約しているにもかかわらずこのエラーが出る場合は、サブスクリプションではなくAnthropic ConsoleのAPIキー経由でリクエストが送信されている可能性があります。
現在の設定状況は次のコマンドで確認できます。
/status表示された情報のうち、APIキーの項目を確認します。
環境変数「ANTHROPIC_API_KEY」が設定されていると、サブスクリプションではなくAPIキー側に課金されます。
対処手順
- いま開いているシェルで ANTHROPIC_API_KEY を解除する
- シェルの設定ファイル（.bashrc や .zshrc など）からも削除する
- claude を起動し直す
- サブスクリプションでサインインしていない場合は /login を実行する
有料プランに加入しているのに実行できないトラブルの多くは、このAPIキー優先の設定が原因です。
ConsoleのAPIクレジット残高が不足している場合
Anthropic Consoleで前払いクレジットを使い切っている場合は、残高のチャージが必要です。
- platform.claude.com/settings/billing でクレジットを追加する
- 同じ画面で自動リロードを有効にすると、残高がゼロになる前に補充される
- Console側でワークスペースごとの上限を設定すると、1つのプロジェクトが組織全体の残高を使い切るのを防げる
支出上限（Spend limit）に関するエラーメッセージ
支出上限に達した際に表示されるプロンプトから上限変更を試みると、次の応答が返ることがあります。
Could not update your spend limit: <サーバーからの理由>エラー理由が併記されている場合は、同じ設定値のまま再試行しても成功しません。
メッセージ内に表示されたエラー理由を確認し、該当する原因を解消してください。
エラー理由が併記されず次の文面のみが表示された場合は、ネットワーク切断など一時的な通信失敗の可能性があります。
この場合は、時間を置いて再試行すると解決することがあります。
Could not update your spend limit. Press Enter to retry.その他のエラーメッセージはClaudeのエラーメッセージ一覧、各種制限の仕組みについてはClaudeの利用制限まとめでそれぞれ解説しています。
本記事は2026年9月7日時点のClaude Code公式ドキュメント（エラーリファレンス）の記載に基づいて作成しています。
Claude Codeのエラー対処は、ほかにも書いています。
