Claude Platform Docs
Modelos e preçosClaude Fable 5.2

Guia de migração para o Claude Fable 5.2 e o Claude Mythos 5.2

Migre para Claude Fable 5.2 e Claude Mythos 5.2 a partir do Claude Fable 5.1, Claude Mythos 5.1, Claude Opus 5.5 ou de um modelo Claude Fable, Claude Mythos ou Claude Opus anterior com este guia de migração. As orientações para habilitar o Claude Fable 5.2 e o Claude Mythos 5.2 incluem IDs de modelo, alterações que quebram a compatibilidade e checklists de migração.

Claude Code

Deixe o Claude Code migrar seu código para você

/claude-api migrate este projeto para claude-fable-5-2

Se o seu agente do Claude Managed Agents tiver um “advisor” (orientador), o model do advisor é um segundo nome de modelo a ser atualizado: defina-o como claude-fable-5-2 ou claude-mythos-5-2 quando você alterar o modelo do agente. Consulte Um executor Claude Fable 5.2 precisa de um advisor Claude Fable 5.2 ou Claude Mythos 5.2.

As seções a seguir abordam a migração para o Claude Fable 5.2, ou para o Claude Mythos 5.2, a partir do Claude Fable 5.1, Claude Mythos 5.1, Claude Opus 5.5 ou de um modelo Claude Fable, Claude Mythos ou Claude Opus anterior. Para as alterações em si, consulte Novidades no Claude Fable 5.2. Para diferenças de comportamento e padrões de prompt específicos do modelo, consulte Prompting para o Claude Fable 5.2.

O Claude Fable 5.2 está disponível na Claude API, na Claude Platform on AWS e no Claude Models on Google Cloud (Anthropic managed). Ele também está disponível no Amazon Bedrock. Ele também está disponível no Claude Models on Google Cloud (Google managed). Ele também está disponível no Microsoft Foundry. O Claude Mythos 5.2 tem as mesmas capacidades e está disponível apenas para organizações verificadas por meio dos programas de verificação da Anthropic, como o Cyber Verification Program.

As configurações de base compartilhadas por claude-fable-5-2 e claude-mythos-5-2:

  • Pensamento: O “adaptive thinking” (pensamento adaptativo) está sempre ativado, sem alterações em relação ao Claude Fable 5.1. O modelo determina quando e quanto pensar, e o parâmetro de esforço controla a profundidade. Tanto thinking: {type: "disabled"} quanto o pensamento estendido manual (thinking: {type: "enabled", budget_tokens: N}) retornam um erro 400.
  • Esforço: Todos os cinco níveis de esforço são suportados, e o padrão é high, sem alterações em relação ao Claude Fable 5.1. Consulte Níveis de esforço recomendados para o Claude Fable 5.2.
  • Prefill: O “prefill” (pré-preenchimento) da mensagem do assistente retorna um erro 400, sem alterações em relação ao Claude Fable 5.1. Use instruções no prompt do sistema em vez disso.
  • Parâmetros de amostragem: Omita temperature, top_p e top_k, como no Claude Fable 5.1. Consulte Parâmetros de amostragem para ver os valores que retornam um erro 400.
  • Escolha de ferramenta: {type: "auto"} (o padrão) e {type: "none"} são suportados. Forçar uma chamada de ferramenta com {type: "any"} ou {type: "tool", name: "..."} retorna um erro 400, sem alterações em relação ao Claude Fable 5.1.
  • Saídas estruturadas: Em uma organização com “customer-managed encryption keys” (chaves de criptografia gerenciadas pelo cliente), ou CMEK, as saídas estruturadas não estão disponíveis para nenhum dos modelos, como no Claude Fable 5.1. Isso abrange tanto o uso de ferramentas estrito quanto as saídas JSON. Se suas requisições definirem strict: true ou output_config.format nesse caso, remova-os e valide a saída no seu código.
  • Pensamento preservado entre modelos: Na Claude API e no Claude Models on Google Cloud (Google managed), o Claude Fable 5.2 e o Claude Mythos 5.2 leem os blocos de pensamento um do outro e os de outros modelos, incluindo Claude Opus 5.5, Claude Sonnet 5.5 e Claude Haiku 5.5. Nenhum outro modelo lê os blocos deles. Consulte Trocando de modelo no meio de uma conversa para ver a lista.
  • Pensamento vinculado à conta: Os blocos de pensamento do Claude Fable 5.2 e do Claude Mythos 5.2 funcionam apenas na conta que os produziu, ou em uma conta vinculada a ela. Quando outra conta envia um desses blocos, a API descarta o bloco antes que o modelo o receba, e a requisição é bem-sucedida. Na Claude API e no Claude Models on Google Cloud (Google managed), com o cabeçalho beta thinking-binding-controls-2026-08-01, a resposta lista cada bloco descartado em input_transformations com reason: "organization_binding_mismatch". Consulte Os blocos de pensamento ficam com a conta que os produziu.
  • Janela de contexto e saída: Uma “context window” (janela de contexto) de 1M de tokens por padrão, e até 128k tokens de saída por requisição.
  • Preços: $8 USD por milhão de tokens de entrada e $40 USD por milhão de tokens de saída, em comparação com $10 USD e $50 USD no Claude Fable 5.1 e no Claude Mythos 5.1. As leituras do cache de prompt custam $0,20 USD por milhão de tokens, em comparação com $0,25 USD nesses modelos. Consulte Preços.
  • Retenção de dados: Ambos os modelos exigem retenção de dados de 30 dias, não estão disponíveis sob acordos de “zero data retention” (retenção zero de dados), ou ZDR, a menos que expressamente autorizados pela Anthropic, e são designados como Modelos Cobertos, assim como o Claude Fable 5.1 e o Claude Mythos 5.1. Na Claude API, uma requisição de uma organização ou workspace sem retenção de 30 dias retorna um erro 400 invalid_request_error. Organizações com um acordo de ZDR devem entrar em contato com sua equipe de conta da Anthropic ou configurar a retenção para workspaces individuais. Consulte Requisitos de retenção de dados específicos do modelo para detalhes por plataforma.
  • Priority Tier: Nenhum dos modelos é suportado no Priority Tier.
  • Modo rápido: Ambos os modelos oferecem suporte ao modo rápido em requisições da Messages API. Disponibilidade do modo rápido lista as plataformas de cada modelo.

Onde os dois modelos divergem:

  • Disponibilidade: Na Claude API, o Claude Fable 5.2 não exige aprovação de acesso. O Claude Mythos 5.2 está disponível apenas para organizações verificadas por meio dos programas de verificação da Anthropic, como o Cyber Verification Program. Para solicitar acesso, inscreva-se no programa que abrange o seu caso de uso ou entre em contato com sua equipe de conta da Anthropic.
  • Limites de taxa: O Claude Fable 5.2 tem seu próprio “rate limit” (limite de taxa), separado do limite combinado que o Claude Fable 5.1 e o Claude Fable 5 compartilham. O Claude Mythos 5.2 compartilha um limite combinado com o Claude Mythos 5.1 e o Claude Mythos 5. Consulte Limites de taxa.

Migrando para o Claude Fable 5.2 a partir do Claude Fable 5.1

A migração é, em grande parte, uma substituição direta. A superfície da API, o pensamento adaptativo sempre ativado, a restrição de escolha forçada de ferramenta, o tratamento de recusas, as categorias de stop_details e o requisito de retenção de dados são todos iguais aos do Claude Fable 5.1. O Claude Fable 5.2 custa menos: $8 USD por milhão de tokens de entrada e $40 USD por milhão de tokens de saída, em comparação com $10 USD e $50 USD no Claude Fable 5.1. Quatro alterações podem quebrar o seu código. A “prefix check” (verificação de prefixo), que detecta edições em turnos anteriores, se aplica a todas as contas. O Claude Fable 5.1 não consegue ler os blocos de pensamento do Claude Fable 5.2. A ferramenta anterior de “computer use” (uso do computador), computer_20251124, retorna um erro 400 em todas as plataformas, exceto no Amazon Bedrock. Com a ferramenta advisor, um executor Claude Fable 5.2 aceita apenas o Claude Fable 5.2 ou o Claude Mythos 5.2 como seu advisor.

