Claude Codeで「Credit balance too low」が出た時の復旧方法｜再入金・自動チャージ設定まで解説

Claude Codeを使っていて、途中で急に止まりました。

CLIに実際に出た表示はこれです。

Credit balance too low · Add funds: https://platform.claude.com/settings/billing

この時、最初に思ったのは「残高が足りなくなったんだな」ということでした。

でも実際には、入金しただけではすぐ戻らず、
さらに認証の向き先まで見直す必要がありました。

今回は、その時に自分がどう考え、どう確認し、どう復旧したのかを
追加の設定画面も含めてまとめます。

最初は「お金が足りないだけ」だと思っていた

Claude Codeを使っている途中で、CLIにこんな表示が出ました。

「Credit balance too low」何をしても次にすすまない。

この表示を見た時、自分は単純に「残高が足りなくなったんだな」と思いました。

その時に実際に確認したのは
「つまり　5ドル分利用した後は利用が制限されるという認識で合っていますか？」

ということでした。

この時点ではまだ

本当に残高だけの問題なのか
入金すればすぐ戻るのか
他にも原因があるのか

そこまで整理できていませんでした。

最初の導入時に、この支払い画面が出た時も、

お試しなので　まずは利用してみる
いくら入れればいいのか
デフォルトの5＄で足りるのか

正直かなり不安でした。

Console側では残高を確認できる

後で分かったのは、Claude Console 側で残高を確認できるということです。

この画面では、現在のクレジット残高が表示されます。
自分の場合は、こうして残高が見えることで少し安心できました。

ここで読者の方に伝えたいのは、

CLIで止まった時は、まずConsole側の残高画面を見ると状況が整理しやすい

ということです。

購入は5ドルからできる

ここで分かったのは、今回もまた購入は5ドルからできるということでした。

これは初心者にとってかなり大事だと思います。

最初から大きな額を入れなくても「まずは5ドルから試せる」

というのは心理的にかなり楽です。

自分も、最初は少額から始める方針の方が合っていました。

使い倒していくようになれば　しっかり支払って利用する。

ただし、途中で止まると復旧が面倒だった

ここが今回の記事で一番大事なところです。

実際に体験して感じたのは、

途中で止まると、復旧に思った以上に時間がかかる

ということでした。

入金したのに戻らない
何が原因か分からない
認証状態まで確認する必要がある
再ログインも必要になる

こういう流れになると、かなり消耗します。

だからこそ、今振り返ると【自動チャージを設定しておく方が、実用上かなり安心】

だと思います。

自動チャージ設定は最低金額の条件がある

自動チャージの画面を見ると、条件があります。

この画面で分かったのは、

残高の下限は最低5ドル
補充額は、下限より最低10ドル以上多い必要がある

ということでした。

実際、下限5ドルで補充14ドルだとエラーになります。

この条件に合わせれば設定できる

次の画面では、

下限4ドル → エラー
補充15ドル → 形式としては合っている

という形で、設定条件がかなりはっきり分かります。

つまり、ルールとしては

下限は最低5ドル
補充額は下限より10ドル以上多くする

この2つを意識すればよい、ということです。

自分の感覚では【自動チャージを有効にしておいた方が、途中停止を避けやすい】

と思います。

特に、自分のように途中で止まって復旧に時間がかかった場合は、
自動設定の価値はかなり大きいです。

でも入金しただけでは直らないことがあった

ここからが、本当に困った所でした。

入金したあと、自分は当然

「これで戻るだろう」

と思っていました。

でも戻りませんでした。

その時の不安はかなり大きかったです。

入金は失敗したのか
反映に時間がかかっているだけなのか
CLI側が別の何かを見ているのか
もう一回やり直さないといけないのか

こういう気持ちが一気に出てきます。

認証の向き先が違う可能性が見えてきた

ここで初めて分かったのは、
問題は「残高が足りない」だけではないかもしれない、ということでした。

そこで確認したのがこのコマンドです。

claude auth status

その時の表示では、

loggedIn: true
authMethod: "claude.ai"
apiKeySource: "/login managed key"
subscriptionType: null

となっていました。

ここで見えてきたのは、

自分が入金したのは Console 側なのに、CLI は別経路を見ている可能性がある

ということでした。

まず認証をいったん切った

復旧のために、認証をいったん切りました。

claude auth logout

そのあとで、Console側に向けて再ログインしました。

claude auth login --console

ここで大事だったのは、
ただ再入金することではなく、

Claude Codeがどこに向いて認証しているかを合わせること

でした。

認証の最終確認画面

ここまで来ると、ブラウザで最終確認画面が出ます。

ここでやることはシンプルです。

承認する
コマンド画面に戻る
もう一度状態確認する

この流れでした。

承認したあと、もう一度これを打ちました。

claude auth status

さらにその後、実際にこれを確認しました。

claude

ここで Credit balance too low が消えていれば、復旧完了です。

最終的に復帰した

最終的には、Claude Codeは復帰しました。

この時に自分が強く感じたのは「入金しただけでは直らないことがある」

ということでした。

つまり、問題は単純な残高不足だけではなく、

残高
認証先
今どの鍵を見て動いているか

ここまで分けて考える必要がありました。

再発した時の最短手順

今回のやり取りから、再発時に使う手順も整理できました。

自分用の最短手順はこの順番です。

echo %ANTHROPIC_API_KEY%
claude auth status
claude auth logout
claude auth login --console
claude auth status
claude

それぞれの意味

1. 環境変数の確認

echo %ANTHROPIC_API_KEY%

%ANTHROPIC_API_KEY% とそのまま表示される
→ 環境変数なし
長い文字列が出る
→ そのAPIキーを見に行っている可能性あり

2. 現在の認証状態確認

claude auth status

見るポイントは

loggedIn
authMethod
apiKeySource
subscriptionType

です。

3. 認証を切る

claude auth logout

4. Console側で再ログイン

claude auth login --console

5. 状態確認

claude auth status

6. Claude起動

claude

まとめ

今回の経験で分かったのは、
Credit balance too low が出た時に大事なのは、

「入金したかどうかだけではない」ということです。

大事なのは、

支払いが通っているか
Console側に残高があるか
自動チャージを設定するか
今どの認証先を見ているか
必要ならConsole側で再認証するか

ここまで確認することでした。

そして、自分の体験から言うと、

途中停止を避けたいなら、自動チャージ設定した方が良いです。

て言うか必須だと思います。

購入は5ドルからできます。
ただ、自動チャージを使う時は

下限は最低5ドル
補充額は下限より10ドル以上多くする

この条件があるので、そこだけ注意が必要です。

自分のように利用が停止して「入金したのに直らない」で止まった人は
残高だけでなく、認証状態まで見た方がいいと思います。

最後になりますが私はPCスキルがあるわけではありません。

チャット型AIに伴走してもらいながら使用方法を学んでいます。
　
後は、それぞれがそれぞれの利用方法で価値を十分に引き出せる環境を
整えれば良いと思っています。　　