Novidades do Claude Sonnet 5.5

Claude Sonnet 5.5 oferece a melhor combinação de velocidade e inteligência. Cinco mudanças incompatíveis podem afetar código que já está em execução 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.
• Algumas versões da ferramenta de uso do computador não são suportadas.
• A ferramenta advisor rejeita quatro modelos como advisors: Claude Opus 4.8, Claude Opus 4.7, Claude Sonnet 5 e Claude Haiku 5.5.

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 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. 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 seja diferente 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 Desativar o pensamento antecipado no 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 uma entrada de ferramenta válida 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 uso forçado de ferramentas não é suportado, no guia de migração, mostra o antes e o depois.

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

Cada “thinking block” (bloco de pensamento) registra qual modelo o produziu. Uma conversa que troca de modelo mantém seu raciocínio anterior apenas se o modelo para o qual ela passa conseguir ler os blocos de pensamento do modelo anterior:

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 receba. 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, a API relata o descarte em um array input_transformations de nível superior. Consulte Trocar de modelo e voltar. Para trocas que não envolvem o Claude Sonnet 5.5, consulte Quais trocas de modelo mantêm o raciocínio na Claude API.

A API também verifica se algo antes de um bloco de pensamento do Claude Sonnet 5.5 mudou desde que o modelo produziu o bloco. Essa “prefix check” (verificação de prefixo) abrange o prompt system, as tools e todas as mensagens anteriores. Mantenha a conversa apenas com acréscimos (append-only): altere instruções ou ferramentas com mensagens do sistema no meio da conversa em vez de edições.

Não passar no “prefix check” (verificação de prefixo) pode ou não resultar em um erro 400. Para identificar e tratar ambos os casos, consulte Verificações de prefixo em blocos de pensamento.

A verificação de prefixo é executada na Claude API e em algumas plataformas de nuvem.

Consulte Pensamento preservado e a nota sobre blocos de pensamento do guia de migração.

Algumas versões da ferramenta de uso do computador não são suportadas

Claude Sonnet 5.5 suporta computer use (uso do computador) por meio do conjunto de ferramentas computer_toolset_20260801. No Amazon Bedrock, Claude Sonnet 5.5 também aceita a ferramenta computer_20251124 com o cabeçalho beta computer-use-2025-11-24. Claude Sonnet 5.5 retorna um erro 400 para qualquer versão da ferramenta de computer use que não aceita, como computer_20251124 na Claude API. A mensagem invalid_request_error da Claude API nomeia o tipo rejeitado e, após Did you mean one of, lista os tipos de ferramenta que o modelo aceita. A mensagem começa assim:

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

Integrações que usam o conjunto de ferramentas não precisam de alteração. Para migrar uma integração com computer_20251124 para o conjunto de ferramentas, siga Migrar de computer_20251124, que mostra a requisição antes e depois. Remova o cabeçalho beta e substitua a entrada tools por {"type": "computer_toolset_20260801"}. Em seguida, atualize o loop do seu agente para blocos tool_use de membros, ações em lote e toolset_name nos resultados.

Alguns pareamentos da ferramenta advisor não são suportados

A ferramenta advisor está em beta. Um executor Claude Sonnet 5.5 aceita apenas estes advisors:

• Claude Mythos 5.2 e Claude Fable 5.2
• Claude Mythos 5.1 e Claude Fable 5.1
• Claude Mythos 5 e Claude Fable 5
• Claude Opus 5.5 e Claude Opus 5
• O próprio Claude Sonnet 5.5

Advisors Claude Opus 4.8, Claude Opus 4.7, Claude Sonnet 5 e Claude Haiku 5.5 funcionam com um executor Claude Sonnet 5. Com um executor Claude Sonnet 5.5, eles retornam um invalid_request_error 400. Todo advisor que o Claude Sonnet 5.5 aceita retorna seu conselho criptografado, como um bloco advisor_redacted_result. Assim, seu cliente não consegue ler o texto do conselho. Consulte Compatibilidade de modelos e Variantes de resultado da ferramenta advisor.

Suporte a recursos

Claude Sonnet 5.5 suporta estes recursos:

• Esforço por mensagem, que está em beta
• Mensagens do sistema no meio da conversa
• Alterações de ferramentas no meio da conversa, que estão em 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
• Ferramentas do lado do servidor e do lado do cliente (consulte Uso de ferramentas com Claude)

O Claude Sonnet 5 não suporta esforço por mensagem, mensagens do sistema no meio da conversa nem alterações de ferramentas no meio da conversa. No Claude Sonnet 5, o prompt mínimo armazenável em cache é de 1.024 tokens. 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 as mensagens dessa requisição. Nas requisições seguintes, o bloco vai primeiro em messages, no lugar das mensagens que ele resume. Você escolhe quando compactar e quais turnos manter após o bloco. No Claude Sonnet 5.5, os blocos de pensamento nos turnos mantidos podem continuar válidos após a compactação. Para as condições, consulte Compactação e pensamento preservado. 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 receba, e a requisição é bem-sucedida. Blocos do Claude Haiku 5.5, do Claude Fable 5.2 e do Claude Mythos 5.2 seguem a mesma regra.

Na Claude API e no Claude Models on Google Cloud (Google managed), você pode ver quais blocos foram descartados. Envie o cabeçalho beta thinking-binding-controls-2026-08-01, e a resposta lista cada bloco descartado em input_transformations com reason: "organization_binding_mismatch". Consulte Contas e plataformas de nuvem.

Diferenças de comportamento

Para orientações sobre cada um dos itens a seguir, consulte Prompts para o Claude Sonnet 5.5. O Claude Sonnet 5.5 difere do Claude Sonnet 5 destas maneiras, que aparecem sem nenhuma alteração de código:

• 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 retorna em blocos de pensamento. Entre as chamadas de ferramentas, notas com mais de uma ou duas frases retornam como blocos thinking de atualização de progresso. Comentários mais curtos permanecem 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. Para recebê-lo, consulte O texto entre chamadas de ferramentas é retornado em blocos de pensamento no guia de migração.
• 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 ajudar no 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 no seu código e configure o fallback. Com o fallback do lado do servidor (fallbacks: "default"), uma requisição recusada na categoria "cyber" ou "frontier_llm" é executada novamente no Claude Sonnet 5. Uma requisição recusada na categoria "bio", "reasoning_extraction" ou "general_harms" não é tentada novamente. O fallback do lado do servidor está em beta na Claude API e no Claude Models on Google Cloud (Anthropic managed). Você também pode usar o middleware do SDK ou sua própria lógica de nova tentativa.

Uma recusa que chega antes de qualquer saída é cobrada em algumas categorias de recusa e não em outras. De qualquer forma, ela conta para seus limites de taxa. Consulte Como as recusas são cobradas.

Preços

O Claude Sonnet 5.5 tem os mesmos preços do Claude Sonnet 5, exceto pelas leituras do cache de prompt, que custam $0,10 USD por milhão de tokens, metade da tarifa do Claude Sonnet 5. Consulte Preços para a lista completa, residência de dados e preços de 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 on AWS, como claude-sonnet-5-5
• Google Cloud: Claude Models on Google Cloud (Anthropic managed), como claude-sonnet-5-5, e Claude Models on Google Cloud (Google managed), 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 de tool_choice any e tool por auto junto com uso estrito de ferramentas.
3. Mantenha as conversas apenas com acréscimos (append-only). Uma requisição que reproduz 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 a ferramenta de uso do computador por meio de computer_20251124, migre para o conjunto de ferramentas. No Amazon Bedrock, computer_20251124 também funciona.
5. Se você usa a ferramenta advisor com um advisor Claude Opus 4.8, Claude Opus 4.7, Claude Sonnet 5 ou Claude Haiku 5.5, mude para um advisor que o Claude Sonnet 5.5 aceite.
6. Se a sua interface exibe o texto entre chamadas de ferramentas, defina thinking.display ao usar o pensamento adaptativo. Com between_tools, o texto é retornado sem isso. Consulte O texto entre chamadas de ferramentas é retornado em blocos de pensamento.

O Guia de migração para o Claude Sonnet 5.5 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