DEV Community

Cover image for Como Usar Claude Sonnet 5 no Claude Code
Lucas
Lucas

Posted on • Originally published at apidog.com

Como Usar Claude Sonnet 5 no Claude Code

Claude Sonnet 5 foi lançado em 30 de junho de 2026 e se tornou um dos modelos padrão mais fortes para usar no Claude Code. A Anthropic o descreve como “o modelo Sonnet mais agêntico até agora”, e os benchmarks de lançamento indicam o motivo: em tarefas de uso de ferramentas e codificação agêntica, ele fica a poucos pontos do Opus 4.8 por uma fração do preço. Isso importa especialmente no Claude Code, onde o modelo lê arquivos, executa comandos de terminal, edita o repositório e itera em loop.

Experimente o Apidog hoje

Neste guia, você vai ver como selecionar o Sonnet 5 no Claude Code, o que muda no comportamento do modelo, como estruturar um fluxo de trabalho realista e quando vale trocar para o Opus 4.8. Também veremos como combiná-lo com o Apidog para que o modelo implemente uma API e teste endpoints reais, em vez de trabalhar com suposições.

Por que o Sonnet 5 é um padrão forte para o Claude Code

O Claude Code é uma ferramenta de codificação agêntica. O modelo não responde apenas uma vez: ele planeja, executa comandos, lê a saída, edita arquivos e repete. Esse loop favorece modelos bons em uso de ferramentas, e o Sonnet 5 foi ajustado justamente para esse tipo de trabalho.

Benchmark do Claude Sonnet 5

Abaixo está um snapshot dos benchmarks de lançamento reportados pela Anthropic. Trate os números como resultados reportados, não como testes próprios.

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/a
OSWorld-Verified, uso de computador 81.2% 83.4% 78.5%

A leitura prática é simples: em tarefas com ferramentas no loop, o Sonnet 5 fica cerca de 1 a 3 pontos atrás do Opus 4.8. Em raciocínio puro, sem apoio de ferramentas, o Opus abre uma vantagem maior, perto de 6 pontos. Como o Claude Code é usado principalmente para ler, editar, executar e testar código, o Sonnet 5 tende a entregar um bom equilíbrio entre desempenho e custo.

O preço reforça esse uso como padrão. O Sonnet 5 custa US$3 por milhão de tokens de entrada e US$15 por milhão de tokens de saída em taxas padrão, com taxa introdutória de US$2 de entrada e US$10 de saída até 31 de agosto de 2026. O Opus 4.8 custa US$5 por milhão de tokens de entrada e US$25 de saída. Em um dia intenso de codificação agêntica, essa diferença acumula. Nossa análise de preços do Claude Sonnet 5 detalha os números, incluindo o impacto do novo tokenizador.

Como selecionar o Sonnet 5 no Claude Code

Dentro de uma sessão do Claude Code, use o comando interativo:

/model
Enter fullscreen mode Exit fullscreen mode

O Claude Code exibirá um seletor com os modelos disponíveis. Escolha Claude Sonnet 5. A partir daí, a sessão usará o modelo para planejamento, leitura de arquivos, execução de comandos e edições.

Se preferir definir o modelo diretamente, use:

/model claude-sonnet-5
Enter fullscreen mode Exit fullscreen mode

claude-sonnet-5 é o ID exato do modelo da API, sem sufixo de data. Use esse ID se você estiver criando scripts, documentando um setup de projeto ou padronizando sessões para sua equipe.

O Sonnet 5 está disponível no Claude Code desde o lançamento. Ele também é o modelo padrão nos aplicativos Claude Gratuito e Pro, e está disponível para Max, Team e Enterprise. Para um passo a passo mais amplo, veja o guia do Claude Code. Para comandos de barra, consulte a referência de comandos CLI do Claude Code.

O que muda no comportamento do modelo

O Sonnet 5 é uma atualização direta do Sonnet 4.6, mas alguns comportamentos mudam na prática. Os mais importantes para quem usa o Claude Code são estes:

  1. pensamento adaptativo ativado por padrão;
  2. remoção do pensamento estendido manual;
  3. remoção de parâmetros de amostragem customizados;
  4. novo tokenizador.

Pensamento adaptativo está ativado por padrão

No Sonnet 4.6, uma solicitação sem o campo thinking era executada sem pensamento explícito. No Sonnet 5, o pensamento adaptativo está ativado por padrão. O modelo decide quanto raciocínio aplicar com base na tarefa.

Exemplos práticos:

  • renomear uma função simples: pouco raciocínio;
  • corrigir um teste quebrado com erro claro: raciocínio moderado;
  • refatorar vários arquivos com dependências cruzadas: mais raciocínio;
  • investigar um bug intermitente: mais planejamento antes de editar.

No Claude Code, você não configura isso como faria em uma chamada bruta de API. A ferramenta gerencia a solicitação. O que você verá é o modelo pausar mais em tarefas difíceis e avançar rápido em mudanças simples. A documentação de pensamento adaptativo da Anthropic explica o mecanismo em detalhes.

