L'API di Claude Code spiegata

Claude Code è un agente da terminale, ma dietro le quinte ogni azione è una chiamata alla stessa API Messages di Anthropic che puoi utilizzare direttamente. Questo ha una conseguenza utile: controlli l'endpoint con cui comunica, la chiave su cui vengono addebitati i costi e, quindi, il costo di una sessione. Questa pagina spiega i vari componenti e rimanda alle guide di configurazione dettagliate.

Cosa significa davvero “API di Claude Code”

Non esiste un prodotto separato chiamato API di Claude Code. Claude Code si autentica tramite un abbonamento Claude (Pro/Max) oppure tramite una chiave API e, in modalità API, invia richieste standard all'API Messages, contenenti prompt di sistema, conversazione, definizioni degli strumenti e risultati degli strumenti, all'endpoint indicato dal suo ambiente.

L'endpoint è configurabile. Due variabili d'ambiente controllano tutto: ANTHROPIC_BASE_URL (dove vengono inviate le richieste) e ANTHROPIC_AUTH_TOKEN o ANTHROPIC_API_KEY (quale account paga). Configurale per usare direttamente Anthropic oppure un gateway compatibile con Anthropic: Claude Code si comporta allo stesso modo.

Usare la propria chiave API con Claude Code

Imposta le due variabili nel profilo della shell o in ~/.claude/settings.json e avvia claude come di consueto. La procedura completa, con esempi di settings.json, è disponibile nella nostra <a href="/it/learn/claude-code-api-key-setup/">guida alla configurazione della chiave API di Claude Code</a>.

Un dettaglio da conoscere: se ANTHROPIC_API_KEY è impostata nella shell, Claude Code fattura alle tariffe API anche se hai un abbonamento; la variabile d'ambiente ha la precedenza. Rimuovila se intendi usare il tuo piano Pro/Max.

Quanto costa una sessione di Claude Code

Le sessioni con agenti consumano molti token: ogni file letto, risultato degli strumenti e diff entra nel contesto. Un'ora di lavoro intenso può consumare milioni di token di input, ed è per questo che la memorizzazione dei prompt nella cache è così importante: sugli endpoint che la supportano, il contesto ripetuto viene riletto dalla cache a una frazione del prezzo.

Analizziamo i costi reali per sessione, il comportamento della cache e come mantenere accessibili le sessioni lunghe nella <a href="/it/learn/claude-code-api-costs/">guida ai costi dell'API di Claude Code</a>.

Anthropic diretto o un gateway

L'accesso diretto all'API di Anthropic offre fatturazione a consumo e supporto del fornitore: una scelta predefinita adatta ai team con budget stabili. Gateway indipendenti come AI Prime Tech (non affiliata ad Anthropic né da essa approvata) rivendono l'accesso a tariffe fisse o scontate e utilizzano lo stesso formato di comunicazione, quindi Claude Code funziona cambiando soltanto l'URL di base e la chiave.

Qualunque soluzione tu scelga, verifica che lo streaming funzioni lungo l'intero percorso e che i modelli necessari siano disponibili con gli esatti ID richiesti da Claude Code. Consulta <a href="/it/learn/use-claude-api-with-claude-code/">usare l'API di Claude con Claude Code</a> per l'elenco completo delle verifiche.

# Claude Code with your own key + custom endpoint
export ANTHROPIC_BASE_URL="https://aiprimetech.io"
export ANTHROPIC_AUTH_TOKEN="sk-your-key"
claude

# or persist in ~/.claude/settings.json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://aiprimetech.io",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-key"
  }
}

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.