Come utilizzare l'API di Claude Sonnet 5

Risposta rapida

Claude Sonnet 5 API è il nuovo modello della classe Sonnet di Anthropic per agenti di coding, ragionamento su contesti estesi, uso di strumenti e lavoro professionale. Anthropic ha annunciato Claude Sonnet 5 il 30 giugno 2026, presentandolo come il modello Sonnet più “agentic” di sempre e un importante upgrade rispetto a Claude Sonnet 4.6. Gli sviluppatori possono usarlo tramite CometAPI con l’ID modello claude-sonnet-5 via l’endpoint nativo Anthropic Messages POST /v1/messages o l’endpoint compatibile OpenAI POST /v1/chat/completions.

Perché Claude Sonnet 5 è importante ora

Anthropic ha introdotto Claude Sonnet 5 il 30 giugno 2026, puntando direttamente agli sviluppatori che costruiscono sistemi agentici. L’azienda descrive Sonnet 5 come il modello Sonnet più “agentic” finora, con migliori capacità di pianificazione, uso di strumenti, coding, lavoro su browser, lavoro su terminale e ragionamento professionale. Il posizionamento più importante è che Sonnet 5 riduce il divario con Claude Opus 4.8 rimanendo nel tier Sonnet, più veloce e più conveniente.

Questo conta perché il mercato è andato oltre le semplici chat completions. Le applicazioni AI in produzione richiedono sempre più spesso un modello in grado di leggere un contesto ampio, chiamare strumenti, scrivere codice, ispezionare documenti, usare un browser, eseguire comandi su terminale, recuperare da errori e completare workflow multi‑step. I modelli Claude Sonnet sono storicamente popolari per coding e flussi agentici, e Sonnet 5 è costruito proprio per questa categoria.

Il rilascio cambia anche il modo in cui gli sviluppatori dovrebbero pensare al controllo via API. Claude Sonnet 5 usa il ragionamento adattivo di default. I budget manuali per il thinking esteso sono stati rimossi per questo modello, e le note di migrazione di Anthropic indicano che impostazioni di campionamento non predefinite come temperature, top_p e top_k possono restituire un errore 400. In altre parole, migrare da Sonnet 4.6 non è solo sostituire il nome del modello.

Che cos’è la Claude Sonnet 5 API?

La Claude Sonnet 5 API è l’interfaccia programmabile per il modello Sonnet 5 di Anthropic. È progettata per generazione di testo, coding, uso di strumenti, ragionamento su documenti, comprensione di immagini e workflow con contesti molto lunghi. Su CometAPI, l’ID modello è:

claude-sonnet-5

Puoi invocarla in due modi principali:

1. Usa l’endpoint Anthropic Messages di CometAPI quando desideri comportamento nativo di Claude, ragionamento adattivo, controllo dello sforzo, prompt caching, tools, web search, streaming e formati di risposta Anthropic.
2. Usa l’endpoint chat compatibile con OpenAI quando la tua applicazione utilizza già chat completions in stile OpenAI e vuoi semplificare il routing tra famiglie di modelli come Claude, GPT, Gemini e altri.

Per la maggior parte dei team in produzione, l’endpoint nativo Messages è la prima scelta migliore per workflow agentici specifici di Claude. L’endpoint compatibile OpenAI è ideale quando portabilità, confronto tra modelli o minimo lavoro di migrazione contano più dei controlli specifici di Claude.

Specifiche rapide di Claude Sonnet 5

Novità della Claude Sonnet 5 API: innovazioni chiave

Anthropic presenta Sonnet 5 come un upgrade sostanziale rispetto a Sonnet 4.6, concentrato sull’affidabilità agentica nel mondo reale.

1. Nuovo tokenizer ed efficienza dei token

Sonnet 5 utilizza un tokenizer aggiornato (simile a Opus 4.7). Lo stesso testo di input può corrispondere a circa 1,0–1,35× token in più a seconda del contenuto, con una media intorno al 30% in più.

