Preços da API do Claude Sonnet 5: riscos de migração, custos de tokens e roteamento do Opus

TLDR

Claude Sonnet 5 está disponível como claude-sonnet-5: 1M de contexto, 128k de saída máxima e preços introdutórios de $2 / $10 por MTok de entrada/saída até 31 de agosto de 2026. O preço padrão passa a $3 / $15 por MTok depois disso.

Para equipes no Sonnet 4.6, não é apenas trocar o ID do modelo. Redefina a referência de tokens de saída, nível de esforço, taxa de acerto do cache de prompt, taxa de HTTP 400 e taxa de fallback do Opus 4.8 antes de rotear tráfego de produção.

API Migration Snapshot

Key Takeaways

• Sonnet 5 é uma decisão de migração, não apenas um ID de modelo mais novo.
• Meça custo por tarefa resolvida, não apenas o preço por token.
• Defina effort intencionalmente; Sonnet 5 padroniza high no Claude API e Claude Code.
• Redefina a referência de cache de prompt, tokens de saída e taxa de HTTP 400 antes do rollout em produção.
• Mantenha o Opus 4.8 no conjunto de avaliação para trabalho agentic de alto esforço.

What Actually Shipped

O anúncio do Claude Sonnet 5 da Anthropic o posiciona como o próximo modelo de classe Sonnet para produção. A superfície prática no resumo dos modelos do Claude e na página oficial de preços leva à mesma conclusão: é no Sonnet, não no Opus, que muitas equipes tomam decisões diárias de roteamento, latência e custo.

What Public Discussion Shows

Os fatos duros vêm da documentação da Anthropic. Na comparação publicada pela Anthropic, o Sonnet 5 marca 63,2% no SWE-bench Pro versus 58,1% para o Sonnet 4.6, alcança 80,4% no Terminal-Bench 2.1 versus 67,0%, e melhora o Humanity's Last Exam com ferramentas de 46,8% para 57,4%.

A discussão pública é útil para um propósito mais estreito: mostra o que os builders notaram primeiro e quais afirmações merecem novo teste. O thread de gráfico de lançamento do TestingCatalog trouxe a conversa de benchmarks, a leitura de preço/desempenho do Chubby enquadrou a questão da comparação, e a nota de disponibilidade de ferramentas de desenvolvedor do Kilo Code mostrou o movimento inicial do ecossistema.–

Fonte: @claudeai

As perguntas de acompanhamento são mais úteis do que o hype de lançamento. A discussão no Hacker News focou no uso de tokens e nas curvas de custo, o thread de lançamento no r/singularity debateu a comparação com o Opus, e as impressões iniciais no r/ClaudeAI coletaram relatos em nível de usuário. Trate esses threads como sinais, não como especificações.

Claude Sonnet 5 API Pricing

O preço do Claude Sonnet 5 tem duas fases.

A tabela segue a página de preços do Claude da Anthropic.

O detalhe importante é que o preço por token não conta a história inteira do custo. A documentação do Claude Sonnet 5 da Anthropic observa que o novo tokenizer pode produzir aproximadamente 30% mais tokens para o mesmo texto. Trate isso como um número aproximado de planejamento, não um multiplicador fixo. O aumento exato depende do conteúdo e do formato da carga de trabalho; portanto, as equipes devem recalcular a contagem de tokens com seus próprios prompts de produção.

Para migração, use esta métrica de roteamento:

Custo efetivo por tarefa resolvida = (custo do modelo primário + custo de tentativas + fallback custo) / tarefas bem-sucedidas

Se o Sonnet 5 concluir mais tarefas com menos novas tentativas ou menos chamadas de fallback ao Opus, ele ainda pode sair mais barato na prática. Se o uso de tokens aumentar sem melhorar a qualidade da conclusão, o preço mais baixo no papel pode não se traduzir em menor custo da carga de trabalho.

Three Engineering Dark Corners

O risco de migração não é apenas a qualidade do modelo. Três detalhes menos visíveis podem alterar o custo ou a confiabilidade em produção.

