Novidades do Claude Sonnet 5.5

O Claude Sonnet 5.5 oferece a melhor combinação de velocidade e inteligência. Cinco "breaking changes" (mudanças incompatíveis) afetam código que já roda no Claude Sonnet 5:

• Desative o pensamento antecipado com between_tools.
• O uso forçado de ferramentas retorna um erro.
• Os blocos de pensamento estão vinculados ao modelo e à conversa.
• Na Claude API e no Google Cloud, a ferramenta de uso do computador anterior computer_20251124 não é aceita.
• A ferramenta de consultor rejeita Claude Opus 4.8, Claude Opus 4.7 e Claude Sonnet 5 como consultores.

Mais uma mudança altera o formato da resposta sem fazer nenhuma requisição falhar: o texto entre chamadas de ferramentas volta em blocos thinking. Uma aplicação que faz streaming desse texto para seus usuários fica em silêncio entre as chamadas de ferramentas até definir um valor de display que retorne o texto, ou até desativar o pensamento antecipado com between_tools.

Novo modelo

O "adaptive thinking" (pensamento adaptativo) fica ativado por padrão, e o parâmetro "effort" (esforço) controla a profundidade do pensamento. Seu padrão na Claude API é high. O "tokenizer" (tokenizador) é o mesmo do Claude Sonnet 5, então o mesmo texto produz as mesmas contagens de tokens. Para a "context window" (janela de contexto), os limites de saída, a data de corte do conhecimento e os preços, consulte a página do modelo Claude Sonnet 5.5.

Para todos os modelos atuais, consulte a visão geral dos modelos.

Mudanças incompatíveis

Desative o pensamento antecipado com between_tools

Para desativar o "up-front thinking" (pensamento antecipado) no Claude Sonnet 5.5, envie thinking: {"type": "between_tools"} em vez de "disabled". Essa é a configuração de pensamento mais baixa neste modelo. Ela está disponível em todas as plataformas que oferecem o Claude Sonnet 5.5. Ela não precisa de cabeçalho beta. As breves "progress updates" (atualizações de progresso) que o modelo escreve entre chamadas de ferramentas continuam voltando como blocos thinking com seu texto de resumo. Devolva esses blocos sem alterações junto com o restante do turno do assistente. Um bloco de atualização de progresso que você envia de volta fornece ao modelo a nota completa que ele escreveu, não o resumo. Se suas requisições não usam ferramentas, a resposta contém apenas texto, como acontece com disabled no Claude Sonnet 5.

No Claude Sonnet 5.5, uma requisição que envia thinking: {"type": "disabled"} retorna um invalid_request_error 400 cuja mensagem aponta para between_tools.

between_tools é aceito com esforço low, medium e high. Com esforço xhigh ou max, uma requisição com between_tools retorna um erro 400. Para executar com xhigh ou max, use o pensamento adaptativo: omita o campo thinking ou envie thinking: {"type": "adaptive"}, que é equivalente. Com between_tools, o esforço não pode mudar no meio da conversa: um output_config.effort por mensagem que difira do nível em vigor retorna um erro 400. Para variar o esforço a cada turno, use o pensamento adaptativo.

between_tools não aceita nenhum outro campo: display, budget_tokens ou block_binding enviados com ele retornam um erro 400. Orçamentos manuais de pensamento (thinking: {"type": "enabled", "budget_tokens": N}) retornam um erro 400. Consulte Pensamento e o antes e depois do guia de migração.

O uso forçado de ferramentas não é suportado

O Claude Sonnet 5.5 não suporta "forced tool use" (uso forçado de ferramentas). tool_choice definido como {"type": "any"} ou {"type": "tool", "name": "..."} retorna um invalid_request_error 400:

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

tool_choice: {"type": "auto"} (o padrão) e {"type": "none"} são suportados. A mesma verificação se aplica ao endpoint de contagem de tokens. Para obter entradas de ferramentas válidas segundo o schema, mantenha tool_choice: {"type": "auto"} e defina strict: true com o uso estrito de ferramentas, ou mova o schema para saídas estruturadas. Para fazer o modelo chamar uma ferramenta em vez de responder em texto, diga no prompt quando a ferramenta se aplica. O guia de migração mostra o antes e depois.