Impatto: il prezzo introduttivo ($2/$10 per milione di token input/output fino al 31 agosto 2026) rende la transizione approssimativamente neutra in termini di costo. Il prezzo standard successivo è $3/$15, in linea con Sonnet 4.6 per token ma potenzialmente più alto per task a causa dell’inflazione di token. Riconta sempre i token con il nuovo modello.

2. Miglioramenti di capacità

Sonnet 5 mostra guadagni sostanziali rispetto a Sonnet 4.6 su benchmark:

• Coding e task agentici: più vicino a Opus 4.8 su valutazioni tipo SWE‑bench, ricerca agentica (BrowseComp) e uso del computer (OSWorld‑Verified).
• Ragionamento e knowledge work: migliore focus sostenuto, auto‑verifica e gestione di codice brownfield o task professionali multi‑step.
• Multimodale e uso di strumenti: chiamata di strumenti in parallelo e capacità di visione più forti.

Le prestazioni scalano con i livelli di sforzo (low/medium/high/xhigh), consentendo trade‑off costo‑prestazioni più fini. A sforzi più alti, eguaglia o si avvicina a Opus su molti task.

I primi feedback degli utenti evidenziano completamento più rapido di task complessi, meno allucinazioni e migliore esecuzione nel mondo reale.

3. Misure di cybersicurezza e sicurezza

• Minori comportamenti indesiderati complessivi rispetto a 4.6.
• Capacità di cyber exploit ridotte rispetto a Opus (0% di exploit completi nei test di vulnerabilità su Firefox).
• Cyber safeguards abilitate di default — rilevamento in tempo reale e blocco di usi pericolosi (come Opus 4.7/4.8, meno rigorose di alcuni modelli superiori).

Questo rende Sonnet 5 più sicuro per agenti in produzione in ambienti sensibili alla sicurezza informatica.

Claude Sonnet 5 è più forte del 4.6 nel ragionamento rilevante per la cyber, ma non è forte quanto Opus 4.8 ed è sostanzialmente sotto Mythos 5 nei task cyber valutati.

La conclusione importante per l’API è che le salvaguardie scalano con la capacità del modello. Anthropic descrive salvaguardie basate su classificatori sul traffico, con categorie come uso proibito, uso a doppio uso ad alto rischio e doppio uso. Gli scambi di uso proibito e doppio uso ad alto rischio sono bloccati di default, mentre le normali attività di sicurezza a doppio uso come il rilevamento di vulnerabilità non sono bloccate di default.

Per i team di sicurezza legittimi, questo significa che Sonnet 5 può essere utile per lavoro difensivo come code review, linee guida per configurazioni sicure, triage delle vulnerabilità, documentazione degli incidenti e pianificazione delle patch.

Ragionamento adattivo in Claude Sonnet 5

Il ragionamento adattivo è uno dei cambiamenti più importanti per gli sviluppatori in Claude Sonnet 5. Invece di chiedere agli sviluppatori di scegliere manualmente un budget di thinking per ogni chiamata, Claude può allocare dinamicamente lo sforzo di ragionamento in base al task.

Il ragionamento adattivo è una delle caratteristiche di spicco di Sonnet 5. Regola dinamicamente la profondità del ragionamento:

• Livelli di sforzo: Low (veloce/economico), Medium, High (analisi più profonda), con opzioni adattive.
• Default: High su API/Claude Code per Sonnet 5.
• Benefici: Bilancia qualità vs costo/latenza. Sforzi più alti eccellono su task complessi ma consumano più token.

Esempio di prompt:

Use adaptive thinking for this task: Quick overview first, then detailed analysis and code if critical issues are found.

Nelle vecchie integrazioni Claude, i team spesso usavano controlli di thinking esteso come:

{
  "thinking": {
    "type": "enabled",
    "budget_tokens": 32000
  }
}

Per Claude Sonnet 5, non inviare quel pattern. Le note di migrazione di Sonnet 5 dicono che i budget manuali di thinking esteso sono rimossi e possono restituire un errore 400. Usa il ragionamento adattivo e i controlli di sforzo al loro posto.

