Le « credit balance is too low » de l’API Claude / 402 insufficient_quota

Cette erreur n’a rien à voir avec votre code : le solde prépayé associé à la clé est vide (ou votre plafond de dépenses mensuel a été atteint). Voici les différences entre les modèles de facturation d’Anthropic Console et des passerelles, ainsi que les alertes qui empêchent le problème de se reproduire à 2 heures du matin.

L’erreur

response (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}}

Causes et solutions en bref

Cause	Solution
Solde prépayé réellement nul	Rechargez le compte. Sur Anthropic : Console → Plans & billing. Sur Kunavo : /app/billing (le solde n’expire jamais).
Le rechargement automatique est désactivé (ou sa carte a expiré)	Activez le rechargement automatique / mettez la carte à jour afin que les pics de consommation ne vident pas le solde sans que vous le remarquiez.
Plafond de dépenses mensuel atteint	Augmentez ou supprimez le plafond par clé / espace de travail si la dépense était légitime.
Clé d’un espace de travail incorrect	Les clés utilisent le solde de l’espace de travail qui les a créées — une organisation approvisionnée ne finance pas la clé d’un autre espace de travail.

Vérifiez qu’il s’agit bien du solde et non de l’authentification

401 = problème de clé ; 400 « credit balance too low » / 402 insufficient_quota = problème d’argent. Ne faites pas tourner les clés pour une erreur de facturation — la nouvelle clé lit le même portefeuille vide.

Rechargez, puis vérifiez avec un appel peu coûteux

Les soldes s’appliquent immédiatement sur Anthropic et Kunavo — aucun redéploiement n’est nécessaire. Vérifiez avec une requête minimale avant de réactiver vos workers :

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?"}]}'

Vous voyez ce message dans Claude Code ?

Claude Code affiche ce message lorsqu’il s’exécute avec une clé API Anthropic dont le solde Console est nul — une connexion Pro ou Max rencontre plutôt des limites d’utilisation et n’affiche jamais ce message. Rechargez la Console ou continuez à travailler avec un endpoint à la carte : Claude Code lit nativement ANTHROPIC_BASE_URL, le changement ne nécessite donc que quelques variables d’environnement. Conservez les quatre lignes de modèle — le modèle par défaut de Claude Code ainsi que ses alias opus et sonnet suivent les modèles les plus récents d’Anthropic, et l’alias sonnet demande Sonnet 5.5, que Kunavo ne propose pas.

~/.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

Rendez le prochain incident sans intérêt

Configurez une alerte de solde faible (par e-mail) et, si votre fournisseur le permet, un rechargement automatique avec un plafond mensuel raisonnable. Le blocage en cas d’épuisement est le comportement approprié — vous voulez simplement recevoir l’avertissement avant le mur, pas après.

Si vous appelez via Kunavo

Kunavo refuse toute requête lorsque le solde est nul, avec une erreur explicite 402 insufficient_quota (jamais une vague erreur 500), les requêtes échouées ne sont pas facturées et les comptes actifs reçoivent un e-mail de solde faible indiquant leur autonomie selon leur propre rythme de consommation avant d’atteindre la limite. Le solde est un portefeuille prépayé à partir de 10 $, qui n’expire jamais, rechargé sur /app/billing par carte, avec Apple Pay, Google Pay ou Link hors d’Inde, ou avec un moyen de paiement local proposé par Stripe dans votre devise, comme Pix, WeChat Pay, UPI ou KakaoPay. La durée couverte par un rechargement donné dépend entièrement du modèle ciblé, et les tarifs par modèle sont indiqués dans le grille tarifaire de l’API Anthropic Claude.

Questions fréquentes

J’ai rechargé mon compte — pourquoi l’erreur s’affiche-t-elle encore ?

Vérifiez que vous avez approvisionné le même compte/espace de travail que celui qui a créé la clé et qu’un plafond de dépenses mensuel n’est pas le véritable blocage. L’application du solde est immédiate sur Anthropic et Kunavo.

L’API Claude dispose-t-elle d’un niveau gratuit ?

Non — Anthropic facture chaque appel d’API dès le premier token (les forfaits grand public Claude.ai sont distincts du crédit API). Les passerelles sont également facturées à l’usage ; Kunavo commence avec un rechargement de 10 $ et des tarifs inférieurs au prix catalogue.

« Credit balance is too low » dans Claude Code — mais je paie Pro. Pourquoi ?

Parce que Claude Code utilise une clé d’API et non votre abonnement. Tant que ANTHROPIC_API_KEY ou ANTHROPIC_AUTH_TOKEN est défini, Claude Code facture la clé et met en pause la connexion Pro ou Max ; cette clé utilise un solde Console prépayé distinct. Exécutez /status pour voir quel identifiant est actif ; supprimez la variable pour revenir au forfait ou rechargez le solde de la clé.

OpenClaw indique « API provider returned a billing error » — est-ce la même chose ?

Oui. C’est le message qu’OpenClaw utilise pour signaler un refus de facturation du fournisseur de modèles : la clé d’API n’a plus de crédits ou son solde est insuffisant. Rechargez ce fournisseur ou basculez OpenClaw vers un autre — les guides associés ci-dessous comparent les options.

Guides associés

La sémantique détaillée des erreurs est disponible dans référence des erreurs ; obtenir une clé prend une minute via inscription et la guide d’authentification.