Atualize o nome do seu modelo

model = "claude-fable-5-1"  # Before
model = "claude-fable-5-2"  # After

O ID do modelo é claude-fable-5-2 em todas as plataformas, exceto no Amazon Bedrock, onde é anthropic.claude-fable-5-2. Para o ID de cada plataforma, consulte a página do modelo Claude Fable 5.2.

Alterações que quebram a compatibilidade

  1. A verificação de prefixo se aplica a todas as contas: Cada bloco thinking do Claude Fable 5.2 é válido apenas em relação ao prompt system, às tools e ao histórico da conversa que o precederam, como no Claude Fable 5.1. O Claude Fable 5.2 aplica essa verificação de prefixo para todas as contas, independentemente da idade. O Claude Fable 5.1 a aplica por padrão para contas criadas em ou após 31 de agosto de 2026. Portanto, em uma conta mais antiga, requisições que passam no Claude Fable 5.1 podem falhar no Claude Fable 5.2.

    Nada muda para você se o Claude Code, o claude.ai, o Claude Managed Agents ou o Claude Agent SDK gerenciar o histórico da sua conversa. Se o seu código monta o array messages por conta própria, compare o que ele faz entre as requisições com a lista em Quem é afetado pela verificação de prefixo. Uma requisição que envia de volta um bloco de pensamento após uma dessas edições retorna um erro 400:

    messages.5.content.0: Invalid `signature` in `thinking` block. The block is bound to a different conversation. Remove the block, or set `thinking.block_binding.prefix_mismatch_behavior` to "drop_block". That setting requires the `thinking-binding-controls-2026-08-01` value in the `anthropic-beta` header.

    Tentar novamente com o mesmo corpo de requisição não elimina o erro. Para encontrar essas edições antes de migrar o tráfego de produção, execute a verificação em Verifique se o seu código edita o prefixo com o modelo que você usa agora, Claude Fable 5.1 ou Claude Opus 5.5. Ela funciona a partir de qualquer conta, porque definir prefix_mismatch_behavior inclui a requisição na verificação. O Pensamento preservado apresenta a correção para cada padrão.

    Em produção, mantenha prefix_mismatch_behavior no seu padrão, "error", se uma incompatibilidade só puder significar um bug no seu código. Para descartar os blocos afetados e continuar sem esse raciocínio enquanto você corrige a edição, defina-o como "drop_block". Trate isso como uma solução temporária, não como uma configuração de longo prazo: descartar blocos pode aumentar os tokens de saída.

  2. O Claude Fable 5.1 não consegue ler os blocos de pensamento do Claude Fable 5.2: Na Claude API e no Claude Models on Google Cloud (Google managed), o Claude Fable 5.2 lê os blocos do Claude Fable 5.1, então uma conversa que passa de claude-fable-5-1 para claude-fable-5-2 mantém seu raciocínio anterior. Na direção oposta, o Claude Fable 5.1 não consegue ler os blocos do Claude Fable 5.2. Se uma troca de roteador, uma nova tentativa no lado do cliente ou um fallback após recusa do classificador mover uma conversa do Claude Fable 5.2 para outro modelo, incluindo o Claude Fable 5.1, a API descarta os blocos que esse modelo não consegue ler. A requisição é bem-sucedida, e você não é cobrado pelos tokens de entrada descartados. O modelo então trabalha sem esse raciocínio, o que pode aumentar o custo e a latência no primeiro turno após a troca. Com o cabeçalho beta thinking-binding-controls-2026-08-01, input_transformations lista cada bloco descartado com reason: "model_binding_mismatch". Consulte Trocando de modelo no meio de uma conversa.

  3. Use o toolset de computer use em vez de computer_20251124: Uma entrada em tools do tipo computer_20251124 retorna um erro 400 em todas as plataformas, exceto no Amazon Bedrock. Declare o toolset computer_toolset_20260801 em vez disso: remova o cabeçalho beta e envie a entrada sem name nem dimensões de tela. Em seguida, atualize o loop do seu agente para o toolset, conforme descrito em Migrar de computer_20251124. No Amazon Bedrock, a ferramenta anterior funciona como no Claude Fable 5.1.

  4. Um executor Claude Fable 5.2 precisa de um advisor Claude Fable 5.2 ou Claude Mythos 5.2: Com a ferramenta advisor, que está em beta, o advisor deve ser pelo menos tão capaz quanto o executor. Um executor Claude Fable 5.2 ou Claude Mythos 5.2 aceita apenas o Claude Fable 5.2 ou o Claude Mythos 5.2 como seu advisor, e qualquer outro advisor, incluindo o Claude Fable 5.1 e o Claude Mythos 5.1, retorna um erro 400 invalid_request_error. Ao alterar o ID do modelo do executor, defina o model na definição da ferramenta advisor como claude-fable-5-2 ou claude-mythos-5-2. Alterar o model do advisor é uma edição em tools, portanto faça a alteração em novas conversas. Uma requisição que envia de volta blocos de pensamento anteriores após a alteração falha na verificação de prefixo (consulte A verificação de prefixo se aplica a todas as contas) e retorna um erro 400, a menos que você defina prefix_mismatch_behavior como "drop_block". Para manter seu executor atual e alterar apenas o advisor, defina o model do advisor como claude-fable-5-2: todos os modelos executores o aceitam. Um advisor Claude Fable 5.2 retorna seu conselho criptografado, então, se o seu código lê o texto do conselho, consulte Variantes de resultado. Os mesmos pares se aplicam ao advisor de um agente do Claude Managed Agents, portanto defina o model desse advisor como um desses dois modelos quando você alterar o do agente. Consulte Compatibilidade de modelos e Dê um advisor à sessão.

Alterações de comportamento

  1. Linhas de prompt que pedem menos pensamento não impedem o modelo de pensar com esforço medium ou superior: O Claude Fable 5.1 geralmente segue uma linha como “responda diretamente sem deliberar”. Nos testes da Anthropic, essa linha não impediu o Claude Fable 5.2 de pensar com medium ou superior. Remova essas linhas e reduza o nível de esforço. Consulte Calibre o esforço.
  2. O modelo pode iniciar subagentes para revisar o próprio trabalho com esforço mais alto: Em um produto de programação agêntica com níveis de esforço mais altos, como xhigh e max, a Anthropic observou o Claude Fable 5.2 usando subagentes para revisar o próprio trabalho. O Claude Fable 5.1 não fazia isso nas mesmas tarefas. Os subagentes podem representar uma grande parte do custo de uma sessão. Consulte Defina expectativas para subagentes.
  3. Um max_tokens pequeno pode não deixar espaço para texto: Os tokens de pensamento contam para max_tokens, então uma requisição com um max_tokens pequeno pode parar com stop_reason: "max_tokens" após um bloco thinking e antes de qualquer texto. Uma linha de prompt que geralmente impede o Claude Fable 5.1 de pensar não impede o Claude Fable 5.2 de pensar com esforço medium ou superior. Assim, uma requisição que dependia dessa linha para caber em um max_tokens pequeno no Claude Fable 5.1 pode esgotar os tokens antes de qualquer texto no Claude Fable 5.2. Aumente max_tokens para deixar espaço para o pensamento ou escolha um nível de esforço mais baixo.

Para os outros comportamentos a verificar ao transferir prompts, consulte Diferenças de comportamento.

