Guide & Tutorial

API Claude: chiave, prezzi con Haiku 5.5 e prima chiamata

Chiave API Claude in 5 passi, prezzi aggiornati con Haiku 5.5 e Sonnet 5.5, crediti API di Max, Ultra e Team, codice in curl, Python e Node ed errori da conoscere.

Cosmin-Anton Mihoc
10 min di lettura
API Claude: chiave, prezzi con Haiku 5.5 e prima chiamata
Indice dei contenuti (11 sezioni)

Per usare l'API Claude ti servono quattro cose: un account sulla Claude Console (platform.claude.com), un po' di credito, una chiave che inizia con sk-ant- e una richiesta all'endpoint /v1/messages.

L'abbonamento Pro non include l'API: si paga a parte, a consumo, per milione di token. Dal 7 ottobre 2026 i piani Max, Ultra e Team danno però un credito API mensile, che ti spiego più sotto. Prezzi e regole sono aggiornati al 4 novembre 2026.

In questa guida ti mostro i passaggi che seguo quando collego Claude al gestionale o al sito di un cliente: come ottenere la chiave, quanto costa davvero una chiamata, il primo codice funzionante e gli errori che ti faranno perdere tempo se non li conosci.

Cosa sono le API Claude

Le API Claude sono il modo per far usare i modelli di Anthropic a un tuo programma, invece di scrivere a mano nella chat. Il tuo codice manda un testo (o un'immagine, un PDF) e riceve la risposta in formato JSON.

Con l'API Claude puoi costruire, per esempio:

  • chatbot e assistenti sul sito o su WhatsApp, con le tue regole;
  • estrazione di dati da email, fatture, contratti e moduli;
  • riassunti e bozze di risposta dentro il CRM o il gestionale;
  • agenti AI che chiamano le funzioni della tua applicazione.

API Claude e abbonamento sono due cose diverse

È il dubbio più comune. Claude.ai con i piani Free, Pro, Max, Ultra, Team ed Enterprise è il prodotto per le persone. La Claude Console è il prodotto per gli sviluppatori.

L'API Claude resta un conto separato dall'abbonamento. L'unica eccezione, dal 7 ottobre 2026, è il credito API mensile incluso in alcuni piani: 100 $ con Max, 200 $ con Ultra (il piano che prima si chiamava Max 20x), 20 $ per ogni postazione Standard e 100 $ per ogni Premium del piano Team, fino a 500 $ per team. Free, Pro ed Enterprise non lo hanno.

Il credito si riscatta da claude.ai, in Impostazioni e Fatturazione, collegando un'organizzazione della Claude Console; chi si è appena abbonato può farlo dopo 7 giorni sul piano. Copre API, Managed Agents e Agent SDK, non Claude Code, e scade a fine ciclo: quello che non usi non passa al mese dopo.

Se ti interessa solo quanto costano i piani mensili, trovi tutto nella mia guida ai prezzi di Claude per Pro, Max, Ultra e Team. Qui resto sulla parte per chi sviluppa.

Come ottenere la chiave API Claude in 5 passi

La procedura richiede pochi minuti. Ecco i passaggi dalla documentazione ufficiale, nell'ordine in cui li faccio io.

  1. Crea l'account sulla Claude Console. Vai su platform.claude.com e registrati, oppure accedi se hai già un account.
  2. Aggiungi la fatturazione. Nella sezione dedicata alla fatturazione inserisci il metodo di pagamento e compri crediti. Sulla piattaforma diretta si paga con l'acquisto di crediti Anthropic.
  3. Apri la pagina delle chiavi. Vai in Settings, poi API keys.
  4. Crea la chiave. Premi Create key, dai un nome, scegli la scadenza e a chi è collegata (te stesso o un service account). Puoi limitarla a un workspace.
  5. Copiala subito. La Console mostra la chiave completa una sola volta, al momento della creazione. Salvala in un gestore di segreti.

Dove trovo la chiave API Claude se l'ho persa?

Non puoi rivederla. Se perdi una chiave, la Console non te la mostra più: ne crei una nuova, aggiorni il tuo codice e revochi quella vecchia.

Per questo do sempre un nome chiaro a ogni chiave, tipo "sito-produzione" o "test-locale".

Quanto costa l'API Claude

L'API Claude si paga per token: i token in ingresso (quello che mandi) costano meno di quelli in uscita (quello che Claude scrive).

Questi sono i prezzi del listino ufficiale per i modelli principali, per milione di token, aggiornati al 4 novembre 2026.

ModelloInputOutputLettura cache
Claude Fable 5.110 $50 $0,25 $
Claude Opus 5.54 $20 $0,20 $
Claude Sonnet 5.52 $10 $0,10 $
Claude Haiku 5.5 (prompt fino a 100.000 token)0,10 $0,50 $0,01 $
Claude Haiku 5.5 (prompt oltre 100.000 token)0,50 $2,50 $0,05 $
Claude Haiku 4.51 $5 $0,10 $

Un esempio di conto reale

Prendo una richiesta tipica di un chatbot: 1.000 token di domanda e contesto, 500 token di risposta, con Sonnet 5.5. Il calcolo è semplice:

  • input: 1.000 token per 2 $ al milione = 0,002 $;
  • output: 500 token per 10 $ al milione = 0,005 $;
  • totale: circa 0,007 $ a richiesta, quindi circa 7 $ ogni mille richieste.

La stessa richiesta con Haiku 5.5 costa 0,0001 $ di input più 0,00025 $ di output: circa 0,35 $ ogni mille richieste, venti volte meno. Il limite da conoscere è la soglia dei 100.000 token di prompt: sopra, Haiku 5.5 costa cinque volte tanto. Prezzi, test e casi d'uso li trovi nella mia guida a Claude Haiku 5.5.

Due leve abbassano il conto. La Batch API dimezza il prezzo di input e output per i lavori che non servono subito.

Il prompt caching fa pagare pochissimo le parti del prompt che si ripetono: ne ho parlato nella guida al prompt caching per ridurre i costi API.

L'API Claude è gratis?

No, ma all'inizio qualcosa c'è. Anthropic dichiara che i nuovi utenti ricevono una piccola quantità di crediti gratuiti per provare l'API Claude.

Bastano per i primi test, non per un progetto vero. Se cerchi strade alternative per programmare senza spendere, ho raccolto quelle che funzionano in Claude Code gratis: 5 modi.

Se hai già un piano Max, Ultra o Team, controlla il credito API mensile incluso dal 7 ottobre 2026: con Max sono 100 $ al mese, abbastanza per prototipi e piccoli progetti interni. Lo trovi nella Console, alla voce Promotional credits della fatturazione, e viene speso prima del credito che compri.

La prima chiamata all'API Claude

Prima di tutto salva la chiave come variabile d'ambiente. Il nome standard è ANTHROPIC_API_KEY: gli SDK ufficiali la leggono da soli.

export ANTHROPIC_API_KEY="sk-ant-..."

Con curl

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2026-10-21" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "max_tokens": 500,
    "messages": [
      {"role": "user", "content": "Riassumi in tre righe cosa fa un CRM."}
    ]
  }'

