Your credit balance is too low to access the Anthropic API : solutions

« Your credit balance is too low to access the Anthropic API » signifie que vous n’avez pas assez de crédits prépayés pour payer votre utilisation de l’API Claude. Dans Claude Code, l’erreur s’affiche sous la forme « Credit balance is too low ». Si vous pensiez utiliser un forfait comme Pro ou Max et que vous la voyez quand même, la cause habituelle est que la clé API de la variable d’environnement ANTHROPIC_API_KEY passe avant votre connexion au forfait, si bien que vous êtes passé à la facturation de l’API.

400 invalid_request_error
Your credit balance is too low to access the Anthropic API. Please go to Plans & Billing to upgrade or purchase credits.

Exemple de réponse de l’API. Elle apparaît sous cette forme dans des journaux collés par des utilisateurs sur le GitHub de Claude Code (un signalement d’avril 2025, un signalement d’août 2026). La liste des erreurs de l’API publiée par Anthropic ne contient pas cette phrase exacte.

En s’appuyant sur la documentation officielle de Claude Code et le centre d’aide d’Anthropic (vérifiés le 26 octobre 2026), cet article explique ce que signifie l’erreur, comment distinguer les causes, les deux solutions, et en quoi elle diffère des crédits API mensuels inclus avec Max et Team ainsi que des « crédits d’utilisation » de votre forfait. Les causes sont repérées par couleur : A Solde et B Clé API.

1. Ce que signifie l’erreur et comment elle s’affiche

L’API Claude est prépayée, sauf pour les organisations sous contrat commercial facturées en fin de mois. D’après l’article d’aide d’Anthropic, l’utilisation de l’API, du Playground et de Claude Code via une organisation de la Claude Console est déduite de crédits achetés à l’avance, et une fois vos crédits épuisés, vous ne pouvez plus appeler l’API tant que vous n’en ajoutez pas. Cette erreur vous indique que vous avez atteint cet état de « solde insuffisant ».

« Plans & Billing », à la fin du message, désigne l’écran de facturation de la Console. Dans la Console actuelle, vous consultez votre solde et achetez des crédits sur la page Billing (platform.claude.com/settings/billing).

Sources : Anthropic, « How do I pay for my Claude API usage? » ; Claude Code, « Error reference: Credit balance is too low ». L’ancien message provient d’un signalement sur GitHub. Vérifié le 26 octobre 2026.

La référence officielle des erreurs de Claude Code donne deux causes : les crédits prépayés de votre organisation de la Console sont épuisés, ou vous vouliez utiliser un abonnement mais les requêtes partent avec une clé API de la Console. Ce sont les causes A et B ci-dessus.

2. Trois questions pour trouver la cause

Répondez-y dans l’ordre, et vous saurez quelle solution suivre.

1. Q1 Voulez-vous utiliser Claude Code avec un forfait Pro, Max, Team ou Enterprise ?

   Oui Passez à Q2. Si vous tournez sur votre forfait, cette erreur ne devrait pas apparaître

   Non (clé API ou votre propre application) Passez à Q3

2. Q2 /status affiche-t-il une clé API ?

   OuiCause B Une ANTHROPIC_API_KEY que vous avez approuvée passe avant votre forfait → section 4

   Non Regardez la ligne de la méthode de connexion. Si vous êtes connecté avec un compte de la Console, vous payez sur le solde de la Console → lancez /login pour vous reconnecter avec le compte de votre forfait (étape 5 de la section 4)

3. Q3 Dans Billing de la Console, l’organisation de la clé a-t-elle un solde ?

   Aucun ou faibleCause A Achetez des crédits → section 3

   Oui Vérifiez si la clé appartient à une autre organisation, si vous venez tout juste d’acheter les crédits, et si vous n’avez que les crédits mensuels de Max ou Team en les utilisant pour un usage qu’ils ne couvrent pas → FAQ

