Comprendere la priorità di autenticazione in Claude Code
Quando si utilizza Claude Code, è importante comprendere come vengono assegnate le priorità ai metodi di autenticazione per evitare addebiti API imprevisti e assicurarsi di utilizzare l'account desiderato.
Importante: Se sul sistema è impostata una variabile d'ambiente ANTHROPIC_API_KEY, Claude Code utilizzerà questa chiave API per l'autenticazione invece dell'abbonamento Claude.ai (Pro, Max, Team o Enterprise), con conseguenti addebiti per l'utilizzo dell'API anziché l'utilizzo dell'uso incluso nell'abbonamento.
Come funziona l'autenticazione
Claude Code dà priorità alle chiavi API delle variabili d'ambiente rispetto agli abbonamenti autenticati.
Si tratta di un comportamento intenzionale progettato per offrire flessibilità nella scelta del metodo di autenticazione.
Quando una chiave API è impostata come variabile d'ambiente, verranno addebitati i costi tramite le tariffe pay-as-you-go dell'API utilizzando l'account API associato a quella chiave.
Ciò accade anche se si è effettuato l'accesso a Claude Code con un abbonamento claude.ai o un account Console diverso.
Best practice
Per utilizzare Claude Code con l'abbonamento Claude: Mantenere la variabile d'ambiente ANTHROPIC_API_KEY non impostata.
Ciò impedisce addebiti API imprevisti e garantisce l'utilizzo dell'uso incluso nell'abbonamento.
Se è necessario utilizzare occasionalmente una chiave API specifica, impostarla temporaneamente solo quando necessario.
Eseguire periodicamente /status in Claude Code per verificare il metodo di autenticazione corrente.
Avvisi di conflitto di autenticazione
Claude Code invierà una notifica quando si verifica un conflitto tra l'abbonamento autenticato e una chiave API della variabile d'ambiente:
Durante la configurazione iniziale, se viene rilevata una chiave API nelle variabili d'ambiente, Claude Code chiederà di confermare quale metodo di autenticazione si desidera utilizzare
Dopo l'accesso riuscito, verrà visualizzata una notifica se entrambe le credenziali sono attive, avvisando della possibilità di addebiti API imprevisti
Verifica della configurazione corrente
Per verificare se una chiave API è impostata come variabile d'ambiente, eseguire /status in Claude Code. Questo mostrerà quale metodo di autenticazione è attualmente attivo.
Per controllare direttamente la variabile d'ambiente, eseguire 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 temporanea di una chiave API
Se è necessario utilizzare una chiave API solo per la sessione del terminale corrente:
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 d'ambiente per la 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:
Aprire Proprietà del sistema → Avanzate → Variabili d'ambiente
In "Variabili utente", fare clic su "Nuova"
Nome variabile: ANTHROPIC_API_KEY
Valore variabile: your-api-key-here
Fare clic su OK e riavviare il terminale
Rimozione di una variabile d'ambiente per la 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): Eliminare la variabile dalle impostazioni delle Variabili d'ambiente di sistema.
Problemi comuni da evitare
Impostare variabili d'ambiente nei file di configurazione della shell e dimenticarsene.
Non riavviare il terminale dopo aver modificato le variabili d'ambiente.
Presumere di utilizzare l'abbonamento quando è configurata una chiave API nell'ambiente.
Per qualsiasi domanda, contattare il team di supporto prodotto.