Con Python

pip install anthropic
import anthropic

client = anthropic.Anthropic()  # legge ANTHROPIC_API_KEY

message = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=500,
    messages=[{"role": "user", "content": "Riassumi in tre righe cosa fa un CRM."}],
)

for block in message.content:
    if block.type == "text":
        print(block.text)

Con Node.js o TypeScript

npm install @anthropic-ai/sdk
import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic(); // legge ANTHROPIC_API_KEY

const message = await client.messages.create({
  model: "claude-sonnet-5-5",
  max_tokens: 500,
  messages: [{ role: "user", content: "Riassumi in tre righe cosa fa un CRM." }],
});

console.log(message.content);

Dal 21 ottobre 2026 c'è una nuova versione dell'API, 2026-10-21, quella che uso nell'esempio con curl. Le nuove versioni maggiori degli SDK la mandano di default, per esempio Python 2.0.0 e TypeScript 1.0.0. La differenza che si nota subito: con questa versione temperature, top_p e top_k restituiscono un errore 400, anche se passi il valore predefinito. Se un vecchio script li usa, toglili oppure lascia quella chiamata sulla versione 2023-06-01.

Gli SDK ufficiali esistono anche per C#, Go, Java, PHP e Ruby. Il campo max_tokens è un tetto, non un obiettivo: impostalo su quanto serve davvero alla funzione.

Quale modello scegliere

La regola che uso: parto dal modello più piccolo che fa bene il lavoro e salgo solo se i test lo chiedono. Tengo sempre l'ID del modello in configurazione, così lo cambio senza toccare il codice.

  • Claude Haiku 5.5 (claude-haiku-5-5): classificazioni, smistamento di email, riassunti e risposte brevi ad alto volume. Se migri da Haiku 4.5, togli temperature, top_p, top_k e il prefill della risposta: su Haiku 5.5 possono dare errore 400. Haiku 4.5 (claude-haiku-4-5-20251001) funziona ancora, ma per i progetti nuovi parto da Haiku 5.5.
  • Claude Sonnet 5.5 (claude-sonnet-5-5): il punto di partenza per chatbot, estrazione dati e riassunti. Ne ho parlato in Claude Sonnet 5.5: quando preferirlo a Opus.
  • Claude Opus 5.5 (claude-opus-5-5): agenti che lavorano a lungo, codice complesso, ragionamenti su più passaggi. Prezzi e limiti nella guida a Claude Opus 5.5.

