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 hiérarchisées pour éviter les frais API inattendus et vous assurer que vous utilisez 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 d'utiliser l'utilisation incluse dans votre abonnement.
Fonctionnement de l'authentification
Claude Code donne la priorité aux clés API des variables d'environnement par rapport aux abonnements authentifiés.
C'est un comportement intentionnel conçu pour vous donner de la flexibilité dans le choix de votre méthode d'authentification.
Lorsqu'une clé API est définie comme variable d'environnement, vous êtes 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 : Gardez la variable d'environnement ANTHROPIC_API_KEY non définie.
Cela évite les frais API inattendus et vous assure d'utiliser l'utilisation incluse dans votre abonnement.
Si vous devez utiliser une clé API spécifique occasionnellement, définissez-la temporairement uniquement si 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 notifiera en cas de 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 la méthode d'authentification que 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 API inattendus
Vérification de 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 votre variable d'environnement directement, 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éfinition temporaire d'une clé API
Si vous devez utiliser une clé API pour la session de terminal actuelle uniquement :
macOS/Linux :
export ANTHROPIC_API_KEY='your-api-key-here'
Windows CMD :
set ANTHROPIC_API_KEY=your-api-key-here
Windows PowerShell :
$env:ANTHROPIC_API_KEY="your-api-key-here"
Définition permanente d'une variable d'environnement de clé API
macOS/Linux :
Pour zsh (par défaut sur macOS) :
bash
# Ajouter au fichier de configuration du shell
echo 'export ANTHROPIC_API_KEY="your-api-key-here"' >> ~/.zshrc
# Appliquer les modifications
source ~/.zshrc
Pour bash :
bash
# Ajouter au fichier de configuration du shell
echo 'export ANTHROPIC_API_KEY="your-api-key-here"' >> ~/.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 : your-api-key-here
Cliquez sur OK et redémarrez votre terminal
Suppression d'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 d'assistance produit