Checklist de migração

  • Atualize o nome do modelo de claude-fable-5-1 para claude-fable-5-2.
  • Verifique seus limites de taxa antes de migrar o tráfego de produção. O Claude Fable 5.2 tem seu próprio limite de taxa, separado do que o Claude Fable 5.1 e o Claude Fable 5 compartilham.
  • Se você usa computer use por meio de computer_20251124 em qualquer lugar, exceto no Amazon Bedrock, o Claude Fable 5.2 retorna um erro 400 para essa ferramenta. Declare computer_toolset_20260801 em vez disso e atualize o loop do seu agente para o toolset.
  • Se você usa a ferramenta advisor com o Claude Fable 5.2 como executor, defina o model do advisor como claude-fable-5-2 ou claude-mythos-5-2.
  • Se o seu código monta o array messages por conta própria, execute uma sessão com o cabeçalho beta thinking-binding-controls-2026-08-01 e prefix_mismatch_behavior: "drop_block", registre input_transformations e corrija todas as entradas prefix_binding_mismatch. Faça isso mesmo que sua conta nunca tenha acionado a verificação no Claude Fable 5.1.
  • Escolha um prefix_mismatch_behavior para produção: "error" (o padrão) ou "drop_block" como solução temporária enquanto você corrige as edições, porque descartar blocos pode aumentar os tokens de saída. Monitore os erros 400 ou as entradas de input_transformations.
  • Continue enviando de volta os blocos thinking sem alterações em todos os turnos, incluindo os vazios. Se um roteador ou fallback puder mover uma conversa do Claude Fable 5.2 para o Claude Fable 5.1, espere que o Claude Fable 5.1 seja executado sem os blocos do Claude Fable 5.2.
  • Se você reproduz conversas armazenadas por meio de uma conta diferente, reproduza cada uma pela conta que a produziu, ou por uma conta vinculada a ela. A API descarta blocos de pensamento do Claude Fable 5.2 produzidos por outra conta. Consulte Os blocos de pensamento ficam com a conta que os produziu.
  • Execute novamente sua varredura de esforço nas suas próprias avaliações e restabeleça a linha de base de custo e latência.
  • Verifique os prompts do sistema, skills e outras instruções que você transfere em relação a Revise instruções escritas para modelos anteriores.

Migrando para o Claude Mythos 5.2 a partir do Claude Mythos 5.1

O Claude Mythos 5.2 é a contraparte do Claude Fable 5.2 para organizações verificadas por meio dos programas de verificação da Anthropic, como o Cyber Verification Program. Confirme que sua organização tem acesso ao Claude Mythos 5.2 antes de trocar os IDs de modelo.

O Claude Mythos 5.2 aplica a verificação de prefixo para todas as contas, assim como o Claude Fable 5.2. Quando prefix_mismatch_behavior não está definido mostra onde o Claude Mythos 5.1 já retorna o erro. No Amazon Bedrock, o Claude Mythos 5.2 retorna o erro 400 para turnos anteriores editados, enquanto o Claude Mythos 5.1 aceita esse tipo de requisição. Se o seu código edita turnos anteriores, consulte Editar turnos anteriores invalida os blocos de pensamento para saber o que alterar e como testar, e execute o teste com claude-mythos-5-2.

Na Claude API e no Claude Models on Google Cloud (Google managed), o Claude Mythos 5.2 lê os blocos de pensamento do Claude Mythos 5.1, então uma conversa que passa de claude-mythos-5-1 para claude-mythos-5-2 mantém seu raciocínio anterior. Na direção oposta, o Claude Mythos 5.1 não consegue ler os blocos do Claude Mythos 5.2: a API os descarta, e a requisição é bem-sucedida. Consulte Trocando de modelo no meio de uma conversa.

Com a ferramenta advisor, que está em beta, um executor Claude Mythos 5.2 aceita apenas o Claude Mythos 5.2 ou o Claude Fable 5.2 como seu advisor. Um advisor Claude Mythos 5.1 ou Claude Fable 5.1 retorna um erro 400. Consulte Um executor Claude Fable 5.2 precisa de um advisor Claude Fable 5.2 ou Claude Mythos 5.2.

O Claude Mythos 5.2 suporta computer use por meio do toolset computer_toolset_20260801. Uma entrada em tools do tipo computer_20251124 retorna um erro 400 em todas as plataformas, exceto no Amazon Bedrock, onde a ferramenta anterior funciona. Consulte Use o toolset de computer use em vez de computer_20251124.

O Claude Mythos 5.2 custa $8 USD por milhão de tokens de entrada e $40 USD por milhão de tokens de saída, em comparação com $10 USD e $50 USD no Claude Mythos 5.1. As leituras do cache de prompt custam $0,20 USD por milhão de tokens, em comparação com $0,25 USD.

Atualize o nome do seu modelo

model = "claude-mythos-5-1"  # Before
model = "claude-mythos-5-2"  # After

Checklist de migração

  • Atualize o nome do modelo de claude-mythos-5-1 para claude-mythos-5-2.
  • Se você usa computer use por meio de computer_20251124 em qualquer lugar, exceto no Amazon Bedrock, o Claude Mythos 5.2 retorna um erro 400 para essa ferramenta. Declare computer_toolset_20260801 em vez disso e atualize o loop do seu agente para o toolset.
  • Se você usa a ferramenta advisor com o Claude Mythos 5.2 como executor, defina o model do advisor como claude-mythos-5-2 ou claude-fable-5-2.
  • Continue enviando de volta os blocos thinking sem alterações em todos os turnos, incluindo os vazios.
  • Se você reproduz conversas armazenadas por meio de uma conta diferente, reproduza cada uma pela conta que a produziu, ou por uma conta vinculada a ela. A API descarta blocos de pensamento do Claude Mythos 5.2 produzidos por outra conta. Consulte Os blocos de pensamento ficam com a conta que os produziu.
  • Se o seu código monta o array messages por conta própria, execute a verificação em Editar turnos anteriores invalida os blocos de pensamento com claude-mythos-5-2, corrija todas as entradas prefix_binding_mismatch e mantenha o histórico da conversa apenas com acréscimos (consulte O que conta como uma edição). Um histórico apenas com acréscimos também mantém o cache de prompt aquecido.
  • Trate stop_reason: "refusal" e leia stop_details.category antes do conteúdo da resposta. Consulte Recusas e fallback.
  • Execute novamente sua varredura de esforço e restabeleça a linha de base de custo e latência.
  • Verifique os prompts do sistema, skills e outras instruções que você transfere em relação a Revise instruções escritas para modelos anteriores.

Migrando para o Claude Fable 5.2 a partir do Claude Opus 5.5

O Claude Fable 5.2 usa a mesma Messages API e os mesmos padrões de uso de ferramentas que o Claude Opus 5.5. Ambos os modelos sempre pensam de forma adaptativa e retornam um erro 400 para escolha forçada de ferramenta, então essas partes das suas requisições são mantidas. As diferenças a seguir se aplicam quando você move tráfego, ou um caminho de fallback, para o Claude Fable 5.2.

Atualize o nome do seu modelo

model = "claude-opus-5-5"  # Before
model = "claude-fable-5-2"  # After

