Índice

Migrar para o Claude Fable 5.1 não termina quando você troca o ID do modelo. A própria Anthropic afirma que “três delas são mudanças incompatíveis” (What's new in Claude Fable 5.1). E duas dessas três se manifestam longe de onde está a causa — são justamente as difíceis de perceber.

⚠️ A terceira é aplicada de forma obrigatória em contas criadas a partir de 31 de agosto de 2026. Em contas anteriores, a API apenas registra a divergência e só a reflete no comportamento quando você pede isso de forma explícita.

Ou seja, o “aqui está funcionando, então está tudo bem” depende de quando a conta foi criada. Pode acontecer de um ambiente de testes recém-criado falhar enquanto a produção não falha.

1. Antes de tudo, o posicionamento: não é uma troca de carro-chefe

Errar aqui é errar a própria decisão de migrar. O Fable 5.1 é o sucessor do Fable 5 e não substitui o Opus 5.

A documentação oficial é clara: “comece a maioria das cargas de trabalho pelo Claude Opus 5”. O Fable 5.1 é indicado para “raciocínio exigente e trabalho agêntico de longa duração” ou para “quando o Opus 5 avaliado com effort alto ainda não é suficiente”.

　 Claude Fable 5.1 Claude Opus 5
Posicionamento Raciocínio exigente e trabalho agêntico de longa duração Comece por aqui (codificação agêntica complexa e uso corporativo)
Preço (por milhão de tokens) Entrada $10 / saída $50 Entrada $5 / saída $25
Leitura de cache $0.25 (0.025 vez a entrada base) 0.1 vez a entrada base
Corte de conhecimento junho de 2026 maio de 2026
Contexto / saída máxima 1M / 128k 1M / 128k
Descontinuação não será antes de 1 de setembro de 2027 24 de julho de 2027

O Fable 5 não desapareceu. Na lista oficial de modelos ele continua como legacy (ainda disponível). A migração não está sendo forçada agora — mas, como veremos adiante, o custo cai.

O Mythos 5.1 tem o mesmo desempenho e difere apenas nas salvaguardas. O acesso está restrito aos participantes do Project Glasswing.

📌 Do lado da assinatura: o uso foi zerado no dia do lançamento. A conta oficial @ClaudeDevs anunciou que, junto com a publicação do 5.1, resetou as janelas de 5 horas e semanal de todos os usuários. Isso não tem a ver com o preço da API, e sim com as cotas de uso das assinaturas, como as do Claude Code — e, além disso, não é uma especificação permanente, mas uma medida temporária ligada a um grande anúncio. Quantas vezes esse tipo de reset já ocorreu, e onde termina o confirmado e começa o não verificado, é o tema do artigo que investiga a recuperação antecipada do limite semanal. Note que o próprio limite semanal será revisado em 14 de setembro de 2026, então, se você planeja com base nessas cotas, vale conferir isso também.

2. Mudança incompatível 1: a chamada de ferramenta forçada devolve 400

Esta é a mais fácil de encontrar, porque gera erro imediato.

tool_choice: type "tool" and "any" are not supported for this model.

Ao informar {"type": "any"} ou {"type": "tool", "name": "..."} em tool_choice, a resposta é 400 invalid_request_error. O padrão {"type": "auto"} e o {"type": "none"} continuam iguais. A mesma validação vale para o endpoint de contagem de tokens.

💡 O motivo é explicado de forma convincente. Neste modelo o raciocínio está sempre ligado e, ao forçar a chamada de ferramenta, esse raciocínio é pulado. O modelo acaba escrevendo o que pensou dentro dos argumentos da ferramenta, e a qualidade dos argumentos cai — daí o bloqueio, segundo a explicação oficial.

O que fazer no lugar

Se você quer garantir o schema

Mantenha tool_choice: auto e use strict: true (strict tool use), ou migre para structured outputs

Se você quer que a ferramenta seja sempre usada

Escreva no prompt quando usá-la (“responda sobre o tempo com a ferramenta get_weather”). A documentação oficial diz que “o Fable 5.1 segue de forma confiável instruções explícitas de ferramenta”

3. Mudança incompatível 2: o bloco de raciocínio fica vinculado ao modelo

É a partir daqui que fica complicado. Os blocos de raciocínio passaram a registrar qual modelo os produziu, e a preservação virou via de mão única.

✅ O sentido que se preserva

Conversas que vêm da geração anterior (Opus 5, Fable 5 e anteriores) e passam para o Fable 5.1 continuam com o raciocínio intacto

❌ O sentido que se perde

Ao sair do Fable 5.1 para a geração anterior, o raciocínio dos turnos processados ali se perde. A geração anterior não consegue ler os blocos de raciocínio do Fable 5.1

⚠️ O mais perigoso é que, por padrão, isso acontece em silêncio. Quando chega uma requisição com blocos ilegíveis misturados, a API descarta esses blocos antes de mostrá-los ao modelo. O que foi descartado não entra em input_tokens nem é cobrado — ou seja, não aparece nem na fatura.

Quem sente isso é quem troca de modelo no meio da conversa. Roteadores, fallbacks, seleção dinâmica de modelo para otimizar custo. Todos podem acabar “parecendo que funcionam” enquanto só o raciocínio some.

Para conseguir perceber, envie o cabeçalho beta thinking-binding-controls-2026-08-01. Com ele, os descartes são reportados no array input_transformations de nível superior. Sem o cabeçalho, não há relatório algum.

4. Mudança incompatível 3: editar turnos antigos quebra a conversa

Das três, é a que atinge mais amplamente o código existente. Alterar qualquer coisa que esteja antes de um bloco de raciocínio do Fable 5.1 — o prompt system, as tools, as mensagens anteriores — faz com que a requisição seguinte retorne erro.

The block is bound to a different conversation

Padrões que invalidam todos os blocos de raciocínio seguintes

  • Editar, reordenar ou excluir turnos antigos mantendo os turnos posteriores
  • Inserir texto específico de cada requisição em turnos antigos e removê-lo na requisição seguinte (lembretes ou linhas de status)
  • Reconstruir o prompt system ou o array tools dentro da mesma conversa
  • URLs de imagens ou documentos que, em requisições posteriores, devolvem bytes diferentes (o que se observa são os bytes, não a URL; se o arquivo for o mesmo, URLs assinadas rotativas não são problema)

O que, ao contrário, não quebra nada

  • Remover blocos de raciocínio de forma contínua a partir do início (do mais antigo para o mais novo)
  • Encolher o histórico com compactação do lado do servidor ou edição de contexto
  • Mover marcadores cache_control
  • Mudar o effort entre requisições

Atenção: remover um único bloco de raciocínio que não seja o primeiro invalida todos os seguintes.

⚠️ Se isso se aplica ou não depende de quando a conta foi criada. Essa verificação é obrigatória em contas criadas a partir de 31 de agosto de 2026. Em contas anteriores, a API apenas registra a divergência e só a reflete no comportamento quando thinking.block_binding.prefix_mismatch_behavior é configurado.

Pode acontecer de um ambiente de testes recém-criado falhar enquanto a produção não falha, e também o contrário.

Como descobrir se o seu código é afetado

A documentação oficial indica um procedimento concreto: rode uma sessão com prefix_mismatch_behavior: "drop_block" e registre input_transformations nos logs. Se você edita o histórico, vai aparecer ali reason: "prefix_binding_mismatch".

Vale notar que Claude Code, claude.ai, Claude Managed Agents e Claude Agent SDK foram feitos para não quebrar esse prefixo. São afetados apenas os códigos que montam o array messages por conta própria.

5. Leitura de cache por um quarto do preço: quanto cai na prática

Nem a entrada nem a saída ficaram mais caras. O que mudou foi apenas a leitura de cache.

Item Por milhão de tokens
Entrada base $10
Escrita em cache (5 minutos) $12.50
Escrita em cache (1 hora) $20
Leitura de cache $0.25
Saída $50
Processamento em lote Entrada $5 / saída $25

O efeito depende de quantas vezes o prefixo em cache é relido. Nos demais modelos Claude, a leitura de cache custa 0.1 vez a entrada base; no Fable 5.1 e no Mythos 5.1, 0.025 vez. Quanto mais longa a execução agêntica que relê o mesmo prefixo, maior a diferença.

O ganho citado pela documentação oficial é de cerca de 25% em cargas típicas e de até cerca de 45% em trabalhos de perfil mais agêntico. A escrita em cache e o comprimento mínimo de cache, de 512 tokens, não mudaram.

6. Sete comportamentos que mudam sem você mexer no código

É aqui que as migrações costumam deixar coisas passar. A especificação da API é a mesma, mas o que sai é diferente. A documentação oficial lista sete pontos.

Menos chamadas de ferramenta em paralelo

Onde o Fable 5 disparava tudo de uma vez, pode passar a fazer uma chamada por turno. A qualidade da resposta não cai, mas aumentam tokens, idas e voltas e tempo real

Menos narração de progresso

Mais evidente com effort alto. Se a interface depende dessa narração, o modelo parece mudo

Com effort low, tende a responder de memória

Chama menos as ferramentas de busca e recuperação. Nos turnos que exigem informação nova, aumente o effort

Prosa mais densa

As frases podem ficar mais longas e as quebras de parágrafo, mais raras

Menos formatação

Usa negrito, títulos e listas menos do que antes. As instruções de “não formate” escritas para os modelos antigos fazem efeito demais

Nem sempre marca as citações ao resumir

Ao resumir documentos, tende a reproduzir trechos do original sem deixar claro que são citações

Reescreve o texto inteiro mesmo em correções pequenas

O resultado é o mesmo, mas gasta tokens de saída e tempo a mais

Para cada um deles existe uma solução oficial no nível do prompt. Para as chamadas em paralelo, acrescentar uma linha do tipo “dispare juntas as leituras independentes”; se você precisa de progresso, pedir explicitamente falas de abertura, de meio e de fechamento, e assim por diante.

7. Os recursos que foram acrescentados

A documentação oficial lista cinco acréscimos. Um deles é a queda no preço da leitura de cache, que, por ter impacto grande, ficou em um capítulo próprio, o quinto. Aqui vemos os quatro restantes.

Mudar o effort no meio da conversa (beta)

Dá para subir e descer a eficiência sem invalidar o cache de prompt. Suba nas etapas difíceis, desça nas rotineiras

Mensagem de sistema limitada ao turno (beta)

clear_at: "next_user_message". É o recurso feito para substituir com segurança o “inserir e apagar” da mudança 3, sem reescrever o histórico

Receber o progresso como texto (beta)

display: "updates". Mantendo o raciocínio oculto, você recebe como texto apenas o progresso entre as chamadas de ferramenta

Proveniência de conteúdo

Uma marca estatística no texto gerado. Não acrescenta tokens nem caracteres ocultos, e não carrega informação do usuário ou da organização. Imagens e vídeos recebem C2PA

Repare no segundo item. Para o padrão “inserir um lembrete e depois apagá-lo”, proibido pela mudança incompatível 3, foi oferecida ao mesmo tempo uma alternativa que cumpre o mesmo objetivo. A migração não é “pare de fazer isso”, e sim “passe a fazer assim”.

8. Roteiro de migração: cinco verificações

Depois de trocar o ID do modelo, a documentação oficial aponta os cinco itens a seguir.

model = "claude-fable-5"    # Before
model = "claude-fable-5-1"  # After
　 O que verificar
1 Remova any e tool de tool_choice. Para impor o schema, use strict tool use ou structured outputs
2 Devolva os blocos de raciocínio como estão e só acrescente ao histórico. O que era inserido e apagado passa para a mensagem de sistema limitada ao turno; alterações em system e tools, para o recurso de mudança no meio da conversa
3 Recalibre o effort a partir do padrão (high) . Considere também mudá-lo no meio da conversa
4 Verifique se o laço do seu agente não passou a fazer uma chamada por turno
5 Rode novamente suas avaliações. O tratamento de recusas, o fallback e a contagem de tokens não mudaram

A parte de recusas não mudou. stop_reason: "refusal" continua sendo devolvido, e os destinos de fallback aceitos para o Fable 5.1 são Opus 4.8 e Opus 5. Recusas que chegam antes da saída não são cobradas, e o custo de cache de prompt da troca de modelo volta como crédito de fallback.

📌 A retenção de dados é de 30 dias e, em regra, não há retenção zero de dados (salvo aprovação explícita da Anthropic). Assim como o Fable 5 e o Mythos 5, ele se enquadra como Covered Model. Dependendo dos seus requisitos, esse ponto sozinho decide se dá para adotar.

Resumo

  • Não é uma troca de carro-chefe. A documentação oficial diz que “a maioria dos usos começa pelo Opus 5”, e o Fable 5.1 é para raciocínio exigente e trabalho agêntico de longa duração
  • São três mudanças incompatíveis. Chamada de ferramenta forçada devolve 400; bloco de raciocínio vinculado ao modelo; invalidação ao editar turnos antigos
  • A segunda falha em silêncio. Os blocos ilegíveis são descartados e nem aparecem na cobrança. Para perceber, é preciso o cabeçalho beta
  • A terceira se aplica ou não conforme a data de criação da conta (obrigatória a partir de 31 de agosto de 2026). O comportamento pode divergir entre teste e produção
  • Não houve aumento de preço. Só a leitura de cache caiu para um quarto (0.025 vez a entrada base). O efeito depende de quantas vezes o mesmo prefixo é relido
  • Sete comportamentos mudam sem você mexer no código. A queda nas chamadas de ferramenta em paralelo, em especial, afeta diretamente custo e tempo

FAQ

Q1. Devo migrar imediatamente?

Ninguém está te apressando. O Fable 5 continua disponível como legacy, e a Anthropic declarou que a descontinuação não será antes de 1 de setembro de 2027. A motivação para migrar é custo — como a leitura de cache cai para um quarto, quanto mais longa a execução que relê o mesmo prefixo, maior o ganho. Já se o seu uso é feito de chamadas curtas e isoladas, a diferença é pequena.

Q2. Se eu só uso o Claude Code, as mudanças incompatíveis me afetam?

Quanto à terceira, não afetam. A documentação oficial afirma que Claude Code, claude.ai, Claude Managed Agents e Claude Agent SDK foram feitos para não quebrar o prefixo. O que é afetado é o código que monta o array messages por conta própria.

Q3. Tenho um mecanismo que troca de modelo dinamicamente. O que preciso corrigir?

Esse é o centro da segunda mudança. Ao passar do Fable 5.1 para a geração anterior, o raciocínio daquele turno se perde. E, por padrão, ele é descartado em silêncio e não aparece na cobrança. O primeiro passo é enviar o cabeçalho beta thinking-binding-controls-2026-08-01, registrar input_transformations nos logs e medir se o descarte está mesmo acontecendo.

Q4. Opus 5 ou Fable 5.1, qual escolher?

O mais sensato é seguir a recomendação oficial ao pé da letra — teste primeiro com o Opus 5 e vá para o Fable 5.1 “quando nem o effort alto for suficiente”. O preço é o dobro do Opus 5 tanto na entrada quanto na saída, e só a leitura de cache é, ao contrário, mais barata. Os detalhes de quando usar cada um estão no guia de escolha entre eles.

Q5. Quero apagar blocos de raciocínio para economizar contexto

Há condições para apagar. Remover de forma contínua a partir do início, do mais antigo para o mais novo, não é problema; mas tirar um bloco do meio invalida todos os blocos de raciocínio seguintes. Se você usar a edição de contexto ou a compactação do lado do servidor, isso não conta como edição.

Q6. Dizem que há uma marca-d'água. Isso afeta a saída?

A documentação oficial diz que não — não altera sentido, qualidade nem legibilidade, não acrescenta tokens nem caracteres ocultos e não inclui informação do usuário ou da organização. Também não exige mudanças na requisição nem na resposta. Imagens e vídeos recebem Content Credentials C2PA via Files API.

Q7. Posso usar o Mythos 5.1?

O desempenho é o mesmo do Fable 5.1, mas o acesso está restrito aos participantes do Project Glasswing. A diferença está nas salvaguardas: no Terminal-Bench 4.0, por exemplo, o Fable 5.1 faz 55.8% contra 60.9% do Mythos 5.1 — uma diferença atribuída ao fato de que é o mesmo modelo, mudando apenas as salvaguardas.

Artigos relacionados