Configuration API : Abonnement ou Clé API, comment choisir et comment basculer

📚 Navigation de la série : L'article précédent 03 · Comment ça fonctionne a décortiqué la boucle de l'agent : comment Claude Code fait « Réfléchir → Agir → Observer ». Cet article aborde la condition préalable à son fonctionnement : quelle identité utiliser pour se connecter au modèle. L'article suivant parlera de l'intégration des modèles tiers/nationaux.

En juin 2026, la documentation officielle de Claude Code listait pas moins de 6 méthodes d'authentification, de la connexion par abonnement aux identifiants des fournisseurs cloud, classées par ordre de priorité.

Il y a ici un piège très courant dans lequel je suis moi-même tombé. À l'époque, par facilité, j'avais exporté une ANTHROPIC_API_KEY dans .zshrc. Plus tard, j'ai souscrit à l'abonnement Max et me suis connecté avec /login sans problème. Sauf qu'un jour, en regardant la facture sur la Console, j'ai réalisé que mon solde API diminuait - alors que je pensais utiliser les crédits de mon abonnement. Après avoir cherché un moment, j'ai compris : tant qu'une clé API est présente dans l'environnement, sa priorité l'emporte sur l'abonnement.

Autrement dit, « être connecté » ne signifie pas « utiliser la bonne identité ». Cet article va clarifier ce point de A à Z.

Après avoir lu cet article, vous obtiendrez :

• Un tableau de comparaison des scénarios d'utilisation pour choisir entre la connexion par abonnement et la clé API
• Trois méthodes d'implémentation (connexion en ligne de commande / variables d'environnement / settings.json) avec les différences entre Mac / Windows / Linux
• Un ensemble de commandes de vérification : utilisez /status pour confirmer « quelle identité et quel modèle j'utilise en ce moment », pour ne plus jamais être facturé par erreur

---

01 Deux identités : Connexion par abonnement vs Clé API

Donnons d'abord la conclusion : Pour un usage personnel, choisissez la connexion par abonnement ; c'est seulement pour l'intégration dans des scripts / CI / ou une facturation à l'usage en équipe qu'il faut utiliser une clé API.

Connecter Claude Code au modèle revient à répondre à une question : « Pourquoi devrais-je te laisser l'utiliser ? » C'est l'authentification (authentication) - vous devez prouver qui vous êtes et de quel quota vous disposez. Les méthodes officielles sont nombreuses, mais pour un débutant, il suffit de se concentrer sur les deux principales.

Analogie : Entrer dans une salle de sport. La connexion par abonnement est comme prendre un abonnement mensuel : reconnaissance faciale à l'entrée, vous vous entraînez autant que vous voulez dans le mois, pas de facturation à la séance ; la clé API est comme un ticket d'entrée à la séance : on vous déduit un ticket à chaque entrée, vous payez ce que vous consommez. L'abonnement mensuel convient à ceux qui y vont tous les jours, le ticket à la séance convient à un usage occasionnel ou pour amener des amis (scripts, automatisation).

Les différences entre les deux voies sont résumées dans ce tableau :