Os blocos de pensamento estão vinculados ao modelo e à conversa

Cada "thinking block" (bloco de pensamento) registra qual modelo o produziu. Cada modelo lê seus próprios blocos e apenas os blocos de alguns outros modelos. O Claude Sonnet 5.5 lê blocos de pensamento do Claude Sonnet 5, Claude Opus 4.8, Claude Haiku 4.5 e modelos anteriores, mas não do Claude Opus 5, Claude Opus 5.5 ou de qualquer modelo Claude Fable ou Claude Mythos. Nenhum outro modelo lê blocos de pensamento do Claude Sonnet 5.5.

Assim, uma conversa que passa do Claude Sonnet 5 para o Claude Sonnet 5.5 mantém seu raciocínio, e uma que passa do Claude Sonnet 5.5 para qualquer outro modelo executa os turnos após a troca sem ele. Quando uma requisição carrega um bloco que o modelo de destino não consegue ler, a API o descarta antes que o modelo o veja: a requisição é bem-sucedida, e os blocos descartados não são cobrados. Com o cabeçalho beta thinking-binding-controls-2026-08-01, o descarte é informado em um array input_transformations de nível superior. Consulte Trocar de modelo no meio da conversa.

A API também verifica se algo antes de um bloco de pensamento do Claude Sonnet 5.5 mudou desde que o bloco foi produzido: o prompt system, as tools ou uma mensagem anterior. Ela aplica essa verificação por padrão para contas criadas em ou após 31 de agosto de 2026, 00:00 UTC, na Claude API, no Amazon Bedrock e no Google Cloud. Nessas contas, uma requisição que reenvia um bloco após tal mudança retorna um erro 400. Para, em vez disso, descartar os blocos afetados, envie o cabeçalho beta thinking-binding-controls-2026-08-01 e defina thinking.block_binding.prefix_mismatch_behavior como "drop_block". Em contas mais antigas, definir esse campo com qualquer um dos valores ativa a verificação para a requisição. block_binding funciona apenas com thinking: {"type": "adaptive"}. Com between_tools, mantenha o histórico somente com acréscimos, ou remova os blocos de pensamento a partir do turno editado.

Mantenha a conversa somente com acréscimos para que a verificação nunca falhe: altere instruções ou ferramentas com mensagens do sistema no meio da conversa em vez de edições. Consulte Pensamento preservado e a nota sobre essa mudança no guia de migração.

A ferramenta de uso do computador computer_20251124 não é suportada na Claude API e no Google Cloud

Na Claude API e no Google Cloud, o Claude Sonnet 5.5 suporta "computer use" (uso do computador) apenas por meio do conjunto de ferramentas computer_toolset_20260801. Uma requisição que declara a ferramenta anterior computer_20251124 retorna um invalid_request_error 400. Na Claude API, a mensagem nomeia o tipo rejeitado e, em seguida, lista os tipos de ferramenta que o modelo aceita. Ela começa assim:

'claude-sonnet-5-5' does not support tool types: computer_20251124.

No Amazon Bedrock, o Claude Sonnet 5.5 aceita a ferramenta anterior computer_20251124.

Para migrar uma integração existente na Claude API ou no Google Cloud, siga Migrar de computer_20251124, que mostra a requisição antes e depois. Remova o cabeçalho beta, substitua a entrada de tools por {"type": "computer_toolset_20260801"} e atualize o loop do seu agente para blocos tool_use de membros, ações em lote e toolset_name nos resultados. O conjunto de ferramentas está disponível na Claude API e no Google Cloud. Para outras plataformas, consulte a seção Compatibilidade da ferramenta de uso do computador. Integrações que já usam o conjunto de ferramentas, e a ferramenta de uso do navegador, não precisam de alterações.

Alguns pareamentos da ferramenta de consultor não são suportados