O pensamento adaptativo pode virar gasto de tokens de saída

O Claude Sonnet 5 usa pensamento adaptativo por padrão. A documentação de pensamento estendido da Anthropic afirma que tokens de pensamento são cobrados como tokens de saída, então uma resposta final curta ainda pode esconder uma grande quantidade de raciocínio cobrado.

O controle padrão não é um orçamento fixo de pensamento. A Anthropic descreve effort como o controle de profundidade de pensamento no guia de migração do Claude e na documentação do effort, enquanto o resumo de modelos lista high como padrão do Sonnet 5 no Claude API e Claude Code. Para roteamento simples ou classificação determinística, teste níveis de esforço mais baixos como low ou medium, ou desative o pensamento completamente; em seguida, verifique latência, qualidade e uso de tokens de saída.

Checklist de migração:

• Registre a configuração real de effort em cada execução de avaliação.
• Acompanhe usage.output_tokens, não apenas o comprimento visível da resposta.
• Compare a latência p50/p95 para Sonnet 4.6, Sonnet 5 e Opus 4.8.
• Para tarefas simples de roteamento ou classificação determinística, teste níveis de esforço menores ou desative o pensamento completamente; então compare latência, uso de tokens de saída e acurácia da tarefa.
• Observe tarefas nas quais o Sonnet 5 responde corretamente, mas gasta tantos tokens de pensamento que o Opus 4.8 se torna competitivo.

1. O cache de prompt deve ser recalibrado

Para pesquisa de longo contexto, agentes de suporte e orquestração multi-etapas, o guia de cache de prompt da Anthropic costuma ser a maior alavanca de custo. O novo tokenizer do Sonnet 5 pode mudar a contagem de tokens do mesmo prompt, então as suposições de custo de entradas em cache devem ser recalculadas após a migração. O comportamento do cache também deve ser verificado novamente de forma independente monitorando os campos de criação de cache e leitura de cache.

Não presuma que uma estratégia de cache de prompt calibrada para o Sonnet 4.6 produzirá o mesmo perfil de custo no nível da carga de trabalho no Sonnet 5.

Checklist de migração:

• Refaça a contagem de tokens em todos os prompts longos antes de mudar o tráfego.
• Revise os pontos de corte do cache e o posicionamento de cache-control.
• Monitore cache_creation_input_tokens e cache_read_input_tokens durante a janela de migração.
• Alerta para quedas súbitas de leitura de cache ou picos de criação de cache após mudar o ID do modelo.

Parâmetros de amostragem rejeitados geram 400s que quebram a produção

O Sonnet 5 é mais rígido em alguns parâmetros de amostragem do que muitas integrações antigas esperam. As notas de versão da API da Anthropic afirmam que temperature, top_p e top_k não padrão retornam erro HTTP 400. Se seu wrapper de SDK fixa configurações de amostragem para cada modelo, um rollout pode falhar no momento da requisição.

Checklist de migração:

• Procure no código por temperature, top_p e top_k hardcoded.
• Adicione validação de parâmetros específica por modelo antes de enviar as requisições.
• Faça canary na migração com alertas de taxa de erro antes do rollout completo em produção.
• Mantenha um caminho de fallback para Sonnet 4.6 até a validação de parâmetros ficar limpa.

Claude Sonnet 5 vs Claude Sonnet 4.6

Claude Sonnet 5 é a atualização natural para equipes que já usam o Sonnet 4.6, mas não deve ser tratado como uma migração sem revisão.

Isso importa mais para aplicações com orçamentos de tokens apertados, configurações determinísticas de amostragem ou prompts longos. Antes de substituir o Sonnet 4.6 em produção, refaça a contagem de tokens, remova parâmetros de amostragem não suportados e compare as taxas de sucesso das tarefas.

Sonnet 5 or Opus 4.8: The Routing Decision Tree

A avaliação mais forte não é apenas Sonnet 5 vs Sonnet 4.6. Para muitas equipes, a verdadeira questão de roteamento é:

