# Fable 5.2 migration: cosa cambia nell'API e perché compaiono gli errori 400

> Fable 5.2 migration da 5.1: ID per piattaforma, quattro modifiche che rompono il codice, errori 400 e checklist per sviluppatori. Dati al 9 novembre 2026.

Fonte: Giallo Studio (giallostudio.it) · Pagina: https://giallostudio.it/blog/fable-5-2-migrazione-api · Pubblicato: 2026-11-09 · Aggiornato: 2026-11-09

**La Fable 5.2 migration si apre con una riga di codice, l'ID del modello, che passa da `claude-fable-5-1` al nuovo `claude-fable-5-2`, e si chiude solo dopo aver controllato quattro punti che possono produrre errori 400.** Claude Fable 5.2, rilasciato da Anthropic il 9 novembre 2026, ha un'API quasi identica a quella della 5.1, ma cambia il modo in cui il codice può trattare la cronologia della conversazione. Chi lascia fare il lavoro a Claude Code, claude.ai, Claude Managed Agents o all'Agent SDK non deve intervenire; chi costruisce da sé le richieste deve fare un test. I dati arrivano dalla [pagina «What's new» della documentazione](https://platform.claude.com/docs/en/models/fable-5-2/whats-new-fable-5-2), letta il 9 novembre 2026.

Per la scheda del modello (prezzo, benchmark, a chi serve) c'è l'[articolo su Claude Fable 5.2](https://giallostudio.it/blog/claude-fable-5-2-cos-e); qui parliamo di cosa si rompe e come si ripara.

<div class="key-points">
<p class="kp-title">In sintesi</p>
<ul>
<li>L'ID API è <code>claude-fable-5-2</code>; su Amazon Bedrock è <code>anthropic.claude-fable-5-2</code> (<a href="https://platform.claude.com/docs/en/models/fable-5-2/overview">scheda ufficiale</a>).</li>
<li>Da Fable 5.1 le modifiche che possono rompere il codice sono quattro: controllo sul prefisso della cronologia, thinking block leggibili solo da Fable 5.2 e Mythos 5.2, vecchio strumento di computer use, advisor obbligatoriamente Fable 5.2 o Mythos 5.2 (<a href="https://platform.claude.com/docs/en/models/fable-5-2/whats-new-fable-5-2">documentazione</a>).</li>
<li>Il ragionamento adattivo non si disattiva e <code>tool_choice</code> forzato dà errore 400, ma chi arriva da Fable 5.1 o Opus 5.5 non deve cambiare nulla su questi due punti (<a href="https://platform.claude.com/docs/en/models/fable-5-2/whats-new-fable-5-2">documentazione</a>).</li>
<li>La compaction on demand e le modifiche agli strumenti a metà conversazione, entrambe in beta, aiutano a mantenere la cronologia in sola aggiunta.</li>
<li>Il prezzo scende: 8 e 40 dollari per milione di token contro i 10 e 50 di Fable 5.1, secondo la <a href="https://platform.claude.com/docs/en/models/fable-5-2/whats-new-fable-5-2">documentazione</a>.</li>
<li>I punti di ingresso più sicuri sono un test sulla cronologia e una prova con le richieste reali, prima di spostare il traffico di produzione.</li>
</ul>
</div>

## Cosa cambia davvero passando da Fable 5.1 a Fable 5.2?

Cambiano quattro cose che possono far fallire il codice, secondo la [documentazione ufficiale](https://platform.claude.com/docs/en/models/fable-5-2/whats-new-fable-5-2). Il resto (contesto da 1 milione di token, output massimo di 128K token, tokenizer introdotto con Claude Opus 4.7) è condiviso con la versione precedente o non richiede interventi.

| Cambio rispetto a Fable 5.1 | Cosa succede | Dove si ripara |
|---|---|---|
| Controllo sul prefisso | Modificare ciò che precede un thinking block dà 400, su ogni account | Cronologia solo in aggiunta |
| Lettura dei thinking block | Solo Fable 5.2 e Mythos 5.2 leggono quelli di Fable 5.2 | Router e fallback |
| Computer use | `computer_20251124` dà 400 tranne che su Amazon Bedrock | Passare a `computer_toolset_20260801` |
| Advisor | Un executor Fable 5.2 accetta solo Fable 5.2 o Mythos 5.2 come advisor | Definizione dello strumento |

Aggiornare l'ID è l'ultimo passo, non il primo: finché i test girano sul vecchio modello, non dicono nulla sulla compatibilità della cronologia.

## Quali ID modello usare su ogni piattaforma?

L'ID cambia a seconda di dove si usa il modello. La [scheda ufficiale](https://platform.claude.com/docs/en/models/fable-5-2/overview) e la pagina «What's new» elencano questi valori; Mythos 5.2 segue lo stesso schema.

| Piattaforma | ID Fable 5.2 | ID Mythos 5.2 |
|---|---|---|
| Claude API | `claude-fable-5-2` | `claude-mythos-5-2` |
| Amazon Bedrock | `anthropic.claude-fable-5-2` | `anthropic.claude-mythos-5-2` |
| Claude Platform on AWS | `claude-fable-5-2` | non elencato |
| Google Cloud (gestito da Anthropic o da Google) | `claude-fable-5-2` | `claude-mythos-5-2` |
| Microsoft Foundry | `claude-fable-5-2` | `claude-mythos-5-2` |

Su Microsoft Foundry, per i deployment ospitati da Anthropic, la modalità veloce è un modello a parte: `claude-fable-5-2-fast`. Mythos 5.2 è invece riservato a organizzazioni verificate; i dettagli sono in [Claude Mythos 5.2: cos'è e chi può usarlo](https://giallostudio.it/blog/claude-mythos-5-2-cos-e).

Il cambio di ID si vede bene in codice. Questa è la modifica minima, quella mostrata dalla documentazione per Python:

```python
model = "claude-fable-5-1"  # prima
model = "claude-fable-5-2"  # dopo
```

## Perché una richiesta restituisce l'errore 400 «The block is bound to a different conversation»?

Perché il codice ha cambiato qualcosa che sta prima di un thinking block prodotto da Fable 5.2. L'API controlla il prefisso della cronologia: se il system prompt, gli strumenti o un messaggio precedente sono diversi da quando il modello ha prodotto quel blocco, la richiesta viene rifiutata con un errore 400 il cui testo contiene «The block is bound to a different conversation». Vale per Fable 5.2 e Mythos 5.2 su qualsiasi account, a meno che `prefix_mismatch_behavior` sia impostato.

Il punto che sorprende è l'età dell'account. Su Fable 5.1 l'errore compare solo sugli account creati dal 31 agosto 2026 in poi, quindi il codice di un account più vecchio può funzionare su 5.1 e rompersi solo dopo il passaggio.

La documentazione indica quando non cambia nulla per voi. Servono tutte e quattro queste condizioni:

<ul class="checklist">
<li>il codice tiene uguali <code>system</code> e <code>tools</code> per tutta la conversazione;</li>
<li>aggiunge soltanto messaggi a <code>messages</code>, senza mai cambiare, riordinare o rimuovere quelli precedenti;</li>
<li>rimanda ogni turno dell'assistente esattamente come l'API lo ha restituito, con tutti i blocchi e nello stesso ordine;</li>
<li>non fa nessuna delle operazioni elencate nella sezione «What to check in your integration» della documentazione.</li>
</ul>

Il caso tipico di violazione è il codice che «ripulisce» la cronologia: accorcia i messaggi vecchi, toglie i blocchi di ragionamento, riscrive il system prompt a ogni turno.

### Come si risolve, e cosa fa «drop_block»?

La soluzione vera è correggere la modifica. Come ripiego, la documentazione descrive un'opzione in beta: con l'header `thinking-binding-controls-2026-08-01` si assegna il valore `"drop_block"` al campo `thinking.block_binding.prefix_mismatch_behavior`. L'API scarta allora i blocchi invalidi e prosegue; la risposta elenca ogni blocco scartato nell'array `input_transformations`. Anthropic avverte che è un ripiego, perché scartare blocchi può far salire i token di output.

Per il test completo la documentazione rimanda alla sezione sul prefix check della guida alla migrazione da Claude Fable 5.1, citata nella [pagina «What's new»](https://platform.claude.com/docs/en/models/fable-5-2/whats-new-fable-5-2). Le differenze di prezzo e benchmark sono in [Fable 5.2 vs Fable 5.1](https://giallostudio.it/blog/fable-5-2-vs-fable-5-1).

## Cosa succede ai thinking block se cambio modello a metà conversazione?

Ogni thinking block registra quale modello lo ha prodotto, e un modello legge solo i blocchi che gli sono compatibili. Il comportamento è questo, secondo la [documentazione](https://platform.claude.com/docs/en/models/fable-5-2/whats-new-fable-5-2) per la Claude API e per Claude Models on Google Cloud gestito da Google:

- Fable 5.2 e Mythos 5.2 leggono i blocchi l'uno dell'altro e quelli di Opus 5.5, Sonnet 5.5, Haiku 5.5, Fable 5.1, Mythos 5.1, Opus 5, Fable 5, Mythos 5 e dei modelli Opus, Sonnet e Haiku precedenti.
- Nessun altro modello legge i blocchi di Fable 5.2. Passare da Fable 5.2 a Opus 5.5, a Fable 5.1 o ai modelli di fallback Opus 4.8 e Opus 5 fa perdere il ragionamento dei turni svolti su Fable 5.2.
- Quando una richiesta porta un blocco che il modello non può leggere, l'API lo scarta prima che il modello lo veda. La richiesta riesce e i blocchi scartati non sono fatturati.

In più, i blocchi di Fable 5.2 e Mythos 5.2 funzionano solo nell'account che li ha prodotti o in un account collegato. Se li invia un altro account, vengono scartati; con l'header beta citato prima compare in `input_transformations` il motivo `organization_binding_mismatch`.

Con un router o un fallback automatico la conseguenza è pratica: salire a Mythos 5.2 conserva il ragionamento, scendere a Opus 5.5 lo perde. Per lavorare con più modelli nella stessa sessione, vedi [Fable 5.2 come Advisor e Orchestrator](https://giallostudio.it/blog/fable-5-2-advisor-orchestrator).

## Come si migrano computer use e advisor?

Sono due modifiche da fare nello stesso intervento del cambio d'ID.

**Computer use.** Fable 5.1 accetta sia il toolset `computer_toolset_20260801` sia, con l'header beta `computer-use-2025-11-24`, il vecchio strumento `computer_20251124`. Fable 5.2 e Mythos 5.2 supportano solo il toolset. Una richiesta che dichiara `computer_20251124` riceve un 400 `invalid_request_error` su tutte le piattaforme tranne Amazon Bedrock, dove il vecchio strumento continua a funzionare. La guida di riferimento della documentazione si chiama «Migrate from computer_20251124». Per cosa conviene automatizzare e con quali cautele, leggete [Fable 5.2 e computer use](https://giallostudio.it/blog/fable-5-2-computer-use) e, per l'ambiente di prova, [Claude SDK con browser e computer use](https://giallostudio.it/blog/claude-sdk-browser-computer-use).

**Advisor.** Con lo strumento advisor (in beta) l'advisor deve essere almeno capace quanto l'executor. Un executor Fable 5.2 o Mythos 5.2 accetta solo Fable 5.2 o Mythos 5.2 come advisor: qualunque altro, Fable 5.1 e Mythos 5.1 compresi, dà un errore 400 `invalid_request_error`. Se spostate l'executor, nella stessa modifica impostate come advisor `claude-fable-5-2` oppure `claude-mythos-5-2`. Cambiare l'advisor è una modifica a `tools`: va fatta in conversazioni nuove, altrimenti scatta il controllo sul prefisso. Il consiglio di un advisor Fable 5.2 arriva cifrato: chi legge il testo dell'advice deve consultare la sezione «Result variants».

## Thinking e tool_choice: quando l'errore dipende da dove si parte

Due regole valgono per ogni richiesta a Fable 5.2. Se parte da Fable 5.1, Mythos 5.1 o Opus 5.5 non c'è nulla da cambiare. Altrimenti sì, e la [documentazione](https://platform.claude.com/docs/en/models/fable-5-2/whats-new-fable-5-2) distingue per punto di partenza:

| Modello di partenza | Thinking sempre attivo | tool_choice forzato (any / tool) |
|---|---|---|
| Fable 5.1, Mythos 5.1, Opus 5.5 | già così, nessuna modifica | già così, nessuna modifica |
| Fable 5, Mythos 5 | già così, nessuna modifica | da cambiare |
| Opus 5 e modelli Opus precedenti | da cambiare | da cambiare |

Le regole in concreto:

- **Il ragionamento adattivo è sempre attivo.** Il campo `thinking` impostato con `type: "enabled"` e `budget_tokens`, oppure impostato con `type: "disabled"`, restituisce 400. Si omette `thinking` o si invia `{"type": "adaptive"}` e si regola la profondità con `effort`.
- **Il tool use forzato non è supportato.** Il campo `tool_choice` impostato con `type: "any"` oppure con `type: "tool"` restituisce un 400 `invalid_request_error`. Per ottenere JSON valido secondo uno schema si lascia il valore `{"type": "auto"}` nel campo `tool_choice` e si imposta `strict: true`, oppure si usano gli output JSON.
- **Chiavi di cifratura gestite dal cliente.** In un'organizzazione che le usa gli structured outputs non sono disponibili per Fable 5.2 e Mythos 5.2, né con strict tool use né con gli output JSON: si toglie `strict` e si valida l'input dello strumento nel proprio codice.

Per scegliere il livello di effort, che è il vero pulsante di costo dopo la migrazione, c'è [Fable 5.2: livelli di ragionamento ed effort](https://giallostudio.it/blog/fable-5-2-livelli-di-ragionamento).

## Quali novità beta aiutano a non rompere la cronologia?

Due funzioni in beta servono proprio a tenere la cronologia in sola aggiunta, come richiede il controllo sul prefisso. La [documentazione](https://platform.claude.com/docs/en/models/fable-5-2/whats-new-fable-5-2) le presenta così:

- **Compaction on demand.** Con l'header `compact-2026-09-04` decidete voi quando sostituire i turni più vecchi con un riassunto, invece di tagliarli a mano.
- **Modifiche agli strumenti a metà conversazione.** Aggiungete o togliete strumenti con un messaggio `role: "system"` invece di modificare `tools`. Sulla Claude API, su Claude Platform on AWS e su Claude Models on Google Cloud (gestito da Anthropic) serve l'header `inline-tools-2026-09-15`; l'header `mid-conversation-tool-changes-2026-07-01` vale per le modifiche che nominano lo strumento per riferimento, sulle piattaforme elencate nella pagina dedicata.

La disponibilità per modello e piattaforma va verificata sulla pagina di ciascuna funzione. Se oggi accorciate la cronologia a mano, la compaction è il candidato per sostituire quella logica.

## Come cambiano costi e comportamento dopo la migrazione?

Il listino scende, ma il comportamento no: va riprovato. Fable 5.2 costa 8 dollari per milione di token in input e 40 in output, contro 10 e 50 di Fable 5.1 (fonte: [documentazione ufficiale](https://platform.claude.com/docs/en/models/fable-5-2/whats-new-fable-5-2), consultata il 9 novembre 2026). Per il conto completo con la cache c'è [Claude Fable 5.2: prezzi API e costi reali](https://giallostudio.it/blog/claude-fable-5-2-prezzi-api); per un metodo di stima valido per ogni modello, [Costo API AI: come calcolarlo](https://giallostudio.it/blog/costo-api-ai-come-calcolarlo).

La pagina «What's new» segnala anche differenze di comportamento che si vedono senza modificare il codice:

- una riga di prompt come «rispondi direttamente senza ragionare» non basta a fermare il pensiero da effort medium in su: ad effort high o superiore il modello ragiona prima di quasi ogni risposta;
- nelle attività lunghe un turno può chiudersi con un elenco di ciò che resta o con un'offerta di continuare, più spesso ad effort basso e medio;
- un limite rigido di lunghezza delle frasi può rendere la prosa spezzata, e i subagent possono pesare sul costo di una sessione.

Sono i limiti noti che raccontiamo in [Fable 5.2: limiti noti e come aggirarli](https://giallostudio.it/blog/claude-fable-5-2-limiti). Prima di sostituire Opus 5.5 con Fable 5.2 vale la pena rileggere anche [come usare Claude Opus 5.5](https://giallostudio.it/blog/claude-opus-5-5-come-usarlo): la documentazione stessa suggerisce di partire dall'ultimo Opus e di passare a Fable quando le prove a effort più alto non bastano.

## Un esempio: il team interno di una software house che integra Claude in un CRM

Un esempio, non un caso reale. Una software house ha costruito per un cliente un CRM che chiama Claude per riassumere le conversazioni commerciali e preparare le bozze delle email. Il servizio usa Fable 5.1 e, per tenere basso il costo, a ogni turno taglia i messaggi più vecchi e riscrive il system prompt con i dati aggiornati del cliente.

Con Fable 5.2 questo schema produce errori 400: il prefisso cambia a ogni turno. Il team sposta i dati del cliente in un messaggio nuovo, senza toccare il system prompt; sostituisce il taglio manuale con la compaction on demand; toglie ogni `tool_choice` forzato usato per ottenere JSON, passando a `strict: true` e al valore `auto` per il campo `tool_choice`. Poi prova le richieste reali su un ambiente separato e sposta il traffico per gradi.

## Errori da evitare nella migrazione

1. **Cambiare solo l'ID e andare in produzione.** Il test sulla cronologia è la parte essenziale. Un account vecchio può non aver mai visto l'errore su 5.1 e vederlo il primo giorno su 5.2.
2. **Usare «drop_block» come soluzione.** È un ripiego: nasconde la modifica, non la toglie, e può aumentare i token di output.
3. **Passare tra modelli a metà conversazione senza pensare ai thinking block.** Scendere a Opus 5.5 fa perdere il ragionamento dei turni su Fable 5.2.
4. **Dimenticare l'advisor.** Se l'executor diventa Fable 5.2 e l'advisor resta Fable 5.1, ogni richiesta fallisce.
5. **Migrare i prompt senza rifare le prove.** Le righe «non ragionare» o i limiti rigidi di stile si comportano in modo diverso su 5.2.

## Checklist di migrazione, in ordine

<ol class="steps">
<li><strong>Mappate dove nascono le richieste.</strong> Quali parti usano Claude Code, Agent SDK o claude.ai (nessun intervento) e quali costruiscono da sole l'array <code>messages</code>.</li>
<li><strong>Provate la cronologia.</strong> Eseguite sul codice proprio il test del prefix check descritto nella guida alla migrazione, anche se Fable 5.1 non ha mai dato errore.</li>
<li><strong>Controllate i router e i fallback.</strong> Individuate dove una conversazione può passare ad altri modelli e cosa perde.</li>
<li><strong>Spostate il computer use</strong> su <code>computer_toolset_20260801</code> (tranne che su Amazon Bedrock, se volete tenere il vecchio strumento).</li>
<li><strong>Aggiornate l'advisor</strong> a <code>claude-fable-5-2</code> o <code>claude-mythos-5-2</code>, in conversazioni nuove.</li>
<li><strong>Togliete <code>tool_choice</code> forzato</strong> se partite da Fable 5, Mythos 5 o da Opus 5 e precedenti, <strong>e <code>thinking</code> disattivato</strong> se partite da Opus 5 e precedenti.</li>
<li><strong>Rifate le prove con un effort sweep</strong> che parte dal livello <code>high</code>, il default dell'API, e confrontate qualità e costo con la vostra baseline.</li>
<li><strong>Cambiate l'ID</strong> e spostate il traffico per gradi.</li>
</ol>

## Da dove partire

La mossa più utile è una sola: testare la cronologia con le richieste reali, in un ambiente separato, prima di toccare la produzione. Se il vostro team non ha tempo di rifare i test, [Giallo Studio](https://giallostudio.it/software-house) può affiancarlo nella revisione dell'integrazione e nel passaggio graduale del traffico.

Le pagine ufficiali cambiano in fretta, e le versioni dei modelli anche: prima di intervenire verificate sempre l'[elenco aggiornato dei modelli Claude](https://platform.claude.com/docs/en/about-claude/models/overview) e la pagina «What's new».

## Domande frequenti

### Basta cambiare l'ID del modello per passare da Fable 5.1 a Fable 5.2?

Per il solo ID sì: da claude-fable-5-1 a claude-fable-5-2. Ma la documentazione ufficiale elenca quattro modifiche che possono far fallire il codice scritto per 5.1, tra cui il controllo sui turni precedenti e il vecchio strumento di computer use. Se il vostro codice costruisce da sé l'array dei messaggi, va provato prima di cambiare modello.

### Perché la mia richiesta a Fable 5.2 restituisce un errore 400?

La causa più frequente è la modifica di qualcosa che precede un thinking block: system prompt, strumenti o un messaggio precedente. In quel caso il messaggio d'errore dice «The block is bound to a different conversation». Le altre cause sono thinking disattivato, tool_choice forzato, lo strumento computer_20251124 e un advisor diverso da Fable 5.2 o Mythos 5.2.

### Posso disattivare il thinking su Fable 5.2?

No. Il ragionamento adattivo è sempre attivo: thinking con type enabled o disabled restituisce un errore 400. Si omette il parametro oppure si invia type adaptive, e la profondità si regola con il parametro effort. Chi arriva da Fable 5.1 non deve cambiare nulla su questo punto.

### Cosa succede se cambio modello a metà conversazione?

La richiesta funziona, ma il ragionamento passato può andare perso. Fable 5.2 e Mythos 5.2 leggono i thinking block l'uno dell'altro e quelli di molti modelli precedenti, mentre gli altri modelli, Opus 5.5 e Fable 5.1 compresi, scartano quelli di Fable 5.2. I blocchi scartati non vengono fatturati.

### Come si usa il computer use con Fable 5.2?

Si dichiara lo strumento computer_toolset_20260801 al posto di computer_20251124. Il vecchio strumento restituisce un errore 400 invalid_request_error su tutte le piattaforme tranne Amazon Bedrock. Il punto di partenza ufficiale è la guida «Migrate from computer_20251124» della documentazione Anthropic.

### Quali novità beta aiutano a migrare senza rompere la cronologia?

Due: la compaction on demand, che permette di sostituire i turni vecchi con un riassunto quando decidete voi, e le modifiche agli strumenti a metà conversazione tramite un messaggio con role system. Entrambe servono a mantenere la cronologia in sola aggiunta, come richiede il controllo sul prefisso. Sono in beta e richiedono header dedicati.

### Il ritiro di Fable 5.1 mi obbliga a migrare subito?

Nelle pagine ufficiali consultate il 9 novembre 2026 non risulta una data di ritiro di Fable 5.1, quindi non c'è una scadenza da citare. Per Fable 5.2 la scheda ufficiale indica un ritiro non prima del 9 novembre 2027. Conviene provare la migrazione su un ambiente di test, perché il prezzo di 5.2 è più basso.