O que muda

  1. A retenção de dados é obrigatória: O Claude Fable 5.2 exige retenção de dados de 30 dias e não está disponível sob um acordo de retenção zero de dados (ZDR), a menos que expressamente autorizado pela Anthropic. Se sua organização ou workspace executa o Claude Opus 5.5 sob ZDR, habilite a retenção de 30 dias para um workspace ou entre em contato com sua equipe de conta da Anthropic antes de migrar. Caso contrário, na Claude API, toda requisição ao Claude Fable 5.2 retorna um erro 400 invalid_request_error. Consulte Requisitos de retenção de dados específicos do modelo.

  2. A verificação de prefixo se aplica a todas as contas: O Claude Opus 5.5 aplica a verificação de prefixo por padrão para contas criadas em ou após 31 de agosto de 2026. O Claude Fable 5.2 a aplica para todas as contas, independentemente da idade. Se sua conta for mais antiga e o seu código editar turnos anteriores, requisições que funcionam no Claude Opus 5.5 falham no Claude Fable 5.2. Para testar antes de migrar, consulte A verificação de prefixo se aplica a todas as contas.

  3. O Claude Opus 5.5 não consegue ler os blocos de pensamento do Claude Fable 5.2: Uma conversa que passa do Claude Fable 5.2 para o Claude Opus 5.5 mantém seu texto e suas chamadas de ferramenta, mas os turnos após a troca são executados sem o raciocínio do Claude Fable 5.2. A API descarta esses blocos antes que o modelo os receba, a requisição é bem-sucedida e os blocos descartados não são cobrados. Espere custo e latência mais altos no primeiro turno após a troca. Na direção oposta, na Claude API e no Claude Models on Google Cloud (Google managed), o Claude Fable 5.2 lê os blocos de pensamento do Claude Opus 5.5, então uma conversa que passa de claude-opus-5-5 para claude-fable-5-2 mantém seu raciocínio anterior.

  4. Classificadores de segurança e fallback: O Claude Fable 5.2 executa classificadores de segurança que cobrem as mesmas categorias de stop_details que o Claude Fable 5.1. Trate todas as categorias na tabela de categorias de recusa, não apenas as que você já viu no Claude Opus 5.5. Para executar novamente requisições recusadas em outro modelo, defina fallbacks: "default", que tenta novamente no modelo que a Anthropic recomenda para essa categoria, ou crie sua própria lógica de nova tentativa. Esse parâmetro está em beta na Claude API e no Claude Models on Google Cloud (Anthropic managed), e exige o cabeçalho beta server-side-fallback-2026-07-01. Os destinos de fallback permitidos para o Claude Fable 5.2 são o Claude Opus 4.8 (claude-opus-4-8) e o Claude Opus 5 (claude-opus-5). O fallback no lado do servidor não tenta novamente uma requisição recusada com "reasoning_extraction". Essa recusa retorna para você. O modelo de fallback não recebe os blocos de pensamento do Claude Fable 5.2. Consulte Recusas e fallback.

  5. Preços: O Claude Fable 5.2 custa $8 USD por milhão de tokens de entrada e $40 USD por milhão de tokens de saída, em comparação com $4 USD e $20 USD para o Claude Opus 5.5. As leituras do cache de prompt custam $0,20 USD por milhão de tokens em ambos os modelos. Consulte Preços.

  6. Modo rápido: O Claude Fable 5.2 suporta o modo rápido (speed: "fast") em requisições da Messages API na Claude API, assim como o Claude Opus 5.5. O modo rápido do Claude Fable 5.2 custa $16 USD por milhão de tokens de entrada e $80 USD por milhão de tokens de saída, em comparação com $8 USD e $40 USD para o Claude Opus 5.5 no modo rápido. Consulte Preços do modo rápido.

    O Claude Fable 5.2 também suporta o modo rápido no Claude Models on Google Cloud (Anthropic managed), com a mesma configuração speed: "fast".

    O Claude Fable 5.2 também suporta o modo rápido no Claude Models on Google Cloud (Google managed), com a mesma configuração speed: "fast". O Google Cloud define os preços nessa plataforma. Consulte Preços das plataformas de nuvem.

    O Claude Fable 5.2 também suporta o modo rápido no Claude in Microsoft Foundry para implantações hospedadas na Anthropic. Nessa plataforma, o modo rápido é um modelo separado: envie as requisições para uma implantação claude-fable-5-2-fast e deixe de fora speed.

    O Claude Mythos 5.2 também oferece suporte ao modo rápido em requisições da Messages API na Claude API, aos preços do modo rápido do Claude Fable 5.2. Disponibilidade do modo rápido lista todas as plataformas em que o Claude Mythos 5.2 tem modo rápido.

    Remova speed: "fast" no Claude Managed Agents. Remova-o também em qualquer plataforma ou opção de hospedagem em que Disponibilidade do modo rápido não liste o modelo para o qual você migra.

  7. Saídas estruturadas em organizações com CMEK: Em uma organização com chaves de criptografia gerenciadas pelo cliente, o Claude Opus 5.5 suporta saídas estruturadas e o Claude Fable 5.2 não. Remova strict: true e output_config.format das requisições que você migrar e valide a saída no seu código.

  8. O esforço padrão é high: O padrão do Claude Opus 5.5 é medium, então uma requisição que omite effort é executada um nível acima no Claude Fable 5.2. A requisição é bem-sucedida, e a alteração aparece apenas como diferenças de custo, latência e resultados. Defina effort explicitamente e, em seguida, execute novamente sua varredura de esforço nas suas próprias avaliações.

  9. Um executor Claude Fable 5.2 precisa de um advisor Claude Fable 5.2 ou Claude Mythos 5.2: Com a ferramenta advisor, que está em beta, um executor Claude Opus 5.5 aceita vários advisors, entre eles o Claude Opus 5.5 e o Claude Fable 5.1. Um executor Claude Fable 5.2 aceita apenas o Claude Fable 5.2 ou o Claude Mythos 5.2, e qualquer outro advisor retorna um erro 400. Defina o model do advisor como claude-fable-5-2 ou claude-mythos-5-2 quando você alterar o do executor. Consulte Um executor Claude Fable 5.2 precisa de um advisor Claude Fable 5.2 ou Claude Mythos 5.2.

Checklist de migração

  • Se sua organização tem um acordo de ZDR, habilite a retenção de 30 dias para o workspace, ou confirme a elegibilidade com sua equipe de conta da Anthropic, antes de qualquer outra coisa.
  • Atualize o ID do modelo de claude-opus-5-5 para claude-fable-5-2.
  • Verifique seus limites de taxa antes de migrar o tráfego de produção. O limite de taxa do Claude Fable 5.2 é separado do limite do Claude Opus 5.5, com limites de tokens menores em cada nível.
  • Se o seu código monta o array messages por conta própria, execute o teste em A verificação de prefixo se aplica a todas as contas, mesmo que sua conta nunca tenha acionado a verificação no Claude Opus 5.5.
  • Trate todas as stop_details.category. Se você definir uma lista fallbacks explícita, indique apenas os destinos permitidos do Claude Fable 5.2.
  • Se um roteador ou fallback move conversas do Claude Fable 5.2 para o Claude Opus 5.5, espere que os turnos após a troca sejam executados sem os blocos de pensamento do Claude Fable 5.2.
  • Se você reproduz conversas armazenadas por meio de uma conta diferente, reproduza cada uma pela conta que a produziu, ou por uma conta vinculada a ela. A API descarta blocos de pensamento do Claude Fable 5.2 produzidos por outra conta. Consulte Os blocos de pensamento ficam com a conta que os produziu.
  • Se você usa o modo rápido em requisições da Messages API, mantenha speed: "fast" apenas em uma plataforma ou opção de hospedagem em que Disponibilidade do modo rápido liste o modelo para o qual você migra. Nessas plataformas e opções de hospedagem, restabeleça a linha de base de custo com base nos preços do modo rápido. Em qualquer outra plataforma ou opção de hospedagem, e no Claude Managed Agents, remova speed: "fast". Você não precisa do cabeçalho beta fast-mode-2026-02-01. Na Claude API, as requisições que o enviam continuam funcionando. O Claude in Microsoft Foundry é a exceção: nessa plataforma, remova speed: "fast" e envie as requisições para uma implantação claude-fable-5-2-fast.
  • Se você usa a ferramenta advisor com o Claude Fable 5.2 como executor, defina o model do advisor como claude-fable-5-2 ou claude-mythos-5-2.
  • Em uma organização com chaves de criptografia gerenciadas pelo cliente, remova strict: true e output_config.format e valide a saída no seu código.
  • Defina effort explicitamente: o padrão do Claude Fable 5.2 é high, enquanto o do Claude Opus 5.5 é medium, então uma requisição que o omite é executada um nível acima. Em seguida, execute novamente sua varredura de esforço nas suas próprias avaliações e restabeleça a linha de base de custo e latência.
  • Verifique os prompts do sistema, skills e outras instruções que você transfere em relação a Revise instruções escritas para modelos anteriores.

