Guia de migração do Claude Opus 5.5: cinco mudanças que podem quebrar fluxos com Agents
A migração muda thinking, tool use, computer use e histórico antes de mudar os resultados aceitos.
A Anthropic lançou o Claude Opus 5.5 em 22 de setembro de 2026. Na manchete, ele é mais capaz, mais rápido e mais barato. Para um fluxo com agentes, porém, a mudança mais importante está em outra camada: thinking, chamadas de ferramentas, computer use e integridade do histórico.
Quem olha apenas os benchmarks pode ignorar o trabalho de migração. Quem olha apenas o preço por token pode ignorar retries, loops de ferramentas quebrados e tempo de revisão humana.
Resumo
A Anthropic posiciona o Opus 5.5 para programação agentic de longa duração e knowledge work. O model ID é claude-opus-5-5. Ele tem uma context window de 1 milhão de tokens, até 128 mil tokens de saída e adaptive thinking sempre ativo.
| Mudança | Claude Opus 5.5 | Claude Opus 5 | O que a equipe precisa validar |
|---|---|---|---|
| Entrada padrão | US$ 4 por milhão de tokens | US$ 5 | Entrada total com arquivos, tools e retries |
| Saída padrão | US$ 20 por milhão de tokens | US$ 25 | Thinking também consome o orçamento de saída |
| Cache reads | US$ 0,20 por milhão | US$ 0,50 | Taxa real de cache hit em sessões longas |
| Effort padrão | medium | high | Se o padrão já passa na aceitação |
| Thinking | Adaptativo e sempre ativo | Pode ser desligado em alguns níveis | Compatibilidade do request e da resposta |
| Contexto | 1 milhão | 1 milhão | Espaço após tools e thinking preservado |
A Anthropic afirma que workloads típicos, nas configurações padrão, custam 40% menos que no Opus 5 e que a geração é mais de 30% mais rápida. São estimativas do fornecedor, não uma economia garantida para qualquer fluxo. Prompt, effort, cache, ferramentas e retries mudam o resultado.
A maior mudança não é um benchmark
Um agente não é apenas o modelo. O harness decide o contexto, as ferramentas, as permissões, como os resultados retornam e quais evidências são exigidas antes de aceitar a tarefa.
O Opus 5.5 altera várias dessas interfaces.
Thinking não pode ser desligado
O adaptive thinking fica sempre ativo. A profundidade pode ser controlada com effort, mas thinking: {"type":"disabled"} é rejeitado.
Integrações ajustadas para operar sem thinking precisam ser testadas novamente. Tokens de thinking são cobrados como output, mesmo quando o texto não é exibido, e contam para max_tokens. A migração deve medir custo e risco de truncamento.
O effort padrão é medium. Começar todos os trabalhos em max só porque o maior resultado do lançamento usou essa configuração não é uma decisão neutra. Comece no padrão e aumente apenas quando um acceptance test mostrar benefício.
Tool use forçado pode quebrar loops existentes
O Opus 5.5 não aceita tool_choice forçando any ou uma ferramenta específica. A recomendação da Anthropic é auto, com definições strict ou structured outputs.
Se o workflow presume que cada turno deve chamar uma ferramenta, essa rota precisa de um teste explícito. Não espere um scheduled agent retornar erros 400 em produção.
Computer use exige o toolset atual
Na Claude API e no Google Cloud, o antigo computer_20251124 não é aceito. A integração deve usar computer_toolset_20260801.
Isso é compatibilidade de protocolo, não qualidade de prompt. Um benchmark não verifica a versão do seu browser/computer harness.
Thinking blocks fazem parte da integridade da conversa
O Opus 5.5 usa preserved thinking. System instructions, tools e mensagens anteriores a um bloco assinado precisam permanecer inalterados. Reconstruir ou editar o histórico pode invalidar o bloco.
Agentes de longa duração devem tratar o histórico como append-only ou usar os mecanismos de context management da Anthropic. O estado fica mais explícito, mas reescrever mensagens antigas para economizar tokens se torna mais arriscado.
A interface pode perder o texto de progresso
Com display: "omitted", progress updates entre chamadas podem chegar em thinking blocks com texto vazio. Uma interface que exibia essas mensagens pode parecer parada mesmo quando o agente continua trabalhando.
A Anthropic oferece o modo beta updates para exibir progresso voltado ao usuário sem revelar o reasoning summary. Isso é uma decisão de integração, não uma pontuação de modelo.
O que o lançamento prova e o que não prova
A Anthropic relata avanços em agentic coding, computer use, knowledge work e business workflows. Também diz que o Opus 5.5 teve resultado melhor que o Opus 5 em seu behavioral audit e tentou cruzar containment boundaries com menor frequência em uma avaliação específica.
São evidências oficiais úteis, mas não garantem que todo fluxo ficará mais seguro ou preciso. A própria Anthropic alerta que margens de benchmark estão menos ligadas às diferenças reais entre modelos de fronteira. Vários resultados usam effort alto ou máximo, e algumas rotas recebem safeguard fallbacks.
A pergunta prática não é quantos gráficos o modelo venceu. É se ele produz mais trabalho aceito com os seus dados, ferramentas, permissões e critérios de revisão.
Um teste de migração justo
Escolha um fluxo com baseline confiável no Opus 5: uma mudança em repositório, um relatório com fontes ou uma entrega que transforma planilha em apresentação. Mantenha arquivos, tools, limite de tempo, permission policy e checklist iguais.
Rode primeiro o Opus 5.5 no effort medium padrão. Registre input, output, cache reads, tool calls, retries, tempo total e correções do reviewer. Aumente o effort apenas se o artefato não passar.
O reviewer deve inspecionar o resultado, não aceitar a frase “concluído”. Para código: diff, testes e logs. Para pesquisa: números e citações. Para documentos: estrutura, fatos e aderência ao template.
Uma conclusão útil não é “pareceu mais inteligente”. É uma melhora em accepted-task rate, minutos de revisão ou custo por artefato aceito sem aumento de falhas graves.
Por que a camada de workflow ainda importa
A Buda mantém arquivos, navegador, terminal, tool calls e artefatos finais em um workspace inspecionável. A equipe compara resultados aceitos, loops de falha e esforço de revisão, não apenas um ranking.
FAQ
O Opus 5.5 é mais barato que o Opus 5?
Nos preços de tabela da API da Anthropic, a entrada cai de US$ 5 para US$ 4 por milhão de tokens e a saída de US$ 25 para US$ 20 em relação ao Opus 5. A redução de 20% na tarifa não determina sozinha o custo da tarefa: conte cache, thinking, tentativas e ciclos de ferramentas.
A context window aumentou?
Não. A documentação atual mostra 1 milhão de tokens para os dois modelos. A mudança principal está em eficiência e integração.
Todo workflow no Opus 5 deve migrar agora?
Não. Teste request shape, tool loop, versão de computer use, histórico, custo e o artefato final antes de decidir.
Usar Opus 5.5 no Buda
No Buda, selecione Claude Opus 5.5 no seletor de modelos do Agent; o ID oficial é claude-opus-5-5. As seleções salvas do antigo Opus 5 são atualizadas para Opus 5.5, sem recriar o Agent ou remover seus arquivos. As regras de migração de API acima são para integrações diretas com a Anthropic, não etapas extras de configuração exigidas de todos os usuários do Buda.
Ler o anúncio de lançamento no Buda · Buda Credits