Comprendre la priorité d'authentification dans Claude Code
Lors de l'utilisation de Claude Code, il est important de comprendre comment les méthodes d'authentification sont priorisées pour éviter des frais d'API inattendus et vous assurer d'utiliser le compte prévu.
Important : Si vous avez une variable d'environnement ANTHROPIC_API_KEY définie sur votre système, Claude Code utilisera cette clé API pour l'authentification au lieu de votre abonnement Claude.ai (Pro, Max, Team ou Enterprise), ce qui entraînera des frais d'utilisation de l'API plutôt que l'utilisation de l'usage inclus dans votre abonnement.
Comment fonctionne l'authentification
Claude Code donne la priorité aux clés API des variables d'environnement par rapport aux abonnements authentifiés.
Il s'agit d'un comportement intentionnel conçu pour vous offrir une flexibilité dans le choix de votre méthode d'authentification.
Lorsqu'une clé API est définie comme variable d'environnement, vous serez facturé selon les tarifs de paiement à l'utilisation de l'API en utilisant le compte API associé à cette clé.
Cela se produit même si vous êtes connecté à Claude Code avec un abonnement claude.ai ou un compte Console différent.
Bonnes pratiques
Pour utiliser Claude Code avec votre abonnement Claude : Laissez la variable d'environnement ANTHROPIC_API_KEY non définie.
Cela évite les frais d'API inattendus et garantit que vous utilisez l'usage inclus dans votre abonnement.
Si vous devez utiliser une clé API spécifique occasionnellement, définissez-la temporairement uniquement lorsque nécessaire.
Exécutez /status dans Claude Code périodiquement pour vérifier votre méthode d'authentification actuelle.
Avertissements de conflit d'authentification
Claude Code vous avertira lorsqu'il y a un conflit entre votre abonnement authentifié et une clé API de variable d'environnement :
Lors de la configuration initiale, si une clé API est détectée dans vos variables d'environnement, Claude Code vous demandera de confirmer quelle méthode d'authentification vous souhaitez utiliser
Après une connexion réussie, vous verrez une notification si les deux identifiants sont actifs, vous alertant du risque de frais d'API inattendus
Vérifier votre configuration actuelle
Pour vérifier si une clé API est définie comme variable d'environnement, exécutez /status dans Claude Code. Cela vous montrera quelle méthode d'authentification est actuellement active.
Pour vérifier directement votre variable d'environnement, exécutez l'une de ces commandes dans un terminal (en dehors de Claude Code) :
macOS/Linux :
echo $ANTHROPIC_API_KEY
Windows CMD :
echo %ANTHROPIC_API_KEY%
Windows PowerShell :
echo $env:ANTHROPIC_API_KEY
Définir une clé API temporairement
Si vous devez utiliser une clé API uniquement pour la session de terminal actuelle :
macOS/Linux :
export ANTHROPIC_API_KEY='votre-clé-api-ici'
Windows CMD :
set ANTHROPIC_API_KEY=votre-clé-api-ici
Windows PowerShell :
$env:ANTHROPIC_API_KEY="votre-clé-api-ici"
Définir une variable d'environnement de clé API de manière permanente
macOS/Linux :
Pour zsh (par défaut sur macOS) :
bash
# Ajouter au fichier de configuration du shell
echo 'export ANTHROPIC_API_KEY="votre-clé-api-ici"' >> ~/.zshrc
# Appliquer les modifications
source ~/.zshrc
Pour bash :
bash
# Ajouter au fichier de configuration du shell
echo 'export ANTHROPIC_API_KEY="votre-clé-api-ici"' >> ~/.bash_profile
# Appliquer les modifications
source ~/.bash_profile
Windows :
Ouvrez Propriétés système → Avancé → Variables d'environnement
Sous « Variables utilisateur », cliquez sur « Nouveau »
Nom de la variable : ANTHROPIC_API_KEY
Valeur de la variable : votre-clé-api-ici
Cliquez sur OK et redémarrez votre terminal
Supprimer une variable d'environnement de clé API
macOS/Linux (temporaire) :
unset ANTHROPIC_API_KEY
macOS (permanent) :
# Supprimer du fichier de configuration
sed -i '' '/ANTHROPIC_API_KEY/d' ~/.zshrc
source ~/.zshrc
Linux (permanent)
sed -i '/ANTHROPIC_API_KEY/d' ~/.zshrc
Windows CMD :
set ANTHROPIC_API_KEY=
Windows PowerShell :
Remove-Item Env:ANTHROPIC_API_KEY
Windows (permanent) : Supprimez la variable des paramètres des variables d'environnement système.
Problèmes courants à éviter
Définir des variables d'environnement dans les fichiers de configuration du shell et les oublier.
Ne pas redémarrer votre terminal après avoir modifié les variables d'environnement.
Supposer que vous utilisez votre abonnement alors qu'une clé API est configurée dans votre environnement.
Si vous avez des questions, veuillez contacter notre équipe de support produit.