Migrando para o Claude Fable 5.2 a partir do Claude Fable 5

A superfície da API, a janela de contexto e os limites de saída, o tokenizador, o pensamento adaptativo sempre ativado e o tratamento de recusas são todos iguais aos do Claude Fable 5. Algumas das alterações a seguir também se aplicam quando você migra do Claude Mythos 5 para o Claude Mythos 5.2. Migrando para o Claude Mythos 5.2 a partir do Claude Mythos 5 indica quais.

Atualize o nome do seu modelo

model = "claude-fable-5"  # Before
model = "claude-fable-5-2"  # After

Mudanças incompatíveis

  1. A escolha forçada de ferramenta retorna um erro 400: O Claude Fable 5 aceita tool_choice auto, none, any e tool. No claude-fable-5-2, {type: "any"} e {type: "tool", name: "..."} retornam um invalid_request_error 400, e o mesmo acontece com o endpoint de contagem de tokens. Consulte Uso forçado de ferramenta não suportado para ver a mensagem de erro.

    Para obter a chamada de ferramenta sem forçá-la, deixe tool_choice como auto e nomeie a ferramenta na sua instrução. Defina strict: true na ferramenta para que a chamada corresponda ao seu schema. Consulte Uso estrito de ferramentas. Se você forçava uma ferramenta apenas para obter JSON válido segundo o schema, use saídas JSON em vez disso. Em uma organização com chaves de criptografia gerenciadas pelo cliente, as saídas estruturadas não estão disponíveis para o Claude Fable 5.2 nem para o Claude Mythos 5.2. Isso abrange tanto o uso estrito de ferramentas quanto as saídas JSON. Nesse caso, mantenha auto e a instrução, deixe de fora strict e valide a entrada da ferramenta no seu código.

    Se a sua aplicação exigir uma chamada de ferramenta específica no turno atual, acrescente uma mensagem de sistema no meio da conversa após o turno user mais recente. Nomeie a ferramenta, diga que a chamada é obrigatória neste turno e instrua o Claude a iniciar a resposta com ela. Os turnos anteriores permanecem inalterados, de modo que os acertos de cache de prompt e os blocos de pensamento deles continuam válidos. Mensagens de sistema no meio da conversa lista as plataformas em que elas estão disponíveis. Para um turno que não deve chamar ferramentas, tool_choice: {"type": "none"} continua funcionando. Consulte Forçando o uso de ferramentas.

  2. Editar turnos anteriores invalida os blocos de pensamento, em todas as contas: O Claude Fable 5 não verifica se os turnos anteriores mudaram. No Claude Fable 5.2, cada bloco thinking é válido apenas em relação ao prompt system, às tools e às mensagens que vieram antes dele. O Claude Fable 5.2 aplica essa verificação de prefixo para todas as contas. Uma requisição que reenvia um bloco de pensamento depois que qualquer um desses elementos mudou retorna um erro 400, e repetir o mesmo corpo de requisição não resolve o problema.

    Nada muda para você se o Claude Code, o claude.ai, o Claude Managed Agents ou o Claude Agent SDK gerenciar o histórico da sua conversa. Se o seu código monta o próprio array messages, mantenha o histórico “append-only” (somente de acréscimo). Congele system e tools durante a sessão. Faça mudanças de instruções e de ferramentas com mensagens de sistema no meio da conversa e reduza o contexto com compactação no servidor ou com edição de contexto. Mensagens de sistema no meio da conversa lista as plataformas em que elas estão disponíveis. Faça alterações sem editar o prefixo apresenta a alternativa para cada edição comum.

    Para encontrar essas edições antes de migrar o tráfego de produção, execute a verificação em Verifique se o seu código edita o prefixo contra o claude-fable-5-2. Em produção, deixe prefix_mismatch_behavior no padrão, "error", se uma divergência só puder significar um bug no seu código. Para descartar os blocos afetados e continuar sem aquele raciocínio enquanto você corrige a edição, defina-o como "drop_block" com o cabeçalho beta thinking-binding-controls-2026-08-01. Trate isso como uma solução temporária, não como uma configuração de longo prazo: descartar blocos pode aumentar os tokens de saída.

  3. O Claude Fable 5 não consegue ler os blocos de pensamento do Claude Fable 5.2: Na Claude API e no Claude Models on Google Cloud (Google managed), o Claude Fable 5.2 lê os blocos do Claude Fable 5, de modo que uma conversa que passa do claude-fable-5 para o claude-fable-5-2 mantém o raciocínio anterior. Na direção oposta, o Claude Fable 5 não consegue ler os blocos do Claude Fable 5.2. Se uma troca de roteador, uma nova tentativa no lado do cliente ou um fallback após recusa do classificador mover uma conversa do Claude Fable 5.2 para outro modelo, incluindo o Claude Fable 5, a API descarta os blocos que esse modelo não consegue ler. A requisição é bem-sucedida, e você não é cobrado pelos tokens de entrada descartados. Com o cabeçalho beta thinking-binding-controls-2026-08-01, input_transformations lista cada bloco descartado com reason: "model_binding_mismatch". Consulte Trocando de modelo no meio da conversa.

  4. Use o toolset de computer use em vez de computer_20251124: No Claude Fable 5.2, uma entrada de tools do tipo computer_20251124 retorna um erro 400 em todas as plataformas, exceto no Amazon Bedrock. O Claude Fable 5 a aceita com o respectivo cabeçalho beta. Declare o toolset computer_toolset_20260801 em vez disso, conforme descrito em Use o toolset de computer use em vez de computer_20251124.

  5. Um executor Claude Fable 5.2 precisa de um advisor Claude Fable 5.2 ou Claude Mythos 5.2: Com a ferramenta advisor, que está em beta, um executor Claude Fable 5.2 aceita apenas o Claude Fable 5.2 ou o Claude Mythos 5.2 como advisor. Os outros advisors que um executor Claude Fable 5 aceita, como o Claude Fable 5 e o Claude Opus 5.5, retornam um erro 400. Defina o model do advisor como claude-fable-5-2 ou claude-mythos-5-2 ao alterar o do executor. Consulte Um executor Claude Fable 5.2 precisa de um advisor Claude Fable 5.2 ou Claude Mythos 5.2.

Outras mudanças

  • Preços: $8 USD por milhão de tokens de entrada e $40 USD por milhão de tokens de saída, em comparação com $10 USD e $50 USD no Claude Fable 5. As leituras de cache de prompt custam $0,20 USD por milhão de tokens, em comparação com $1 USD. Consulte Preços.
  • Priority Tier: O Claude Fable 5.2 não é suportado no Priority Tier. O Claude Fable 5 é. Se a sua organização tiver um compromisso de Priority Tier, planeje a capacidade separadamente.
  • Esforço por mensagem (beta): Para alterar o esforço no meio de uma conversa sem perder os acertos de cache de prompt, envie uma mensagem role: "system" de esforço por mensagem em vez de alterar output_config.effort entre requisições. Essa seção lista as plataformas em que isso está disponível.