O modelo também suporta um parâmetro de esforço com quatro níveis:

low
medium
high
xhigh
Enter fullscreen mode Exit fullscreen mode

Esforço controla a profundidade do pensamento e quantos tokens o modelo gasta. Mais esforço pode ajudar em problemas difíceis, mas também aumenta custo. Em um fluxo agêntico, esse é o ajuste relevante quando a tarefa precisa de mais deliberação.

Pensamento estendido manual e parâmetros de amostragem foram removidos

Se você criou ferramentas próprias em torno da API do Claude, revise seus scripts.

O padrão antigo de pensamento estendido manual agora retorna erro 400:

{
  "thinking": {
    "type": "enabled",
    "budget_tokens": 10000
  }
}
Enter fullscreen mode Exit fullscreen mode

No Sonnet 5, use pensamento adaptativo e o parâmetro de esforço.

Também retornam erro 400 valores não padrão para:

temperature
top_p
top_k
Enter fullscreen mode Exit fullscreen mode

Na prática, controle o comportamento com prompt, instruções de sistema e escopo da tarefa. O Claude Code lida com isso internamente, mas automações escritas para o Sonnet 4.6 podem precisar de ajustes. A lista completa está na comparação entre Sonnet 5 e Sonnet 4.6.

O novo tokenizador afeta contexto e custo

O Sonnet 5 usa um novo tokenizador. O mesmo texto-fonte produz aproximadamente 30% mais tokens do que no Sonnet 4.6, cerca de 1,3x mais.

Nada muda no formato das solicitações e respostas, então integrações não quebram por causa disso. Mas duas coisas mudam:

  1. a janela de contexto de 1.000.000 de tokens comporta menos texto em média;
  2. o custo por workload equivalente pode ser maior, mesmo com o preço por token definido.

Se você trabalha com repositórios grandes, não envie tudo para o contexto sem necessidade. Aponte o Claude Code para os arquivos relevantes e deixe o modelo buscar mais contexto quando precisar.

Se você estiver orçando uma carga de trabalho, não reutilize estimativas feitas para o Sonnet 4.6. Recalcule com o Sonnet 5 usando o endpoint de contagem de tokens da Anthropic.

Fluxo de trabalho recomendado no Claude Code com Sonnet 5

O Sonnet 5 funciona melhor quando você separa planejamento, implementação e validação.

Use este fluxo:

  1. descreva a tarefa em alto nível;
  2. peça ao modelo para ler os arquivos relevantes;
  3. peça um plano antes de qualquer edição;
  4. revise o plano;
  5. autorize a implementação;
  6. peça para executar testes;
  7. deixe o modelo ler falhas e iterar.

Um prompt inicial útil:

Leia os arquivos relacionados a autenticação e cadastro de usuário.
Não edite nada ainda.

Primeiro, explique:
1. quais arquivos são relevantes;
2. qual é o fluxo atual;
3. qual plano você recomenda para adicionar validação de e-mail;
4. quais testes devem ser atualizados ou criados.
Enter fullscreen mode Exit fullscreen mode

Depois de revisar o plano:

O plano está correto. Implemente a mudança.
Após editar, execute os testes relacionados e mostre qualquer falha antes de tentar corrigir.
Enter fullscreen mode Exit fullscreen mode

Esse padrão evita edições prematuras. Como o pensamento adaptativo já está ativado, você não precisa forçar raciocínio manual para a etapa de planejamento. Seu papel é delimitar a tarefa e revisar o plano antes de deixar o modelo alterar o repositório.

Também evite prompts genéricos como:

Corrija o projeto.
Enter fullscreen mode Exit fullscreen mode

Prefira algo delimitado:

Corrija a falha no teste UserSignupServiceTest.
Leia apenas os arquivos relacionados ao fluxo de signup, validação de usuário e persistência.
Antes de editar, explique a causa provável.
Enter fullscreen mode Exit fullscreen mode

Construa uma API e deixe o Sonnet 5 testá-la

Um caso prático: você está criando uma API REST com Claude Code.

O modelo pode criar rotas, handlers, validações e testes. Mas ele precisa verificar se o endpoint em execução realmente cumpre o contrato esperado. É aí que o Apidog entra no fluxo.

Use o Apidog para:

  1. definir endpoints;
  2. especificar schemas de request e response;
  3. criar exemplos realistas;
  4. simular a API antes do backend estar pronto;
  5. executar cenários de teste contra o endpoint real.

Depois, conecte esse contrato ao Claude Code via servidor Apidog MCP. Assim, o Sonnet 5 lê a especificação real da API, em vez de inventar payloads, campos ou status codes.

O ciclo fica assim:

# Sonnet 5 no Claude Code implementa o endpoint.
# Depois, executa a suíte de testes Apidog via CLI:

apidog run --access-token $APIDOG_TOKEN \
  --project-id $PROJECT_ID \
  --test-scenario "user-signup-flow"
Enter fullscreen mode Exit fullscreen mode

Quando um teste falha, peça ao Claude Code para analisar a saída:

Leia a saída do teste Apidog.
Identifique se a falha está no contrato, no handler ou na validação.
Não altere a especificação da API sem explicar o motivo.
Corrija a implementação e rode o cenário novamente.
Enter fullscreen mode Exit fullscreen mode

Esse loop é mais seguro do que apenas pedir para o modelo “ver se parece certo”. O contrato da API fica no Apidog, os testes validam o comportamento real e o Sonnet 5 corrige a implementação com base em falhas concretas.

Para configurar o projeto localmente, baixe o Apidog.

A conexão é simples: o Sonnet 5 escreve o código; o Apidog confirma se a API faz o que o contrato diz.

Quando mudar para o Opus 4.8

Use o Sonnet 5 como padrão para a maioria das sessões do Claude Code. Troque para o Opus 4.8 apenas quando a tarefa justificar o custo maior.

Use Opus 4.8 quando:

  • o problema for principalmente raciocínio difícil, não execução com ferramentas;
  • você estiver resolvendo lógica algorítmica complexa;
  • a tarefa envolver muitas etapas autônomas em que pequenos erros se acumulam;
  • a mudança for crítica e qualidade for mais importante que custo;
  • o Sonnet 5 já tentou e não conseguiu convergir.

Fique no Sonnet 5 quando:

  • a tarefa envolve ler arquivos, editar, executar testes e iterar;
  • o volume de uso é alto;
  • custo importa;
  • você precisa de iteração rápida em várias mudanças pequenas;
  • a validação vem de testes, linters, builds ou contratos de API.

A troca é um comando:

/model claude-opus-4-8
Enter fullscreen mode Exit fullscreen mode

Depois da tarefa difícil, volte:

/model claude-sonnet-5
Enter fullscreen mode Exit fullscreen mode

Você não precisa usar o mesmo modelo para tudo. Uma estratégia prática é:

  1. Sonnet 5 para exploração, implementação e testes;
  2. Opus 4.8 para revisar decisões complexas ou resolver bloqueios;
  3. Sonnet 5 novamente para aplicar mudanças e iterar.

Para uma comparação mais detalhada, leia a comparação entre Sonnet 5 e Opus 4.8. Se você já usou Sonnet 4.5 no Claude Code ou Fable 5 no Claude Code, o fluxo será familiar.

Checklist prático

Use este checklist em sessões reais:

  • Defina o modelo: /model claude-sonnet-5.
  • Delimite a tarefa: indique arquivos, módulos ou testes relevantes.
  • Peça plano antes de edição: principalmente em refatorações.
  • Revise o plano: corrija suposições antes de gastar tokens em mudanças ruins.
  • Execute testes cedo: não espere o fim da sessão.
  • Use contratos reais para APIs: valide endpoints com Apidog.
  • Monitore tokens: o novo tokenizador gera cerca de 30% mais tokens que o Sonnet 4.6.
  • Troque para Opus só quando necessário: use para raciocínio difícil ou mudanças críticas.
  • Volte para Sonnet 5: economize em tarefas de implementação e iteração.

Perguntas frequentes

O Claude Sonnet 5 está disponível no Claude Code?

Sim. O Sonnet 5 está disponível no Claude Code desde seu lançamento em 30 de junho de 2026. Selecione-o com /model e escolha Claude Sonnet 5, ou use diretamente:

/model claude-sonnet-5
Enter fullscreen mode Exit fullscreen mode

Preciso alterar configurações para usar pensamento adaptativo?

Não. O pensamento adaptativo está ativado por padrão no Sonnet 5, e o Claude Code gerencia a solicitação. O modelo decide quanto pensar por tarefa. Isso muda em relação ao Sonnet 4.6, onde uma solicitação sem o campo de pensamento era executada sem pensamento explícito. Veja a comparação entre Sonnet 5 e Sonnet 4.6 para a lista completa de mudanças.

O Sonnet 5 é suficiente para codificar ou devo usar o Opus 4.8?

Para a maioria das tarefas agênticas no Claude Code, o Sonnet 5 é um padrão forte. Nos benchmarks de lançamento da Anthropic, ele fica cerca de 1 a 3 pontos do Opus 4.8 em tarefas com uso de ferramentas, como SWE-bench Pro e Terminal-Bench, com preço menor. Use o Opus 4.8 para problemas de raciocínio puro mais difíceis ou trabalhos autônomos longos.

Posso usar o Sonnet 5 no Claude Code gratuitamente?

O Sonnet 5 é o modelo padrão nos aplicativos Claude Gratuito e Pro e está disponível no Claude Code. O uso gratuito vem com limites de taxa e uso. Veja o guia gratuito do Claude Sonnet 5 para entender os caminhos disponíveis e seus limites.

Como o novo tokenizador afeta minhas sessões do Claude Code?

O mesmo texto gera aproximadamente 30% mais tokens do que no Sonnet 4.6. Nada quebra, mas a janela de contexto de 1M comporta menos texto e o custo de uma carga equivalente pode ser maior. Recalcule estimativas de tokens para o Sonnet 5 em vez de reaproveitar números antigos.

Top comments (0)