Claude Platform Docs
Note di rilascio

Note di rilascio della Claude Platform

Aggiornamenti alla Claude Platform, inclusi la Claude API, gli SDK client e la Claude Console.

Subscribe

Le note di rilascio della Claude Platform elencano le modifiche alla Claude API, agli SDK client e alla Claude Console, a partire dalle più recenti.

9 ottobre 2026

  • Ora puoi consentire a un agente di Claude Managed Agents di usare i workflow dinamici, in beta con l'header beta managed-agents-2026-04-01. Per lavori composti da molte parti, come la revisione di centinaia di documenti, l'agente può scrivere un workflow. Un workflow è un programma che esegue molti agenti in fasi e ne combina i risultati. Il server lo esegue in background come esecuzione di workflow. Per attivare i workflow dinamici, imposta il campo multiagent dell'agente su {"type": "multiagent_20261001", "workflows": {"type": "enabled"}}. Per guidare l'agente, indicagli nel suo prompt di sistema quando avviare un'esecuzione. Segui ogni esecuzione tramite gli eventi workflow_run.* nello stream di eventi della sessione. Consulta Esecuzioni di workflow.

8 ottobre 2026

7 ottobre 2026

  • Abbiamo ridotto il prezzo delle letture della "prompt cache" (cache dei prompt) su Claude Sonnet 5.5 da $0,20 USD a $0,10 USD per milione di token: 0,05x il prezzo di input base invece di 0,1x. Le scritture nella cache e tutti gli altri prezzi restano invariati. Consulta Prezzi della cache dei prompt.
  • Abbiamo lanciato Claude Haiku 5.5 (claude-haiku-5-5), il nostro modello più capace ottimizzato per carichi di lavoro ad alto volume e sensibili alla "latency" (latenza). Dispone di una "context window" (finestra di contesto) da 1M token, 128k token di output massimi e "adaptive thinking" (ragionamento adattivo) con il parametro effort. È disponibile sulla Claude API, Claude in Amazon Bedrock, Claude Platform on AWS, Claude on Google Cloud e Claude in Microsoft Foundry. Consulta Novità di Claude Haiku 5.5.
  • Il codice scritto per Claude Haiku 4.5 può non funzionare su Claude Haiku 5.5. L'"extended thinking" (ragionamento esteso) manuale (budget_tokens), i parametri di campionamento temperature, top_p e top_k e il prefill dei messaggi dell'assistente possono ciascuno restituire un errore 400. Anche computer_20250124 restituisce un errore 400: usa il toolset computer_toolset_20260801 sulla Claude API e su Google Cloud, oppure computer_20251124 su Amazon Bedrock. Anche una richiesta che rinvia blocchi di ragionamento dopo una modifica a system, tools o ai turni precedenti può restituire un errore 400. Su Amazon Bedrock, gli output strutturati non sono disponibili per Claude Haiku 5.5. Il ragionamento adattivo è attivo per impostazione predefinita, quindi una risposta può iniziare con blocchi thinking, il cui testo viene omesso a meno che tu non imposti thinking.display su "summarized". Lo stesso testo conta inoltre come un numero maggiore di token. Consulta la guida alla migrazione per ogni modifica. Per i pattern di prompting specifici del modello, consulta Prompting per Claude Haiku 5.5.
  • Gli SDK Python e TypeScript ora includono classi, in beta, per lo strumento browser use e lo strumento computer use. Crea una sottoclasse di una di esse e scrivi un metodo per ogni strumento basato sulla tua automazione del browser o del desktop. L'SDK esegue il ciclo degli strumenti, le policy su URL e file che imposti per il browser e la tua callback di approvazione. Consulta Uso del browser e del computer con i toolset dell'SDK.
  • I piani Claude Max e Team ora includono crediti API mensili. Per sapere come richiederli, consulta Crediti API per i piani Max e Team.
  • In Claude Managed Agents, un ambiente cloud con networking limited ora applica i suoi allowed_hosts anche agli strumenti web_search e web_fetch. Una chiamata web_fetch per un URL su un host che non corrisponde a allowed_hosts restituisce all'agente un risultato di errore url_not_allowed. web_search omette i risultati provenienti da tali host. Quando allowed_hosts non elenca alcun host, nessuno dei due strumenti restituisce una pagina o un risultato di ricerca. allow_package_managers e allow_mcp_servers non aggiungono host per questi strumenti. Per consentire agli strumenti di raggiungere un host, aggiungilo a allowed_hosts, il che lo rende accessibile anche alla sandbox. Il networking unrestricted e gli ambienti self-hosted non limitano questi strumenti. Consulta Networking dell'ambiente.
  • Con il networking limited, la creazione di una sessione fallisce con un errore 400 quando gli allowed_domains di uno strumento web abilitato contengono una voce non compresa in allowed_hosts. Lo stesso vale per un aggiornamento della sessione che aggiunge una voce di questo tipo. Una voce di allowed_hosts corrisponde a un unico host esatto a meno che non inizi con *., quindi docs.example.com non è compreso in ["example.com"]. Per correggere l'errore, aggiungi l'host a allowed_hosts o rimuovi la voce da allowed_domains. Consulta Limitare i domini di web search e web fetch.
  • In Claude Managed Agents, lo strumento web_fetch ora recupera solo gli URL già comparsi nella sessione, ad esempio nel testo di un messaggio dell'utente, in un risultato di web_search o in una pagina restituita in precedenza da web_fetch. Questo riduce il rischio di esfiltrazione dei dati. Un URL che compare solo nell'output di Claude stesso, nel prompt di sistema dell'agente, in un documento allegato o nell'output di uno strumento come bash, read o uno strumento MCP non conta: una chiamata web_fetch per tale URL restituisce all'agente un risultato di errore url_not_in_prior_context. Per consentire all'agente di recuperare un URL, invialo nel testo di un evento user.message.