Checklist de migração

  • Atualize o nome do modelo de claude-fable-5 para claude-fable-5-2.
  • Verifique seus limites de taxa antes de mover o tráfego de produção. O Claude Fable 5.2 tem seu próprio limite de taxa, separado daquele que o Claude Fable 5.1 e o Claude Fable 5 compartilham.
  • Substitua o tool_choice forçado ({type: "any"} ou {type: "tool", ...}) por {type: "auto"} mais uma instrução explícita e ferramentas com strict: true, ou por saídas JSON. Coloque a instrução no turno user. Quando a sua aplicação exigir a chamada, coloque-a em vez disso em uma mensagem role: "system" no meio da conversa, nas plataformas listadas em Mensagens de sistema no meio da conversa. Em uma organização com chaves de criptografia gerenciadas pelo cliente, o uso estrito de ferramentas e as saídas JSON não estão disponíveis para o Claude Fable 5.2. Nesse caso, mantenha {type: "auto"} e a instrução, e valide a entrada da ferramenta no seu código.
  • Se o seu código monta o próprio array messages, execute uma sessão com o cabeçalho beta thinking-binding-controls-2026-08-01 e prefix_mismatch_behavior: "drop_block", registre input_transformations e corrija cada entrada prefix_binding_mismatch. Entradas model_binding_mismatch após uma troca de modelo são esperadas.
  • Mantenha o histórico somente de acréscimo: congele system e tools no início da sessão, faça mudanças no meio da sessão com mensagens role: "system" e reduza o contexto no servidor. Mensagens de sistema no meio da conversa lista as plataformas em que elas estão disponíveis.
  • Escolha um prefix_mismatch_behavior para produção: "error" (o padrão) ou "drop_block" como solução temporária enquanto você corrige as edições, porque descartar blocos pode aumentar os tokens de saída. Monitore os erros 400 ou as entradas de input_transformations.
  • Continue reenviando os blocos thinking inalterados em todos os turnos, incluindo os vazios. Se um roteador ou fallback puder mover uma conversa do Claude Fable 5.2 para o Claude Fable 5, espere que o Claude Fable 5 seja executado sem os blocos do Claude Fable 5.2.
  • Se você reproduz conversas armazenadas por meio de outra conta, reproduza cada uma pela conta que a gerou ou por uma conta vinculada a ela. A API descarta blocos de pensamento do Claude Fable 5.2 gerados por outra conta. Consulte Os blocos de pensamento ficam com a conta que os produziu.
  • Se você usa computer use por meio de computer_20251124 em qualquer plataforma, exceto no Amazon Bedrock, o Claude Fable 5.2 retorna um erro 400 para essa ferramenta. Declare computer_toolset_20260801 em vez disso e atualize o loop do seu agente para o toolset.
  • Se você usa a ferramenta advisor com o Claude Fable 5.2 como executor, defina o model do advisor como claude-fable-5-2 ou claude-mythos-5-2.
  • Se você altera o esforço entre requisições, passe a fazer essa alteração com uma mensagem role: "system" de esforço por mensagem, que está em beta, onde a sua plataforma oferecer suporte.
  • Se a sua organização tiver um compromisso de Priority Tier, planeje a capacidade separadamente.
  • Trate stop_reason: "refusal" e leia stop_details.category. Considere fallbacks: "default", em beta na Claude API e no Claude Models on Google Cloud (Anthropic managed).
  • Execute novamente sua varredura de esforço nas suas próprias avaliações e restabeleça as referências de custo e latência.
  • Confira os prompts do sistema, as skills e outras instruções que você reaproveitar em relação a Revise instruções escritas para modelos anteriores.

Migrando para o Claude Mythos 5.2 a partir do Claude Mythos 5

O Claude Mythos 5.2 é o equivalente do Claude Fable 5.2 para organizações verificadas pelos programas de verificação da Anthropic, como o Cyber Verification Program. Confirme que a sua organização tem acesso ao Claude Mythos 5.2 antes de trocar os IDs de modelo.

Quatro das mudanças em Migrando para o Claude Fable 5.2 a partir do Claude Fable 5 se aplicam como estão descritas:

Na Claude API e no Claude Models on Google Cloud (Google managed), o Claude Mythos 5.2 lê os blocos de pensamento do Claude Mythos 5, de modo que uma conversa que passa do claude-mythos-5 para o claude-mythos-5-2 mantém o raciocínio anterior. Na direção oposta, o Claude Mythos 5 não consegue ler os blocos do Claude Mythos 5.2: a API os descarta, e a requisição é bem-sucedida. Consulte Trocando de modelo no meio da conversa. O Claude Mythos 5.2 custa $8 USD por milhão de tokens de entrada e $40 USD por milhão de tokens de saída, em comparação com $10 USD e $50 USD no Claude Mythos 5. As leituras de cache de prompt custam $0,20 USD por milhão de tokens, em comparação com $1 USD.

Atualize o nome do modelo

model = "claude-mythos-5"  # Before
model = "claude-mythos-5-2"  # After

Checklist de migração

  • Atualize o nome do modelo de claude-mythos-5 para claude-mythos-5-2.
  • Substitua o tool_choice forçado (any ou tool) por auto mais uma instrução explícita e ferramentas com strict: true, ou por saídas JSON. Em uma organização com chaves de criptografia gerenciadas pelo cliente, o uso estrito de ferramentas e as saídas JSON não estão disponíveis para o Claude Mythos 5.2. Nesse caso, mantenha auto e a instrução, e valide a entrada da ferramenta no seu código.
  • Se você usa computer use por meio de computer_20251124 em qualquer plataforma, exceto no Amazon Bedrock, o Claude Mythos 5.2 retorna um erro 400 para essa ferramenta. Declare computer_toolset_20260801 em vez disso e atualize o loop do seu agente para o toolset.
  • Se você usa a ferramenta advisor com o Claude Mythos 5.2 como executor, defina o model do advisor como claude-mythos-5-2 ou claude-fable-5-2.
  • Continue reenviando os blocos thinking inalterados em todos os turnos, incluindo os vazios.
  • Se você reproduz conversas armazenadas por meio de outra conta, reproduza cada uma pela conta que a gerou ou por uma conta vinculada a ela. A API descarta blocos de pensamento do Claude Mythos 5.2 gerados por outra conta. Consulte Os blocos de pensamento ficam com a conta que os produziu.
  • Se o seu código monta o próprio array messages, execute a verificação em Editar turnos anteriores invalida os blocos de pensamento contra o claude-mythos-5-2, corrija cada entrada prefix_binding_mismatch e mantenha o histórico da conversa somente de acréscimo (consulte O que conta como edição). Um histórico somente de acréscimo também mantém o cache de prompt aquecido.
  • Trate stop_reason: "refusal" e leia stop_details.category antes do conteúdo da resposta. Consulte Recusas e fallback.
  • Execute novamente sua varredura de esforço e restabeleça as referências de custo e latência.
  • Confira os prompts do sistema, as skills e outras instruções que você reaproveitar em relação a Revise instruções escritas para modelos anteriores.

Migrando para o Claude Fable 5.2 a partir do Claude Opus 5

O Claude Fable 5.2 usa os mesmos padrões da Messages API e de uso de ferramentas que o Claude Opus 5. A “context window” (janela de contexto) de 1M tokens, o máximo de 128k tokens de saída, o mínimo de 512 tokens para “prompt caching” (cache de prompt) e as mensagens de sistema no meio da conversa permanecem. O mesmo vale para as restrições de prefill e de parâmetros de amostragem. As diferenças a seguir se aplicam quando você move tráfego, ou um caminho de fallback, para o Claude Fable 5.2.

Atualize o nome do modelo

model = "claude-opus-5"  # Before
model = "claude-fable-5-2"  # After