Este workflow deve rodar no Sonnet 5 mais barato ou no Opus 4.8 mais forte?

Use esta árvore de decisão simples:

• Direcione para Sonnet 5 quando o workflow for de complexidade média, sensível à latência ou sensível a custo.
• Direcione para Sonnet 5 quando a tarefa for suficientemente repetitiva para que tentativas e tempo de revisão possam ser medidos com confiabilidade.
• Mantenha o Opus 4.8 na rota quando a tarefa exigir planejamento de alto esforço, programação multi-arquivo ou decisões corporativas caras.
• Mantenha o Opus 4.8 na rota quando uma resposta falha custar mais do que a diferença de tokens.
• Mantenha o Sonnet 4.6 temporariamente quando prompts de produção dependerem de parâmetros de amostragem não suportados ou orçamentos manuais de pensamento estendido.

O erro mais comum é escolher apenas pelo preço. A abordagem melhor é comparar:

• taxa de tarefas resolvidas
• média de tokens de entrada
• média de tokens de saída
• tentativas por tarefa bem-sucedida
• latência por tarefa bem-sucedida
• tempo de revisão humana economizado
• taxa de fallback ao Opus

Benchmarks: What To Trust And What To Retest

A Anthropic posiciona o Claude Sonnet 5 em programação, uso de ferramentas e workflows profissionais agentic. A conversa de terceiros no lançamento, especialmente o thread de benchmarks do TestingCatalog e a comparação de preço/desempenho do Chubby, virou isso numa pergunta prática de benchmark: o Sonnet 5 fecha lacunas suficientes em relação ao Opus para mudar o roteamento de produção?

Os números explicam por que essa pergunta importa. O Sonnet 5 fica atrás do Opus 4.8 por 6,0 pontos no SWE-bench Pro e 2,3 pontos no Terminal-Bench 2.1, mas supera o Sonnet 4.6 por 5,1 e 13,4 pontos nesses mesmos testes. O gráfico do Chubby também mostra o Sonnet 5 indo de aproximadamente $2+ por tarefa em baixo esforço para a faixa de $5-$7 em esforço mais alto, então as configurações de esforço devem fazer parte do benchmark.

Fonte: @kimmonismus

Trate os benchmarks de lançamento como direcionais. Reteste:

• Se o Sonnet 5 reduz tentativas no seu próprio codebase.
• Se o pensamento adaptativo altera a latência ou o comprimento da saída.
• Se o novo tokenizer aumenta sua conta efetiva.
• Se a taxa de acerto do cache de prompt permanece estável após as mudanças do tokenizer.
• Se parâmetros rejeitados criam picos de HTTP 400 no tráfego canário.
• Se o Opus 4.8 ainda vence em tarefas de alto esforço.

How To Evaluate Claude Sonnet 5 Yourself

Use a janela de preço introdutório para rodar um teste pequeno, mas realista.

Crie um conjunto de avaliação com 20 tarefas

Inclua tarefas reais, não prompts de brinquedo:

• correção de bug no seu repositório
• workflow com chamadas de ferramenta
• síntese de documentos de longo contexto
• triagem de chamados de suporte
• revisão de código
• SQL ou análise de dados
• tarefa agentic multi-etapas

Rode as mesmas tarefas no Sonnet 4.6, Sonnet 5 e Opus 4.8

Não compare saídas pontuais. Compare o mesmo conjunto de tarefas sob o mesmo prompt e os mesmos critérios de revisão.

Se sua stack de avaliação usa agentes de programação, frameworks ou ferramentas de avaliação de prompt, o CometAPI Cookbook tem guias com integração nativa ao GitHub para workflows comuns de desenvolvedor como Claude Code, Codex, LiteLLM, LangChain, Langfuse e Promptfoo.

Meça o custo por tarefa resolvida

Acompanhe:

