Como Usar Claude Sonnet 5 no Claude Code

Claude Sonnet 5 foi lançado em 30 de junho de 2026, e é um dos modelos padrão mais fortes que você pode usar no Claude Code. A Anthropic o chama de “o modelo Sonnet mais agêntico até agora”, e os benchmarks de lançamento comprovam isso: 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. Essa combinação é mais importante dentro do Claude Code, onde o modelo passa o dia lendo arquivos, executando comandos de terminal e editando seu repositório em loop.

Este guia mostra como selecionar o Sonnet 5 no Claude Code, quais mudanças ocorrem em seu comportamento (o pensamento adaptativo está ativado por padrão agora), como executar um fluxo de trabalho realista e quando mudar para o Opus 4.8. Você também verá como emparelhá-lo com o Apidog para que o modelo possa construir uma API e testar o endpoint real em vez de adivinhar.

button

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

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 recompensa modelos que são bons no uso de ferramentas, e o Sonnet 5 é ajustado exatamente para isso.

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

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%

O padrão é a parte útil. Com ferramentas no loop, o Sonnet 5 fica dentro de cerca de 1 a 3 pontos do Opus 4.8. No raciocínio puro, sem nada para se apoiar, o Opus se destaca em cerca de 6 pontos. Codificar no Claude Code é um trabalho que exige muitas ferramentas, então na maioria das vezes você está na faixa em que o Sonnet 5 está próximo do Opus e muito mais barato.

O preço torna o caso mais claro. 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 uma 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. Para um dia movimentado de codificação agêntica, essa diferença se acumula. Nossa análise de preços do Claude Sonnet 5 detalha os números, incluindo a questão do tokenizador abaixo.

Selecionar Sonnet 5 no Claude Code

O Claude Code expõe a seleção do modelo através do comando interativo /model. Dentro de uma sessão, digite:

/model

Você obterá um seletor listando os modelos disponíveis. Escolha Claude Sonnet 5. A partir desse ponto, a sessão o utilizará para planejamento e edições.

Se você preferir definir o modelo sem abrir o seletor, pode passá-lo diretamente:

/model claude-sonnet-5

A string claude-sonnet-5 é o ID exato do modelo da API, sem sufixo de data. Se você estiver roteirizando o Claude Code ou definindo um padrão de projeto, use esse ID exato.

O Sonnet 5 está disponível no Claude Code desde o lançamento. É também o modelo padrão nos aplicativos Claude Gratuitos e Pro, e disponível para Max, Team e Enterprise. Então, esteja você em um plano pago ou gratuito, pode usar o Sonnet 5 hoje. Para um passo a passo completo, consulte nosso guia do Claude Code, e a referência de comandos CLI do Claude Code cobre o restante dos comandos de barra.

O que muda no comportamento do modelo

Sonnet 5 é uma atualização direta do Sonnet 4.6, mas alguns comportamentos são diferentes. Dois deles aparecem enquanto você trabalha no Claude Code.

O pensamento adaptativo está ativado por padrão

No Sonnet 4.6, uma solicitação sem o campo thinking era executada sem pensar. No Sonnet 5, o pensamento adaptativo está ativado por padrão. O modelo decide o quanto pensar com base na tarefa que tem pela frente. Uma renomeação rápida quase não exige pensamento. Uma refatoração complicada em vários arquivos exige mais.

Você não configura isso no Claude Code da mesma forma que faria em uma chamada de API bruta. A ferramenta gerencia a solicitação para você. O que você notará é que o Sonnet 5 faz pausas para raciocinar em etapas mais difíceis e avança rapidamente em tarefas simples. Esse é o comportamento adaptativo funcionando como pretendido. A documentação de pensamento adaptativo da Anthropic explica o mecanismo se você quiser detalhes.

O modelo também suporta um parâmetro de esforço com quatro níveis: low, medium, high e xhigh. Esforço controla a profundidade do pensamento e quantos tokens ele gasta. Um esforço maior ajuda nos problemas mais difíceis e custa mais. Em um loop agêntico, este é o controle que você ajusta quando uma tarefa realmente precisa de mais deliberação.

