O que há de novo no Claude Opus 5.5

Claude Opus 5.5 foi criado para trabalho agêntico de programação de longa duração e trabalho de conhecimento, com preço de $4 / $20 USD por milhão de tokens de entrada / saída. Quatro mudanças incompatíveis podem afetar código que já está em execução no Claude Opus 5:

• O pensamento não pode ser desativado.
• 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.

As três primeiras também se aplicam ao Claude Fable 5.1. Uma mudança adicional altera o formato da resposta sem fazer nenhuma requisição falhar: o texto entre chamadas de ferramentas é retornado em blocos thinking cujo texto fica vazio na configuração padrão de display. Uma aplicação que faz streaming desse texto para seus usuários como atualizações de progresso fica em silêncio entre chamadas de ferramentas até definir um valor de display que retorne o texto.

Novo modelo

O pensamento adaptativo está sempre ativado, e o parâmetro effort controla a profundidade do pensamento; seu padrão neste modelo é medium. 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 Opus 5.5; para todos os modelos atuais, consulte a visão geral dos modelos.

Mudanças incompatíveis

O pensamento não pode ser desativado

No Claude Opus 5, o pensamento está ativado por padrão e thinking: {"type": "disabled"} é aceito com esforço high ou inferior. No Claude Opus 5.5, o pensamento está sempre ativado: uma requisição que define thinking: {"type": "disabled"}, ou um orçamento manual com thinking: {"type": "enabled", "budget_tokens": N}, retorna um 400 invalid_request_error. Omita o campo thinking ou envie thinking: {"type": "adaptive"}, que é equivalente. Nenhum cabeçalho beta está envolvido.

As mensagens de erro são:

"thinking.type.disabled" is not supported for this model. Use "thinking.type.adaptive" and "output_config.effort" to control thinking behavior.

"thinking.type.enabled" is not supported for this model. Use "thinking.type.adaptive" and "output_config.effort" to control thinking behavior.

O parâmetro effort é o controle para profundidade de pensamento, “latency” (latência) e custo: reduza-o onde você antes desativava o pensamento; Otimizando para custo e inteligência traz resultados medidos para escolher um nível. Como toda resposta pode começar com um ou mais blocos thinking (retornados com um campo thinking vazio no padrão display: "omitted"), selecione os blocos de conteúdo pelo campo type em vez de pela posição, e devolva os blocos thinking sem modificações em loops de “tool use” (uso de ferramentas). Código que já roda no Claude Opus 5 com o pensamento ativado não precisa de alteração. Consulte Pensamento e o antes e depois para o pensamento do guia de migração.

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

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

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, e a mesma validação se aplica ao endpoint de contagem de tokens. Para JSON válido 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 para a escolha de ferramenta.

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

Todo bloco de pensamento registra qual modelo o produziu, e cada modelo lê seus próprios blocos e apenas os de alguns outros modelos. Claude Opus 5.5 lê blocos de pensamento do Claude Opus 5, de modelos Opus, Sonnet e Haiku anteriores e, na Claude API e no Claude Models on Google Cloud (Google managed), do Claude Sonnet 5.5 e do Claude Haiku 5.5, mas não de modelos Claude Fable ou Claude Mythos. Na Claude API, Claude Fable 5.1 e Claude Mythos 5.1 leem blocos de pensamento do Claude Opus 5.5; nenhum outro modelo faz isso. Uma conversa que passa do Claude Opus 5 para o Claude Opus 5.5, ou do Claude Opus 5.5 para o Claude Fable 5.1 ou o Claude Mythos 5.1 na Claude API, mantém seu raciocínio. Uma que passa do Claude Opus 5.5 para qualquer modelo além desses dois, ou que chega a ele a partir de um modelo Claude Fable ou Claude Mythos, executa os turnos após a troca sem o raciocínio do modelo anterior. Quando uma solicitação carrega um bloco que o modelo de destino não consegue ler, a API o descarta antes que o modelo o veja: a solicitaçã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 Opus 5.5 (o prompt system, as tools ou uma mensagem anterior) mudou desde que o bloco foi produzido. 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. Uma solicitação que reproduz um bloco após tal alteração e deixa thinking.block_binding.prefix_mismatch_behavior sem definir recebe um erro 400 em contas criadas em ou após 31 de agosto de 2026, 00:00 UTC. Isso se aplica na Claude API e em plataformas de nuvem. Em contas criadas antes dessa data, a solicitação recebe o erro apenas quando define o campo como "error". Para descartar os blocos afetados em vez disso, envie o cabeçalho beta thinking-binding-controls-2026-08-01 e defina o campo como "drop_block". 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 Opus 5.5 suporta “computer use” (uso do computador) por meio do toolset computer_toolset_20260801. No Amazon Bedrock, o Claude Opus 5.5 também aceita a ferramenta computer_20251124 com o cabeçalho beta computer-use-2025-11-24. O Claude Opus 5.5 retorna um erro 400 para qualquer versão da ferramenta de uso do computador que ele não aceite, 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 com:

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

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

