Come collegare le API di Claude
ai tuoi strumenti

Come si paga

A consumo,
per "token"

A differenza di un abbonamento mensile, l'API si paga a consumo. L'unità di misura è il token: un pezzetto di testo, in media circa 0,75 parole in inglese (in italiano un po' di più, perché le parole sono più lunghe). Si pagano separatamente i token in ingresso (quello che mandate: prompt, documenti, contesto) e quelli in uscita (la risposta del modello). I prezzi si esprimono per milione di token (MTok).

A giugno 2026 la gamma è composta da tre modelli, dal più economico al più potente. I prezzi base per milione di token sono:

Per capire l'ordine di grandezza: riassumere un documento di poche pagine e ricevere una risposta breve consuma tipicamente qualche migliaio di token. Con Haiku, parliamo di frazioni di centesimo a richiesta. È per questo che, nelle PMI, il costo dei modelli è quasi sempre la voce minore rispetto al tempo delle persone.

Consiglio: partite da Haiku 4.5 per provare e per i volumi alti, passate a Sonnet 4.6 quando la qualità non basta, tenete Opus 4.8 per i casi davvero complessi. Si cambia modello cambiando una riga.

Passo 2

La prima
chiamata

Tutto passa da un solo "indirizzo": l'endpoint dei messaggi, a cui si invia una richiesta con la chiave, la versione, il modello scelto e il messaggio. Ecco la versione più essenziale possibile, con curl (lo strumento da riga di comando che c'è quasi ovunque):

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: LA_TUA_CHIAVE" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-haiku-4-5",
    "max_tokens": 300,
    "messages": [
      {"role": "user", "content": "Riassumi in tre punti questo testo: ..."}
    ]
  }'

I pezzi da capire sono pochi: model sceglie quale modello usare; max_tokens mette un tetto alla lunghezza della risposta (e quindi alla spesa); messages è la conversazione, dove role: "user" è quello che dite voi. La risposta che torna contiene il testo del modello e un riepilogo dei token consumati.

Lo stesso, da uno script (esempio in C#)

In un contesto .NET — un gestionale, un servizio interno — la chiamata è una normale richiesta HTTP:

using var http = new HttpClient();
http.DefaultRequestHeaders.Add("x-api-key",
    Environment.GetEnvironmentVariable("ANTHROPIC_API_KEY"));
http.DefaultRequestHeaders.Add("anthropic-version", "2023-06-01");

var payload = new {
    model = "claude-sonnet-4-6",
    max_tokens = 500,
    messages = new[] {
        new { role = "user", content = "Estrai data e importo da questo testo: ..." }
    }
};

var resp = await http.PostAsJsonAsync(
    "https://api.anthropic.com/v1/messages", payload);
var json = await resp.Content.ReadAsStringAsync();

Lo stesso schema vale in Python, JavaScript o qualsiasi linguaggio: esistono anche librerie ufficiali (SDK) che evitano di scrivere la richiesta a mano, ma il concetto sotto è sempre questo.

Quando i volumi crescono

Tre cose
che fanno risparmiare

• Batch (lavori in differita). Se non vi serve la risposta all'istante, l'elaborazione a lotti costa la metà sia in ingresso sia in uscita. Perfetta per elaborare archivi di documenti durante la notte.
• Prompt caching. Se ripetete sempre lo stesso contesto lungo (le stesse istruzioni, lo stesso manuale), potete "metterlo in cache": le riletture successive costano circa un decimo. Conviene quando lo stesso testo lungo torna in molte richieste.
• Scegliere il modello giusto. Non tutto merita il modello più potente. Spesso Haiku fa benissimo l'80% del lavoro a un quinto del costo di Opus.

In sintesi

Una chiave dalla console, una richiesta HTTP all'endpoint dei messaggi, un modello scelto in base a costo e qualità. Da lì, collegate l'API dove i dati già passano — un foglio, un gestionale, uno script — e tenete sempre un tetto di spesa. I prezzi e i nomi dei modelli cambiano: per i valori del momento, la fonte di verità è la pagina prezzi ufficiale su claude.com/pricing e la documentazione su docs.claude.com.

FAQ

Domande
frequenti

Posso provare l'API di Claude senza pagare?

Sì. I nuovi account su platform.claude.com ricevono un piccolo credito gratuito per fare le prime prove, senza inserire una carta di credito. Sufficiente per validare un caso d'uso su qualche centinaio di richieste con i modelli economici.

Che differenza c'è tra usare l'API e usare claude.ai dall'app?

L'intelligenza sottostante è la stessa, cambia l'interfaccia. Sull'app c'è una chat con una persona che scrive e legge. Con l'API è il vostro software a inviare la domanda e ricevere la risposta — utile per integrare il modello in fogli di calcolo, gestionali o script automatici.

Cosa succede se supero il limite di spesa che ho impostato?

Le richieste vengono semplicemente bloccate fino al mese successivo o finché non alzate il tetto. È esattamente la rete di sicurezza che vi serve contro errori che fanno girare richieste a vuoto. Impostatelo subito, prima ancora di scrivere la prima riga di codice.

Posso usare l'API con dati riservati dei miei clienti?

Sì, ma con accortezze: usate i piani business/API (non i piani consumer gratuiti), firmate il DPA con Anthropic prima di trattare dati personali, valutate l'opzione di erogazione tramite cloud "vostro" (AWS Bedrock, Google Vertex) con residenza UE per i dati più sensibili. Vedere anche la guida su privacy e sicurezza.

I prezzi e i nomi dei modelli cambiano spesso?

I prezzi tendono a scendere nel tempo (più capacità per lo stesso costo), e nuovi modelli escono ogni pochi mesi. La fonte di verità per i valori del momento è la pagina prezzi ufficiale su claude.com/pricing. Costruite il vostro codice in modo da poter cambiare il modello con una riga.