6 ottobre 2026

  • Abbiamo aggiunto capabilities.server_tools alla Models API. GET /v1/models e GET /v1/models/{model_id} ora indicano se ciascun modello accetta gli strumenti di ricerca web e di esecuzione del codice. Per verificare se un modello accetta lo strumento di esecuzione del codice, leggi capabilities.server_tools.code_execution. Il campo di primo livello capabilities.code_execution indica se il codice può chiamare gli altri strumenti della tua richiesta. Consulta Utilizzo della Models API.

5 ottobre 2026

  • Abbiamo aggiunto capabilities.thinking.types.disabled alla Models API. GET /v1/models e GET /v1/models/{model_id} ora indicano se ciascun modello accetta thinking: {type: "disabled"}, che disattiva il ragionamento. Consulta Utilizzo della Models API.

1 ottobre 2026

  • Abbiamo aggiunto un campo line alla Models API. GET /v1/models e GET /v1/models/{model_id} ora restituiscono la linea di modelli a cui appartiene ciascun modello. Ad esempio, Claude Opus 4.5 e Claude Opus 4.6 riportano entrambi opus. Usa line per raggruppare i modelli senza analizzarne gli ID. line è null per un modello che non appartiene ad alcuna linea. Consulta Utilizzo della Models API.
  • Dreams (anteprima di ricerca) ora supporta Claude Opus 5.5, Claude Fable 5.1 e Claude Sonnet 5.5. Consulta Modelli supportati.

30 settembre 2026

  • In Python SDK 1.10.0, TypeScript SDK 0.130.0, C# SDK 12.52.0, Go SDK 1.77.0, Java SDK 2.67.0, PHP SDK 0.53.0, Ruby SDK 1.75.0 e nella versione 1.37.0 della CLI ant, i metodi dell'Admin API per informazioni sull'organizzazione, membri, inviti, workspace, chiavi API, "rate limits" (limiti di velocità), service account, workload identity federation, chiavi di crittografia gestite dal cliente e impostazioni di conformità sono usciti dalla beta: chiamali tramite client.organization e ant organization. Queste versioni mantengono anche client.beta.organization e ant beta:organization.
  • Abbiamo annunciato la deprecazione del modello Claude Sonnet 4.5 (claude-sonnet-4-5-20250929), con il ritiro dalla Claude API previsto per il 30 novembre 2026. Consigliamo di migrare a Claude Sonnet 5.5. Scopri di più in Deprecazioni dei modelli.

28 settembre 2026

  • Abbiamo lanciato Claude Sonnet 5.5 (claude-sonnet-5-5). È disponibile sulla Claude API, Claude in Amazon Bedrock, Claude Platform on AWS, Claude on Google Cloud e Claude in Microsoft Foundry. Per la finestra di contesto, i limiti di output e i prezzi, consulta la pagina del modello Claude Sonnet 5.5.
  • Il codice scritto per Claude Sonnet 5 può non funzionare su Claude Sonnet 5.5 in cinque modi. Per disattivare il ragionamento iniziale, invia thinking: {"type": "between_tools"} invece di "disabled", con effort high o inferiore. L'uso forzato degli strumenti (tipi di tool_choice any e tool) restituisce un errore 400. I blocchi di ragionamento sono legati al modello e alla conversazione. Sulla Claude API e su Google Cloud, il precedente strumento computer use computer_20251124 non è accettato. Lo strumento advisor rifiuta Claude Opus 4.8, Claude Opus 4.7 e Claude Sonnet 5 come advisor. Consulta Novità di Claude Sonnet 5.5 per ciascuna modifica e la guida alla migrazione per le richieste prima e dopo. Per i pattern di prompting specifici del modello, consulta Scrivere prompt per Claude Sonnet 5.5.
  • I blocchi di ragionamento prodotti da Claude Sonnet 5.5 funzionano solo nell'account che li ha prodotti o in un account collegato a esso. Quando un altro account invia uno di questi blocchi, l'API scarta il blocco prima che il modello lo veda e la richiesta va a buon fine. I blocchi dei modelli precedenti non sono interessati. Consulta Ragionamento preservato.