Opus 5.5, Sonnet 5.5 e Haiku 5.5 hanno una finestra di contesto da 1 milione di token. Su Opus e Sonnet il prezzo per token è lo stesso a qualsiasi lunghezza, su Haiku 5.5 no: oltre i 100.000 token di prompt scatta la tariffa più alta.

Se hai ancora codice su Claude Sonnet 4.5, pianifica ora il passaggio: è deprecato dal 30 settembre e verrà ritirato dall'API il 30 novembre 2026. Il sostituto indicato è Sonnet 5.5.

Limiti e tier dell'API Claude

Ogni organizzazione ha un limite di richieste e di token al minuto, più un tetto di spesa mensile legato al tier. Il passaggio al tier successivo avviene in automatico, in base allo storico di utilizzo.

TierTetto di spesa mensile
Start500 $
Build1.000 $
Scale200.000 $
Customnessun tetto

I limiti del tuo account li vedi nella Console, nella pagina Rate limits, dove puoi anche chiedere un aumento.

Ti consiglio di impostare subito un limite di spesa tuo, più basso del tetto: un ciclo sbagliato in un agente può bruciare crediti in pochi minuti.

Gli errori più comuni dell'API Claude

Quando "la chiave non funziona", di solito la risposta è in uno di questi codici.

  • 401 authentication_error: chiave sbagliata, scaduta o revocata. Controlla che la variabile d'ambiente sia davvero caricata.
  • 400 invalid_request_error: richiesta malformata, ma arriva anche quando raggiungi il limite di spesa che hai impostato.
  • 402 billing_error: problema con il pagamento o i crediti.
  • 429 rate_limit_error: troppe richieste o tetto mensile raggiunto. Rispetta l'header retry-after; se è il tetto di spesa, quell'header non c'è e l'errore resta fino al mese successivo o al cambio di tier.
  • 529 overloaded_error: API sovraccarica per tutti. Riprova con attese crescenti.

Come proteggere la chiave API Claude

Una chiave rubata è credito che paghi tu. Le regole che applico su ogni progetto:

  • mai nel frontend: il browser chiama il tuo server, il server chiama Claude;
  • mai nel repository: la chiave sta in variabili d'ambiente o in un gestore di segreti;
  • una chiave per ambiente: test e produzione separati, così ne revochi una senza fermare l'altra;
  • scadenza e workspace: usa la scadenza alla creazione e limita la chiave al workspace del progetto.

Il tema è serio: nel threat report di Anthropic sulle API key le chiavi rubate sono descritte come il nuovo bottino dei criminali.

Usare l'API Claude con Claude Code e altri strumenti

La stessa chiave funziona anche fuori dal tuo codice. Claude Code accetta una chiave API al posto dell'abbonamento: paghi a consumo invece che a forfait. Trovi i passaggi nella guida per installare Claude Code.

Se la tua azienda lavora già su un cloud, Claude è disponibile anche tramite Amazon Bedrock, Claude Platform on AWS, Google Cloud e Microsoft Foundry. In quel caso la fatturazione passa dal tuo fornitore cloud.

API Claude in azienda: cosa controllare prima

Collegare l'API Claude a un sito è facile. Farlo bene in un'azienda richiede qualche decisione in più:

  • dati personali: se mandi a Claude nomi, email o documenti dei clienti, serve una base giuridica GDPR e l'informativa aggiornata;
  • controllo dei costi: limite per utente, log dei token di ogni risposta, avvisi quando la spesa sale;
  • qualità: un prompt di sistema con le regole, test su casi reali e una risposta di riserva quando l'API non risponde.

Italia e Romania sono tra i paesi in cui l'API Claude è supportata.

Se vuoi un'integrazione già pronta per il tuo gestionale o il tuo sito, guarda come lavoro sull'automazione AI per le aziende oppure scrivimi: ti rispondo io.

Leggi anche

Condividi questo articolo
Hai domande? Contattami

Pronto a dare vita al tuo progetto?

Contattami per discutere della tua idea e ricevere una consulenza gratuita.

Iniziamo insieme