Fondement de Q2 : la référence des erreurs de Claude Code demande aux utilisateurs d’un forfait qui voient cette erreur de vérifier la ligne de la clé API dans /status. Pour changer de méthode quand vous êtes connecté via la Console, voir Anthropic, « Use Claude Code with your Pro or Max plan » (si vous êtes connecté via un compte de la Console à l’usage, passez à votre forfait avec /login).

Ce que vous payez pour un forfait comme Claude Pro ne peut pas servir à payer l’API. L’aide d’Anthropic précise que les forfaits et la Console sont des produits distincts, et que l’API est facturée à part (Why is Claude API usage billed separately from my paid Claude plan?). Même avec un forfait, il vous faut un solde dans la Console tant que vous tournez sur une clé API.

3. Cause A Ajouter des crédits

C’est la solution pour ceux qui utilisent une clé API. Seuls les membres ayant le rôle Admin ou Billing dans l’organisation de la Console peuvent acheter des crédits. S’il s’agit de l’organisation de votre entreprise, demandez à un administrateur.

1. Ouvrir la page Billing Connectez-vous à la Console et ouvrez Billing. Le solde de crédits de l’organisation et le montant consommé apparaissent sur la même page. Si vous appartenez à plusieurs organisations, vérifiez que vous avez sélectionné l’organisation dans laquelle la clé en échec a été créée. Les soldes sont propres à chaque organisation, et toutes les clés API d’une même organisation puisent dans le même solde.
2. Acheter des crédits Cliquez sur « Buy credits », saisissez un montant et confirmez. D’après l’article d’aide, les crédits achetés sont disponibles immédiatement.
3. Activer la recharge automatique (facultatif) Dans la section Credit balance, utilisez « Set up auto-reload » pour saisir le solde qui déclenche une recharge (When credit balance reaches) et le solde à rétablir (Bring credit balance back up to), puis cliquez sur « Turn on ». Si votre solde est déjà égal ou inférieur à ce montant, le bouton devient « Turn on and purchase » et l’achat a lieu sur-le-champ.
4. Relancer ce qui a échoué Dans Claude Code, renvoyez la même instruction.

Source : Anthropic, « How do I pay for my Claude API usage? » (étapes d’achat, disponibilité immédiate, configuration de la recharge automatique, expiration un an après l’achat, aucun remboursement). Vérifié le 26 octobre 2026.

Les crédits achetés expirent un an après la date d’achat et ne sont pas remboursables. N’acheter que ce que vous utiliserez et laisser la recharge automatique compléter quand le solde baisse devrait limiter le gaspillage. La référence des erreurs de Claude Code recommande aussi de définir des plafonds de dépenses par espace de travail (workspace) dans la Console, pour qu’un seul projet ne vide pas le solde de l’organisation.

4. Cause B Supprimer la clé API et utiliser votre forfait

C’est la solution pour ceux qui veulent utiliser un forfait Pro, Max, Team ou Enterprise. Quand plusieurs identifiants sont présents, Claude Code en choisit un selon un ordre fixe, et la variable d’environnement ANTHROPIC_API_KEY et apiKeyHelper dans un fichier de paramètres passent avant la connexion au forfait configurée avec /login. Quand la clé est utilisée, comme l’explique l’aide d’Anthropic, vous êtes facturé à l’usage sur l’organisation de cette clé, et si cette organisation n’a pas de solde, vous êtes bloqué par cette erreur.

1. Vérifier avec /status Lancez /status dans Claude Code et regardez la ligne de la clé API. Quand une connexion et une clé API sont toutes deux présentes, celle qui n’est pas utilisée est signalée.
2. La supprimer du shell actuel Supprimez la variable du terminal ouvert (commandes ci-dessous).
3. Supprimer la source de la clé Trouvez et supprimez la ligne export ANTHROPIC_API_KEY=... dans le fichier de configuration de votre shell, la variable d’environnement utilisateur de Windows et toute entrée dans votre profil PowerShell ($PROFILE). Sinon, le prochain terminal ouvert la rechargera. D’après la référence officielle des erreurs, des outils comme direnv ou le terminal d’un IDE peuvent charger la clé depuis le fichier .env d’un projet : vérifiez donc aussi le .env du dossier de votre projet. Comment la repérer dans env ou apiKeyHelper des fichiers de paramètres de Claude Code est expliqué dans notre article sur « claude.ai connectors are disabled ».
4. Rouvrir le terminal et lancer claude L’aide officielle cite parmi les erreurs courantes le fait de modifier des variables d’environnement sans rouvrir le terminal.
5. Lancer /login si nécessaire, puis /status à nouveau Si vous n’êtes pas encore connecté avec le compte de votre forfait, lancez /login. Une fois que /status confirme qu’aucune clé API n’est utilisée, c’est terminé.

