Claude Code : abonnement Claude ou facturation API
Claude Code peut utiliser un abonnement Claude ou la facturation API. Avec un abonnement (Pro, Max, Team ou Enterprise), l’utilisation est incluse jusqu’aux limites de votre forfait. Avec une clé API, vous payez au token, sans limite de forfait. Si ANTHROPIC_API_KEY est défini et approuvé, Claude Code l’utilise à la place de votre abonnement.
Aussi en: English · Español · Deutsch · 日本語 · 简体中文 · Português (Brasil) · 한국어 · Italiano · Nederlands · 繁體中文
Un guide de Switch, un gestionnaire indépendant de profils Claude Desktop. Switch est en accès anticipé avant sa sortie publique.
Deux façons de payer Claude Code
Connexion par abonnement. Vous vous connectez avec votre compte claude.ai. Claude Code est inclus dans tous les forfaits payants et partage leurs limites : une limite de session qui se réinitialise toutes les cinq heures et une limite hebdomadaire. En octobre 2026, Pro coûte 20 $ US par mois et Max 100 $ US ou 200 $ US par mois (claude.com/pricing).
Facturation API. Vous utilisez un compte Claude Console, une clé API ou un fournisseur cloud. L’utilisation se paie à l’usage, au token, et elle est facturée sur ce compte, sans arrêt net (Models, usage, and limits in Claude Code). Les prix de l’API varient selon le modèle et sont facturés par million de tokens en entrée et en sortie ; consultez la page des tarifs d’Anthropic pour les prix actuels.
Abonnement ou API : lequel vous convient
Un abonnement offre un coût mensuel prévisible. En contrepartie, vous vous arrêtez, ou passez à des crédits payants, quand vous atteignez une limite. La facturation API se paie à l’usage : le coût dépend de votre consommation, même si les comptes API ont des limites de débit et que les administrateurs peuvent fixer des plafonds de dépenses pour un espace de travail.
Pour donner un ordre de grandeur, la page d’Anthropic sur les coûts indique que, sur l’ensemble des déploiements en entreprise, la moyenne est d’environ 13 $ US par développeur et par jour actif, et de 150 $ US à 250 $ US par développeur et par mois, 90 % des utilisateurs restant sous 30 $ US par jour actif. Vos propres chiffres dépendent du modèle choisi, de la taille de la base de code et de vos habitudes.
Un abonnement convient à un usage quotidien régulier, quand une facture prévisible compte. Anthropic suggère aussi un compte Console avec des crédits API pour les sprints de code intensifs.
Savoir lequel est actif
Lancez /status dans Claude Code. La documentation d’Anthropic sur l’authentification indique que cette commande confirme la méthode active et que, lorsqu’une connexion et une clé API sont toutes deux configurées, elle signale celle qui n’est pas utilisée.
Autres indices : sur un abonnement, /usage affiche les barres d’utilisation du forfait, tandis qu’en facturation API, son bloc Session affiche un coût estimé en dollars. Les utilisateurs de l’API peuvent aussi lancer /cost pour voir leurs dépenses cumulées.
ANTHROPIC_API_KEY passe avant votre abonnement
C’est la cause la plus fréquente de frais inattendus. Dans l’ordre de priorité de l’authentification de Claude Code, une variable d’environnement ANTHROPIC_API_KEY passe avant votre connexion par abonnement. En mode interactif, Claude Code vous demande une fois s’il doit utiliser la clé et retient votre choix ; en mode non interactif (-p), il utilise toujours la clé. Le centre d’aide d’Anthropic prévient que cela entraîne des frais API au lieu de l’utilisation incluse dans votre forfait.
Pour revenir à votre abonnement :
unset ANTHROPIC_API_KEYSupprimez ensuite la ligne qui la définit dans votre profil de shell, relancez Claude Code et vérifiez /status. Tant que la variable est définie, vous pouvez aussi modifier votre choix précédent avec l’option « Use custom API key » dans /config. Claude Desktop ne lit pas cette variable ; il se connecte via OAuth.
Rester uniquement sur votre forfait
Quand vous atteignez une limite sur un abonnement, Claude Code peut proposer de continuer avec des crédits API. Anthropic précise que vous pouvez refuser et attendre la réinitialisation. Pour que l’option ne s’affiche plus, déconnectez-vous, reconnectez-vous uniquement avec vos identifiants Pro ou Max et n’ajoutez pas d’identifiants Console (Use Claude Code with your Pro or Max plan). La recharge automatique des crédits API est un réglage de la Console : vérifiez-le là-bas si vous avez déjà utilisé la facturation API.
Si vous avez un compte professionnel facturé d’une façon et un forfait personnel facturé d’une autre, donnez à chacun son propre CLAUDE_CONFIG_DIR pour que les connexions ne se mélangent pas. Voir plusieurs comptes Claude Code sur un seul Mac, ou Switch pour Claude Code si vous utilisez Claude Code dans Claude Desktop.