O que muda

  1. O pensamento não pode ser desativado: O Claude Opus 5 aceita thinking: {type: "disabled"} em um nível de esforço high ou inferior. No Claude Fable 5.2, o pensamento adaptativo está sempre ativo, e thinking: {type: "disabled"} retorna um erro 400 em qualquer nível de esforço. Remova o campo e controle o gasto de tokens com níveis de esforço mais baixos. Para cargas de trabalho que eram executadas com o pensamento desativado, revise max_tokens, que cobre o pensamento mais o texto da resposta. Se esse código lê o conteúdo por posição, como content[0].text, selecione os blocos de conteúdo por type, porque os blocos thinking vêm primeiro.

  2. A escolha forçada de ferramenta retorna um erro 400: O Claude Opus 5 aceita tool_choice any e tool. O Claude Fable 5.2 rejeita ambos. Consulte A escolha forçada de ferramenta retorna um erro 400 para saber o que enviar em vez disso.

  3. Editar turnos anteriores invalida os blocos de pensamento, em todas as contas: O Claude Opus 5 não verifica se os turnos anteriores mudaram. O Claude Fable 5.2 verifica, para todas as contas. Se o seu código edita mensagens anteriores, reconstrói system ou tools, ou compacta no lado do cliente entre requisições, o Claude Fable 5.2 rejeita a requisição ou descarta os blocos de pensamento inválidos. Consulte Editar turnos anteriores invalida os blocos de pensamento para saber o que mudar e como testar.

  4. O Claude Opus 5 não consegue ler os blocos de pensamento do Claude Fable 5.2: Na Claude API e no Claude Models on Google Cloud (Google managed), o Claude Fable 5.2 lê os blocos do Claude Opus 5, de modo que uma conversa que passa do claude-opus-5 para o claude-fable-5-2 mantém o raciocínio anterior. Na direção oposta, o Claude Opus 5 não consegue ler os blocos do Claude Fable 5.2. Uma conversa que passa do Claude Fable 5.2 para o Claude Opus 5 executa os turnos após a troca sem o raciocínio do Claude Fable 5.2. A API descarta esses blocos antes que o modelo os receba, a requisição é bem-sucedida e os blocos descartados não são cobrados. Consulte Trocando de modelo no meio da conversa.

  5. O texto entre chamadas de ferramenta é retornado em blocos de pensamento: No Claude Opus 5, o texto que o modelo escreve entre chamadas de ferramenta volta como blocos text. No Claude Fable 5.2, essa narração volta como blocos thinking de atualização de progresso, no máximo um antes de cada chamada de ferramenta. Se a sua interface renderiza essa narração, defina thinking.display como "updates", que está em beta, para receber as atualizações de progresso como texto enquanto o raciocínio permanece oculto, ou como "summarized" para receber ambos. Em seguida, renderize os blocos thinking não vazios entre os blocos tool_use. Consulte Atualizações de progresso entre chamadas de ferramenta.

  6. Use o toolset de computer use em vez de computer_20251124: O Claude Opus 5 aceita a ferramenta anterior computer_20251124 com o respectivo cabeçalho beta. O Claude Fable 5.2 retorna um erro 400 para ela em todas as plataformas, exceto no Amazon Bedrock. Consulte Use o toolset de computer use em vez de computer_20251124.

  7. Classificadores de segurança e fallback: Os classificadores de segurança do Claude Fable 5.2 cobrem um conjunto mais amplo de categorias de stop_details do que os classificadores do Claude Opus 5. Espere valores adicionais de stop_details.category, como "bio". Trate todas as categorias da tabela de categorias de recusa. Para executar novamente requisições recusadas em outro modelo, defina fallbacks: "default" ou implemente sua própria nova tentativa. Esse parâmetro está em beta na Claude API e no Claude Models on Google Cloud (Anthropic managed), e exige o cabeçalho beta server-side-fallback-2026-07-01. Recusas, fallback e cobrança lista os destinos de fallback permitidos.

  8. Preços: O Claude Fable 5.2 custa $8 USD por milhão de tokens de entrada e $40 USD por milhão de tokens de saída, em comparação com $5 USD e $25 USD para o Claude Opus 5. As leituras de cache de prompt custam $0,20 USD por milhão de tokens, em comparação com $0,50 USD. Consulte Preços.

  9. A retenção de dados é obrigatória: O Claude Fable 5.2 exige retenção de dados de 30 dias e não está disponível sob um acordo de “zero data retention” (retenção zero de dados), ou ZDR, a menos que expressamente autorizado pela Anthropic. O Claude Opus 5 está disponível sob ZDR. Na Claude API, uma requisição de uma organização ou workspace sem retenção de 30 dias retorna um invalid_request_error 400. Consulte Requisitos de retenção de dados específicos por modelo.

  10. Modo rápido: O Claude Opus 5 oferece suporte ao modo rápido (speed: "fast") em prévia de pesquisa, com o cabeçalho beta fast-mode-2026-02-01. O Claude Fable 5.2 oferece suporte a ele em requisições da Messages API na Claude API sem o cabeçalho. As requisições que enviam o cabeçalho continuam funcionando. O modo rápido do Claude Fable 5.2 custa $16 USD por milhão de tokens de entrada e $80 USD por milhão de tokens de saída, em comparação com $10 USD e $50 USD para o Claude Opus 5 no modo rápido. Consulte Preços do modo rápido.

    O Claude Fable 5.2 também oferece suporte ao modo rápido no Claude Models on Google Cloud (Anthropic managed), com a mesma configuração speed: "fast".

    O Claude Fable 5.2 também oferece suporte ao modo rápido no Claude Models on Google Cloud (Google managed), com a mesma configuração speed: "fast". O Google Cloud define os preços nessa plataforma. Consulte Preços das plataformas de nuvem.

    O Claude Fable 5.2 também oferece suporte ao modo rápido no Claude in Microsoft Foundry para implantações hospedadas na Anthropic. Nessa plataforma, o modo rápido é um modelo separado: envie as requisições para uma implantação claude-fable-5-2-fast e deixe de fora speed.

    O Claude Mythos 5.2 também oferece suporte ao modo rápido em requisições da Messages API na Claude API, sem o cabeçalho e aos preços do modo rápido do Claude Fable 5.2. Disponibilidade do modo rápido lista todas as plataformas em que o Claude Mythos 5.2 tem modo rápido.

    Remova speed: "fast" no Claude Managed Agents. Remova-o também se Disponibilidade do modo rápido não listar o modelo para o qual você mover.

  11. Saídas estruturadas em organizações com CMEK: Em uma organização com chaves de criptografia gerenciadas pelo cliente, o Claude Opus 5 oferece suporte a saídas estruturadas e o Claude Fable 5.2 não. Remova strict: true e output_config.format das requisições que você mover e valide a saída no seu código.

  12. Um executor Claude Fable 5.2 precisa de um advisor Claude Fable 5.2 ou Claude Mythos 5.2: Com a ferramenta advisor, que está em beta, um executor Claude Opus 5 aceita vários advisors, entre eles o Claude Opus 5 e o Claude Fable 5.1. Um executor Claude Fable 5.2 aceita apenas o Claude Fable 5.2 ou o Claude Mythos 5.2, e qualquer outro advisor retorna um erro 400. Defina o model do advisor como claude-fable-5-2 ou claude-mythos-5-2 ao alterar o do executor. Consulte Um executor Claude Fable 5.2 precisa de um advisor Claude Fable 5.2 ou Claude Mythos 5.2.