Come funziona il controllo dello sforzo

Il parametro effort offre agli sviluppatori un modo più semplice per influenzare quanto lavoro compie il modello. I livelli di sforzo attuali di Anthropic includono low, medium, high, xhigh e max; high è il default ed è equivalente a omettere il parametro. Una policy pratica in produzione può essere:

Il pattern architetturale è stabile: instrada i task difficili a sforzi più alti e quelli semplici a sforzi più bassi.

Perché usare la Claude Sonnet 5 API con CometAPI?

CometAPI è utile quando i team vogliono un unico layer di integrazione per molte famiglie di modelli. Invece di costruire integrazioni separate per ogni provider, puoi instradare Claude, GPT, Gemini, modelli di immagini, video, embedding e altre API dietro un solo account e un’unica architettura applicativa.

Per Claude Sonnet 5, CometAPI offre tre vantaggi pratici.

Primo, CometAPI espone Claude Sonnet 5 sia tramite l’endpoint nativo Anthropic Messages sia tramite un endpoint compatibile con OpenAI. Questo significa che un team può usare funzionalità native di Claude per workflow agentici seri e, al contempo, testare Sonnet 5 in applicazioni che già usano chat completions in stile OpenAI.

Secondo, il catalogo CometAPI semplifica il confronto tra modelli. Puoi eseguire la stessa suite di prompt contro Sonnet 5, Sonnet 4.6, modelli tier Opus, modelli classe GPT, modelli classe Gemini e modelli specializzati. Questo conta perché il miglior modello per il coding potrebbe non essere il migliore per estrazione documentale, supporto clienti, chat sensibile alla latenza o batch sensibili al costo.

Terzo, CometAPI aiuta con il routing in produzione. Puoi iniziare con Sonnet 5 come modello predefinito per coding e ragionamento agentico, quindi aggiungere regole di fallback per disponibilità, budget, latenza o comportamento di rifiuto. Un sistema AI maturo non dovrebbe essere saldato per sempre a un nome di modello.

Come usare la Claude Sonnet 5 API con CometAPI

Gli esempi seguenti usano codice server‑side. Non esporre mai la tua chiave CometAPI in JavaScript lato browser, app mobile, repository pubblici o log lato client.

Step 1: crea e conserva la tua chiave CometAPI

Conserva la tua chiave API come variabile d’ambiente:

export COMETAPI_KEY="your_cometapi_key"

Su Windows PowerShell:

$env:COMETAPI_KEY="your_cometapi_key"

Step 2: scegli l’endpoint giusto

Usa POST /v1/messages quando vuoi comportamento nativo di Claude:

https://api.cometapi.com/v1/messages

Usa POST /v1/chat/completions quando vuoi chat compatibile OpenAI:

https://api.cometapi.com/v1/chat/completions

Raccomandazione: inizia con /v1/messages per i nuovi sistemi agentici Claude Sonnet 5. Usa /v1/chat/completions quando hai già wrapper SDK OpenAI, router di modelli o strumenti di valutazione multi‑modello basati sulle chat completions.

Step 3: chiama Claude Sonnet 5 con cURL

Questo è l’esempio più semplice con la Messages API nativa:

curl https://api.cometapi.com/v1/messages \  -H "Authorization: Bearer $COMETAPI_KEY" \  -H "Content-Type: application/json" \  -d '{    "model": "claude-sonnet-5",    "max_tokens": 1200,    "messages": [      {        "role": "user",        "content": "Write a concise migration checklist for moving a Node.js API from Express 4 to Express 5."      }    ]  }'

Per Sonnet 5, evita di aggiungere vecchi override di campionamento o budget manuali di thinking a meno che la documentazione corrente non li supporti esplicitamente per la tua rotta. Lascia che il ragionamento adattivo gestisca l’analisi e usa il controllo dello sforzo dove supportato.

Step 4: esempio Python con l’SDK Anthropic

Molti workflow con l’SDK Anthropic possono essere puntati a CometAPI impostando base URL e chiave API.