Pensamento estendido manual e parâmetros de amostragem foram removidos

Se você construiu ferramentas personalizadas em torno do Claude, observe duas remoções. O pensamento estendido manual (thinking: {type: "enabled", budget_tokens: N}) agora retorna um erro 400. Use o pensamento adaptativo e o parâmetro de esforço em vez disso. Definir temperature, top_p ou top_k para um valor não padrão também retorna um erro 400. Controle o comportamento através do seu prompt e instruções do sistema. O Claude Code lida com isso para você, mas quaisquer scripts que você escreveu para o Sonnet 4.6 precisam ser revisados. A lista completa está em nossa comparação entre Sonnet 5 e Sonnet 4.6.

O novo tokenizador afeta o contexto e o 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,3 vezes mais. As formas de solicitação e resposta não mudam, então nada se quebra, mas duas coisas mudam.

Primeiro, a janela de contexto de 1.000.000 de tokens comporta menos texto em média, já que cada token cobre menos. Um grande repositório preenche a janela um pouco mais rápido do que a contagem de caracteres brutos sugere. Segundo, o custo por solicitação de texto equivalente pode ser maior, mesmo que o preço por token não seja alterado. Não reutilize suas estimativas de tokens do Sonnet 4.6. Recalcule com o Sonnet 5 usando o endpoint de contagem de tokens da Anthropic se você estiver orçando uma carga de trabalho.

Um fluxo de trabalho realista do Claude Code com o Sonnet 5

O Sonnet 5 está no seu melhor quando você o deixa planejar antes de editar:

Descreva a tarefa em alto nível. Peça-lhe para ler os arquivos relevantes e propor um plano antes de tocar no código.
Revise o plano. Corrija qualquer coisa errada. Isso é mais barato do que corrigir edições ruins depois.
Deixe-o implementar, executando comandos de terminal e editando arquivos à medida que avança.
Peça-lhe para executar seus testes. Se falharem, deixe-o ler a saída e iterar.

Como o pensamento adaptativo está ativado, você não precisa aumentar manualmente o raciocínio para a etapa de planejamento. O modelo dedica mais esforço onde a tarefa é mais difícil. Seu trabalho é dar instruções claras e revisar o plano.

Mantenha o contexto em mente. Mesmo com uma janela de 1M, alimentar o modelo com todo o seu repositório a cada vez desperdiça tokens e dinheiro. Aponte-o para os arquivos que importam. O Sonnet 5 é bom em seguir uma tarefa delimitada e puxar mais contexto apenas quando precisa.

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

Aqui é onde o fluxo de trabalho se torna concreto. Digamos que você esteja construindo uma API REST no Claude Code. O modelo pode estruturar as rotas, mas não consegue ver se o endpoint em execução realmente se comporta. Essa é a lacuna que o Apidog preenche.

Projete e simule a API no Apidog primeiro. Você define os endpoints, esquemas de solicitação e resposta, e um servidor de simulação que retorna dados realistas, para que seu frontend e testes tenham algo para bater antes que o backend esteja finalizado. Então, enquanto o Sonnet 5 escreve a implementação, você o aponta para o endpoint real através do servidor Apidog MCP, que expõe sua especificação de API ao modelo. O modelo lê o esquema real em vez de inventar um, gera manipuladores que correspondem a ele e pode executar cenários de teste contra o servidor ativo.

O ciclo se parece com isto:

# Sonnet 5 no Claude Code implementa o endpoint,
# depois executa sua suíte de testes Apidog via CLI:
apidog run --access-token $APIDOG_TOKEN \
  --project-id $PROJECT_ID \
  --test-scenario "user-signup-flow"

Quando um teste falha, o modelo lê a saída da asserção e corrige o manipulador. Você obtém um loop de construção-teste apertado onde o modelo verifica contra um contrato real, não uma suposição. Os testes automatizados e as asserções visuais do Apidog detectam a incompatibilidade; o Sonnet 5 faz a correção. Baixe o Apidog para configurar o projeto localmente primeiro.

A conexão honesta é pequena: o modelo escreve o código, e o Apidog é onde você confirma que a API realmente faz o que o contrato diz.