Suporte a recursos

Claude Opus 5.5 suporta esforço por mensagem (beta), mensagens de sistema no meio da conversa, orçamentos de tarefa, cache de prompt com um mínimo de 512 tokens de prompt armazenável em cache, processamento em lote, a Files API, suporte a PDF, visão e ferramentas do lado do servidor e do lado do cliente. Consulte a página de cada recurso para ver a disponibilidade por modelo.

Modo rápido

O modo rápido está disponível para o Claude Opus 5.5 na Claude API, no Claude Models on Google Cloud (Anthropic managed) e no Claude no Microsoft Foundry para implantações hospedadas no Azure. Na Claude API e no Claude Models on Google Cloud (Anthropic managed), defina speed: "fast" na sua requisição. Claude Opus 5.5 não precisa de cabeçalho beta. Consulte Modo rápido para modelos suportados, “rate limits” (limites de taxa) e preços.

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, para que você possa adicionar uma ferramenta, alterar seu schema ou mover uma ferramenta de servidor para uma versão mais nova no meio da conversa sem editar tools e sem perder o cache de prompt. Isso funciona em todos os modelos que suportam mudanças de ferramentas no meio da conversa, incluindo o Claude Opus 5.5. Consulte Definir ferramentas em uma mensagem.

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, que você então envia primeiro no lugar das mensagens resumidas. Está disponível nos modelos que suportam compactação, incluindo o Claude Opus 5.5. Você escolhe quando compactar, e a requisição pode ser executada em segundo plano. Sob as condições em Compactação e pensamento preservado, os blocos de pensamento nos turnos que você mantém podem permanecer válidos após a substituição. Isso importa no Claude Opus 5.5 porque seus blocos de pensamento estão vinculados à conversa. Consulte Compactação sob demanda para a disponibilidade por plataforma e o fluxo completo da requisição.

Diferenças de comportamento

Claude Opus 5.5 difere do Claude Opus 5 de várias maneiras que aparecem sem nenhuma alteração de código. Cada uma tem orientações em Prompting para o Claude Opus 5.5:

