Accesso illimitato a Claude Code

Claude Code è l'agente ufficiale da riga di comando di Anthropic per lo sviluppo software. Opera con una finestra di contesto di 200k, avvia sottoagenti con contesti indipendenti, legge file interi inserendoli nella cronologia della conversazione e reinvia il contesto completo a ogni turno, causando una crescita quadratica dei token nelle sessioni lunghe. Questo lo rende uno degli strumenti per sviluppatori con il maggior consumo di token. Collegare Claude Code a un gateway illimitato a tariffa fissa lo trasforma da uno strumento da usare con parsimonia a un vero partner di sviluppo sempre disponibile.

Perché il consumo di token di Claude Code cresce in modo quadratico

Dal punto di vista dell'API, Claude Code non mantiene lo stato tra un turno e l'altro. Ogni messaggio che invii include l'intera cronologia della conversazione: tutti i messaggi precedenti, tutti i contenuti dei file letti, tutti i risultati degli strumenti e tutte le risposte dell'assistente. Il primo messaggio potrebbe contenere 5,000 token. Al decimo scambio, stai inviando 50,000 token di cronologia più tutti i nuovi contenuti aggiunti. Al ventesimo scambio, il contesto può superare 150,000 token per richiesta.

I sottoagenti aggravano questa situazione. Quando Claude Code delega un'attività a un sottoagente, quest'ultimo riceve una propria finestra di contesto e inizia ad accumulare autonomamente la propria cronologia. Il contesto dell'agente principale cresce per includere il riepilogo del sottoagente, mentre il sottoagente stesso genera costi per i propri token. I team di agenti, in cui collaborano più sottoagenti, moltiplicano ulteriormente questo consumo. Un'attività complessa potrebbe coinvolgere un agente principale e tre sottoagenti, ciascuno con oltre 100k token di contesto, tutti operativi con la stessa chiave API.

Il comando /compact aiuta riassumendo la cronologia e troncando il contesto precedente, ma è un intervento manuale che sacrifica dettagli per recuperare spazio. Con la fatturazione per token, gli utenti ricorrono continuamente alla compattazione per controllare i costi. Con un piano illimitato, puoi lasciare che le conversazioni crescano naturalmente, compattarle solo quando la qualità del contesto peggiora e usare liberamente i sottoagenti senza dover calcolare mentalmente quanto costano.

Configurazione delle variabili d'ambiente

Claude Code legge la propria configurazione API dalle variabili d'ambiente. Le due variabili essenziali sono ANTHROPIC_BASE_URL e una tra ANTHROPIC_API_KEY e ANTHROPIC_AUTH_TOKEN. Imposta ANTHROPIC_BASE_URL su https://unlimited.aiprimetech.io, ovvero l'host di base senza /v1, perché l'SDK di Anthropic aggiunge automaticamente il percorso API. Per la chiave, usa ANTHROPIC_API_KEY se il gateway richiede l'autenticazione tramite l'header x-api-key, il formato standard di Anthropic.

Imposta queste variabili nel profilo della shell (.bashrc, .zshrc o $PROFILE di PowerShell) per rendere persistente la configurazione. Su Windows puoi anche impostarle come variabili d'ambiente di sistema tramite la finestra Impostazioni di sistema avanzate. Claude Code le legge all'avvio: se le modifichi, riavvia la sessione di Claude Code affinché i nuovi valori abbiano effetto.

Per applicare configurazioni specifiche a ciascun progetto, crea un file .env nella directory radice del progetto. Claude Code carica i file .env dalla directory di lavoro. Questo ti permette di usare configurazioni API diverse per ogni progetto, utile se alcuni progetti usano un piano illimitato e altri la fatturazione diretta di Anthropic. Il file .env ha la precedenza sulle variabili d'ambiente di sistema.

Mappatura dei modelli per Sonnet, Opus, Haiku e Fable

