Source: https://aiprimetech.io/it/learn/claude-code-api/

[Home](/it/) / [Impara](/it/learn/) / L'API di Claude Code, spiegata 

# 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. 

Copia

```
# 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 

 Posso usare Claude Code con la mia chiave API?

Sì. Imposta ANTHROPIC_API_KEY (o ANTHROPIC_AUTH_TOKEN) e, facoltativamente, ANTHROPIC_BASE_URL nell'ambiente o in ~/.claude/settings.json, quindi avvia claude. I costi verranno addebitati a quella chiave anziché a un abbonamento. Claude Code ha una propria API?

No: utilizza l'API Messages standard di Anthropic. Qualsiasi servizio che utilizzi quel formato, inclusi i gateway compatibili con Anthropic, può servire Claude Code. Perché Claude Code ignora il mio abbonamento e addebita i costi alla mia chiave API?

Se ANTHROPIC_API_KEY è impostata nella shell, ha la precedenza sull'autenticazione tramite abbonamento. Rimuovi la variabile per usare il tuo piano Pro/Max. Posso indirizzare Claude Code verso un endpoint diverso?

Sì, tramite ANTHROPIC_BASE_URL. È così che gateway, proxy e configurazioni di instradamento aziendali funzionano con Claude Code senza modificarlo.  

Inizia a usare Claude in pochi minuti

Ottieni una chiave API: non servono un account Anthropic né una lista d'attesa.[Ottieni la tua chiave API](/register) 

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.    

## Altre guide all'API di Claude

[Come ottenere una chiave API di Claude](/it/learn/how-to-get-a-claude-api-key/)[I prezzi dell'API Claude, spiegati](/it/learn/claude-api-pricing-explained/)[Il modo più economico per usare l'API Claude](/it/learn/cheapest-way-to-use-claude-api/)[Cursor illimitato con l'API Claude](/it/learn/unlimited-cursor-claude-api/)[Accesso illimitato a Claude Code](/it/learn/use-claude-api-with-claude-code/)[Gateway API Claude e accesso diretto ad Anthropic a confronto](/it/learn/claude-api-vs-anthropic-direct/)[Usare Claude tramite un'API compatibile con OpenAI](/it/learn/openai-compatible-claude-api/)[Modelli Claude a confronto](/it/learn/claude-api-models-compared/)[Pagare l'API Claude con criptovalute](/it/learn/claude-api-with-crypto-payment/)[Accesso all'API Claude senza lista d'attesa](/it/learn/claude-api-without-waitlist/)[Come ridurre l'utilizzo dei token di Claude](/it/learn/how-to-reduce-claude-token-usage/)[Cline illimitato con l'API Claude](/it/learn/use-claude-api-with-cline/)[Roo Code illimitato con l'API Claude](/it/learn/use-claude-api-with-roo-code/)[Claude illimitato negli IDE JetBrains](/it/learn/use-claude-api-with-jetbrains/)[Aider senza limiti con l'API di Claude](/it/learn/use-claude-api-with-aider/)[Claude illimitato in VS Code](/it/learn/use-claude-api-with-vscode/)[OpenCode senza limiti con l'API di Claude](/it/learn/use-claude-api-with-opencode/)[Eseguire un agente Hermes senza limiti su Claude](/it/learn/run-hermes-agent-with-claude-api/)[Eseguire OpenClaw senza limiti con Claude](/it/learn/run-openclaw-with-claude-api/)[Cosa significa un'API compatibile con Anthropic](/it/learn/anthropic-compatible-api/)[Chiave API di Claude Code: come ottenerla e configurarla](/it/learn/claude-code-api-key-setup/)[Costi dell'API di Claude Code — Prezzi e come ridurli](/it/learn/claude-code-api-costs/)[Errori dell'API di Claude: limiti di frequenza e soluzioni per 400, 500, 529](/it/learn/claude-api-errors-troubleshooting/)[Come acquistare crediti per l'API di Claude](/it/learn/buy-claude-api-credits/)[Prova gratuita dell'API di Claude: cosa è davvero gratuito e cosa no](/it/learn/claude-api-free-trial/)[API Claude e abbonamento Claude Pro/Max a confronto — Quale scegliere](/it/learn/claude-api-vs-subscription/)[Eseguire la CLI di Codex su Claude](/it/learn/use-claude-api-with-codex/)[Collegare Claude a n8n](/it/learn/use-claude-api-with-n8n/)[Instradare LiteLLM verso Claude](/it/learn/use-claude-api-with-litellm/)[Usare Claude in Kilo Code](/it/learn/use-claude-api-with-kilo-code/)[Integrare Claude in GitHub Copilot](/it/learn/use-claude-api-with-github-copilot/)[Collega Zed a Claude tramite il gateway](/it/learn/use-claude-api-with-zed/)[Collega Cherry Studio a Claude](/it/learn/use-claude-api-with-cherry-studio/)[Configurare LangChain per usare Claude sul gateway](/it/learn/use-claude-api-with-langchain/)[Esegui Factory Droid con Claude](/it/learn/use-claude-api-with-factory-droid/)[Integrare l'API di Claude nella tua applicazione](/it/learn/claude-api-integration/)