Quatro tarefas pequenas de código e raciocínio, prompts idênticos, uma execução para cada modelo. Os dois acertaram todas as quatro. O Opus 5 usou 81, 94, 407 e 600 tokens de saída; o Opus 4.8, 36, 35, 103 e 206, pelo mesmo preço de $25 por milhão. É disso que trata a migração de Claude Opus 4.8 para Opus 5: trocar a string do modelo leva uma linha, mas custo e comportamento não mudam tão simplesmente.
A razão documentada não é uma diferença de capacidade. No Opus 5, o thinking roda por padrão; no 4.8, ficava desligado por padrão. Portanto, uma solicitação igual passa a pagar pelo raciocínio que antes não gerava custo. E quem realmente move a fatura é effort, não a escolha entre os dois modelos. Para quem já roda claude-opus-4-8 em produção, o resumo é este:
- Há uma quebra de API importante. A combinação de
thinking: {"type": "disabled"}com effortxhighoumaxretorna 400 no Opus 5. O Opus 4.8 aceita essa combinação. - O preço não é o fator que muda. Ambos cobram $5 de entrada e $25 de saída por milhão de tokens. O gasto sobe ou desce apenas conforme o volume de tokens.
- Thinking agora vem ativado por padrão. O limite de
max_tokenscontinua cobrindo thinking e resposta visível juntos. Limites ajustados para o 4.8 podem, portanto, cortar respostas no novo modelo. - Seus prompts representam mais risco que seu código. Instruções que pediam ao 4.8 para revisar o próprio trabalho podem levar o Opus 5 a verificar demais.
- Nenhum dos modelos foi descontinuado. Os dois aparecem como Active, então permanecer no 4.8 durante o próximo ciclo de release é uma decisão perfeitamente defensável.
O que pode quebrar ao trocar a string do modelo
O guia de migração da Anthropic descreve o Opus 5 como "um upgrade direto do Claude Opus 4.8 pelo mesmo preço". A superfície da API quase não muda: claude-opus-5 é um ID fixo, sem sufixo de data, seguindo o mesmo padrão de claude-opus-4-8. Ainda assim, há cinco pontos para auditar antes de alterar uma rota em produção.
1. thinking: {"type": "disabled"} com effort xhigh ou max retorna 400. As mudanças oficiais de comportamento classificam isso como uma quebra em relação ao 4.8, no qual desligar thinking era independente do effort. A validação ocorre em cada requisição. Por isso, aumentar o effort no meio de uma conversa é rejeitado, mesmo que os turnos anteriores tenham funcionado. 2. max_tokens agora precisa acomodar o thinking. Ele continua sendo um teto rígido para toda a saída — thinking mais resposta —, então uma tarefa que executava sem thinking no 4.8 com max_tokens: 4096 mantém o mesmo teto enquanto o raciocínio consome parte dele. A Anthropic recomenda começar com 64k em xhigh ou max. 3. Instruções de verificação podem ter o efeito contrário. O Opus 5 revisa seu trabalho por conta própria. Segundo o guia de prompting, comandos como "include a final verification step" provocam verificação excessiva; removê-los "reduz tokens desperdiçados sem perda de qualidade". Uma usuária do acesso antecipado, Allie K. Miller, encontrou o problema pelo lado do effort: "I often default to 'high' reasoning effort... I had to switch it down to medium." 4. Skills e a estrutura de agentes podem mudar de comportamento sem erro de API. A Anthropic afirma que o Opus 5 "performs well out of the box on existing Claude Opus 4.8 prompts". Uma equipe relatou o contrário: Dan Shipper, da Every, publicou no dia do lançamento que "it breaks backward compatibility... It will often stop early or otherwise miss your instructions" e que reconstruíram suas skills do zero. É a experiência de uma equipe, mas já basta como motivo para rodar novamente suas avaliações: não haverá uma linha de log avisando sobre isso. 5. A Anthropic informa corte de conhecimento em maio de 2026 para o Opus 5, ante janeiro de 2026 no 4.8. Prompts de sistema que fixam algo como "your knowledge ends January 2026, defer to retrieved context" passam a descrever o modelo errado, e qualquer cálculo de datas ancorado nessa frase muda junto.
Há uma armadilha por trás do primeiro item. Com thinking desativado, o Opus 5 pode ocasionalmente escrever uma chamada de ferramenta no texto visível, em vez de emitir um bloco tool_use, ou vazar tags XML internas. Em loops agênticos, esse texto entra no histórico e contamina os próximos turnos. A mitigação indicada pela Anthropic é manter thinking ativado e usar effort menor para controlar o custo.
A requisição que retorna 400 — e duas formas de corrigir
Veja a combinação que falha, em formato de diff para colar e comparar com o corpo da sua própria requisição:
# Rejeitado em claude-opus-5 com HTTP 400. Aceito em claude-opus-4-8.
{
"model": "claude-opus-5",
"max_tokens": 16000,
"thinking": { "type": "disabled" },
"output_config": { "effort": "xhigh" }
}
# Correção A - mantenha effort xhigh e deixe o thinking rodar. Aumente max_tokens, pois thinking conta no limite.
{
"model": "claude-opus-5",
- "max_tokens": 16000,
+ "max_tokens": 65536,
- "thinking": { "type": "disabled" },
"output_config": { "effort": "xhigh" }
}
# Correção B - mantenha thinking desligado e limite o effort a high ou menos.
{
"model": "claude-opus-5",
"max_tokens": 16000,
"thinking": { "type": "disabled" },
- "output_config": { "effort": "xhigh" }
+ "output_config": { "effort": "high" }
}
Escolha a Correção A para trabalho agêntico, tarefas com vários arquivos ou uso intenso de ferramentas, em que o artefato de chamada de ferramenta vazada é a falha cara. Escolha a Correção B para endpoints sensíveis à latência e extração em formato rígido, casos nos quais reduzir o effort de xhigh para high tende a custar pouco.
O que você ganha com a troca
O Opus 5 chegou em 2026-07-24 sem alterar os dois números que a maioria verifica primeiro em uma comparação Claude Opus 5 vs Opus 4.8: $5/$25 e janela de contexto de 1M tokens. O detalhamento completo de lançamento e preços do Claude Opus 5 cobre a estreia; as diferenças relevantes para migração são mais restritas.
Especificações verificadas em 25 de julho de 2026:
| Claude Opus 4.8 | Claude Opus 5 | O que muda para você | |
|---|---|---|---|
| ID do modelo na API | claude-opus-4-8 | claude-opus-5 | Alteração de uma linha |
| Preço por MTok | $5 / $25 | $5 / $25 | Nada |
| Contexto | 1M | 1M, padrão e máximo | Não há plano adicional para contratar |
| Níveis de effort | até xhigh, padrão high | de low a max, padrão high | Refaça seus testes de effort |
| Thinking por padrão | desligado, salvo solicitação | ativado, adaptativo | Revise max_tokens |
| Desativar thinking | qualquer effort | effort high ou menor | 400 acima de high |
| Prompt mínimo cacheável | 1.024 tokens | 512 tokens | Prompts curtos agora podem usar cache |
| Corte de conhecimento | jan 2026 | mai 2026 | Atualize a redação sobre o corte |
Além da tabela, há duas mudanças — e só uma delas é benchmark:
- Prompts curtos agora podem ser armazenados em cache. O mínimo cai de 1.024 para 512 tokens. Assim, um prefixo de sistema de 600 tokens, que não era cacheável no 4.8, passa a custar $0.50 por milhão nos acertos de cache, contra $5 de entrada padrão. Considere $6.25 por milhão para gravar uma entrada de 5 minutos: o prefixo precisa ser reutilizado antes de compensar.
- Os dados de capacidade vêm apenas do fornecedor. O anúncio da Anthropic traz números relativos sem reprodução independente: Frontier-Bench v0.1 em "mais do que o dobro" do Opus 4.8, com menor custo por tarefa, e CursorBench 3.2 a 0.5% do pico do Fable 5, pela metade do custo. A parte mais útil são as fraquezas divulgadas: cibersegurança e biologia ficam atrás do Mythos 5.
Nossas quatro tarefas não dizem nada sobre esse teto de capacidade, porque os dois modelos passaram nas quatro. Em trabalhos tão pequenos, o ganho de capacidade é invisível; o aumento de tokens, não.
A conta de custos: com o mesmo preço, o volume decide
Os dois modelos cobram $25 por milhão de tokens de saída. Portanto, em um único canal e ao preço de tabela, a questão de custo entre Claude Opus 5 e Opus 4.8 se resume a quantos tokens cada um emite para o mesmo trabalho. Nas quatro tarefas, foram 1.182 tokens no Opus 5 contra 380 no Opus 4.8: proporção de 3,1x, ou cerca de 3,0 centavos contra 0,95 centavo.
Esse número tem três limitações:
- Uma execução por modelo e por tarefa, em 2026-07-24. É um teste rápido, não um benchmark.
- Configurações padrão nos dois lados: sem valor de
effort, sem campothinkinge sem prompt de sistema. - Apenas tokens de saída, porque o gateway informou contagens de tokens de prompt muito inconsistentes para algumas famílias de modelos. Os valores absolutos são triviais; apenas a proporção escala.
A direção também não é uniforme. Duas tarefas foram repetidas pelo canal próprio do Claude Code, em vez do gateway:
| Execução | Opus 5 | Opus 4.8 |
|---|---|---|
| Refatoração, canal próprio | 429 tok | 220 tok |
| Correção de bug, canal próprio | 36 tok | 63 tok |
| Correção de bug, gateway (gráfico acima) | 81 tok | 36 tok |
O Opus 5 consumiu menos em uma dessas três execuções. A Anthropic aponta na outra direção no topo da escala, citando um parceiro do setor jurídico que teve média de 26% menos tokens com raciocínio máximo, sem metodologia publicada.
Os dois padrões podem coexistir. Thinking roda por padrão e as respostas do Opus 5 são mais longas, inflando a saída quando o raciocínio é puro overhead. Já em trabalho com vários arquivos, esse mesmo raciocínio pode substituir ciclos de tentativa e erro, reduzindo tokens por tarefa concluída mesmo que os tokens por chamada aumentem. Nenhum dos conjuntos de dados mede isso diretamente. Faça orçamento com base no seu custo por tarefa aceita e trate effort — não o modelo — como a alavanca:
- Reduza o effort antes de qualquer outra medida. A orientação da Anthropic é que
lowemediumno Opus 5 superam os mesmos níveis em modelos Opus anteriores usando uma fração dos tokens;xhighcontinua sendo o ponto de partida recomendado para código e trabalho agêntico. - Audite os padrões herdados. Um
xhighcarregado de antes em um endpoint de classificação pode ser a linha mais cara da sua fatura sem gerar ganho de qualidade. - Ainda está caro? Reavalie a categoria do modelo. Opus 5 contra Sonnet 5 no mesmo orçamento é a alternativa mais barata.
Quando faz sentido continuar no Opus 4.8
Há quatro situações em que o 4.8 vence neste trimestre:
- Você tem um compromisso com o Priority Tier. O guia de migração informa que o Priority Tier não é compatível com Claude Opus 5, enquanto o Opus 4.8 mantém o suporte. Se você comprou capacidade reservada para garantias de latência, migrar significa abrir mão disso: é uma decisão de compras, não de engenharia.
- Uma integração precisa rodar com thinking desligado acima de effort
high. Se suas avaliações exigem raciocínio emxhighe saída sem thinking, o 4.8 é hoje o único modelo que atende aos dois requisitos. - Você tem skills muito ajustadas e não consegue retestá-las neste ciclo. Uma rota congelada no 4.8 é melhor do que uma migração incompleta para o Opus 5 usando prompts escritos para outro modelo.
- Há pressão de custo e um relay no caminho. Gateways de terceiros compatíveis com OpenAI dão descontos agressivos para modelos mais antigos: a lista de modelos Anthropic da AIReiter precifica o Opus 4.8 em $1.56/$7.76 por milhão de tokens, cerca de 69% abaixo da tabela, e ainda não adicionou
claude-opus-5. A paridade de preços deixa de valer entre canais de acesso. Onde o 4.8 já entrega o resultado, o modelo correto mais barato vence. O comparativo de melhor modelo Claude para programação avalia toda a linha tarefa por tarefa.
Medo de uma aposentadoria iminente não entra nessa lista. A página de descontinuação de modelos da Anthropic listava ambos como Active, e não Deprecated, em 25 de julho de 2026. Isso significa que nenhum tem retirada programada, com datas mais cedo ainda provisórias de 28 de maio de 2027 para o 4.8 e 24 de julho de 2027 para o Opus 5.
Uma ordem de rollout que preserva o caminho de volta
1. Primeiro, congele uma base de comparação do 4.8. Registre tokens de saída, latência e taxa de aprovação em 20 a 50 solicitações reais como piso, e mais do que isso para trabalho agêntico de alta variância. Inclua tarefas nas quais o 4.8 falha hoje. Sem esse histórico, uma regressão parece apenas uma diferença. 2. Faça buscas no código antes do deploy. Procure "disabled" perto de effort, valores de max_tokens abaixo de 16k e as strings "verify", "double-check" e "January 2026" em prompts de sistema. Quatro buscas cobrem a quebra explícita e três mudanças silenciosas. 3. Rode uma rota, não uma virada global. Direcione uma fatia do tráfego para claude-opus-5, com o ID do modelo na configuração em vez de espalhado pelo código. Assim, reverter é uma alteração de configuração, não um deploy. 4. Defina critérios numéricos de promoção antes de ativar a rota. Taxa de aprovação igual ou maior que a linha de base do 4.8; validade de schema e aderência a chamadas de ferramentas também iguais ou maiores; custo por tarefa aceita abaixo de um teto definido previamente; latência p95 dentro do seu SLO; e taxa de erros 400 igual a zero. Falhou em qualquer item, a configuração volta para claude-opus-4-8. 5. Registre separadamente o modelo solicitado e o modelo retornado. Os classificadores de cibersegurança do Opus 5 podem encaminhar solicitações recusadas de volta ao Opus 4.8 após você aderir ao fallback no servidor. Assim, uma execução exibida como Opus 5 no seu painel pode ter sido atendida pelo 4.8.
Para a maioria das equipes, a decisão entre Claude Opus 5 e Opus 4.8 termina em migrar, seguindo essa ordem e dentro de um ciclo de release. Promova apenas o que superar os critérios da etapa 4 contra sua própria base do 4.8. No primeiro dia, remova prompts herdados que pedem verificação, como orienta o guia da Anthropic: é aí que o aumento de tokens se transforma em fatura.
Perguntas frequentes
Claude Opus 5 substitui o Opus 4.8 diretamente?
O guia de migração da Anthropic o chama de upgrade direto pelo mesmo preço, e isso se sustenta na camada de API: mesma janela de contexto, mesmo teto de saída de 128k e uma quebra importante para auditar. Na camada de prompts, não. Instruções de verificação, padrões de effort, limites de max_tokens e definições de skills ajustadas para o 4.8 precisam ser revisados — e nenhum deles se anuncia com um erro.
Por que minha requisição ao Opus 5 retorna erro 400?
O mais provável é que você tenha enviado thinking: {"type": "disabled"} junto de effort xhigh ou max, combinação que o Opus 5 rejeita em toda requisição. Remova o campo thinking e mantenha o nível de effort, ou deixe thinking desativado e reduza o effort para high ou menos. Valores não padrão de temperature, top_p ou top_k também retornam 400 em todos os modelos Claude a partir do 4.7.
Claude Opus 4.8 será descontinuado?
Não. A página de descontinuações da Anthropic lista claude-opus-4-8 como Active, com primeira data de retirada provisória em 28 de maio de 2027 e uma política de aviso mínimo de 60 dias para modelos lançados publicamente. Ele também continua como destino de fallback para recusas do Opus 5 na categoria de cibersegurança e mantém suporte ao Priority Tier, que o Opus 5 não oferece.
Qual modelo Claude Opus é o melhor agora?
Claude Opus 5, considerando os números divulgados pela Anthropic e relatos iniciais de desenvolvedores, com programação agêntica e tarefas de longo horizonte como os ganhos mais claros. O Opus 4.8 continua sendo a melhor escolha para cargas com Priority Tier, integrações com thinking desativado que exigem effort acima de high e conjuntos de prompts que você ainda não consegue recalibrar.
Como mudar para o Opus 5 no Claude Code e nos apps Claude?
Opus 5 é o novo padrão no Claude Max e o modelo mais forte no Claude Pro. Ele pode ser selecionado no Claude Code, Claude Cowork, claude.ai, Amazon Bedrock como anthropic.claude-opus-5, Google Cloud e Microsoft Foundry.
O effort padrão no Claude Code é high, e a profundidade de raciocínio agora é definida por effort, em vez de um controle manual de extended thinking. O Opus 4.8 continua selecionável nessas superfícies, permitindo reverter sem mexer no código da API.
Claude Opus 5 custa mais que o Opus 4.8?
Não por token: ambos custam $5 de entrada e $25 de saída por milhão, $2.50/$12.50 na Batch API e $0.50 por milhão em acertos de cache. Por tarefa, nosso teste de uma única execução mostrou o Opus 5 emitindo cerca de 3x mais tokens de saída; preços de tabela idênticos ainda podem resultar em uma fatura maior. O modo rápido, a $10/$50 para cerca de 2,5x mais velocidade, está disponível apenas na Claude API.