24 settembre 2026

  • Riprendiamo la fatturazione dei "refusal" (rifiuti) che arrivano prima di qualsiasi output quando stop_details.category è "bio", "frontier_llm" o "reasoning_extraction", le categorie in cui misuriamo bassi volumi di falsi positivi. I rifiuti a metà dello stream erano già fatturati. I rifiuti fatturati in base a questa modifica vengono addebitati come qualsiasi altra richiesta, alle tariffe del modello che l'ha eseguita. I rifiuti prima di qualsiasi output nelle altre categorie continuano a non essere fatturati, e il credito di fallback rimane invariato. Questa modifica si applica a tutte le piattaforme. Consulta Come vengono fatturati i rifiuti.
  • Gli endpoint delle sessioni locali della Compliance API sono usciti dalla beta per le sessioni di Claude for Microsoft 365 in Excel, PowerPoint, Word e Outlook (valori di product_surface che iniziano con office_agents). Consulta Sessioni sui computer degli utenti.
  • L'Activity Feed della Compliance API non restituisce più nomi di file, nomi di documenti di progetto o titoli di artifact. I campi filename e title nelle attività relative a file, documenti di progetto e artifact sono ora sempre vuoti o omessi, incluse le attività registrate prima di questa modifica. Per cercare un nome o un titolo tramite l'ID presente nell'attività, usa una Compliance Access Key con lo scope read:compliance_user_data. Consulta Comprendere l'oggetto Activity.

23 settembre 2026

  • La diagnostica della cache è uscita dalla beta sulla Claude API e non richiede più l'header beta cache-diagnosis-2026-04-07. Includi l'oggetto diagnostics in una richiesta Messages per attivarla; le richieste che inviano ancora l'header funzionano come prima. Le risposte da POST /v1/messages ora includono sempre il campo diagnostics, che è null quando la richiesta non includeva l'oggetto diagnostics.

22 settembre 2026

  • Abbiamo lanciato Claude Opus 5.5 (claude-opus-5-5), un modello per il coding agentico di lunga durata e il lavoro di conoscenza. Ha una "context window" (finestra di contesto) da 1M token per impostazione predefinita, 128k token di output massimi e l'"adaptive thinking" (ragionamento adattivo) sempre attivo, a $4 / $20 USD per MTok (Claude Opus 5 costa $5 / $25). Claude Opus 5.5 è disponibile sulla Claude API, su Claude in Amazon Bedrock, Claude Platform on AWS, Claude on Google Cloud e Claude in Microsoft Foundry. Consulta Novità di Claude Opus 5.5 per capacità, modifiche all'API e indicazioni per la migrazione.
  • Su Claude Opus 5.5, il ragionamento non può essere disabilitato: thinking: {"type": "disabled"} e thinking: {"type": "enabled", ...} restituiscono un errore 400. Ometti il campo thinking e controlla la profondità del ragionamento con il parametro effort. Anche i tipi tool_choice any e tool restituiscono un errore 400, come su Claude Fable 5.1; usa auto con l'uso rigoroso degli strumenti. Sulla Claude API e su Google Cloud, il "computer use" (uso del computer) su questo modello richiede il toolset computer_toolset_20260801 e lo strumento precedente computer_20251124 restituisce un errore 400; su Amazon Bedrock, computer_20251124 continua a funzionare. Consulta la guida alla migrazione.
  • La "fast mode" (modalità veloce) (anteprima di ricerca) è disponibile per Claude Opus 5.5 sulla Claude API.
  • Gli strumenti possono ora essere definiti all'interno di un messaggio di sistema a metà conversazione, in beta sulla Claude API con l'header beta inline-tools-2026-09-15. Un blocco tool_addition può contenere la definizione completa dello strumento (tool: {"type": "tool_definition", "definition": {...}}), così puoi aggiungere uno strumento, modificarne lo schema o spostare uno strumento server a una versione più recente senza modificare tools né invalidare la cache dei prompt. Lo stesso header copre l'aggiunta e la rimozione di strumenti per riferimento. Usando anche l'header beta mcp-client-2026-09-15 del connettore MCP, la definizione può essere un toolset MCP, e una risposta registra l'elenco degli strumenti recuperato da ciascun server in un blocco mcp_tool_listing, che fissa quell'elenco quando lo rinvii.