Checklist de migração

  • Se a sua organização tiver um acordo de ZDR, habilite a retenção de 30 dias para o workspace, ou confirme a elegibilidade com a equipe da sua conta na Anthropic, antes de qualquer outra coisa.
  • Atualize o ID do modelo de claude-opus-5 para claude-fable-5-2.
  • Verifique seus limites de taxa antes de mover o tráfego de produção. O limite de taxa do Claude Fable 5.2 é separado do limite do Claude Opus 5, com limites de tokens menores em cada nível.
  • Remova qualquer configuração thinking: {type: "disabled"}. Controle o gasto de tokens com níveis de esforço mais baixos, revise max_tokens e selecione os blocos de conteúdo por type.
  • Reenvie os blocos thinking inalterados em todos os turnos, incluindo os vazios. Em um loop de uso de ferramentas, reenvie-os junto com os resultados das ferramentas. Consulte Preservando blocos de pensamento.
  • Substitua o tool_choice forçado (any ou tool) por auto mais uma instrução explícita e ferramentas com strict: true, ou por saídas JSON. Em uma organização com chaves de criptografia gerenciadas pelo cliente, o uso estrito de ferramentas e as saídas JSON não estão disponíveis para o Claude Fable 5.2. Nesse caso, mantenha auto e a instrução, e valide a entrada da ferramenta no seu código.
  • Se o seu código monta o próprio array messages, execute a verificação em Editar turnos anteriores invalida os blocos de pensamento contra o claude-fable-5-2, corrija cada entrada prefix_binding_mismatch e mantenha o histórico somente de acréscimo.
  • Se você usa computer use por meio de computer_20251124 em qualquer plataforma, exceto no Amazon Bedrock, o Claude Fable 5.2 retorna um erro 400 para essa ferramenta. Declare computer_toolset_20260801 em vez disso e atualize o loop do seu agente para o toolset.
  • Se você usa a ferramenta advisor com o Claude Fable 5.2 como executor, defina o model do advisor como claude-fable-5-2 ou claude-mythos-5-2.
  • Se um roteador ou fallback mover conversas do Claude Fable 5.2 para o Claude Opus 5, espere que os turnos após a troca sejam executados sem os blocos de pensamento do Claude Fable 5.2.
  • Se você reproduz conversas armazenadas por meio de outra conta, reproduza cada uma pela conta que a gerou ou por uma conta vinculada a ela. A API descarta blocos de pensamento do Claude Fable 5.2 gerados por outra conta. Consulte Os blocos de pensamento ficam com a conta que os produziu.
  • Se a sua interface renderiza texto entre chamadas de ferramenta, defina thinking.display como "updates", que está em beta, ou como "summarized", e renderize os blocos thinking não vazios.
  • Trate todos os valores de stop_details.category. Se você definir uma lista fallbacks explícita, nomeie apenas os destinos permitidos do Claude Fable 5.2.
  • Se você usa o modo rápido em requisições da Messages API na Claude API, mantenha speed: "fast" apenas se Disponibilidade do modo rápido listar o modelo para o qual você mover. Se você o mantiver, restabeleça as referências de custo com base nos preços do modo rápido. Remova speed: "fast" no Claude Managed Agents. Você não precisa do cabeçalho beta fast-mode-2026-02-01, e as requisições que o enviam continuam funcionando.
  • Em uma organização com chaves de criptografia gerenciadas pelo cliente, remova strict: true e output_config.format, e valide a saída no seu código.
  • Execute novamente sua varredura de esforço nas suas próprias avaliações e restabeleça as referências de custo e latência.
  • Confira os prompts do sistema, as skills e outras instruções que você reaproveitar em relação a Revise instruções escritas para modelos anteriores.

Migrando para o Claude Fable 5.2 a partir do Claude Opus 4.8 ou anterior

Primeiro, siga Migrando para o Claude Fable 5.2 a partir do Claude Opus 5, com claude-opus-4-8 como o ID de modelo que você substitui. Essa seção se aplica ao código no Claude Opus 4.8 como está descrita, porque o Claude Opus 4.8, assim como o Claude Opus 5:

  • Aceita thinking: {type: "disabled"}, escolha forçada de ferramenta, a ferramenta computer_20251124 e o modo rápido.
  • Retorna o texto entre chamadas de ferramenta como blocos text.
  • Está disponível sob acordos de retenção zero de dados (ZDR).
  • Custa $5 USD por milhão de tokens de entrada e $25 USD por milhão de tokens de saída, com leituras de cache de prompt a $0,50 USD.

Esta seção acrescenta as diferenças que a seção do Claude Opus 5 não cobre.

O que muda

  1. O pensamento é executado em requisições que o omitem: No Claude Opus 4.8, o pensamento fica desativado a menos que você o solicite. No Claude Fable 5.2, uma requisição sem o campo thinking é executada com pensamento adaptativo. As respostas podem trazer blocos thinking antes dos blocos text, então selecione os blocos de conteúdo por type em vez de ler content[0].text. Em um loop de uso de ferramentas, reenvie os blocos thinking inalterados com os resultados das ferramentas, incluindo os vazios. Os tokens de pensamento são cobrados como tokens de saída, e max_tokens cobre o pensamento mais o texto da resposta. Revise max_tokens e reduza effort onde você quiser menos pensamento. Na Claude API e no Claude Models on Google Cloud (Google managed), o Claude Fable 5.2 lê os blocos de pensamento de turnos anteriores do Claude Opus 4.8, de modo que uma conversa que passa para o claude-fable-5-2 mantém esse raciocínio.

  2. Mínimo de cache de prompt menor: O comprimento mínimo de prompt armazenável em cache no Claude Fable 5.2 é de 512 tokens, abaixo dos 1.024 tokens no Claude Opus 4.8. Prompts que eram curtos demais para o cache podem criar entradas de cache, sem necessidade de alterações no código. Consulte Cache de prompt.

  3. O Priority Tier não é suportado: O Claude Opus 4.8 oferece suporte ao Priority Tier. O Claude Fable 5.2 não. Se a sua organização tiver um compromisso de Priority Tier, planeje a capacidade separadamente.

  4. O conselho da ferramenta advisor volta criptografado: Com a ferramenta advisor, que está em beta, um executor Claude Opus 4.8 pode ser combinado com um advisor que retorna o conselho em texto simples, como o Claude Opus 4.8. Os únicos advisors que um executor Claude Fable 5.2 aceita, o Claude Fable 5.2 e o Claude Mythos 5.2, retornam o conselho criptografado, como um bloco advisor_redacted_result, de modo que o seu cliente não consegue ler o texto. Se o seu código lê o texto do conselho, remova essa dependência. Consulte Variantes de resultado.

Se o seu código estiver no Claude Opus 4.7 ou anterior, aplique também parte do checklist de migração do guia do Claude Opus 5.5. Comece pelo grupo Claude Opus 4.7 ou anterior e siga até o grupo que nomeia o seu modelo. Esses grupos cobrem alterações de requisição feitas antes do Claude Opus 4.8, como parâmetros de amostragem e cabeçalhos beta removidos. Aplique o item do modo rápido desse checklist apenas se Disponibilidade do modo rápido listar o modelo para o qual você migra. Em uma organização com chaves de criptografia gerenciadas pelo cliente, as saídas estruturadas não estão disponíveis para o Claude Fable 5.2, então não aplique o item output_config.format nesse caso. Em vez disso, remova output_format das suas requisições e valide o JSON no seu código.

Checklist de migração

  • Siga o checklist do Claude Opus 5, com claude-opus-4-8 como o ID de modelo que você substitui.
  • Revise as cargas de trabalho que eram executadas sem o campo thinking. No Claude Fable 5.2, elas são executadas com pensamento, então revise max_tokens, reduza effort onde você quiser menos pensamento e selecione os blocos de conteúdo por type.
  • Verifique se qualquer código que analisa o campo thinking o trata apenas como texto de exibição. Defina thinking.display como "summarized" para receber resumos legíveis.
  • Revise prompts próximos ao mínimo de cache: prompts de 512 tokens ou mais podem criar entradas de cache.
  • Se a sua organização tiver um compromisso de Priority Tier, planeje a capacidade separadamente.
  • Se você usa a ferramenta advisor e o seu código lê o texto do conselho, remova essa dependência: o conselho chega como um bloco advisor_redacted_result criptografado.
  • Execute uma nova varredura de esforço nas suas próprias avaliações em vez de reaproveitar uma configuração ajustada para o Claude Opus 4.8.
  • No Claude Opus 4.7 ou anterior, aplique também os grupos do checklist do guia do Claude Opus 5.5 para o seu modelo. Deixe de fora o item do modo rápido, a menos que Disponibilidade do modo rápido liste o modelo para o qual você migra. Em uma organização com chaves de criptografia gerenciadas pelo cliente, deixe de fora também o item output_config.format e remova output_format das suas requisições.

Esta página foi útil?