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.
Come funziona l'autenticazione
Claude Code dà priorità alle chiavi API delle variabili di ambiente rispetto agli abbonamenti autenticati.
Questo è un comportamento intenzionale progettato per offrirti flessibilità nella scelta del metodo di autenticazione.
Quando una chiave API è impostata come variabile di ambiente, ti verrà addebitato tramite tariffe API pay-as-you-go utilizzando l'account API associato a quella chiave.
Questo accade anche se sei connesso a Claude Code con un abbonamento claude.ai o un account Console diverso.
Best practice
Per utilizzare Claude Code con il tuo abbonamento 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 nel tuo abbonamento.
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 il tuo abbonamento autenticato 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 l'accesso riuscito, vedrai una notifica se entrambe le credenziali sono attive, avvisandoti del potenziale per addebiti API inaspettati.
Verifica della 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 terminale
Rimozione di una variabile di ambiente della chiave API
macOS/Linux (temporanea):
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 stai utilizzando il tuo abbonamento quando una chiave API è configurata nel tuo ambiente.
Se hai domande, contatta il nostro team di supporto.