Com a "advisor tool" (ferramenta de consultor) (beta), um executor Claude Sonnet 5.5 precisa ter como consultor o Claude Mythos 5.1, Claude Fable 5.1, Claude Mythos 5, Claude Fable 5, Claude Opus 5.5 ou Claude Opus 5, ou o próprio Claude Sonnet 5.5. Consultores Claude Opus 4.8, Claude Opus 4.7 e Claude Sonnet 5 funcionam com um executor Claude Sonnet 5, mas com um executor Claude Sonnet 5.5 eles retornam um invalid_request_error 400. Todo consultor que o Claude Sonnet 5.5 aceita retorna seu conselho criptografado, como um bloco advisor_redacted_result, de modo que seu cliente não consegue ler o texto do conselho. Consulte Compatibilidade de modelos e Variantes de resultado da ferramenta de consultor.

Suporte a recursos

O Claude Sonnet 5.5 suporta esforço por mensagem (beta), mensagens do sistema no meio da conversa, alterações de ferramentas no meio da conversa (beta), "prompt caching" (cache de prompt) com um prompt mínimo armazenável em cache de 512 tokens, processamento em lote, a Files API, suporte a PDF, visão e ferramentas do lado do servidor e do lado do cliente. Esforço por mensagem, mensagens do sistema no meio da conversa e alterações de ferramentas no meio da conversa não estão disponíveis no Claude Sonnet 5, cujo prompt mínimo armazenável em cache é de 1.024 tokens. Na Claude API e no Google Cloud, o uso do computador requer o conjunto de ferramentas computer_toolset_20260801 (consulte a mudança incompatível). Consulte a página de cada recurso para ver a disponibilidade por modelo.

Compactação sob demanda (beta)

Com o cabeçalho beta compact-2026-09-04, uma requisição que envia o parâmetro de nível superior compaction retorna um bloco compaction assinado que resume toda a conversa. Em seguida, você envia esse bloco primeiro, no lugar das mensagens resumidas. Você escolhe quando compactar, e os blocos de pensamento nos turnos que você mantém podem continuar válidos após a substituição, nas condições descritas em Compactação e pensamento preservado. Isso importa no Claude Sonnet 5.5 porque seus blocos de pensamento estão vinculados à conversa. Consulte Compactação sob demanda para ver a disponibilidade por plataforma e o fluxo completo da requisição.

Definir ferramentas em uma mensagem (beta)

Com o cabeçalho beta inline-tools-2026-09-15, um bloco tool_addition em uma mensagem do sistema no meio da conversa pode carregar uma definição completa de ferramenta em vez de uma referência. Você pode adicionar uma ferramenta, alterar seu schema ou mover uma ferramenta do servidor para uma versão mais recente no meio da conversa sem editar tools e sem perder o cache de prompt. Consulte Definir ferramentas em uma mensagem.

Os blocos de pensamento permanecem com a conta que os produziu

Os blocos de pensamento que o Claude Sonnet 5.5 produz 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 veja, e a requisição é bem-sucedida. Na Claude API e no Google Cloud, 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". Blocos de modelos anteriores não são afetados. Consulte Pensamento preservado.

Diferenças de comportamento

O Claude Sonnet 5.5 difere do Claude Sonnet 5 de várias maneiras que aparecem sem nenhuma alteração de código. Prompts para o Claude Sonnet 5.5 traz orientações para cada uma:

• Os níveis de esforço foram recalibrados. Um nível de esforço não produz a mesma quantidade de pensamento que produzia no Claude Sonnet 5. Execute novamente sua varredura de esforço em vez de reaproveitar uma configuração. Comece com high, a menos que sua carga de trabalho seja agêntica ou sensível à "latency" (latência). Para programação agêntica e uso de ferramentas em várias etapas, comece com medium para tarefas bem especificadas e passe para high para tarefas mais difíceis ou mais longas. Para chat e outros trabalhos sensíveis à latência, comece com medium ou low.
• O texto entre chamadas de ferramentas volta em blocos de pensamento. Entre chamadas de ferramentas, notas com mais de uma ou duas frases voltam como blocos thinking de atualização de progresso. Comentários mais curtos continuam como text. Com o padrão display: "omitted", o texto dos blocos de atualização de progresso fica vazio, então uma aplicação que faz streaming dessas notas para seus usuários fica em silêncio entre as chamadas de ferramentas, sem nenhum erro. Se você desativar o pensamento antecipado com between_tools, o texto volta. O guia de migração mostra como recebê-lo.
• Categorias de salvaguardas. As salvaguardas do modelo podem recusar uma requisição em cinco categorias de stop_details. "cyber" significa que a requisição poderia possibilitar danos cibernéticos. "bio" significa que ela poderia possibilitar danos biológicos. "frontier_llm" significa que ela poderia auxiliar o desenvolvimento de modelos de IA concorrentes. "reasoning_extraction" significa que ela pede ao modelo que reproduza seu raciocínio interno no texto da resposta. "general_harms" significa que ela se enquadra em outra área da política de uso. Consulte Recusas, fallback e cobrança.

Recusas, fallback e cobrança

Tudo em Recusas e fallback se aplica ao Claude Sonnet 5.5. Uma requisição recusada retorna HTTP 200 com stop_reason: "refusal" e um objeto stop_details que nomeia a área da política. Trate as recusas e configure o fallback. O fallback do lado do servidor (fallbacks: "default", em beta, na Claude API) tenta novamente recusas "cyber" e "frontier_llm" no Claude Sonnet 5. Ele não tenta novamente recusas "bio", "reasoning_extraction" ou "general_harms". Você também pode usar o middleware do SDK ou sua própria lógica de nova tentativa. Se uma recusa que chega antes de qualquer saída é cobrada depende de sua categoria de recusa, e ela conta para seus "rate limits" (limites de taxa) em qualquer caso. Consulte Como as recusas são cobradas.

Preços

O Claude Sonnet 5.5 tem os mesmos preços do Claude Sonnet 5, incluindo as tarifas de cache de prompt e de processamento em lote. Consulte Preços para ver a lista completa, a residência de dados e os preços das ferramentas.

Disponibilidade

O Claude Sonnet 5.5 está disponível em:

• Claude API: todos os clientes, como claude-sonnet-5-5.
• AWS: Claude no Amazon Bedrock, como anthropic.claude-sonnet-5-5, e Claude Platform na AWS, como claude-sonnet-5-5.
• Google Cloud: Claude no Google Cloud, como claude-sonnet-5-5.
• Microsoft Foundry: Claude no Microsoft Foundry, como claude-sonnet-5-5.

Migrar do Claude Sonnet 5

Atualize o ID do seu modelo:

model = "claude-sonnet-5"  # Before
model = "claude-sonnet-5-5"  # After

Em seguida, verifique seis coisas:

1. Se o seu código desativa o pensamento com disabled, envie between_tools em vez disso, com esforço high ou inferior.
2. Substitua os tipos any e tool de tool_choice por auto mais o uso estrito de ferramentas.
3. Mantenha as conversas somente com acréscimos. Uma requisição que reenvia um bloco de pensamento do Claude Sonnet 5.5 após uma edição no histórico anterior pode retornar um erro 400. Consulte Os blocos de pensamento estão vinculados ao modelo e à conversa.
4. Se você usa o uso do computador por meio de computer_20251124 na Claude API ou no Google Cloud, migre para o conjunto de ferramentas.
5. Se você usa a ferramenta de consultor com um consultor Claude Opus 4.8, Claude Opus 4.7 ou Claude Sonnet 5, troque para um consultor que o Claude Sonnet 5.5 aceite.
6. Se a sua interface mostra o texto entre chamadas de ferramentas, defina thinking.display quando usar o pensamento adaptativo. Com between_tools, o texto volta sem essa configuração. Consulte O texto entre chamadas de ferramentas é retornado em blocos de pensamento.

O guia de migração traz instruções passo a passo a partir do Claude Sonnet 5 e de modelos anteriores, além da lista de verificação completa.

Próximos passos