Claude Sonnet 5 é o modelo intermediário mais recente da Anthropic, lançado em 30 de junho de 2026. A Anthropic o descreve como “a melhor combinação de velocidade e inteligência” e “o modelo Sonnet mais agêntico até agora”. Na prática, ele chega perto do Opus 4.8 em tarefas com agentes e uso de ferramentas, mas com custo menor. Este guia mostra como avaliar o Sonnet 5 para uso em produção: especificações, mudanças de API, benchmarks, preços, disponibilidade, segurança e um exemplo de chamada HTTP que você pode testar no Apidog.
Use este artigo como um mapa técnico. Quando precisar de detalhes de implementação, consulte os guias específicos sobre API, preços ou a comparação direta com o Opus 4.8.
O que é o Claude Sonnet 5
Claude Sonnet 5 é o sucessor do Claude Sonnet 4.6. O ID de modelo da API é exatamente:
claude-sonnet-5
Não há sufixo de data. Ele pertence à camada Sonnet, posicionada pela Anthropic entre os modelos Haiku menores e os modelos Opus e Fable maiores.
A principal proposta é custo-benefício. Para fluxos que usam ferramentas, executam loops ou dependem de comportamento agêntico, o Sonnet 5 fica próximo do Opus 4.8. Em raciocínio puro, sem apoio de ferramentas, o Opus ainda lidera.
Na prática:
- Use Sonnet 5 para agentes, automações, ferramentas, codificação assistida e workloads de alto volume.
- Use Opus 4.8 quando precisar do melhor raciocínio puro e o custo extra fizer sentido.
Se você está migrando do Sonnet 4.6, o caminho básico é trocar o ID do modelo e revisar as mudanças de comportamento descritas abaixo. A comparação dedicada está em Sonnet 5 vs Sonnet 4.6.
Especificações completas
Use claude-sonnet-5 com as seguintes características:
| Especificação | Valor |
|---|---|
| Janela de contexto | 1.000.000 tokens |
| Saída máxima | 128.000 tokens |
| Pensamento adaptativo | Ativado por padrão |
| Parâmetro de esforço |
low, medium, high, xhigh
|
| Visão | Suportado |
| Cache de prompt | Suportado |
| Uso de ferramentas | Suportado |
| Lote | Suportado |
| Saídas estruturadas | Suportado |
| Camada de Prioridade | Não disponível |
| Retenção zero de dados, ZDR | Suportado para organizações com acordo ZDR |
Pontos importantes para implementação:
- A janela de contexto de 1M é padrão e máxima. Não há uma variante menor.
- O pensamento adaptativo vem ativado por padrão.
- O parâmetro de esforço controla quanto o modelo “pensa” e, por consequência, quanto pode consumir.
- A Camada de Prioridade não está disponível no Sonnet 5.
- O conjunto de recursos é próximo ao Sonnet 4.6, mas o comportamento da API mudou em alguns pontos.
Para detalhes da forma de requisição e resposta, veja o guia passo a passo da API e a visão geral dos modelos da Anthropic.
Mudanças de API ao migrar do Sonnet 4.6
Se você está saindo do Sonnet 4.6, revise estes pontos antes de colocar o Sonnet 5 em produção.
1. Pensamento adaptativo agora vem ativado por padrão
No Sonnet 4.6, não enviar thinking significava executar sem pensamento. No Sonnet 5, solicitações sem esse campo usam pensamento adaptativo.
Para desativar:
{
"thinking": {
"type": "disabled"
}
}
Também revise max_tokens. Esse limite inclui os tokens de pensamento e o texto final da resposta.
2. Pensamento estendido manual foi removido
Este formato agora retorna erro 400:
{
"thinking": {
"type": "enabled",
"budget_tokens": 4096
}
}
Em vez disso, use pensamento adaptativo e o parâmetro de esforço.
3. Parâmetros de amostragem não padrão não são aceitos
Definir valores não padrão para estes campos retorna erro 400:
{
"temperature": 0.2,
"top_p": 0.9,
"top_k": 40
}
Ao migrar, remova esses parâmetros e controle o comportamento com instruções no prompt do sistema.
4. Pré-preenchimento de mensagens do assistente continua sem suporte
O pré-preenchimento de mensagens do assistente ainda retorna erro 400, como no Sonnet 4.6. Para moldar a saída, prefira:
- saídas estruturadas;
- instruções claras no prompt do sistema;
- validação pós-resposta no seu código.
Novo tokenizador: remeça seus custos
O Sonnet 5 usa um novo tokenizador. O mesmo texto de entrada gera aproximadamente 30% mais tokens do que no Sonnet 4.6, cerca de 1,3x.
Isso não muda o formato da API, mas muda suas métricas:
-
usageretorna números maiores para o mesmo texto. - A janela de 1M comporta menos texto real em média.
-
max_tokenspode precisar ser aumentado para evitar truncamento. - O custo por requisição equivalente pode subir, mesmo com o mesmo preço por token.
Checklist de migração:
[ ] Trocar model para claude-sonnet-5
[ ] Remover temperature, top_p e top_k não padrão
[ ] Remover thinking.budget_tokens
[ ] Decidir se thinking será adaptativo ou disabled
[ ] Recalcular max_tokens
[ ] Recontar tokens com o Sonnet 5
[ ] Atualizar estimativas de custo
A página de novidades documenta essas mudanças. A documentação de contagem de tokens mostra como medir os novos totais.
Benchmarks de lançamento
Os números abaixo foram relatados pela Anthropic no lançamento. Trate-os como resultados reportados, não como testes independentes.
| Benchmark | Sonnet 5 | Opus 4.8 | Sonnet 4.6 |
|---|---|---|---|
| SWE-bench Pro, codificação agêntica | 63,2% | 69,2% | 58,1% |
| Terminal-Bench 2.1 | 80,4% | 82,7% | Não relatado |
| OSWorld-Verified, uso de computador | 81,2% | 83,4% | 78,5% |
O padrão é consistente:
- Em tarefas com ferramentas no loop, o Sonnet 5 fica a poucos pontos do Opus 4.8.
- Em raciocínio puro, o Opus 4.8 mantém vantagem.
- Em relação ao Sonnet 4.6, o Sonnet 5 melhora em codificação agêntica e uso de computador.
Comparação com o Sonnet 4.6:
- SWE-bench Pro:
58,1%→63,2% - OSWorld-Verified:
78,5%→81,2%
Para uma análise mais detalhada, veja o aprofundamento dos benchmarks do Sonnet 5. Também vale consultar o centro de transparência da Anthropic para os dados subjacentes.
Preços
O Sonnet 5 mantém a mesma taxa por token do Sonnet 4.6 e foi lançado com desconto introdutório.
| Período | Entrada, por 1M tokens | Saída, por 1M tokens |
|---|---|---|
| Introdutório, até 31 de agosto de 2026 | US$ 2 | US$ 10 |
| Padrão, a partir de 1º de setembro de 2026 | US$ 3 | US$ 15 |
Atenção ao tokenizador: como o mesmo texto pode gerar cerca de 30% mais tokens, uma requisição equivalente pode custar mais do que no Sonnet 4.6, mesmo com taxa por token idêntica.
Para comparar:
| Modelo | Entrada, por 1M tokens | Saída, por 1M tokens |
|---|---|---|
| Sonnet 5, padrão | US$ 3 | US$ 15 |
| Opus 4.8 | US$ 5 | US$ 25 |
| Fable 5 | US$ 10 | US$ 50 |
Para cache de prompt e lote, confira a página de preços da Anthropic. A análise completa de preços traz um exemplo prático.
Disponibilidade
O Sonnet 5 está disponível nos produtos da Anthropic e em grandes plataformas de nuvem:
- API Claude: disponível para todos os clientes.
- Aplicativos Claude: modelo padrão para Free e Pro; também disponível para Max, Team e Enterprise.
- Claude Code: disponível.
-
AWS: via Claude no Amazon Bedrock e Plataforma Claude na AWS. Não nas rotas legadas Bedrock
InvokeModelouConverse. - Google Cloud: disponível no Vertex AI.
- Microsoft Foundry: em prévia.
Como o Sonnet 5 é o modelo padrão no plano gratuito do Claude, é possível testá-lo sem pagar, sujeito a limites de uso. Veja o guia de acesso gratuito.
Segurança e recusas
Segundo o cartão do sistema da Anthropic, o Sonnet 5 tem menor taxa geral de comportamentos indesejáveis do que o Sonnet 4.6 e é mais seguro em contextos de agente. Ele também apresenta menor alucinação e bajulação, além de melhor resistência a solicitações maliciosas e injeção de prompt.
Um detalhe importante para implementação: recusas não chegam necessariamente como erro HTTP.
Solicitações sobre tópicos cibernéticos proibidos ou de alto risco podem retornar:
{
"stop_reason": "refusal"
}
Isso pode vir com HTTP 200. Portanto, não trate apenas status HTTP como indicador de sucesso funcional.
Exemplo de verificação:
if (response.stop_reason === "refusal") {
// Registre a recusa, mostre uma mensagem ao usuário
// ou acione um fluxo alternativo.
}
Compensações importantes:
- O Sonnet 5 apresenta taxas de comportamento desalinhado mais altas do que o Opus 4.8 e o Mythos Preview na auditoria comportamental automatizada da Anthropic.
- Ele tem menor capacidade cibernética do que modelos Opus.
- Nenhum modelo Sonnet conseguiu desenvolver um exploit funcional na medida citada, pontuando 0,0%.
Teste a API do Sonnet 5 com Apidog
Ao chamar o Sonnet 5, você está lidando com uma API HTTP: autenticação, cabeçalhos, JSON, limites de taxa, erros, streaming e validação de resposta. O Apidog pode ser usado para montar, testar e salvar essas requisições em uma coleção reutilizável.
Um fluxo prático:
- Crie uma requisição para o endpoint de Mensagens da Anthropic.
- Salve sua chave como variável de ambiente, por exemplo
ANTHROPIC_API_KEY. - Configure os cabeçalhos obrigatórios.
- Envie uma mensagem mínima para validar o modelo.
- Adicione asserções para verificar campos como
stop_reason. - Salve a requisição em uma coleção compartilhável.
- Use mock quando quiser desenvolver contra uma resposta estável sem gastar tokens.
Exemplo com curl:
curl https://api.anthropic.com/v1/messages \
--header "x-api-key: $ANTHROPIC_API_KEY" \
--header "anthropic-version: 2023-06-01" \
--header "content-type: application/json" \
--data '{
"model": "claude-sonnet-5",
"max_tokens": 1024,
"messages": [
{
"role": "user",
"content": "Summarize this changelog entry in one sentence."
}
]
}'
Se quiser desativar o pensamento adaptativo:
{
"model": "claude-sonnet-5",
"max_tokens": 1024,
"thinking": {
"type": "disabled"
},
"messages": [
{
"role": "user",
"content": "Summarize this changelog entry in one sentence."
}
]
}
Para validar recusas, adicione uma checagem para stop_reason:
const body = await response.json();
if (!body.stop_reason) {
throw new Error("Campo stop_reason ausente");
}
if (body.stop_reason === "refusal") {
console.warn("O modelo recusou a solicitação.");
}
Depois que a requisição estiver funcionando, salve-a e use como baseline para testes de regressão ao trocar versões de modelo. Você pode baixar o Apidog e importar a requisição. O passo a passo completo da API inclui o fluxo completo e uma versão com SDK Python.
Para quem é o Sonnet 5
Use o Sonnet 5 como padrão quando:
- Você constrói agentes ou fluxos com uso intenso de ferramentas. É o principal ponto forte do modelo.
- Você executa alto volume e precisa controlar custo. O preço fica bem abaixo de Opus e Fable.
- Você quer migrar do Sonnet 4.6. A migração é direta, desde que você revise as mudanças de API e o novo tokenizador.
- Você usa Claude Code ou editor com assistência agêntica. O Sonnet 5 é um bom padrão para codificação com ferramentas. Veja como usá-lo no Claude Code.
Prefira Opus 4.8 quando:
- o raciocínio puro for mais importante que custo;
- você precisar da maior qualidade absoluta;
- a tarefa exigir autonomia mais longa ou mais robusta;
- o custo adicional for aceitável.
A comparação Sonnet 5 vs Opus 4.8 detalha essa decisão. Para entender a camada Opus, veja o que é o Claude Opus 4.8.
FAQ
O Claude Sonnet 5 é melhor que o Opus 4.8?
Depende da tarefa. Em benchmarks de agente e uso de ferramentas, o Sonnet 5 fica a 1–3 pontos do Opus 4.8 com custo menor. Em raciocínio puro, o Opus 4.8 lidera por aproximadamente 6 pontos. Use Sonnet 5 para agentes e alto volume; use Opus 4.8 para o raciocínio mais complexo. Veja a comparação direta.
Qual é o ID do modelo para Claude Sonnet 5?
O ID da API é:
claude-sonnet-5
Use essa string no campo model.
Quanto custa o Claude Sonnet 5?
Até 31 de agosto de 2026, a taxa introdutória é de US$ 2 por milhão de tokens de entrada e US$ 10 por milhão de tokens de saída. A partir de 1º de setembro de 2026, passa para US$ 3 por milhão de entrada e US$ 15 por milhão de saída.
Como o novo tokenizador gera cerca de 30% mais tokens para o mesmo texto, remeça suas cargas reais antes de estimar custo.
Posso usar o Claude Sonnet 5 gratuitamente?
Sim. O Sonnet 5 é o modelo padrão no plano gratuito do Claude em claude.ai e na camada gratuita do Claude Code, sujeito a limites de uso. Consulte o guia de acesso gratuito.
Preciso mudar meu código para fazer upgrade do Sonnet 4.6?
Na maior parte dos casos, sim, mas a mudança é pequena. Troque o ID do modelo para claude-sonnet-5 e revise:
- pensamento adaptativo ativado por padrão;
-
max_tokensincluindo pensamento e resposta; - remoção de
thinking.budget_tokens; - remoção de
temperature,top_petop_knão padrão; - nova contagem de tokens por causa do tokenizador.




Top comments (0)