import osimport anthropic​client = anthropic.Anthropic(    base_url="https://api.cometapi.com",    api_key=os.environ["COMETAPI_KEY"],)​message = client.messages.create(    model="claude-sonnet-5",    max_tokens=1500,    messages=[       {            "role": "user",            "content": (                "Review this deployment plan for a payments API. "                "Return the top risks, missing tests, and rollout checklist."            ),        }    ],)​for block in message.content:    if getattr(block, "type", None) == "text":        print(block.text)

Se la tua rotta CometAPI supporta il controllo dello sforzo con la stessa forma della documentazione corrente di Anthropic, puoi aggiungere un’impostazione di sforzo per lavoro più impegnativo:

message = client.messages.create(    model="claude-sonnet-5",    max_tokens=3000,    thinking={"type": "adaptive"},    output_config={"effort": "high"},    messages=[       {            "role": "user",            "content": "Analyze this incident report and propose a root-cause investigation plan.",        }    ],)

Poiché gli schemi di provider e aggregator possono evolvere, testa i parametri di sforzo in staging prima della produzione. Se una rotta rifiuta output_config, rimuovilo o usa la forma di parametro CometAPI attualmente documentata.

Step 5: esempio di chat completion compatibile OpenAI

Usa questo percorso se la tua applicazione usa già chat completions compatibili con OpenAI.

curl https://api.cometapi.com/v1/chat/completions \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "messages": [
      {
        "role": "system",
        "content": "You are a senior backend engineer. Be precise and practical."
      },
      {
        "role": "user",
        "content": "Design a retry strategy for a webhook delivery service. Include database fields and failure states."
      }
    ],
    "max_completion_tokens": 1800,
    "stream": false
  }'

La rotta compatibile OpenAI è eccellente per la portabilità, ma non dare per scontato che ogni funzionalità nativa di Claude mappi perfettamente sulle chat completions. Per workflow Claude avanzati, preferisci l’endpoint Messages.

Step 6: esempio di streaming

Lo streaming migliora la latenza percepita per chat, assistenti di coding e report lunghi.

const response = await fetch("https://api.cometapi.com/v1/messages", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.COMETAPI_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "claude-sonnet-5",
    max_tokens: 2500,
    stream: true,
    messages: [
      {
        role: "user",
        content": "Write a production runbook for investigating elevated API error rates.",
      },
    ],
  }),
});

if (!response.ok) {
  throw new Error(`Stream failed: ${response.status} ${await response.text()}`);
}

for await (const chunk of response.body) {
  process.stdout.write(Buffer.from(chunk).toString("utf8"));
}

In produzione, analizza gli eventi server‑sent invece di stampare chunk grezzi. Gestisci anche disconnessioni di rete, risposte parziali, idempotenza dei retry e cancellazione da parte dell’utente.

Computer Use / Agentic Flows: combina con strumenti per controllo di browser/terminale. Sonnet 5 dà il meglio qui.

Best Practices con CometAPI:

• Monitora la dashboard di utilizzo per i costi.
• Esegui A/B test sui modelli (ad es., Sonnet 5 vs. Opus 4.8).
• Imposta avvisi di budget.
• Usa per integrazioni Claude Code puntando all’endpoint CometAPI.

Suggerimenti di prompting per Claude Sonnet 5

Claude Sonnet 5 rende al meglio quando il task è esplicito e i criteri di successo sono visibili.

Usa questa struttura per coding e task agentici:

Goal: [what should be achieved]
Context: [repo, system, constraints, known facts]
Inputs: [files, logs, tickets, data]
Rules: [must not change, security requirements, output format]
Success criteria: [tests pass, plan quality, risk list, exact schema]
Output: [what you want returned]

Per esempio:

Goal: Find likely causes of increased checkout API latency.
Context: The service is Node.js, PostgreSQL, Redis, and Stripe webhooks.
Inputs: I will provide logs, traces, recent deploy notes, and database metrics.
Rules: Do not invent metrics. Separate evidence from hypotheses.
Success criteria: Return the top 5 likely causes, what evidence supports each one, and the next query or dashboard to check.
Output: A table followed by a 30-minute investigation plan.