Dimension	Connexion par abonnement (Compte Claude.ai)	Clé API (Console / Variable d'environnement)
Comment se connecter	Lancer claude dans le terminal, se connecter via le navigateur	Configurer la variable d'environnement ANTHROPIC_API_KEY
Comment c'est facturé	Abonnement mensuel (Pro / Max / Team)	Selon la consommation de tokens, déduit du solde de la Console
Quota	A un plafond d'utilisation, il faut attendre la réinitialisation si on l'atteint	Vous utilisez ce que vous chargez, pas de plafond fixe
Pour qui	Développement interactif quotidien individuel	Scripts / CI / Facturation à l'usage en équipe
Origine des identifiants	Autorisation navigateur /login	Création de clé dans la Console Claude
Sans navigateur ?	Nécessite un navigateur par défaut (la CI utilise setup-token)	Oui, une simple variable d'environnement suffit

Subdivisons un peu la partie abonnement, car nous en aurons besoin pour choisir le modèle plus tard :

• Claude Pro / Max : Abonnement personnel, connexion avec le compte Claude.ai. Pro est plus léger, Max a un quota élevé et permet d'utiliser le modèle le plus puissant.
• Claude for Teams / Enterprise : Forfait d'équipe, l'administrateur vous invite, facturation unifiée. Enterprise permet également de configurer SSO et des stratégies gérées.

Pour les projets personnels, utilisez toujours la connexion par abonnement Max, c'est sans souci et vous n'avez pas à surveiller votre solde ; ce n'est que lorsque vous insérez des tâches d'automatisation dans GitHub Actions que vous créez une clé API séparée (les détails sur l'utilisation en CI seront abordés dans l'article 44). Pour le développement quotidien, ne touchez pas à la clé API, c'est chercher l'anxiété de la facturation.

💡 En un mot : Abonnement = Pass mensuel (quotidien individuel), Clé API = Billet (scripts/équipe à l'usage), déterminez d'abord à quelle catégorie vous appartenez avant de configurer.

---

02 Connexion par abonnement : La voie la plus tranquille

Si vous êtes un utilisateur individuel et que vous avez acheté Pro ou Max, alors il n'y a pratiquement rien à configurer - lancez-le et connectez-vous.

Il n'y a qu'une seule étape. Après avoir installé Claude Code (voir l'article 02), tapez dans le terminal :

claude

Au premier lancement, Claude Code va automatiquement ouvrir le navigateur pour vous demander de vous connecter à votre compte Claude.ai. Une fois connecté, le navigateur vous renverra vers le terminal, et c'est terminé.

Quelques situations réelles que vous pourriez rencontrer :

• Le navigateur ne s'est pas ouvert automatiquement ? Appuyez sur c dans l'interface de Claude Code, il copiera le lien de connexion dans le presse-papiers, collez-le vous-même dans votre navigateur pour l'ouvrir.
• Après la connexion, le navigateur affiche un « code de connexion » et ne revient pas au terminal ? Collez ce code dans le terminal au niveau de l'invite Paste code here if prompted. C'est fréquent dans WSL2, les sessions SSH distantes, et les conteneurs, car le navigateur ne peut pas se connecter au port de rappel de la machine locale.
• Vous voulez changer de compte / vous déconnecter ? Tapez /logout dans Claude Code, et reconnectez-vous au prochain lancement.

Où sont stockés les identifiants de connexion ? Cela dépend de la plateforme, le savoir permet de dépanner sans tâtonner :

Plateforme	Emplacement des identifiants
macOS	Trousseau d'accès (Keychain) système chiffré
Linux	~/.claude/.credentials.json (permissions 0600)
Windows	%USERPROFILE%\.claude\.credentials.json (hérite des permissions du dossier utilisateur)

Tout cela est géré automatiquement par Claude Code via /login / /logout, vous n'avez pas besoin d'y toucher manuellement. Quand j'ai eu des problèmes de connexion sur mon Mac, j'ai cherché ~/.claude/.credentials.json comme sur Linux, et impossible de le trouver, j'ai cru que la connexion avait échoué - c'était parce que macOS ne le stocke pas dans un fichier, mais dans le Keychain.

💡 En un mot : Les utilisateurs abonnés n'ont qu'à faire « exécuter claude → se connecter dans le navigateur », Claude Code stocke les identifiants automatiquement, ne cherchez pas manuellement.

---

03 Clé API : La voie pour les scripts et les équipes

La voie de la clé API est en réalité très ciblée : si vous ne faites pas d'automatisation ou si vous n'êtes pas dans une équipe facturée à l'usage, vous n'en aurez pas besoin. Mais pour bien comprendre « comment basculer », il faut savoir à quoi cela ressemble.

Première étape, obtenir la clé. Allez sur la Console Claude pour créer une clé API (c'est la console de développeur officielle d'Anthropic, facturée aux tokens utilisés, ce qui est différent de l'abonnement Claude.ai).

Deuxième étape, configurer la variable d'environnement. Les commandes varient selon la plateforme :

macOS / Linux :

export ANTHROPIC_API_KEY=sk-ant-votre-clé

Windows (PowerShell, enregistrement permanent dans les variables d'environnement de l'utilisateur) :

[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-ant-votre-clé", [EnvironmentVariableTarget]::User)

⚠️ La clé c'est de l'argent, ne la laissez pas traîner. Ne l'écrivez pas dans le code, ne la commitez pas dans Git, ne la collez pas dans des fichiers partagés. L'utiliser temporairement avec export dans le terminal courant est le plus sûr, elle disparaît à la fermeture. Pour la rendre persistante, utilisez les variables d'environnement du système, ne la codez pas en dur dans le projet.

Troisième étape, confirmer au démarrage. Après configuration, lancez claude. En mode interactif, le système vous demandera d'approuver cette clé une fois (Approuver / Rejeter au choix, le choix sera mémorisé). Après approbation, elle sera utilisée.

Il y a ici un comportement clé explicitement mentionné par l'équipe officielle, qui est à l'origine du piège mentionné au début :

Si vous avez un abonnement Claude actif, mais que ANTHROPIC_API_KEY est également configuré dans l'environnement, alors la clé API aura la priorité après avoir été approuvée. Si cette clé appartient à une organisation désactivée ou expirée, cela entraînera directement l'échec de la validation.

Autrement dit, la clé API « écrasera » votre abonnement. C'est la raison d'être de la section suivante sur le basculement.

💡 En un mot : La clé API s'obtient en trois étapes : Console pour la clé → Configurer la variable d'environnement → Approuver au lancement ; retenez qu'une fois présente, elle a priorité sur l'abonnement, c'est la source de tous les problèmes de « basculement » ultérieurs.

---

04 Comment basculer : La priorité est la clé

Conclusion fondamentale : Ce que vous « pensez utiliser » comme identité n'a pas d'importance, c'est l'ordre de priorité de Claude Code qui décide. Pour basculer, il faut manipuler cette priorité.

Analogie : L'ordre de branchement d'une prise. Vous avez plusieurs prises sur votre mur (abonnement, clé API, identifiants cloud...), l'appareil électrique ne choisit pas l'alimentation selon vos souhaits, mais selon ce qui est branché et la position la plus proche de l'arrivée de courant. Pour changer de source, il faut débrancher ce qui est en amont.

L'ordre de priorité d'authentification donné par la documentation officielle, de haut en bas sur 6 niveaux (le niveau supérieur écrase l'inférieur) :

Priorité	Source de l'identifiant	Scénario typique
1 (Plus haute)	Fournisseur Cloud (Bedrock / Vertex / Foundry)	Entreprises utilisant des fournisseurs Cloud
2	Variable d'environnement ANTHROPIC_AUTH_TOKEN	Utilisation via une passerelle LLM / proxy
3	Variable d'environnement ANTHROPIC_API_KEY	Connexion directe à l'API Anthropic
4	Sortie du script apiKeyHelper	Identifiants dynamiques / rotatifs
5	CLAUDE_CODE_OAUTH_TOKEN	Jeton longue durée pour la CI
6 (Plus basse)	Identifiant d'abonnement de /login	L'abonnement personnel utilise ce niveau par défaut

Cette image empile le tableau ci-dessus : 6 couches d'identifiants empilées de haut en bas, Claude Code scanne depuis le sommet, ignore toutes les couches « vides », et s'arrête à la première couche ayant une valeur pour l'utiliser. Dans le scénario de l'abonnement personnel, les 5 couches supérieures sont vides, il utilise donc la connexion par abonnement tout en bas.

Compris ? L'abonnement est tout en bas. Donc, si une couche supérieure a une valeur, elle écrase votre abonnement. Cela explique le scénario du début : bien qu'étant connecté à Max, l'API était facturée, car ANTHROPIC_API_KEY (niveau 3) écrasait l'abonnement (niveau 6).

Alors comment repasser à l'abonnement ? La solution officielle est directe : vider la couche de priorité supérieure :

unset ANTHROPIC_API_KEY

Puis lancez /status pour confirmer. Si, en mode interactif, vous ne souhaitez temporairement pas utiliser une clé spécifique, vous pouvez également la désactiver via le commutateur « Use custom API keys » dans /config.

À l'inverse, pour passer de l'abonnement à la clé API, il suffit de configurer la clé avec export et de l'approuver une fois (voir section 03).

Quelques détails où il est facile de se tromper :

• ANTHROPIC_API_KEY / ANTHROPIC_AUTH_TOKEN ne sont valides que pour la session CLI du terminal. L'application de bureau Claude Desktop et les sessions à distance ne reconnaissent que la connexion OAuth et ne lisent pas ces variables d'environnement.
• Claude Code sur le Web utilisera toujours vos identifiants d'abonnement, la variable d'environnement de clé API dans le bac à sable ne peut pas l'écraser.
• ANTHROPIC_AUTH_TOKEN (niveau 2) et ANTHROPIC_API_KEY (niveau 3) sont deux choses différentes : la première est envoyée dans l'en-tête Authorization: Bearer (utilisée via des passerelles / proxys) ; la seconde est envoyée dans l'en-tête X-Api-Key (connexion directe à l'API officielle). Ne les confondez pas.

💡 En un mot : Basculer = Ajuster la priorité. L'abonnement est tout en bas, n'importe quelle clé API / jeton au-dessus l'écrasera ; pour repasser à l'abonnement, utilisez unset pour supprimer la valeur supérieure, puis vérifiez avec /status.

---

05 Bases du choix de modèle : opus, sonnet ou default

L'identité est configurée, il reste une chose à décider : quel modèle utiliser pour le travail.

Analogie : Assigner des tâches à l'équipe. Opus est l'ingénieur senior le plus fort de l'équipe : il a une bonne tête, un raisonnement profond, mais il est lent et coûteux ; Sonnet est la force de frappe principale : rapide et stable pour la programmation quotidienne, excellent rapport qualité-prix ; Haiku est l'assistant de base : réponse immédiate pour les tâches simples, le plus économique. Les problèmes difficiles pour Opus, le quotidien pour Sonnet, les corvées pour Haiku.

Claude Code utilise des alias de modèles pour vous éviter d'avoir à mémoriser de longs numéros de version. Voici les plus utilisés :

Alias	Utilisation
default	Valeur spéciale : efface le remplacement manuel, revient au modèle recommandé pour votre niveau de compte
opus	Dernier Opus, pour le raisonnement complexe / décisions d'architecture
sonnet	Dernier Sonnet, pour la programmation quotidienne
haiku	Rapide et efficace, pour traiter les tâches simples
best	Actuellement équivalent à opus, utilise le modèle le plus puissant disponible
opusplan	Mode mixte : Plan Mode utilise Opus pour réfléchir, puis bascule sur Sonnet pour exécuter
opus[1m] / sonnet[1m]	Fenêtre de contexte de 1 million de tokens, pour analyser les grands dépôts de code / les longues sessions

Attention : Les alias pointent vers « la version recommandée pour votre niveau de compte », qui évolue avec le temps. Quant à la version exacte vers laquelle ils sont résolus, consultez la documentation officielle pour en être sûr - par exemple, sur l'API Anthropic, opus est actuellement résolu en Opus 4.8, sonnet est résolu en Sonnet 4.6, mais chez d'autres fournisseurs (Bedrock / Vertex, etc.), les versions résolues peuvent différer (selon la documentation officielle, sujet à changement).

Votre niveau d'abonnement détermine quel modèle vous est attribué par défaut :

Type de compte	Résolution de default
Max / Team Premium / Entreprise à l'usage / API Anthropic	Opus 4.8
Pro / Team Standard / Siège d'abonnement Entreprise	Sonnet 4.6

Cela signifie que les utilisateurs Pro ont Sonnet par défaut, et les utilisateurs Max ont Opus par défaut - c'est aussi l'une des raisons pour lesquelles on recommande aux utilisateurs intensifs de passer à Max. De plus, lorsque le seuil d'utilisation d'Opus est atteint, Claude Code peut revenir automatiquement à Sonnet, ce qui est un comportement normal et non un bug.

Comment configurer le modèle ? La documentation officielle donne quatre méthodes par ordre de priorité :

# 1. Changement temporaire pendant la session (exécuter /model sans paramètres ouvre le sélecteur) — Priorité la plus élevée
/model sonnet

# 2. Spécifié au lancement
claude --model opus

# 3. Variable d'environnement (valide pour cette session)
ANTHROPIC_MODEL=opus

// 4. Écrit dans settings.json, par défaut de manière permanente pour les nouvelles sessions — Priorité la plus basse
{
  "model": "opus"
}

Ce qui précède est classé par ordre de priorité décroissant : /model dans la session > --model au démarrage > variable d'environnement ANTHROPIC_MODEL > fichier de paramètres. Une habitude pratique : fixez sonnet dans settings.json pour un usage quotidien, et lorsque vous rencontrez un problème d'architecture complexe, tapez manuellement /model opus dans le dialogue pour l'activer temporairement, ce qui permet d'économiser votre quota.

Concernant les détails du niveau d'effort (/effort, qui contrôle la profondeur de réflexion) et de opusplan, nous ne les détaillerons pas ici - bien choisir le modèle est suffisant pour un débutant. Pour approfondir, consultez la documentation officielle « Configuration du modèle ».

💡 En un mot : Problèmes difficiles opus, quotidien sonnet, corvées haiku ; default suit votre niveau d'abonnement, Pro par défaut sur Sonnet, Max par défaut sur Opus.

---

06 Pratique : 3 minutes pour confirmer « qui j'utilise »

Lire sans pratiquer ne sert à rien. Exécutez cet ensemble de commandes une fois et vous comprendrez parfaitement votre identité et le modèle actuel. Toutes les manipulations se font dans le terminal, puis dans l'interface de Claude Code, sans dépendre d'un environnement complexe.

Première étape : Entrez dans Claude Code. Dans n'importe quel répertoire, tapez :

claude

Deuxième étape : Vérifiez le statut actuel. Dans la boîte de dialogue de Claude Code, tapez :

/status

Il affichera les informations de votre compte et la méthode d'authentification / modèle actuellement actifs. Vous devriez voir quelque chose comme ça (les champs exacts varient selon la version, fiez-vous à l'affichage réel) :

Account: votre@email.com (Max)
Auth: Claude subscription (OAuth)
Model: opus (Opus 4.8)

Si l'élément Auth affiche une clé API alors que vous pensiez utiliser votre abonnement - félicitations, vous venez de tomber sur le piège mentionné au début.

Troisième étape : Voir les modèles disponibles / Changer de modèle. Tapez :

/model

Le sélecteur de modèle apparaîtra, listant les options telles que opus / sonnet / haiku, choisissez avec les flèches haut/bas et validez avec Entrée. Pour changer directement, tapez :

/model sonnet

Quatrième étape (optionnelle) : Vérifier la priorité « Abonnement vs Clé API ». Cette étape vous permet de voir de vos propres yeux la règle de la section 04. Quittez d'abord Claude Code, puis dans le terminal :

# Regardez si une clé API est présente dans l'environnement et "écrase" silencieusement votre abonnement
echo $ANTHROPIC_API_KEY

• S'il affiche une chaîne de caractères sk-ant-... : Cela signifie qu'il écrase votre abonnement. Si vous voulez repasser à l'abonnement, utilisez unset ANTHROPIC_API_KEY, puis relancez claude et vérifiez avec /status, la valeur de Auth devrait redevenir la connexion par abonnement.
• Si la sortie est vide : Vous utilisez déjà votre abonnement (ou un autre identifiant prioritaire), c'est bon.

Pour vérifier les variables d'environnement sur Windows (PowerShell) :

echo $env:ANTHROPIC_API_KEY

Critère de validation : Vous pouvez dire en un coup d'œil en utilisant /status : « J'utilise un abonnement ou une clé API, et je fais tourner tel modèle », et vous pouvez utiliser unset + revérification pour repasser manuellement à l'abonnement. Si vous réussissez cela, l'objectif principal de cet article est atteint.

---

07 Résumé

Cet article a clarifié une chose : Quelle identité Claude Code utilise-t-il pour se connecter au modèle, comment choisir cette identité et comment basculer entre elles.

Votre situation	Comment configurer	Modèle par défaut
Pro / Max personnel	Lancer claude → Navigateur /login	Pro→Sonnet, Max→Opus
Script / CI / Équipe facturée à l'usage	Obtenir une clé depuis la Console → Configurer ANTHROPIC_API_KEY	Selon les paramètres spécifiques
Vous voulez repasser à l'abonnement	unset ANTHROPIC_API_KEY + revérifier avec /status	—

Les trois points les plus importants à retenir :

• L'abonnement a la priorité la plus basse, toute clé API ou jeton dans l'environnement l'écrasera - si vous êtes facturé de manière inattendue, vérifiez d'abord cela.
• /status est votre miroir révélateur : si vous ne savez pas qui vous utilisez, tapez-le.
• Choisissez le modèle selon la tâche : problèmes difficiles opus, quotidien sonnet, default suit le niveau d'abonnement.

Vous devriez maintenant être capable de : vous connecter correctement après l'installation, comprendre quelle identité et quel modèle vous utilisez, basculer entre l'abonnement et la clé API, et ne plus jamais vous faire piéger par « j'étais connecté avec un abonnement mais on me facture l'API ».

Aperçu du prochain article

Jusqu'à présent, vous avez été connecté au modèle officiel de Claude. Mais en Chine, l'API officielle de Claude n'est pas très pratique. Peut-on utiliser des modèles nationaux (chinois) comme DeepSeek, Qwen ou GLM avec Claude Code ?

Oui. Le secret se cache dans une variable d'environnement qui est souvent apparue mais n'a pas été expliquée : ANTHROPIC_BASE_URL. Elle ne change pas « quel modèle est utilisé », mais seulement « vers où la requête est envoyée ». Dans le prochain article 05 · Intégrer des modèles tiers / nationaux, nous l'utiliserons pour connecter Claude Code aux grands modèles nationaux (chinois), ce qui permet d'économiser de l'argent et d'éviter l'utilisation d'un VPN.

Une petite question à laquelle réfléchir : puisque la clé API écrase l'abonnement, si je configure ANTHROPIC_BASE_URL vers une plateforme nationale et que je fournis la clé API correspondante, est-ce que Claude Code ne va pas changer de « cœur » ? Réponse dans le prochain article.

---

Après avoir connecté le modèle officiel sur la « voie principale », le prochain article nous emmènera sur la « voie alternative » des modèles nationaux.

---

Lectures recommandées

• MCP : Connecter Claude au monde extérieur
• Contrôle et Modes : Votre « table de mixage » lors de l'ouverture d'une session
• Manuel de référence des plugins : Empaquetez votre propre configuration pour la partager