18 settembre 2026

  • Per la diagnostica della cache, una risposta a una richiesta che invia l'header beta cache-diagnosis-2026-04-07 ora include sempre il campo diagnostics. Il campo è null quando la richiesta non includeva l'oggetto diagnostics. In precedenza, in quel caso il campo veniva omesso.
  • Gli endpoint delle sessioni locali della Compliance API ora restituiscono anche le trascrizioni delle sessioni di Claude in Chrome (valore product_surface claude_in_chrome), in beta per le organizzazioni Claude Enterprise, con la tua Compliance Access Key esistente e lo scope read:compliance_user_data. Consulta Sessioni sui computer degli utenti.

14 settembre 2026

  • La Messages API può ora compattare una conversazione su richiesta sulla Claude API, in beta con l'header beta compact-2026-09-04. Invia il parametro di primo livello compaction e l'API restituisce un blocco compaction firmato che riassume i messaggi che hai inviato. Nelle richieste successive, invia prima quel blocco, al posto di quei messaggi. Scegli tu quando compattare, la richiesta può essere eseguita in background e puoi mantenere i turni recenti parola per parola dopo il riepilogo. Sui modelli con ragionamento preservato, il ragionamento in quei turni mantenuti può rimanere valido.
  • Con l'header beta thinking-binding-controls-2026-08-01, il campo di risposta input_transformations acquisisce un secondo tipo di voce, thinking_mismatch_allowed. Indica un blocco di ragionamento che non ha superato il controllo del prefisso in una richiesta in cui l'API non applica tale controllo: su Claude Fable 5.1, ad esempio, una richiesta da un account creato prima del 31 agosto 2026, con prefix_mismatch_behavior non impostato. Il blocco raggiunge comunque il modello invariato. Registra queste voci per individuare le modifiche alla cronologia nel traffico di produzione prima di attivare l'applicazione del controllo. Consulta Imposta il comportamento in caso di mancata corrispondenza e leggi input_transformations.

10 settembre 2026

  • Le policy di autorizzazione di Claude Managed Agents ora includono auto: il server valuta ogni chiamata a uno strumento dell'agente o MCP e la esegue, la nega o si mette in pausa in attesa della tua approvazione. Gli eventi agent.tool_use e agent.mcp_tool_use riportano come è stata valutata ciascuna chiamata in un campo evaluation accanto a evaluated_permission. Consulta Lascia che il server valuti ogni chiamata con auto.
  • La versione 1.32.0 della CLI ant aggiunge ant beta:sessions connect, che collega il tuo terminale a una sessione di Claude Managed Agents. Puoi seguire la sessione in tempo reale, inviare messaggi e consentire o negare le chiamate agli strumenti in attesa di approvazione. Passa --web per servire localmente il visualizzatore di sessioni della Claude Console e aprire invece lì la sessione. Consulta Connettiti a una sessione di Managed Agents dal tuo terminale.

9 settembre 2026

  • Per la diagnostica della cache, l'API ora memorizza l'impronta di una richiesta solo quando la richiesta include l'oggetto diagnostics. Una richiesta che invia solo l'header beta cache-diagnosis-2026-04-07 viene comunque accettata, ma non viene memorizzata alcuna impronta. Un turno successivo il cui previous_message_id punta a tale richiesta riporta previous_message_not_found. Includi diagnostics in ogni turno, con "previous_message_id": null nel primo.

3 settembre 2026

  • La versione 1.30.0 della CLI ant aggiunge ant apply, che crea e aggiorna agenti, ambienti, skill, memory store e deployment a partire da file nel tuo repository. Descrivi ogni risorsa in un file, esegui ant apply e approva il piano che stampa. Esegui il commit del lockfile claude-lock.json che genera, in modo che le esecuzioni successive, sulla tua macchina o in CI, aggiornino le stesse risorse invece di crearne di nuove. Consulta Gestisci le risorse come codice con ant apply.
  • Le modifiche dell'effort per messaggio, in beta, sono disponibili anche su Google Cloud per Claude Fable 5.1, Claude Mythos 5.1 e Claude Opus 5, con lo stesso header beta mid-conversation-output-config-2026-07-01.

1 settembre 2026