• tokens de entrada
• tokens de saída
• requisições com grande uso de tokens de pensamento, usando deltas de tokens de saída e qualquer detalhamento de uso disponível
• tokens de criação de cache
• tokens de leitura de cache
• tentativas
• latência
• erros HTTP 400
• edições manuais necessárias
• pontuação final de aprovação/reprovação

1. Observe as restrições de migração

Ao migrar do Sonnet 4.6 para o Sonnet 5:

• use claude-sonnet-5
• remova parâmetros de amostragem não suportados
• evite orçamentos manuais de pensamento estendido
• reteste max_tokens
• reconte tokens com o tokenizer do Sonnet 5
• revise os pontos de corte do cache de prompt
• alerte sobre quedas de leitura de cache, picos de criação de cache e picos de HTTP 400

Decida pela classe de carga de trabalho

Use o Sonnet 5 por padrão para workflows de produção de complexidade média. Mantenha o Opus 4.8 para workflows de alto esforço até que seus próprios dados de tarefas resolvidas indiquem o contrário.

What To Watch Next

Observe cinco coisas nas próximas semanas:

1. Benchmarks independentes de programação e agentes.
2. Relatos reais de desenvolvedores sobre uso de tokens com o novo tokenizer.
3. Relatos sobre gasto de tokens de saída com pensamento adaptativo.
4. Comportamento da taxa de acerto de cache de prompt em cargas de longo contexto.
5. Mudanças de preço ou disponibilidade após o fim da janela introdutória em 31 de agosto de 2026.

Se sua equipe já usa o Sonnet 4.6, não espere a janela de preços fechar. Julho e agosto são o momento certo para testar o Sonnet 5 contra suas cargas de trabalho reais e decidir se deve migrar.

FAQ

Quanto custa o Claude Sonnet 5?

O Claude Sonnet 5 custa $2/$10 por MTok de entrada/saída até 31 de agosto de 2026. O preço padrão é $3/$15 por MTok depois disso.

O Claude Sonnet 5 é um substituto imediato para o Sonnet 4.6?

Na maioria dos casos, mas não sem testes. Atualize o ID do modelo, remova parâmetros de amostragem não suportados, defina effort, reconte tokens e redefina a referência do cache de prompt.

Tokens de pensamento do Claude Sonnet 5 são cobrados?

Sim. Tokens de pensamento são cobrados como tokens de saída, então monitore usage.output_tokens e latência.

Posso desligar o pensamento adaptativo para tarefas simples?

Sim. No Claude Sonnet 5, passe thinking: {"type": "disabled"} para desligar o pensamento. Se a carga ainda se beneficiar de raciocínio, mantenha o pensamento adaptativo ativado e use o parâmetro effort para controlar a profundidade de pensamento. O Sonnet 5 padroniza high, então cargas sensíveis à latência devem testar níveis mais baixos como low ou medium.

Os custos de cache de prompt podem mudar após migrar para o Sonnet 5?

Sim. Reavalie os pontos de corte do cache e monitore cache_creation_input_tokens e cache_read_input_tokens.

O Sonnet 5 ignora parâmetros de amostragem não suportados?

Não. temperature, top_p e top_k não padrão retornam erros HTTP 400. Remova parâmetros hardcoded ou adicione validação específica por modelo antes do rollout em produção.

Devo usar o Claude Sonnet 5 ou o Claude Opus 4.8?

Use o Sonnet 5 para cargas sensíveis a custo. Mantenha o Opus 4.8 para programação agentic de alto esforço e tarefas corporativas complexas.

Test The Migration With CometAPI

Você pode testar o Claude Sonnet 5 via CometAPI e compará-lo com o Claude Sonnet 4.6, Claude Opus 4.8 e outros modelos de ponta em um único workflow de API. Para padrões de setup em agentes de programação, ferramentas de automação e frameworks de avaliação, use o CometAPI Cookbook como um companheiro prático para seu benchmark. Comece com um conjunto pequeno de tarefas, meça o custo por tarefa resolvida e escolha o modelo que vence na sua própria carga de trabalho.