L’attuale generazione di Anthropic è la famiglia Claude 5. Al momento della scrittura (ottobre 2026) comprende Claude Fable 5.1, il modello più capace ampiamente disponibile, oltre a Claude Opus 5.5, Claude Sonnet 5.5 e Claude Haiku 5.5. Tutti usano la stessa Messages API, quindi passare dall’uno all’altro significa quasi sempre cambiare un identificatore. La gamma cambia in fretta: considera la tabella un’istantanea e verifica prezzi e ID nella documentazione ufficiale prima di fissare un budget.
La gamma attuale
| Modello | ID API | Input / output, $ per 1 M di token | Ideale per |
|---|---|---|---|
| Claude Fable 5.1 | claude-fable-5-1 | $10 / $50 | Ragionamento più difficile e lavoro autonomo lungo |
| Claude Opus 5.5 | claude-opus-5-5 | $4 / $20 | Scelta predefinita per funzioni di prodotto e codice |
| Claude Sonnet 5.5 | claude-sonnet-5-5 | $2 / $10 | Codice quotidiano veloce, agenti, enterprise |
| Claude Haiku 5.5 | claude-haiku-5-5 | $0.10 / $0.50 | Passaggi di massa economici |
La mia scelta predefinita per funzioni di prodotto e coding agentico è Claude Opus 5.5: è l’Opus attuale, più economico del predecessore e abbastanza forte per la maggior parte dei compiti reali. Claude Sonnet 5.5 serve per velocità e volume: assistenza quotidiana al codice, agenti di supporto, processi aziendali. Claude Haiku 5.5 si adatta a classificazione, instradamento, estrazione e altri passaggi di massa economici. Claude Fable 5.1 giustifica il prezzo più alto solo per il ragionamento più difficile e il lavoro autonomo prolungato. Un schema comune: un modello forte pianifica, uno più economico esegue i tanti piccoli passaggi. Misura sui tuoi dati: il modello giusto è il più economico che supera il tuo set di valutazione.
Cosa è cambiato nell’API
Il codice scritto per i vecchi modelli Claude può rompersi con i nuovi. Il prefill dell’assistente è stato rimosso: controlla il formato con output strutturati o istruzioni chiare. I parametri di campionamento come temperature e top_p vengono rifiutati sulla maggior parte dei modelli più recenti. Su Opus 5.5 il ragionamento non si può disattivare, quindi gestisci costo e latenza con il parametro effort, ricordando che Opus 5.5 usa medium per impostazione predefinita, non high. Forzare uno strumento specifico con tool_choice viene rifiutato: usa auto con un’istruzione chiara e schemi di strumenti rigorosi. Infine, i classificatori di sicurezza possono chiudere una risposta con il motivo refusal: controlla sempre stop_reason prima di leggere il contenuto e decidi cosa fa il tuo prodotto in quel caso.
Creare e proteggere una chiave API
Una chiave API è una password legata a un account di fatturazione: chi la possiede può spendere i tuoi soldi e leggere ciò che contengono i tuoi prompt. Crea le chiavi nella Console Anthropic, dai a ogni ambiente o progetto una chiave propria in un workspace separato, nominale in modo chiaro e imposta limiti di spesa, così una fuga o un ciclo fuori controllo hanno un tetto. Una chiave per servizio significa anche poterne revocare una senza fermare tutto.
La chiave deve stare solo sul server. Mai nel codice del browser, nel bundle di un’app mobile, in un repository pubblico o in una variabile con prefisso pubblico come NEXT_PUBLIC_. In Next.js chiama Claude da un route handler o da una server action, leggi la chiave dall’ambiente e lascia che il frontend parli con il tuo endpoint, che verifica l’utente, applica limiti di frequenza e limita la dimensione della richiesta. L’SDK ufficiale legge ANTHROPIC_API_KEY dall’ambiente in automatico, quindi il client si crea senza chiave nel codice sorgente.
In locale tieni la chiave in un file .env.local ignorato da git e committa solo un .env.example con valori vuoti. In produzione usa il secret store del tuo hosting o cloud, non un file dentro l’immagine. Tieni le chiavi fuori da log, report di errore e screenshot e attiva la scansione dei segreti nel repository. Se una chiave trapela, revocala subito e creane una nuova: cancellare il commit non basta. In locale puoi accedere con la CLI di Anthropic invece di gestire a mano una chiave, e per i carichi cloud la workload identity federation elimina del tutto le chiavi di lunga durata.
Una prima richiesta sensata
Inizia con una chiamata lato server: ID del modello, un max_tokens generoso e streaming per gli output lunghi, per evitare timeout. Leggi i campi usage della risposta per vedere il costo di ogni chiamata e aggiungi il prompt caching se reinvii lo stesso lungo prompt di sistema o gli stessi documenti: la lettura dalla cache costa una frazione dell’input normale. Gestisci gli errori tipizzati, perché limiti e sovraccarichi sono normali e l’SDK ritenta già alcune richieste. Registra token e costo per funzione dal primo giorno, così il conto non sorprende mai.
Se vuoi integrare Claude nel tuo prodotto, con gestione delle chiavi, valutazione e controllo dei costi fatti bene, mandami il compito e il vincolo principale.
Dai al prossimo prodotto qualcuno che resti.
Pronto a iniziare? Scrivimi: posso cominciare subito e restare. Collaborazioni a lungo termine, non passaggi di consegne dopo due settimane. Parliamo del progetto, dei requisiti e del modo migliore per procedere.