Claude Code usa alias interni dei modelli che puoi sovrascrivere tramite variabili d'ambiente. ANTHROPIC_DEFAULT_SONNET_MODEL determina quale modello viene usato per la selezione predefinita 'sonnet'. ANTHROPIC_DEFAULT_OPUS_MODEL sovrascrive la scelta 'opus'. ANTHROPIC_DEFAULT_HAIKU_MODEL e ANTHROPIC_DEFAULT_FABLE_MODEL controllano i livelli rimanenti. Imposta queste variabili sugli ID esatti dei modelli supportati dal tuo gateway.

Ad esempio, imposta ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-4-5 e ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-4-6.. Quando selezioni un livello di modello in Claude Code usando /model o il flag di avvio, viene utilizzato il modello che hai associato. Questo è particolarmente utile se il gateway espone identificatori di modello personalizzati o se vuoi fissare versioni specifiche dei modelli.

Con un piano illimitato, la scelta del modello dipende esclusivamente dal compromesso tra qualità e velocità. Non ci sono differenze di costo tra i livelli. Usa Opus come modello predefinito per ottenere la massima qualità e passa a Sonnet o Haiku solo quando ti servono risposte più rapide durante cicli di iterazione veloci. Il comando /effort regola ulteriormente il livello di approfondimento con cui Claude Code affronta ogni attività: combina un livello di impegno elevato con Opus per ottenere la configurazione più capace.

Sottoagenti, team di agenti e agenti in background

Claude Code può avviare sottoagenti: istanze indipendenti di Claude con proprie finestre di contesto che gestiscono sottoattività delegate. Quando l'agente principale incontra un'attività complessa, può delegare ricerca, implementazione o verifica a sottoagenti che lavorano in isolamento e riferiscono i risultati. Ogni sottoagente parte con un contesto nuovo e accumula la propria cronologia della conversazione.

I team di agenti estendono questo concetto consentendo a più sottoagenti di collaborare simultaneamente su attività correlate. L'agente principale funge da coordinatore, distribuendo il lavoro e sintetizzando i risultati. Questo è estremamente efficace per modifiche su larga scala: un sottoagente può eseguire il refactoring del modulo A mentre un altro si occupa del modulo B, ma il consumo dell'API cresce linearmente con il numero di agenti attivi.

Gli agenti in background vengono eseguiti in modo asincrono mentre continui a lavorare nella sessione principale. Operano su attività separate e comunicano i risultati una volta completate. Con la fatturazione per token, eseguire più agenti in background contemporaneamente diventa rapidamente costoso. Con un piano illimitato, puoi avviare diversi agenti in background, lasciarli lavorare su aspetti diversi del progetto ed esaminarne i risultati quando sono pronti: tutto è incluso nella tariffa fissa.

Imposta CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 per impedire a Claude Code di inviare telemetria e richieste non essenziali. È una buona pratica su qualsiasi gateway personalizzato per ridurre il rumore. Inoltre, CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1 indica a Claude Code di interrogare il gateway per conoscere i modelli disponibili anziché usare elenchi predefiniti nel codice.

Modalità senza interfaccia e integrazione CI/CD

La modalità senza interfaccia di Claude Code (flag --headless) funziona senza richieste interattive, rendendola adatta a pipeline CI/CD, revisione automatizzata del codice ed elaborazione in batch. In questa modalità, Claude Code legge l'input da stdin o dagli argomenti della riga di comando e scrive i risultati su stdout. Termina quando l'attività è completata, anziché attendere ulteriori input.

Per l'integrazione CI, imposta le variabili d'ambiente nella configurazione della pipeline (segreti di GitHub Actions, variabili di GitLab CI, credenziali di Jenkins) e invoca Claude Code passando la descrizione dell'attività come argomento. I casi d'uso CI più comuni includono la revisione automatizzata delle PR, la generazione di documentazione, la scrittura di test e gli script di migrazione.