Prezzi di Claude Sonnet 5 su CometAPI

Il catalogo live di CometAPI verificato per questo articolo elenca claude-sonnet-5 a:

Verifica sempre i prezzi correnti nella dashboard CometAPI prima di pubblicare claim di prezzo per i clienti. I prezzi dei modelli possono cambiare e gli accordi enterprise possono differire dai valori pubblici.

Esempio di stima dei costi

def estimate_sonnet5_cost(input_tokens, output_tokens):
    input_price_per_million = 1.60
    output_price_per_million = 8.00

    input_cost = (input_tokens / 1_000_000) * input_price_per_million
    output_cost = (output_tokens / 1_000_000) * output_price_per_million
    return round(input_cost + output_cost, 6)


print(estimate_sonnet5_cost(input_tokens=120_000, output_tokens=8_000))
print("Expected output: 0.256")

Se un’analisi con contesto esteso usa 120.000 token di input e 8.000 token di output, il costo stimato da catalogo è circa “$0.256” al prezzo CometAPI verificato. Questo non include eventuali fee di piattaforma, sconti, tasse o cambi di prezzo futuri.

Per i workflow agentici, misura anche il costo per task risolto. Un agente di coding che completa un ticket in un’unica esecuzione ad alto sforzo di Sonnet 5 può costare meno di un modello più economico che richiede retry ripetuti e correzione umana.

Guida alla migrazione da Claude Sonnet 4.6

La migrazione è semplice ma richiede attenzione ai breaking changes.

Cosa cambia da Sonnet 4.6 a Sonnet 5?

Checklist di migrazione:

1. Aggiorna il nome del modello: cambia "claude-sonnet-4-6" in "claude-sonnet-5".
2. Tokenizer e costi: ri‑testa i prompt e riconta i token. Aspettati ~30% in più.
3. Configurazione del thinking: sostituisci il thinking esteso legacy con adattivo (thinking: {type: "adaptive"}) + livello di sforzo. budget_tokens è deprecato/rimosso.
4. Parametri di campionamento: rimuovi temperature, top_p, top_k — non sono più supportati (usa system prompt per controlli di stile).
5. Test approfonditi: esegui regression test su flussi agentici, uso di strumenti e parsing dell’output. Valida i costi.
6. Rate limits: limiti aumentati disponibili; controlla il tuo tier.
7. Aumenta max_tokens dove il ragionamento adattivo può richiedere più budget.

Codice di migrazione retro‑compatibile

async function runClaudeTask({ prompt, taskType, useSonnet5 = true }) {
  const model = useSonnet5 ? "claude-sonnet-5" : "claude-sonnet-4-6";
  const effort =
    taskType === "coding_agent" || taskType === "security_review"
      ? "high"
      : "medium";

  const body = {
    model,
    max_tokens: taskType === "coding_agent" ? 5000 : 1800,
    thinking: useSonnet5 ? { type: "adaptive" } : undefined,
    messages: [{ role: "user", content: prompt }],
  };

  if (useSonnet5) {
    body.output_config = { effort };
  }

  const response = await fetch("https://api.cometapi.com/v1/messages", {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.COMETAPI_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify(body),
  });

  if (response.status === 400 && useSonnet5) {
    // Retry once without optional Sonnet 5-only controls in case the route schema changed.
    delete body.output_config;
    const retry = await fetch("https://api.cometapi.com/v1/messages", {
      method: "POST",
      headers: {
        Authorization: `Bearer ${process.env.COMETAPI_KEY}`,
        "Content-Type": "application/json",
      },
      body: JSON.stringify(body),
    });

    if (!retry.ok) {
      throw new Error(`Retry failed: ${retry.status} ${await retry.text()}`);
    }

    return retry.json();
  }

  if (!response.ok) {
    throw new Error(`Claude request failed: ${response.status} ${await response.text()}`);
  }

  return response.json();
}