• O esforço padrão é medium. Uma requisição que omite effort é executada em medium; no Claude Opus 5 era executada em high. Defina effort explicitamente e execute novamente sua varredura; consulte Calibrar o esforço.
• Mais pensamento por turno em um dado nível de esforço. Com a mesma configuração de esforço, o modelo tende a pensar mais por turno do que o Claude Opus 5, sobretudo em xhigh e max. Execute novamente sua varredura de esforço em vez de reaproveitar uma configuração, e deixe espaço em max_tokens para o pensamento. Consulte Calibrar o esforço.
• O texto entre chamadas de ferramentas volta em blocos de pensamento. As notas curtas que o modelo escreve entre chamadas de ferramentas chegam como blocos thinking de atualização de progresso em vez de blocos text, então, no padrão display: "omitted", uma aplicação que faz streaming delas para seus usuários fica em silêncio entre chamadas de ferramentas, sem nenhum erro. O guia de migração explica como receber o texto entre chamadas de ferramentas, e Atualizações de progresso voltadas ao usuário aborda como pedir mais delas.
• Mais categorias de salvaguarda. O modelo executa um classificador de segurança de biologia além do de cibersegurança. Assim como no Claude Opus 5, requisições que o pressionam a reproduzir seu raciocínio interno no texto da resposta podem ser recusadas com a categoria reasoning_extraction. Consulte Recusas e fallback no Claude Opus 5.5 e Recusas de salvaguarda.
• Leitura mais precisa de gráficos, diagramas e capturas de tela. O modelo lê valores de gráficos densos e de visuais dependentes de layout com muito mais precisão sem ferramentas, então soluções alternativas de visão no prompt criadas para modelos anteriores podem não ser mais necessárias; ferramentas de imagem ainda aumentam a precisão nas entradas mais densas. Consulte Ferramentas para entradas visuais complexas.

Se sua integração com o Claude Opus 5 rodava com o pensamento desativado, consulte Prompts escritos para o pensamento desativado junto com a mudança incompatível O pensamento não pode ser desativado. Para os ganhos de capacidade em codificação agêntica e revisão de código, trabalho de conhecimento, comunicação, entradas visuais e uso de computador, consulte Capacidades relevantes para prompting.

Recusas e fallback

Claude Opus 5.5 vem com classificadores de segurança, e tudo em Recusas e fallback se aplica. Uma requisição recusada retorna HTTP 200 com stop_reason: "refusal" e um objeto stop_details que nomeia a área de política, então trate as recusas e configure o fallback: tente novamente em outro modelo com o fallback do lado do servidor (fallbacks: "default", em beta, tenta novamente no modelo que a Anthropic recomenda para aquela categoria), o middleware do SDK ou sua própria nova tentativa. Se uma recusa que chega antes de qualquer saída é cobrada depende de sua categoria de recusa, e ela conta contra seus limites de taxa de qualquer forma; consulte Como as recusas são cobradas.

Preços

Claude Opus 5.5 custa $4 USD por milhão de tokens de entrada e $20 USD por milhão de tokens de saída, abaixo dos $5 e $25 USD do Claude Opus 5, com gravações em cache de 5 minutos a $5 USD, gravações em cache de 1 hora a $8 USD e leituras de cache a $0,20 USD por milhão de tokens (0,05x o preço base de entrada). O processamento em lote custa metade do preço: $2 e $10 USD. Consulte Preços para residência de dados e preços de ferramentas.

Disponibilidade

Claude Opus 5.5 está disponível em:

• Claude API: todos os clientes, como claude-opus-5-5
• AWS: Claude no Amazon Bedrock, como anthropic.claude-opus-5-5, e Claude Platform on AWS, como claude-opus-5-5
• Google Cloud: Claude Models on Google Cloud (Anthropic managed), como claude-opus-5-5, e Claude Models on Google Cloud (Google managed), como claude-opus-5-5
• Microsoft Foundry: Claude no Microsoft Foundry, como claude-opus-5-5

Migrar do Claude Opus 5

Atualize o ID do seu modelo:

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

Em seguida, remova quaisquer configurações thinking: {"type": "disabled"} ou thinking: {"type": "enabled", ...} e escolha um nível de esforço em vez disso. Substitua os tipos any e tool de tool_choice por auto combinado com uso estrito de ferramentas. Se você usa o uso do computador por meio de computer_20251124, migre para o toolset. No Amazon Bedrock, computer_20251124 também funciona. Se sua interface exibe o texto entre chamadas de ferramentas, defina também thinking.display; consulte O texto entre chamadas de ferramentas é retornado em blocos de pensamento. Consulte o guia de migração para instruções passo a passo a partir do Claude Opus 5 e de modelos anteriores, além da checklist completa.

Próximos passos