--- 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. --- 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](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). * [Algumas versões da ferramenta de uso do computador não são suportadas](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. 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`](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 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 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: ```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 para profundidade de pensamento, “latency” (latência) e 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ção. Consulte [Pensamento](https://platform.claude.com/docs/pt-BR/build-with-claude/thinking) e o [antes e depois para o pensamento](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 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`: ```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 para a escolha de ferramenta](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 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](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. Mantenha a conversa apenas com acréscimos (append-only): 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. 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](https://platform.claude.com/docs/pt-BR/build-with-claude/preserved-thinking) e a [nota sobre blocos de pensamento](https://platform.claude.com/docs/pt-BR/models/opus-5-5/migration-guide#thinking-blocks) 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](https://platform.claude.com/docs/pt-BR/agents-and-tools/tool-use/computer-use-tool)) 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: ```text wrap '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`](https://platform.claude.com/docs/pt-BR/agents-and-tools/tool-use/computer-use-tool#migrate-from-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](https://platform.claude.com/docs/pt-BR/models/opus-5-5/migration-guide#computer-use-toolset). ## Suporte a recursos 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 de 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), [cache de prompt](https://platform.claude.com/docs/pt-BR/build-with-claude/prompt-caching) com um mínimo de 512 tokens de prompt armazenável em cache, [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. 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, no [Claude Models on Google Cloud (Anthropic managed)](https://platform.claude.com/docs/pt-BR/build-with-claude/claude-models-on-google-cloud/anthropic-managed) 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. 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](https://platform.claude.com/docs/pt-BR/build-with-claude/fast-mode) 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](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, 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](https://platform.claude.com/docs/pt-BR/build-with-claude/compaction-thinking-blocks#conditions-for-kept-thinking-to-stay-valid), 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](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 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](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 [Calibrar o esforço](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 dado 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, 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](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 chamadas de ferramentas, sem nenhum erro. O guia de migração explica [como receber o texto entre chamadas de ferramentas](https://platform.claude.com/docs/pt-BR/models/opus-5-5/migration-guide#text-between-tool-calls), 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) 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](https://platform.claude.com/docs/pt-BR/models/opus-5-5/whats-new-opus-5-5#refusals-and-fallback) e [Recusas de salvaguarda](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 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](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 o 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 [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). 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](https://platform.claude.com/docs/pt-BR/build-with-claude/prompt-engineering/prompting-claude-opus-5-5#capability-improvements). ## Recusas e fallback 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 de política, então trate as recusas e configure o fallback: 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 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](https://platform.claude.com/docs/pt-BR/build-with-claude/refusals-and-fallback#how-refusals-are-billed). ## 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](https://platform.claude.com/docs/pt-BR/build-with-claude/batch-processing) custa metade do preço: $2 e $10 USD. Consulte [Preços](https://platform.claude.com/docs/pt-BR/about-claude/pricing) 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](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 Models on Google Cloud (Anthropic managed)](https://platform.claude.com/docs/pt-BR/build-with-claude/claude-models-on-google-cloud/anthropic-managed), como `claude-opus-5-5`, e [Claude Models on Google Cloud (Google managed)](https://platform.claude.com/docs/pt-BR/build-with-claude/claude-models-on-google-cloud/google-managed), 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` combinado com [uso estrito de ferramentas](https://platform.claude.com/docs/pt-BR/agents-and-tools/tool-use/strict-tool-use). Se você usa o uso do computador por meio de `computer_20251124`, [migre para o toolset](https://platform.claude.com/docs/pt-BR/agents-and-tools/tool-use/computer-use-tool#migrate-from-computer-20251124). 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](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, além da checklist completa. ## Próximos passos Especificações completas e preços de todos os modelos Claude atuais. Mova o código do Claude Opus 5 e de modelos anteriores para o Claude Opus 5.5. Diferenças de comportamento e padrões de prompting específicos do Claude Opus 5.5. Controle quantos tokens 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.