Questo pattern ti permette di testare Sonnet 5 senza rendere fragile l’applicazione. Puoi mantenere un modello di fallback, rimuovere campi opzionali in caso di errori di schema e instradare i carichi difficili a sforzi più alti.

Esiste una Claude Sonnet 5 API gratuita?

Non ci sono prove pubbliche affidabili che Anthropic offra una Claude Sonnet 5 API illimitata gratuita. Tuttavia, gli sviluppatori possono iniziare a testare Claude Sonnet 5 tramite CometAPI con crediti di prova gratuiti. Dopo aver creato un account CometAPI, i nuovi utenti possono ricevere $1 di credito gratuito, utilizzabile per esplorare i modelli supportati ed eseguire i primi test API prima di aggiungere altro budget.

FAQ su Claude Sonnet 5 API

Che cos’è la Claude Sonnet 5 API?

La Claude Sonnet 5 API è l’interfaccia per sviluppatori del modello Sonnet 5 di Anthropic, un modello ad alte prestazioni per coding, agenti, uso di strumenti, ragionamento su contesti lunghi, analisi di documenti e lavoro professionale.

Come uso la Claude Sonnet 5 API con CometAPI?

Usa l’ID modello claude-sonnet-5. Per comportamento nativo di Claude, invia richieste a POST https://api.cometapi.com/v1/messages. Per chat compatibile OpenAI, usa POST https://api.cometapi.com/v1/chat/completions.

Cosa c’è di nuovo in Claude Sonnet 5?

Claude Sonnet 5 aggiunge performance agentiche più forti per coding e uso di strumenti, una finestra di contesto da 1M token, ragionamento adattivo di default, controllo dello sforzo, un nuovo tokenizer e salvaguardie aggiornate per richieste cyber‑rilevanti e ad alto rischio.

Claude Sonnet 5 supporta il ragionamento adattivo?

Sì. Il ragionamento adattivo è attivo di default per Claude Sonnet 5. Gli sviluppatori non dovrebbero usare i vecchi budget manuali di thinking esteso con Sonnet 5; usa invece il controllo dello sforzo dove supportato.

Perché il nuovo tokenizer di Claude Sonnet 5 è importante?

Il nuovo tokenizer può produrre circa il 30% di token in più per lo stesso testo rispetto a Claude Sonnet 4.6. Questo influisce su costi, packing del contesto, prompt caching, chunking e pianificazione di max_tokens.

CometAPI vs Anthropic diretto: quale è meglio

CometAPI offre accesso unificato, prezzi più bassi e sperimentazione multi‑modello più semplice — ideale per la maggior parte degli sviluppatori.

Dovrei migrare da Claude Sonnet 4.6 a Claude Sonnet 5 subito?

Migra a fasi. Rimuovi i parametri non supportati, riconta i token, esegui i tuoi eval interni, monitora costi e comportamenti di rifiuto, mantieni Sonnet 4.6 come fallback, quindi instrada gradualmente più traffico di produzione a Sonnet 5.

Considerazioni finali

La Claude Sonnet 5 API è uno dei rilasci di modelli per sviluppatori più importanti del 2026 perché spinge i modelli della classe Sonnet più a fondo nel lavoro agentico. I casi d’uso più forti sono agenti di coding, workflow su terminale, analisi con contesti lunghi, uso di strumenti, ragionamento su documenti multimodali e automazione professionale. La migrazione è anche più sottile di un cambio di nome del modello: Sonnet 5 introduce un nuovo tokenizer, ragionamento adattivo di default, controllo basato sullo sforzo, comportamento di campionamento cambiato e salvaguardie di cybersicurezza aggiornate.

Raccomandazione: inizia con CometAPI oggi per accesso senza soluzione di continuità a Sonnet 5 (e oltre 500 altri modelli) con crediti gratuiti, costi inferiori e gestione unificata. Iscriviti su CometAPI, integra in pochi minuti e scala con fiducia.