Peut-on utiliser Claude Code gratuitement ? Installation, abonnement et API

Ce qui est gratuit et payant dans Claude Code

Le téléchargement et l’installation du client ne font pas l’objet d’une facturation séparée. Toutefois, l’installation seule ne donne pas accès aux modèles : Claude Code doit s’authentifier avec un forfait Claude payant, Claude Console ou une plateforme d’entreprise prise en charge.

Le guide officiel de configuration de Claude Code indique explicitement que le forfait Claude.ai Free n’inclut pas l’accès à Claude Code. Les requêtes nécessitent un forfait Claude payant, une facturation Claude Console/API ou un fournisseur tiers pris en charge. Utilisez la page des tarifs Claude uniquement pour les fonctions et limites actuelles des forfaits payants, qui peuvent changer.

L’affirmation « Claude Code est gratuit » désigne généralement le client uniquement. Les requêtes utilisent soit le quota d’un forfait payant, soit des tokens API facturables.

Abonnement Claude et API : deux modes de facturation

Lorsque vous vous connectez via Claude.ai, l’utilisation de Claude Code est incluse dans le forfait payant et partage ses limites globales avec les autres surfaces Claude. Avec Claude Console, la facturation API est basée sur les tokens. Le coût réel dépend du modèle, de la taille du contexte et du travail effectué.

• Forfait Claude payant : abonnement avec usage inclus et décompté du quota commun ; consultez /usage et Settings → Usage. Adapté au travail interactif si vous avez déjà un forfait.
• Claude Console / API : facturation par tokens, comptabilisée dans l’organisation API et le Workspace ; consultez /usage pour la session et Claude Console pour la facture. Adapté à une facturation API, un budget et des accès organisationnels distincts.

Ne pas confondre authentification par abonnement et par API

Claude Code choisit les identifiants selon un ordre de priorité. La variable d’environnement ANTHROPIC_API_KEY prévaut sur l’authentification OAuth via /login. En mode interactif, Claude Code demande une fois l’autorisation d’utiliser une clé détectée ; en mode non interactif -p, une clé définie est utilisée automatiquement.

Vérifiez si la variable existe sans afficher sa valeur :

if [ "${ANTHROPIC_API_KEY+x}" = x ]; then
  printf '%s\n' 'Variable is set'
else
  printf '%s\n' 'Variable is not set'
fi

Exécutez ensuite /status dans Claude Code. La ligne Login method indique le mode actif et une ligne API key supplémentaire apparaît lorsqu’une clé API est utilisée.

Si vous souhaitiez utiliser l’abonnement alors qu’une clé d’environnement est active, retirez-la de la session courante :

unset ANTHROPIC_API_KEY

Relancez ensuite /status. Ne supprimez pas manuellement les fichiers d’identifiants : utilisez les commandes officielles /logout et /login pour changer de compte enregistré.

Lire l’usage et les limites dans /usage

La section Session en haut de /usage affiche les statistiques de la session actuelle : tokens d’entrée, de sortie, de lecture du cache et d’écriture du cache. Son montant en dollars est calculé localement à partir des tokens et peut différer de la facture réelle.

Pour les utilisateurs de l’API, cette section aide à estimer l’usage de la session, mais la page Usage de Claude Console constitue la référence de facturation. Après /clear, les compteurs redémarrent pour la nouvelle session.

Pour les abonnés Pro, Max, Team et Enterprise, l’usage de Claude Code est inclus dans le forfait. L’estimation en dollars de Session n’est donc pas une somme facturée à l’abonnement. Le même écran présente les barres d’usage du forfait, des statistiques d’activité et des répartitions pour skills, subagents, plugins et serveurs MCP.

Les touches d et w font basculer la répartition entre les dernières 24 heures et sept jours. Ces données proviennent de l’historique local de l’ordinateur actuel et excluent les autres appareils et claude.ai.

Où vérifier les conditions actuelles

Quatre pages officielles couvrent le sujet :

• Claude Plans & Pricing — forfaits incluant actuellement Claude Code et limites annoncées.
• Manage costs effectively — lecture de /usage, facturation API et fonctionnement des limites.
• Authentication — modes de connexion, priorité des identifiants, /status, /login et /logout.
• Claude Console Usage — usage et coûts réels d’une organisation API.

Ne considérez pas les prix, limites ou fonctions comme permanents dans vos notes. Ouvrez la page des tarifs actuelle avant de payer ou de changer de mode d’authentification.

Choisir un mode d’accès à Claude Code

Le bon choix dépend de l’endroit où l’usage doit être comptabilisé :

1. Vous avez déjà un forfait Claude payant et travaillez en mode interactif. Connectez-vous avec /login, vérifiez Login method dans /status et surveillez les barres du forfait dans /usage.
2. Votre organisation a besoin d’une facturation API et de limites de dépenses distinctes. Utilisez Claude Console et vérifiez la facture réelle dans Console, pas l’estimation locale de Session.
3. Claude Code s’exécute en CI ou dans un script sans navigateur. L’accès API est une option, mais pas la seule : la documentation officielle accepte aussi un jeton OAuth d’abonnement longue durée via claude setup-token. Le mode actif détermine la facturation.
4. La limite de votre forfait payant est épuisée. Attendez sa réinitialisation, changez de forfait ou activez des crédits d’usage s’ils sont disponibles pour votre compte. L’usage supplémentaire est facturé aux tarifs API standard.

Après tout changement, répétez deux contrôles : /status répond à « quel compte est actif ? », tandis que /usage indique « quelle limite ou quel enregistrement d’usage est visible ? »

La comparaison détaillée des modes de paiement Claude Code couvre les routes abonnement et API. Cette page conserve un objectif plus étroit : distinguer l’installation gratuite du client de l’accès payant au modèle.

Questions fréquentes

Peut-on utiliser Claude Code avec le forfait Free ?

La page des tarifs actuelle présente Claude Code pour les forfaits payants, pas pour Free. Le client peut être installé sans achat séparé, mais les requêtes nécessitent un mode d’accès payant pris en charge.

Pourquoi /usage affiche-t-il des dollars avec un abonnement ?

C’est une estimation locale du coût API des tokens utilisés dans la session actuelle, pas une facture d’abonnement. Consultez les barres d’usage du forfait sur le même écran.

Une clé API peut-elle faire passer Claude Code de l’abonnement à la facturation API ?

Oui. Si ANTHROPIC_API_KEY est définie et son utilisation autorisée, elle prévaut sur l’OAuth d’abonnement. Vérifiez le mode actif dans /status.

Où consulter les frais API exacts ?

Dans Claude Console. La section Session de /usage est une estimation locale qui peut différer de la facture réelle.

Étape suivante : accès API pour Claude Code

Si vous avez choisi un budget API distinct et votre propre clé pour Claude Code, consultez la page API pour Claude Code. Il s’agit d’une intégration de l’API BetterToken, et non d’un abonnement Claude ; vérifiez les champs et limites actuels avant la configuration.