# macOS / Linux : vérifier si elle est définie
env | grep ANTHROPIC
# La supprimer du shell actuel
unset ANTHROPIC_API_KEY
# Trouver quel fichier de configuration la définit
grep -n ANTHROPIC_API_KEY ~/.zshrc ~/.bashrc ~/.bash_profile ~/.profile 2>/dev/null

# Windows (PowerShell) : vérifier si elle est définie
Get-ChildItem Env:ANTHROPIC*
# La supprimer du shell actuel
Remove-Item Env:ANTHROPIC_API_KEY

# Windows (invite de commandes) : vérifier si elle est définie
echo %ANTHROPIC_API_KEY%
# La supprimer du shell actuel
set ANTHROPIC_API_KEY=

Sous Windows, supprimez les réglages persistants dans les variables utilisateur, via « Propriétés système » → « Paramètres système avancés » → « Variables d’environnement ». Sources : Anthropic, « Manage API key environment variables in Claude Code » ; Claude Code, « Authentication precedence » et « Error reference » (les commandes de vérification et le .env figurent dans l’entrée « Invalid API key »). Vérifié le 26 octobre 2026.

Si vous ne voulez pas supprimer la clé, vous pouvez plutôt retirer votre approbation. Lancé en mode interactif, Claude Code demande une fois s’il doit utiliser ANTHROPIC_API_KEY la première fois qu’il la trouve, et retient votre réponse. Pour la changer ensuite, basculez « Use custom API key » dans /config (cette option n’apparaît que si la variable est définie). En revanche, avec claude -p (non interactif), la clé est toujours utilisée si elle est présente. Si d’autres scripts ont besoin de la clé, ne la transmettez qu’au lancement de ces commandes.

Si elle apparaît dans l’extension VS Code

Dans l’extension Claude Code pour VS Code, vous vérifiez les mêmes points. Tapez /status dans le panneau pour afficher votre compte et d’autres informations (Claude Code v2.1.280 ou ultérieur). D’après la documentation officielle, VS Code lancé depuis un terminal avec code . hérite des variables d’environnement de ce shell. Si la clé se trouve dans le fichier de configuration de votre terminal, elle peut donc atteindre l’extension. Après avoir supprimé la clé, fermez puis rouvrez VS Code avant de vérifier.

Vous pouvez aussi définir des variables d’environnement dans le réglage claudeCode.environmentVariables de l’extension. Dans les paramètres, sous Extensions → Claude Code, vérifiez que ANTHROPIC_API_KEY n’y est pas défini.

Source : Claude Code, « Use Claude Code in VS Code » (héritage des variables d’environnement, réglage environmentVariables, /status). Vérifié le 26 octobre 2026.

5. Ce qui paie votre utilisation

Trois choses s’appellent « crédits », et les confondre conduit à mal interpréter cette erreur : les crédits API achetés dans la Console, les crédits API mensuels inclus avec Max et Team, et les crédits d’utilisation, qui paient l’utilisation au-delà des limites de votre forfait Pro ou Max. Voici avec quoi chaque type d’utilisation peut être payé.

