Comprendere la priorità di autenticazione in Claude Code
Quando si utilizza Claude Code, è importante comprendere come vengono prioritizzati i metodi di autenticazione per evitare addebiti API inaspettati e assicurarsi di utilizzare l'account desiderato.
Importante: Se hai una variabile di ambiente ANTHROPIC_API_KEY impostata sul tuo sistema, Claude Code utilizzerà questa chiave API per l'autenticazione invece della tua sottoscrizione Claude.ai (Pro, Max, Team o Enterprise), generando addebiti per l'utilizzo dell'API anziché utilizzare l'utilizzo incluso nella tua sottoscrizione.
Come funziona l'autenticazione
Claude Code prioritizza le chiavi API delle variabili di ambiente rispetto alle sottoscrizioni autenticate.
Questo è un comportamento intenzionale progettato per darti flessibilità nella scelta del tuo metodo di autenticazione.
Quando una chiave API è impostata come variabile di ambiente, ti verrà addebitato secondo le tariffe API pay-as-you-go utilizzando l'account API associato a quella chiave.
Questo accade anche se sei connesso a Claude Code con una sottoscrizione claude.ai o un account Console diverso.
Best practice
Per utilizzare Claude Code con la tua sottoscrizione Claude: Mantieni la variabile di ambiente ANTHROPIC_API_KEY non impostata.
Questo previene addebiti API inaspettati e assicura che tu stia utilizzando l'utilizzo incluso nella tua sottoscrizione.
Se hai bisogno di utilizzare una chiave API specifica occasionalmente, impostala temporaneamente solo quando necessario.
Esegui /status in Claude Code periodicamente per verificare il tuo metodo di autenticazione attuale.
Avvisi di conflitto di autenticazione
Claude Code ti notificherà quando c'è un conflitto tra la tua sottoscrizione autenticata e una chiave API della variabile di ambiente:
Durante la configurazione iniziale, se una chiave API viene rilevata nelle tue variabili di ambiente, Claude Code ti chiederà di confermare quale metodo di autenticazione desideri utilizzare
Dopo il login riuscito, vedrai una notifica se entrambe le credenziali sono attive, avvisandoti del potenziale per addebiti API inaspettati
Verifica della tua configurazione attuale
Per verificare se una chiave API è impostata come variabile di ambiente, esegui /status in Claude Code. Questo ti mostrerà quale metodo di autenticazione è attualmente attivo.
Per controllare la tua variabile di ambiente direttamente, esegui uno di questi comandi in un terminale (al di fuori di Claude Code):
macOS/Linux:
echo $ANTHROPIC_API_KEY
Windows CMD:
echo %ANTHROPIC_API_KEY%
Windows PowerShell:
echo $env:ANTHROPIC_API_KEY
Impostazione di una chiave API temporaneamente
Se hai bisogno di utilizzare una chiave API solo per la sessione di terminale attuale:
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"
Impostazione permanente di una variabile di ambiente della chiave API
macOS/Linux:
Per zsh (predefinito su macOS):
bash
# Aggiungi al file di configurazione della shell
echo 'export ANTHROPIC_API_KEY="your-api-key-here"' >> ~/.zshrc
# Applica le modifiche
source ~/.zshrc
Per bash:
bash
# Aggiungi al file di configurazione della shell
echo 'export ANTHROPIC_API_KEY="your-api-key-here"' >> ~/.bash_profile
# Applica le modifiche
source ~/.bash_profile
Windows:
Apri Proprietà del sistema → Avanzate → Variabili di ambiente
In "Variabili utente", fai clic su "Nuova"
Nome variabile: ANTHROPIC_API_KEY
Valore variabile: your-api-key-here
Fai clic su OK e riavvia il tuo terminale
Rimozione di una variabile di ambiente della chiave API
macOS/Linux (temporaneo):
unset ANTHROPIC_API_KEY
macOS (permanente):
# Rimuovi dal file di configurazione
sed -i '' '/ANTHROPIC_API_KEY/d' ~/.zshrc
source ~/.zshrc
Linux (permanente)
sed -i '/ANTHROPIC_API_KEY/d' ~/.zshrc
Windows CMD:
set ANTHROPIC_API_KEY=
Windows PowerShell:
Remove-Item Env:ANTHROPIC_API_KEY
Windows (permanente): Elimina la variabile dalle impostazioni delle variabili di ambiente di sistema.
Problemi comuni da evitare
Impostazione di variabili di ambiente nei file di configurazione della shell e dimenticanza di esse.
Mancato riavvio del terminale dopo la modifica delle variabili di ambiente.
Presupporre che tu stia utilizzando la tua sottoscrizione quando una chiave API è configurata nel tuo ambiente.
Se hai domande, contatta il nostro team di supporto prodotto.