---
title: O que há de novo no Claude Opus 5.5
url: https://platform.claude.com/docs/pt-BR/models/opus-5-5/whats-new-opus-5-5
description: Visão geral das mudanças incompatíveis, do suporte a recursos e das diferenças de comportamento no Claude Opus 5.5.
---
O Claude Opus 5.5 foi criado para codificação agêntica 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 "breaking changes" (mudanças incompatíveis) afetam código que já roda no Claude Opus 5: [o pensamento não pode ser desativado](https://platform.claude.com/docs/pt-BR/models/opus-5-5/whats-new-opus-5-5#thinking-cant-be-disabled), [o uso forçado de ferramentas retorna um erro](https://platform.claude.com/docs/pt-BR/models/opus-5-5/whats-new-opus-5-5#forced-tool-use-is-not-supported), [os blocos de pensamento estão vinculados ao modelo e à conversa](https://platform.claude.com/docs/pt-BR/models/opus-5-5/whats-new-opus-5-5#thinking-blocks-are-tied-to-the-model-that-produced-them) e, na Claude API e no Google Cloud, [a ferramenta anterior de "computer use" (uso de computador) `computer_20251124` não é aceita](https://platform.claude.com/docs/pt-BR/models/opus-5-5/whats-new-opus-5-5#computer-20251124-is-not-supported). As três primeiras também se aplicam ao Claude Fable 5.1. Outra mudança altera o formato da resposta sem fazer nenhuma requisição falhar: [o texto entre chamadas de ferramentas volta em blocos `thinking`](https://platform.claude.com/docs/pt-BR/models/opus-5-5/whats-new-opus-5-5#text-between-tool-calls), 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 as chamadas de ferramentas até definir um valor de `display` que retorne o texto.
## Novo modelo
| Modelo | ID na Claude API | Descrição |
| --------------- | ---------------- | --------------------------------------------------------------------- |
| Claude Opus 5.5 | claude-opus-5-5 | Para codificação agêntica de longa duração e trabalho de conhecimento |
O [pensamento adaptativo](https://platform.claude.com/docs/pt-BR/build-with-claude/thinking) está sempre ativado, e o [parâmetro effort](https://platform.claude.com/docs/pt-BR/build-with-claude/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](https://platform.claude.com/docs/pt-BR/models/opus-5-5/overview); para todos os modelos atuais, consulte a [visão geral dos modelos](https://platform.claude.com/docs/pt-BR/models/overview).
## Mudanças incompatíveis
### O pensamento não pode ser desativado
No Claude Opus 5, o pensamento fica 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 erro 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:
```text wrap
"thinking.type.disabled" is not supported for this model. Use "thinking.type.adaptive" and "output_config.effort" to control thinking behavior.
```
```text wrap
"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](https://platform.claude.com/docs/pt-BR/build-with-claude/effort) é o controle da profundidade do pensamento, da "latency" (latência) e do custo: reduza-o onde você antes desativava o pensamento; [Otimizando para custo e inteligência](https://platform.claude.com/docs/pt-BR/about-claude/models/optimizing-for-cost-and-intelligence#tune-effort) 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ções. Consulte [Pensamento](https://platform.claude.com/docs/pt-BR/build-with-claude/thinking) e o [antes e depois](https://platform.claude.com/docs/pt-BR/models/opus-5-5/migration-guide#thinking-cant-be-disabled) do guia de migração.
### O uso forçado de ferramentas não é suportado
O Claude Opus 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 erro 400 `invalid_request_error`:
```text wrap
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](https://platform.claude.com/docs/pt-BR/build-with-claude/token-counting). Para JSON válido segundo o schema, mantenha `tool_choice: {"type": "auto"}` e defina `strict: true` com o [uso estrito de ferramentas](https://platform.claude.com/docs/pt-BR/agents-and-tools/tool-use/strict-tool-use), ou mova o schema para [saídas estruturadas](https://platform.claude.com/docs/pt-BR/build-with-claude/structured-outputs). 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](https://platform.claude.com/docs/pt-BR/models/opus-5-5/migration-guide#forced-tool-use).
### Os blocos de pensamento estão vinculados ao modelo e à conversa
Cada bloco de pensamento registra qual modelo o produziu, e cada modelo lê seus próprios blocos e apenas os de alguns outros modelos. O 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 Google Cloud, do Claude Sonnet 5.5 e do Claude Haiku 5.5, mas não de modelos Claude Fable ou Claude Mythos. Na Claude API, o Claude Fable 5.1 e o Claude Mythos 5.1 leem blocos de pensamento do Claude Opus 5.5; nenhum outro modelo lê. 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 que não seja esses dois, ou que chega a ele vinda de um modelo Claude Fable ou Claude Mythos, executa os turnos após a troca sem o raciocínio 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 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](https://platform.claude.com/docs/pt-BR/build-with-claude/preserved-thinking#switching-models).
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. Assim como no Claude Fable 5.1, 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 e nas plataformas de nuvem. Nessas contas, uma requisição que reenvia um bloco após tal mudança retorna um erro 400. Para descartar os blocos afetados em vez disso, 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 o comportamento para a requisição. Mantenha a conversa apenas com acréscimos para que a questão nunca surja: altere instruções ou ferramentas com [mensagens do sistema no meio da conversa](https://platform.claude.com/docs/pt-BR/build-with-claude/mid-conversation-system-messages) em vez de edições. Consulte [Pensamento preservado](https://platform.claude.com/docs/pt-BR/build-with-claude/preserved-thinking) e a [nota sobre essa mudança](https://platform.claude.com/docs/pt-BR/models/opus-5-5/migration-guide#thinking-blocks) no guia de migração.
### A ferramenta de uso de computador `computer_20251124` não é suportada na Claude API e no Google Cloud
O Claude Opus 5 aceita o [uso de computador](https://platform.claude.com/docs/pt-BR/agents-and-tools/tool-use/computer-use-tool) tanto como o toolset `computer_toolset_20260801` quanto, com o cabeçalho beta `computer-use-2025-11-24`, como a ferramenta anterior `computer_20251124`. Na Claude API e no Google Cloud, o Claude Opus 5.5 suporta apenas o toolset: uma requisição que declara uma ferramenta `computer_20251124` retorna um erro 400 `invalid_request_error`. A mensagem nomeia o tipo rejeitado e, em seguida, lista os tipos de ferramenta que o modelo aceita (entre eles `computer_toolset_20260801`) após `Did you mean one of`; ela começa assim:
```text wrap
'claude-opus-5-5' does not support tool types: computer_20251124.
```
Para migrar uma integração existente na Claude API ou no Google Cloud, siga [Migrar de `computer_20251124`](https://platform.claude.com/docs/pt-BR/agents-and-tools/tool-use/computer-use-tool#migrate-from-computer-20251124): remova o cabeçalho beta, substitua a entrada em `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. No Amazon Bedrock, a ferramenta anterior `computer_20251124` continua funcionando no Claude Opus 5.5 como funciona no Claude Opus 5, então nenhuma alteração é necessária lá. Para outras plataformas, consulte a seção [Compatibilidade](https://platform.claude.com/docs/pt-BR/agents-and-tools/tool-use/computer-use-tool#compatibility) da ferramenta de uso de computador. Integrações que já usam o toolset, e a [ferramenta de uso do navegador](https://platform.claude.com/docs/pt-BR/agents-and-tools/tool-use/browser-use-tool), não precisam de alterações. O guia de migração mostra a requisição [antes e depois](https://platform.claude.com/docs/pt-BR/models/opus-5-5/migration-guide#computer-use-toolset).
## Suporte a recursos
O Claude Opus 5.5 suporta [esforço por mensagem](https://platform.claude.com/docs/pt-BR/build-with-claude/effort#change-effort-mid-conversation-beta) (beta), [mensagens do sistema no meio da conversa](https://platform.claude.com/docs/pt-BR/build-with-claude/mid-conversation-system-messages), [orçamentos de tarefa](https://platform.claude.com/docs/pt-BR/build-with-claude/task-budgets), ["prompt caching" (cache de prompt)](https://platform.claude.com/docs/pt-BR/build-with-claude/prompt-caching) com um prompt mínimo armazenável em cache de 512 tokens, [processamento em lote](https://platform.claude.com/docs/pt-BR/build-with-claude/batch-processing), a [Files API](https://platform.claude.com/docs/pt-BR/build-with-claude/files), [suporte a PDF](https://platform.claude.com/docs/pt-BR/build-with-claude/pdf-support), [visão](https://platform.claude.com/docs/pt-BR/build-with-claude/vision) e [ferramentas](https://platform.claude.com/docs/pt-BR/agents-and-tools/tool-use/overview) do lado do servidor e do lado do cliente. Na Claude API e no Google Cloud, o uso de computador exige o toolset `computer_toolset_20260801` (consulte a [mudança incompatível](https://platform.claude.com/docs/pt-BR/models/opus-5-5/whats-new-opus-5-5#computer-20251124-is-not-supported)). Consulte a página de cada recurso para ver a disponibilidade por modelo.
### Modo rápido
O [modo rápido](https://platform.claude.com/docs/pt-BR/build-with-claude/fast-mode) está disponível para o Claude Opus 5.5 na Claude API e no [Claude no Microsoft Foundry](https://platform.claude.com/docs/pt-BR/build-with-claude/claude-in-microsoft-foundry) para implantações hospedadas no Azure, mas não para implantações hospedadas na Anthropic; ele não está disponível no Amazon Bedrock, no Claude Platform on AWS nem no Google Cloud. Na Claude API, defina `speed: "fast"` na sua requisição. O Claude Opus 5.5 não precisa de um cabeçalho beta. Consulte [Modo rápido](https://platform.claude.com/docs/pt-BR/build-with-claude/fast-mode) para ver os modelos suportados, os limites de taxa e os 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 conter 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 recente no meio da conversa sem editar `tools` e sem perder o cache de prompt. Isso funciona em todos os modelos que suportam alterações de ferramentas no meio da conversa, incluindo o Claude Opus 5.5. Consulte [Definir ferramentas em uma mensagem](https://platform.claude.com/docs/pt-BR/build-with-claude/mid-conversation-system-messages#define-tools-in-a-message-beta).
### 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, o qual você então envia primeiro no lugar das mensagens resumidas. Ele está disponível nos modelos que suportam compactação, incluindo o Claude Opus 5.5. Você escolhe quando compactar, a requisição pode ser executada em segundo plano, 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](https://platform.claude.com/docs/pt-BR/build-with-claude/compaction-thinking-blocks#conditions-for-kept-thinking-to-stay-valid)), o que é importante no Claude Opus 5.5 porque seus [blocos de pensamento estão vinculados à conversa](https://platform.claude.com/docs/pt-BR/models/opus-5-5/whats-new-opus-5-5#thinking-blocks-are-tied-to-the-model-that-produced-them). Consulte [Compactação sob demanda](https://platform.claude.com/docs/pt-BR/build-with-claude/compaction-on-demand) para a disponibilidade por plataforma e o fluxo completo da requisição.
## Diferenças de comportamento
O 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 [Como escrever prompts para o Claude Opus 5.5](https://platform.claude.com/docs/pt-BR/build-with-claude/prompt-engineering/prompting-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 [Calibre o effort](https://platform.claude.com/docs/pt-BR/build-with-claude/prompt-engineering/prompting-claude-opus-5-5#calibrate-effort).
* **Mais pensamento por turno em um determinado nível de esforço.** Com a mesma configuração de [esforço](https://platform.claude.com/docs/pt-BR/build-with-claude/effort), o modelo tende a pensar mais por turno do que o Claude Opus 5, principalmente 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 [Calibre o effort](https://platform.claude.com/docs/pt-BR/build-with-claude/prompt-engineering/prompting-claude-opus-5-5#calibrate-effort).
* **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](https://platform.claude.com/docs/pt-BR/build-with-claude/thinking#progress-updates) 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 as chamadas de ferramentas, sem nenhum erro. O [guia de migração](https://platform.claude.com/docs/pt-BR/models/opus-5-5/migration-guide#text-between-tool-calls) traz a correção para recebê-las, e [Atualizações de progresso voltadas ao usuário](https://platform.claude.com/docs/pt-BR/build-with-claude/prompt-engineering/prompting-claude-opus-5-5#user-facing-progress-updates) explica 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](https://platform.claude.com/docs/pt-BR/models/opus-5-5/whats-new-opus-5-5#refusals-and-fallback) e [Recusas de salvaguardas](https://platform.claude.com/docs/pt-BR/build-with-claude/prompt-engineering/prompting-claude-opus-5-5#safeguard-refusals).
* **Leitura mais precisa de gráficos, diagramas e capturas de tela.** O modelo lê valores em gráficos densos e em elementos 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](https://platform.claude.com/docs/pt-BR/build-with-claude/prompt-engineering/prompting-claude-opus-5-5#tools-for-complex-visual-inputs).
Se sua integração com o Claude Opus 5 rodava com o pensamento desativado, consulte [Prompts escritos para pensamento desativado](https://platform.claude.com/docs/pt-BR/build-with-claude/prompt-engineering/prompting-claude-opus-5-5#prompts-written-for-thinking-disabled) junto com a [mudança incompatível](https://platform.claude.com/docs/pt-BR/models/opus-5-5/whats-new-opus-5-5#thinking-cant-be-disabled). 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 prompts](https://platform.claude.com/docs/pt-BR/build-with-claude/prompt-engineering/prompting-claude-opus-5-5#capability-improvements).
## Recusas e fallback
O Claude Opus 5.5 vem com classificadores de segurança, e tudo em [Recusas e fallback](https://platform.claude.com/docs/pt-BR/build-with-claude/refusals-and-fallback) se aplica. Uma requisição recusada retorna HTTP 200 com `stop_reason: "refusal"` e um objeto [`stop_details`](https://platform.claude.com/docs/pt-BR/build-with-claude/refusals-and-fallback#refusal-response) que nomeia a área da política, então trate as recusas e configure o "fallback" (alternativa de contingência): tente novamente em outro modelo com o [fallback do lado do servidor](https://platform.claude.com/docs/pt-BR/build-with-claude/refusals-and-fallback#server-side-fallback) (`fallbacks: "default"`, em beta, tenta novamente no modelo que a Anthropic recomenda para aquela categoria), o [middleware do SDK](https://platform.claude.com/docs/pt-BR/build-with-claude/refusals-and-fallback#client-side-fallback) ou sua própria lógica de nova tentativa. Se uma recusa que chega antes de qualquer saída é cobrada ou não depende da categoria de recusa, e ela conta para seus "rate limits" (limites de taxa) de qualquer forma; consulte [Como as recusas são cobradas](https://platform.claude.com/docs/pt-BR/build-with-claude/refusals-and-fallback#how-refusals-are-billed).
## Preços
O 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 do Claude Opus 5, com gravações em cache de 5 minutos a $5, gravações em cache de 1 hora a $8 e leituras de cache a $0,20 por milhão de tokens (0,05x o preço base de entrada). O [processamento em lote](https://platform.claude.com/docs/pt-BR/build-with-claude/batch-processing) custa metade do preço: $2 e $10. Consulte [Preços](https://platform.claude.com/docs/pt-BR/about-claude/pricing) para residência de dados e preços de ferramentas.
## Disponibilidade
O Claude Opus 5.5 está disponível em:
* **Claude API:** todos os clientes, como `claude-opus-5-5`.
* **AWS:** [Claude no Amazon Bedrock](https://platform.claude.com/docs/pt-BR/build-with-claude/claude-in-amazon-bedrock), como `anthropic.claude-opus-5-5`, e [Claude Platform on AWS](https://platform.claude.com/docs/pt-BR/build-with-claude/claude-platform-on-aws), como `claude-opus-5-5`.
* **Google Cloud:** [Claude no Google Cloud](https://platform.claude.com/docs/pt-BR/build-with-claude/claude-on-vertex-ai), como `claude-opus-5-5`.
* **Microsoft Foundry:** [Claude no Microsoft Foundry](https://platform.claude.com/docs/pt-BR/build-with-claude/claude-in-microsoft-foundry), como `claude-opus-5-5`.
## Migrar do Claude Opus 5
Atualize o ID do seu modelo:
```python Python
model = "claude-opus-5" # Before
model = "claude-opus-5-5" # After
```
```typescript TypeScript
let model = "claude-opus-5"; // Before
model = "claude-opus-5-5"; // After
```
```csharp C#
var model = Model.ClaudeOpus5; // Before
model = Model.ClaudeOpus5_5; // After
```
```go Go
model := anthropic.ModelClaudeOpus5 // Before
model = anthropic.ModelClaudeOpus5_5 // After
```
```java Java
Model model = Model.CLAUDE_OPUS_5; // Before
model = Model.CLAUDE_OPUS_5_5; // After
```
```php PHP
$model = Model::CLAUDE_OPUS_5; // Before
$model = Model::CLAUDE_OPUS_5_5; // After
```
```ruby Ruby
model = Anthropic::Model::CLAUDE_OPUS_5 # Before
model = Anthropic::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](https://platform.claude.com/docs/pt-BR/build-with-claude/effort) em vez disso. Substitua os tipos `any` e `tool` de `tool_choice` por `auto` mais o [uso estrito de ferramentas](https://platform.claude.com/docs/pt-BR/agents-and-tools/tool-use/strict-tool-use). Se você usa a ferramenta de uso de computador por meio de `computer_20251124` na Claude API ou no Google Cloud, [migre para o toolset](https://platform.claude.com/docs/pt-BR/agents-and-tools/tool-use/computer-use-tool#migrate-from-computer-20251124). 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](https://platform.claude.com/docs/pt-BR/models/opus-5-5/migration-guide#text-between-tool-calls). Consulte o [guia de migração](https://platform.claude.com/docs/pt-BR/models/opus-5-5/migration-guide) para instruções passo a passo a partir do Claude Opus 5 e de modelos anteriores, e para a lista de verificação completa.
## Próximos passos
Especificações completas e preços de todos os modelos Claude atuais.
Migre código do Claude Opus 5 e de modelos anteriores para o Claude Opus 5.5.
Diferenças de comportamento e padrões de prompt específicos do Claude Opus 5.5.
Controle quantos tokens o Claude usa ao responder, de low a max.
Como o pensamento adaptativo funciona e como os blocos de pensamento são preservados.
Trate `stop_reason: "refusal"` e tente novamente em outro modelo.