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 hai effettuato l'accesso a Claude Code con un abbonamento claude.ai o un account Console diverso.
Procedure consigliate
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 viene rilevata una chiave API 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 la 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
Imposta una chiave API temporaneamente
Se hai bisogno di utilizzare una chiave API solo per la sessione del 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"
Imposta una variabile di ambiente della chiave API in modo permanente
macOS/Linux:
For zsh (default on macOS):
bash
# Add to shell config file
echo 'export ANTHROPIC_API_KEY="your-api-key-here"' >> ~/.zshrc
# Apply changes
source ~/.zshrc
For bash:
bash
# Add to shell config file
echo 'export ANTHROPIC_API_KEY="your-api-key-here"' >> ~/.bash_profile
# Apply changes
source ~/.bash_profile
Windows:
Apri Proprietà di sistema → Avanzate → Variabili di ambiente
Sotto "Variabili utente", fai clic su "Nuovo"
Nome variabile: ANTHROPIC_API_KEY
Valore variabile: la-tua-chiave-api-qui
Fai clic su OK e riavvia il terminale
Rimuovi una variabile di ambiente della chiave API
macOS/Linux (temporaneo):
unset ANTHROPIC_API_KEY
macOS (permanente):
# Remove from config file
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 il tuo abbonamento quando una chiave API è configurata nel tuo ambiente.
Se hai domande, contatta il nostro team di supporto.