Abbonamento Claude o fatturazione API in Claude Code
Claude Code può usare un abbonamento Claude o la fatturazione API. Con un abbonamento (Pro, Max, Team o Enterprise), l’utilizzo è incluso fino ai limiti del tuo piano. Con una chiave API paghi per token, senza limite del piano. Se ANTHROPIC_API_KEY è impostata e approvata, Claude Code la usa al posto del tuo abbonamento.
Disponibile anche in: English · Español · Deutsch · Français · 日本語 · 简体中文 · Português (Brasil) · 한국어 · Nederlands · 繁體中文
Una guida di Switch, un gestore indipendente di profili Claude Desktop. Switch è in accesso anticipato in vista della sua uscita pubblica.
Due modi di pagare Claude Code
Accesso con abbonamento. Accedi con il tuo account claude.ai. Claude Code è incluso in tutti i piani a pagamento e ne condivide i limiti: un limite di sessione che si azzera ogni cinque ore e un limite settimanale. A ottobre 2026, Pro costa 20 US$ al mese e Max 100 US$ o 200 US$ al mese (claude.com/pricing).
Fatturazione API. Usi un account Claude Console, una chiave API o un provider cloud. L’utilizzo è a consumo per token, fatturato a quell’account, senza un blocco netto (Models, usage, and limits in Claude Code). I prezzi API variano in base al modello e si pagano per milione di token in input e in output; vedi la pagina dei prezzi di Anthropic per le tariffe attuali.
Quale fa per te
Un abbonamento dà un costo mensile prevedibile. Il compromesso è che ti fermi, o passi a crediti a pagamento, quando raggiungi un limite. La fatturazione API è a consumo, quindi il costo dipende da quanto usi, anche se gli account API hanno limiti di frequenza e gli amministratori possono impostare limiti di spesa per un workspace.
Per darti un’idea delle dimensioni, la pagina sui costi di Anthropic dice che, nei deployment aziendali, la media è di circa 13 US$ per sviluppatore per giorno attivo e da 150 a 250 US$ per sviluppatore al mese, con il 90% degli utenti sotto i 30 US$ per giorno attivo. I tuoi numeri dipendono dalla scelta del modello, dalle dimensioni del codebase e dalle tue abitudini.
Un abbonamento è adatto a un uso quotidiano costante, quando conta avere una spesa prevedibile. Anthropic suggerisce anche un account Console con crediti API per sprint di programmazione intensi.
Come capire quale è attivo
Esegui /status in Claude Code. La documentazione sull’autenticazione di Anthropic dice che conferma quale metodo è attivo e, quando sono configurati sia un accesso sia una chiave API, segnala quello non in uso.
Altri indizi: con un abbonamento /usage mostra le barre di utilizzo del piano, mentre con la fatturazione API il suo blocco Session mostra un costo stimato in dollari. Gli utenti API possono anche eseguire /cost per vedere la spesa progressiva.
ANTHROPIC_API_KEY ha la precedenza sul tuo abbonamento
È la causa più comune di addebiti imprevisti. Nella precedenza di autenticazione di Claude Code, una variabile d’ambiente ANTHROPIC_API_KEY viene prima dell’accesso con abbonamento. In modalità interattiva Claude Code chiede una volta se usare la chiave e ricorda la tua scelta; in modalità non interattiva (-p) usa sempre la chiave. Il centro assistenza di Anthropic avverte che questo comporta addebiti API invece dell’utilizzo incluso nel tuo piano.
Per tornare al tuo abbonamento:
unset ANTHROPIC_API_KEYPoi rimuovi dal profilo della shell la riga che la imposta, riavvia Claude Code e controlla /status. Finché la variabile è impostata, puoi anche cambiare la scelta fatta in precedenza con l’opzione "Use custom API key" in /config. Claude Desktop non legge questa variabile; accede con OAuth.
Restare solo sul tuo piano
Quando raggiungi un limite con un abbonamento, Claude Code può proporti di continuare con crediti API. Anthropic dice che puoi rifiutare e aspettare il reset. Per non far più comparire l’opzione, esci, accedi di nuovo solo con le credenziali Pro o Max e non aggiungere credenziali Console (Use Claude Code with your Pro or Max plan). La ricarica automatica dei crediti API è un’impostazione della Console, quindi controllala lì se in passato hai usato la fatturazione API.
Se hai un account di lavoro fatturato in un modo e un piano personale fatturato in un altro, dai a ciascuno il proprio CLAUDE_CONFIG_DIR, così gli accessi non si mescolano. Vedi più account Claude Code su un Mac, oppure Switch per Claude Code se usi Claude Code dentro Claude Desktop.