Source: https://aiprimetech.io/it/learn/claude-api-integration/
[Home](/it/) / [Impara](/it/learn/) / Integrare l'API Claude nella tua applicazione
# Integrare l'API di Claude nella tua applicazione
L'integrazione dell'API Claude è semplice il primo giorno: l'installazione di un SDK e una chiamata autenticata. Ma la preparazione per la produzione dipende dagli elementi che circondano quella chiamata: streaming, nuovi tentativi, budget di token e osservabilità. Questa guida copre l'intero percorso, con codice funzionante che puoi adattare direttamente.
## Autenticazione e prima richiesta
Installa l'SDK ufficiale (pip install anthropic oppure npm install @anthropic-ai/sdk), imposta la chiave in una variabile d'ambiente, mai nel codice sorgente, ed esegui una chiamata alla Messages API per verificare il funzionamento della pipeline. L'API è versionata tramite un header anthropic-version che gli SDK impostano automaticamente.
Le chiavi funzionano allo stesso modo, sia che provengano dalla Anthropic Console sia da un gateway compatibile con Anthropic come AI Prime Tech (un servizio indipendente, non affiliato ad Anthropic): l'unica differenza è il base_url con cui viene creato il client.
## Scegliere i modelli in base all'attività
Le integrazioni che fissano un unico modello nel codice spendono troppo o offrono prestazioni insufficienti. Instrada le richieste in base all'attività: Haiku 4.5 per classificazione, estrazione e instradamento; Sonnet 4.6 per la maggior parte delle funzionalità di prodotto e la programmazione; Opus 4.8 quando la profondità del ragionamento è il valore del prodotto; Fable 5 quando serve la finestra di contesto da 1M. Il confronto completo è disponibile in Modelli Claude a confronto.
Rendi il modello un valore di configurazione, non una costante: i nomi dei modelli cambiano ogni pochi mesi e vorrai eseguire test A/B sulle nuove versioni senza effettuare un deploy.
## Streaming, timeout e tentativi successivi
Usa lo streaming per tutto ciò che una persona visualizza: gli eventi inviati dal server trasmettono i token man mano che vengono generati, riducendo la latenza percepita da molti secondi a meno di un secondo. Anche le chiamate senza streaming con valori elevati di max_tokens hanno maggiori probabilità di incorrere nei timeout di lettura del proxy: una categoria di bug che emerge solo in produzione.
Riprova le richieste con risposte 429 e 5xx usando un backoff esponenziale con jitter, rispetta gli header retry-after quando presenti e limita il numero totale di tentativi. Considera gli errori 400 come permanenti: il payload stesso è errato (spesso l'input è troppo grande; vedi Errori della Claude API) e riprovare consuma soltanto la quota.
## Checklist per la produzione
Prima del lancio: applica limiti ai token sia in ingresso sia in uscita; registra il costo di ogni richiesta (i dati di utilizzo vengono restituiti in ogni risposta); abilita la cache dei prompt per i prompt di sistema ripetuti; prevedi un modello o un endpoint di riserva per gli incidenti; ed esegui una revisione dei rischi di prompt injection se l'input dell'utente raggiunge il prompt.
La maggior parte delle difficoltà di integrazione non deriva dall'API stessa, ma dalla crescita illimitata del contesto e dalla mancanza di osservabilità. Registra i token in ingresso e in uscita fin dal primo giorno e le sorprese sui costi scompariranno.
Copia
```
import os, anthropic
client = anthropic.Anthropic(
api_key=os.environ["ANTHROPIC_API_KEY"],
base_url=os.environ.get("ANTHROPIC_BASE_URL", "https://aiprimetech.io"),
)
with client.messages.stream(
model="claude-sonnet-4-6",
max_tokens=1024,
messages=[{"role": "user", "content": "Summarize our launch plan in 3 bullets."}],
) as stream:
for text in stream.text_stream:
print(text, end="", flush=True)
```
## Domande frequenti
Come integro la Claude API nella mia app?
Installa l'SDK anthropic per Python o TypeScript, imposta la chiave API in una variabile d'ambiente e chiama la Messages API. Aggiungi lo streaming, la logica per i tentativi successivi e i limiti ai token prima di gestire traffico di produzione. Esiste un SDK ufficiale per Claude?
Sì: Anthropic fornisce SDK ufficiali per Python e TypeScript, oltre a SDK della community per altri linguaggi. Tutti utilizzano la stessa Messages API. Posso usare il formato dell'SDK OpenAI con Claude?
Diversi gateway espongono Claude tramite un endpoint compatibile con OpenAI, consentendo al codice esistente in formato OpenAI di funzionare con i modelli Claude cambiando l'URL di base. L'accesso diretto ad Anthropic usa il formato Anthropic. Quanto costa utilizzare un'integrazione con la Claude API?
Il costo è dato dall'utilizzo dei token moltiplicato per il prezzo del modello. Instrada le attività semplici verso Haiku 4.5, memorizza nella cache i prefissi dei prompt ripetuti e limita max_tokens: insieme, queste misure riducono in genere la spesa di ben oltre la metà rispetto a un'integrazione elementare.
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/)[L'API di Claude Code spiegata](/it/learn/claude-code-api/)