Sources : Anthropic, « Monthly API credits for Max and Team plans » (Claude Code interactif et crédits d’utilisation non couverts ; claude -p et l’Agent SDK lancés vous-même avec une clé API couverts) ; « Manage usage credits for paid Claude plans » (les crédits d’utilisation s’appliquent à Claude comme à Claude Code au-delà des limites du forfait, et sont distincts des crédits API mensuels) ; « Manage API key environment variables in Claude Code » (si une clé API est présente, vous êtes facturé à l’usage sur l’organisation de cette clé) ; « How do I pay for my Claude API usage? ». Vérifié le 26 octobre 2026.

Ce qui compte pour cette erreur, ce sont les deux colonnes de droite (le solde de votre organisation de la Console). Le tableau permet d’en tirer trois conclusions.

• Si vous la voyez alors que vous pensez être sur votre forfait, vous êtes dans l’une des lignes « clé API ». Ajouter à votre forfait ou à vos crédits d’utilisation (les deux colonnes de gauche) ne réglera rien, quel que soit le montant (cause B).
• Les crédits API mensuels de Max et Team ne peuvent pas servir pour Claude Code en mode interactif. Même si les crédits de votre forfait apparaissent encore sur l’écran du solde de la Console, ils ne peuvent pas payer Claude Code interactif lancé avec une clé API. Comment les réclamer et dans quel ordre ils sont consommés est expliqué dans notre article sur les crédits API de Max et Team.
• Les crédits d’utilisation sont un solde distinct, dans les paramètres de claude.ai (Paramètres → Utilisation). Comme ils sont séparés du solde de la Console, les recharger n’aide en rien pour une utilisation avec une clé API.

6. Erreurs semblables mais différentes

D’autres erreurs concernent aussi des soldes ou des limites. Distinguez-les par le début du message.

Sources : Claude API, « Rate limits » (les deux erreurs de plafond de dépenses) ; Claude Code, « Error reference ». Vérifié le 26 octobre 2026.

Pour une liste des autres erreurs de Claude Code, consultez Erreurs courantes de Claude Code et leurs correctifs.

Récapitulatif

FAQ

Q. Existe-t-il une offre gratuite pour l’API Claude ?

R. L’aide officielle ne mentionne pas d’offre gratuite. Après la création d’une organisation de la Console, la consigne est d’« ajouter des crédits au solde de votre organisation pour utiliser l’API et le Playground » (I created a Claude Console organization - how do I start using the Claude API?). L’exception, ce sont les crédits API mensuels inclus avec les forfaits Max et Team ; les forfaits Free, Pro et Enterprise n’y ont pas droit.

Q. J’ai Claude Pro. Pourquoi ai-je cette erreur ?

R. Parce que Claude Code tourne sur une clé API. Le prix de votre forfait ne peut pas payer l’API : si l’organisation de la clé API n’a pas de solde, vous obtenez cette erreur. Vérifiez avec /status si une clé API est utilisée, et supprimez-la en suivant les étapes de la section 4.

Q. J’ai acheté des crédits, mais l’erreur persiste.

R. D’après l’article d’aide, les crédits achetés sont disponibles immédiatement. Vérifiez d’abord que l’organisation où vous avez créé la clé est bien celle pour laquelle vous avez acheté les crédits. La page d’état d’Anthropic consigne un incident le 1er septembre 2026 (UTC) au cours duquel les crédits achetés tardaient à s’appliquer pour les utilisateurs dont le solde était tombé à zéro, et certaines requêtes API renvoyaient à tort « credit balance is too low » (Delays in credit purchases). Le 1er octobre de la même année, un autre incident a retardé l’application des achats (Delayed credits on the Claude Platform). Si l’organisation correspond et que le solde s’affiche, consultez status.claude.com pour voir si un incident est en cours.

Q. Il me reste des crédits API mensuels Max, mais j’ai cette erreur dans Claude Code.

R. Les crédits API mensuels ne peuvent pas servir pour Claude Code interactif dans le terminal, l’IDE, l’application de bureau ou sur le Web (le tableau de la section 5). Pour utiliser votre forfait, supprimez la clé API et utilisez votre connexion ; pour utiliser une clé API, achetez des crédits dans la Console.