Claude Code et la clé API : que faire quand ça bloque ?
Une clé ANTHROPIC_API_KEY oubliée passe avant ton abonnement. Lance /status, retire la clé avec unset, relance claude, puis /login si besoin.
En clair, en 30 secondes
- Claude Code se connecte soit avec ton compte Claude et son abonnement, soit avec un compte Claude Console facturé au token [1] [2] [3]. Si une clé API est aussi présente sur ta machine, elle passe avant l'abonnement une fois que tu l'as approuvée [2].
- Premier réflexe quand ça bloque : tape
/status. Il indique quel moyen de connexion est utilisé [2] [4].- Message
Invalid API key,Credit balance is too lowouThis organization has been disabledalors que tu as un abonnement : retire la variableANTHROPIC_API_KEY, puis relanceclaude[4] [5].
Quand Claude Code se bloque sur une erreur de clé API ou de connexion, commence par /status pour voir quel identifiant il utilise. Si une vieille clé ANTHROPIC_API_KEY traîne dans ton terminal, elle prend la place de ton abonnement : retire-la avec unset ANTHROPIC_API_KEY, relance claude, et reconnecte-toi avec /login si besoin.
En bref
- Les deux façons de se connecter : un compte Claude avec abonnement (Pro, Max, Ultra, Team ou Enterprise), ou un compte Claude Console avec des crédits payés d'avance [3].
- Le piège le plus courant : une clé API oubliée dans ta configuration. Elle fait facturer tes messages à l'usage au lieu de les compter dans ton abonnement [5] [6].
- La facturation à l'API se fait à la consommation de tokens, ces petits morceaux de texte que l'IA lit et écrit [1].
Deux façons de se connecter, deux façons de payer
| Abonnement | Compte Console avec clé API | |
|---|---|---|
| Connexion | /login avec ton compte Claude, dans le navigateur | Identifiants Console, ou clé dans la variable ANTHROPIC_API_KEY |
| Paiement | Compris dans le forfait | À la consommation de tokens |
| Où suivre la dépense | /usage dans Claude Code | Page Cost de la Console, limites de dépense par espace de travail |
| Source | [2] [3] | [1] [2] [3] |
La documentation des coûts le dit simplement : Claude Code facture la consommation de tokens de l'API. Pour les abonnements, elle renvoie vers la page officielle des tarifs, où les montants peuvent changer [1]. Notre article Combien coûte un premier projet avec Claude Code ? en fait le budget complet.
Qui passe en premier quand plusieurs identifiants existent ?
Claude Code suit un ordre fixe. La variable ANTHROPIC_API_KEY se place avant les identifiants de ton abonnement obtenus avec /login, qui sont en dernière position de la liste [2]. À la première utilisation, Claude Code te demande une seule fois d'approuver ou de refuser la clé, et il retient ton choix. Pour le changer plus tard, utilise l'interrupteur « Use custom API key » dans /config ; il n'apparaît que si la variable est définie [2].
Le centre d'aide le confirme : avec cette variable, Claude Code utilise la clé au lieu de ton abonnement, ce qui entraîne des frais d'API au lieu de l'usage inclus dans le forfait [6].
Quand ça bloque : la marche à suivre
- Tape
/status. La commande ouvre l'écran d'état, avec la version, le modèle, le compte et la connectivité [7]. Quand un identifiant et une clé sont tous deux configurés,/statusmarque celui qui n'est pas utilisé [2]. - Repère ton message dans le tableau ci-dessous.
- Si une clé parasite est en cause, retire-la (voir plus bas), puis relance
claude. - Si tu dois te reconnecter, tape
/logoutpuis/login. La déconnexion remet aussi à zéro l'état du premier lancement : au prochainclaude, la connexion est reproposée [2].
| Message affiché | Cause | Quoi faire | Source | |
|---|---|---|---|---|
Invalid API key | La clé de ANTHROPIC_API_KEY ou d'un script d'aide a été refusée | Vérifie les fautes de frappe et que la clé n'est pas révoquée dans la Console. Cherche une clé oubliée avec `env \ | grep ANTHROPIC. Retire-la puis connecte-toi avec /login` | [4] |
Not logged in | Aucun identifiant valide | Lance /login | [4] | |
Login expired | La connexion enregistrée a expiré | Lance /login. Réessayer sans te reconnecter affiche le même message | [4] | |
Credit balance is too low | Le compte Console n'a plus de crédits, ou Claude Code envoie tes demandes avec une clé Console alors que tu voulais utiliser ton abonnement | Lance /status et regarde la ligne « API key ». Retire la clé, ou ajoute des crédits dans la Console | [4] | |
This organization has been disabled | Une ancienne clé d'une organisation Console désactivée prend la place de ton abonnement | Retire la variable ANTHROPIC_API_KEY, relance claude, puis vérifie avec /status | [4] [5] | |
Unable to connect to API | La connexion à l'API n'a pas abouti | Vérifie ton accès internet. Dans Terminal, curl -I https://api.anthropic.com teste si le serveur répond | [4] |
Retirer une clé API qui bloque l'abonnement
Sur Mac, dans le même Terminal que celui où tu lances claude :
``bash unset ANTHROPIC_API_KEY claude ``
Cela ne vaut que pour la fenêtre en cours. Pour le rendre définitif, cherche une ligne export ANTHROPIC_API_KEY=... dans ~/.zshrc, ~/.bashrc ou ~/.profile, et supprime-la [5]. Une clé peut aussi venir d'un fichier .env de ton projet ou d'un outil comme direnv, qui chargent la clé sans que tu l'aies tapée [4]. Sous Windows PowerShell, la commande est Remove-Item Env:ANTHROPIC_API_KEY [5]. Enfin, lance /status pour confirmer que l'abonnement est bien l'identifiant actif [5].
Si la connexion au navigateur échoue
Pendant /login, tu peux appuyer sur c pour copier l'adresse de connexion et la coller dans ton navigateur. Si le navigateur affiche un code au lieu de revenir au terminal, colle-le dans le terminal à l'invite « Paste code here if prompted » [2]. Si Claude Code te redemande de te connecter après une session, la documentation conseille /login et, si cela se répète, de vérifier l'heure de ton ordinateur [5]. Sur Mac, claude doctor signale un souci d'accès au trousseau par un avertissement qui commence par macOS Keychain is not writable [5].
Comprendre la facturation au token
Si tu te connectes avec un compte Console, tout ce que Claude Code lit et écrit est compté en tokens et facturé. La commande /usage affiche un bloc « Session » avec un montant en dollars. La documentation précise que ce montant est une estimation calculée sur ton ordinateur au tarif public : pour la facturation exacte, consulte la page Cost de la Console [1]. Côté Console, une première connexion crée automatiquement un espace de travail « Claude Code » et tu peux y fixer des limites de dépense [1] [3].
Quatre gestes réduisent la consommation, d'après la même page : lancer /clear entre deux tâches sans rapport, choisir un modèle adapté (Sonnet coûte moins cher qu'Opus), donner des demandes précises plutôt que vagues, et passer en mode plan avant un gros travail [1]. Pour des crédits épuisés, la documentation propose d'ajouter des crédits sur la page de facturation de la Console et d'y activer le rechargement automatique [4].
Le module 1 du kit débutant couvre l'installation, la connexion et la première question, gratuitement et sans compte. Le parcours complet est sur la page Kit débutant. Si Claude Code se trompe en dehors de ces cas, lis aussi Claude Code fait une erreur : comment la décrire et la corriger ?.
Questions fréquentes
Ai-je besoin d'une clé API pour utiliser Claude Code ?
Non, pas avec un abonnement. Tu lances claude, tu te connectes avec ton compte Claude dans le navigateur, et les identifiants sont enregistrés pour la suite [2] [3]. Une clé API ne sert que si tu choisis de passer par un compte Console.
Pourquoi suis-je facturé alors que j'ai un abonnement ?
Probablement parce qu'une variable ANTHROPIC_API_KEY est définie et approuvée : Claude Code l'utilise alors à la place de ton abonnement, avec des frais d'API [2] [6]. Lance /status, retire la clé, puis relance.
Que faire si j'atteins ma limite d'usage ?
Le message You've hit your session limit ou You've hit your weekly limit signale une limite de ton forfait, partagée entre tous les modèles. Changer de modèle avec /model ne la lève pas, et le message indique l'heure de réinitialisation [1]. Si tu as des crédits d'usage activés, /usage-credits ouvre leurs réglages [1].
Sources
Pages consultées le 12 novembre 2026.
[1] Anthropic. Manage costs effectively, sections Using the /usage command, Add usage credits to your subscription, Claude Console, When a developer asks about a limit et Reduce token usage. Claude Code Docs. https://code.claude.com/docs/en/costs
[2] Anthropic. Authentication, sections Log in to Claude Code, Authentication precedence et Credential management. Claude Code Docs. https://code.claude.com/docs/en/authentication
[3] Anthropic. Quickstart, sections Before you begin et Step 2: Start your first session. Claude Code Docs. https://code.claude.com/docs/en/quickstart
[4] Anthropic. Error reference, sections Invalid API key, Not logged in, Login expired, Credit balance is too low, This organization has been disabled et Unable to connect to API. Claude Code Docs. https://code.claude.com/docs/en/errors
[5] Anthropic. Troubleshoot installation and login, sections This organization has been disabled with an active subscription et Not logged in or token expired. Claude Code Docs. https://code.claude.com/docs/en/troubleshoot-install
[6] Anthropic. Using Claude Code with your Pro or Max plan. Claude Help Center. https://support.claude.com/en/articles/11145838-using-claude-code-with-your-pro-or-max-plan
[7] Anthropic. Commands, entrée /status. Claude Code Docs. https://code.claude.com/docs/en/commands
Par Kemy Guerouine, le 12 novembre 2026. Cet article a été rédigé pour Formez-vous à l'IA (FVIA).