Con un piano illimitato, la modalità senza interfaccia consente flussi di lavoro ad alto volume. Puoi eseguire Claude Code su ogni PR di un repository, generare in batch suite di test per moduli privi di test o automatizzare gli aggiornamenti della documentazione a ogni rilascio, senza preoccuparti del costo di ogni invocazione. La tariffa fissa copre l'intero volume, purché rimanga entro i limiti di frequenza previsti dalla politica di utilizzo corretto.

Memoria del progetto con CLAUDE.md e hook

I file CLAUDE.md forniscono un contesto persistente del progetto che Claude Code carica automaticamente. Inserisci un file CLAUDE.md nella directory radice del progetto con standard di codifica, decisioni architetturali, schemi comuni e istruzioni specifiche del progetto. Questo contenuto viene incluso nel prompt di sistema di ogni richiesta, aggiungendo token a ogni chiamata ma migliorando notevolmente la qualità e la coerenza delle risposte.

Con la fatturazione per token, gli utenti mantengono CLAUDE.md essenziale per controllare i costi: ogni parola aggiunge token a ogni singola richiesta per tutta la durata della sessione. Con un piano illimitato, scrivi tutto il contesto che è davvero utile: documentazione architetturale dettagliata, guide di stile complete, spiegazioni delle dipendenze e convenzioni del team. I token aggiuntivi per richiesta non comportano costi extra e il miglioramento della qualità si accumula a ogni interazione.

Gli hook consentono di eseguire script personalizzati in punti specifici dell'esecuzione di Claude Code: prima e dopo le chiamate agli strumenti, all'avvio della sessione e durante la compattazione. Usa gli hook per inserire contesto dinamico, convalidare le modifiche tramite CI, formattare automaticamente il codice o attivare notifiche. Gli hook si integrano perfettamente con il gateway illimitato, poiché operano a livello di CLI anziché a livello di API.

Risoluzione dei problemi del gateway con Claude Code

Se Claude Code non riesce a connettersi, verifica che ANTHROPIC_BASE_URL sia impostata sull'host di base senza /v1. Esegui echo $ANTHROPIC_BASE_URL (oppure $env:ANTHROPIC_BASE_URL in PowerShell) per confermare il valore. L'SDK aggiunge automaticamente /v1/messages: se includi /v1 nell'URL di base, le richieste vengono inviate a /v1/v1/messages, che restituisce un 404.

Gli errori di modello non trovato indicano che l'ID del modello nella variabile di mappatura non corrisponde a quello fornito dal gateway. Controlla gli identificatori esatti supportati nella dashboard di AI Prime Tech e aggiorna ANTHROPIC_DEFAULT_SONNET_MODEL di conseguenza. Ricorda che gli ID dei modelli distinguono tra maiuscole e minuscole e includono suffissi di versione.

Se le sessioni funzionano ma i sottoagenti no, il problema potrebbe essere che i sottoagenti ereditano le variabili d'ambiente in modo diverso a seconda di come vengono avviati. Assicurati che le variabili d'ambiente siano impostate a livello di sistema anziché soltanto nella sessione shell corrente, soprattutto su Windows, dove i processi figli potrebbero non ereditare le variabili locali della shell.

# Shell environment (add to .bashrc / .zshrc / $PROFILE)
export ANTHROPIC_BASE_URL="https://aiprimetech.io"
export ANTHROPIC_API_KEY="<your AI Prime Tech Unlimited key>"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4-5"
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4-6"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

# Or per-project .env file:
# ANTHROPIC_BASE_URL=https://aiprimetech.io
# ANTHROPIC_API_KEY=sk-...
# ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-4-5

# Run Claude Code:
# claude            (interactive)
# claude --headless (CI/CD mode)

Domande frequenti

AI Prime Tech è un gateway API indipendente. Non è affiliato ad Anthropic, non è approvato da Anthropic e non è un suo rivenditore. Claude e i nomi dei modelli correlati sono marchi dei rispettivi proprietari.