Quando mudar para o Opus 4.8

O Sonnet 5 é o padrão certo para a maioria das sessões do Claude Code, mas o Opus 4.8 justifica seu preço mais alto em alguns casos.

Recorra ao Opus 4.8 quando:

A tarefa é um problema de raciocínio difícil, não um problema de loop de ferramentas. Projetos algorítmicos puros ou lógica sutil é onde a vantagem de ~6 pontos do Opus aparece.
Você está executando um trabalho autônomo de longo prazo onde pequenos erros se acumulam em muitas etapas.
A qualidade importa mais do que o custo para uma mudança crítica específica.

Mantenha-se no Sonnet 5 quando:

Você está fazendo codificação agêntica padrão: lendo arquivos, executando comandos, editando, testando.
O volume é alto e o custo importa.
Você deseja iteração rápida em muitas tarefas pequenas.

Mudar é um comando. Digite /model claude-opus-4-8 para a tarefa difícil, depois volte para claude-sonnet-5 para o resto da sua sessão. Você não precisa se comprometer com um modelo para tudo. Para uma comparação lado a lado mais aprofundada, leia nossa comparação entre Sonnet 5 e Opus 4.8. Se você usou Sonnet 4.5 no Claude Code ou Fable 5 no Claude Code antes, o fluxo de trabalho aqui parecerá familiar.

Dicas práticas

Deixe-o planejar. Peça um plano antes das edições em qualquer coisa não trivial. O pensamento adaptativo lida com a profundidade do raciocínio automaticamente.
Delimite seu contexto. Aponte o modelo para os arquivos que importam. A janela de 1M é grande, mas o novo tokenizador significa que ela se preenche mais rápido do que você esperaria.
Monitore o custo em dias pesados. O Sonnet 5 é mais barato que o Opus, mas um dia inteiro de edições acumula. A taxa introdutória até 31 de agosto de 2026 ajuda.
Teste contra contratos reais. Peça ao modelo para executar testes Apidog contra seus endpoints, em vez de confiar que o código "parece certo".
Use o esforço para etapas difíceis. Quando uma tarefa precisa de mais deliberação, o parâmetro de esforço (até xhigh) é o controle, não os orçamentos de pensamento manual.

Perguntas Frequentes

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

Sim. O Sonnet 5 está disponível no Claude Code a partir de seu lançamento em 30 de junho de 2026. Selecione-o com o comando /model e escolha Claude Sonnet 5, ou passe o ID do modelo diretamente com /model claude-sonnet-5.

Preciso alterar minhas configurações para o pensamento adaptativo?

Não. O pensamento adaptativo está ativado por padrão no Sonnet 5, e o Claude Code gerencia a solicitação para você. O modelo decide o quanto pensar por tarefa. Isso é uma mudança em relação ao Sonnet 4.6, onde uma solicitação sem o campo de pensamento era executada sem qualquer pensamento. Consulte nossa comparação entre Sonnet 5 e Sonnet 4.6 para a lista completa de mudanças de comportamento.

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

Para a maioria das codificações agênticas no Claude Code, o Sonnet 5 é um padrão forte. Os benchmarks de lançamento da Anthropic o colocam a cerca de 1 a 3 pontos do Opus 4.8 em tarefas de uso de ferramentas como SWE-bench Pro e Terminal-Bench, a um preço mais baixo. Mude para o Opus 4.8 para os problemas de raciocínio puro mais difíceis ou trabalhos autônomos de longo prazo.

Posso usar o Sonnet 5 no Claude Code gratuitamente?

O Sonnet 5 é o modelo padrão nos aplicativos Claude Gratuitos e Pro e está disponível no Claude Code. O uso gratuito vem com limites de taxa e uso. Consulte nosso guia gratuito do Claude Sonnet 5 para os caminhos honestos e quais são os limites.

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

O mesmo texto produz aproximadamente 30% mais tokens do que no Sonnet 4.6. Nada se quebra, mas a janela de contexto de 1M comporta menos texto e o custo de texto equivalente pode ser maior. Recalcule os tokens para o Sonnet 5 em vez de reutilizar estimativas antigas.