Como Usar Claude Sonnet 5.5 no Claude Code e Quando Manter Opus 5.5

Para usar o Claude Sonnet 5.5 no Claude Code, atualize para a v2.1.284 ou posterior, depois inicie com claude --model claude-sonnet-5-5 ou selecione-o com /model. Você precisa de um plano pago do Claude (Pro, Max, Team ou Enterprise) ou uma chave de API Anthropic; o plano Gratuito não inclui o Claude Code. O modelo padrão permanece Opus 5.5 em todos eles, então o Sonnet 5.5 só será executado quando você o selecionar. Nas taxas de API, ele custa a metade: $2/$10 por milhão de tokens de entrada/saída contra $4/$20 para o Opus 5.5.

A seguir: configuração, a armadilha do alias sonnet, esforço, hábitos a direcionar, custo e quando o Opus 5.5 ainda vence. Para o modelo em si, veja o que é o Claude Sonnet 5.5. Se seu código chama APIs, o Apidog contém os cenários de teste que o Claude Code pode executar contra suas mudanças.

Claude Sonnet 5.5 no Claude Code em um relance

Fontes: documentação de configuração de modelo do Claude Code e post de lançamento da Anthropic.

Passo 1: atualize o Claude Code e verifique seu plano

O Sonnet 5.5 chegou no Claude Code v2.1.284 em 28 de setembro de 2026, e versões mais antigas não podem executá-lo:

claude update

De acordo com claude.com/pricing, o Pro custa $17 por mês cobrado anualmente ou $20 mensalmente, e o Max começa em $100. Usuários gratuitos podem conversar com o Sonnet 5.5 em Claude.ai, mas não no Claude Code; nosso guia de acesso gratuito cobre o que funciona.

Passo 2: mude o modelo para Sonnet 5.5

claude --model claude-sonnet-5-5

Dentro de uma sessão, /model claude-sonnet-5-5 muda e o salva como seu padrão. Execute /model sozinho para abrir o seletor, onde s muda apenas para esta sessão. ANTHROPIC_MODEL ou uma chave "model" em um arquivo de configurações também funcionam, e /status mostra o que está ativo.

Uma mudança com /model também alcança subagentes que herdam o modelo principal, e uma sessão retomada mantém o modelo com o qual foi salva. Se você fixou claude-sonnet-5 para nosso guia do Claude Code para Sonnet 5, atualize-o: um ID completo não se move quando o alias muda.

O alias sonnet não significa Sonnet 5.5 em todos os lugares

sonnet aponta para Sonnet 5.5 apenas na API Anthropic:

Em um provedor de nuvem, defina ANTHROPIC_DEFAULT_SONNET_MODEL para o ID do Sonnet 5.5 do seu provedor: claude-sonnet-5-5 no Google Cloud e na Plataforma Claude na AWS, o nome da sua implantação no Foundry, seu perfil de inferência no Bedrock. A mesma variável define o modelo que o opusplan executa.

Pule sonnet[1m]: a documentação diz que não tem efeito uma vez que sonnet é Sonnet 5.5, cuja janela de 1M é nativa.

Passo 3: escolha um nível de esforço (o pensamento permanece ativado)

O Sonnet 5.5 começa em medium no Claude Code, um nível abaixo de seu padrão high na API da Plataforma Claude. Os níveis são low, medium, high, xhigh, max:

claude --model claude-sonnet-5-5 --effort high

Em uma sessão, /effort high salva um nível para o modelo atual, /effort abre um controle deslizante, e /effort auto o limpa. CLAUDE_CODE_EFFORT_LEVEL o define a partir do ambiente. Mudar o esforço no meio da conversa pode invalidar o cache de prompts, então o Claude Code pode avisá-lo primeiro.

Você não pode desativar o pensamento aqui. O interruptor Option+T (Alt+T), alwaysThinkingEnabled e MAX_THINKING_TOKENS=0 não têm efeito no Sonnet 5.5. O guia de prompts da Anthropic adiciona que, de medium para cima, ele pensa antes de quase toda resposta, e pedir para "pensar menos" não funciona de forma confiável. Diminua o esforço, ou adicione ultrathink a um prompt para uma única interação mais profunda.

O que cada nível oferece no CursorBench

O Cursor mediu estas pontuações do CursorBench 4.0 em seu próprio ambiente; os custos por tarefa vêm dos gráficos de lançamento da Anthropic.

De low a high, o Sonnet 5.5 custa menos da metade do Opus 5.5 no mesmo nível. Olhe entre os níveis, no entanto: Opus 5.5 em medium ($2,91) supera o Sonnet em high e fica a um ponto do Sonnet em xhigh, que custa $3,88. Se você está forçando o Sonnet 5.5 para xhigh ou max, tente o Opus 5.5 em medium primeiro.

Direcione os hábitos que surgem em uma sessão de codificação

O guia de prompts do Sonnet 5.5 da Anthropic sinaliza comportamentos que importam no Claude Code:

• Ele verifica cedo em low e medium em tarefas agentivas longas.
• Ele adiciona testes, documentos e pequenos arquivos que você não pediu, em todos os níveis de esforço.
• Em xhigh e max, ele inicia rodadas de revisão extras ou subagentes revisores. A Anthropic liga isso a uma pontuação FrontierCode menor em max (46,2%) do que em xhigh (52,1%).
• Em low, ele pode pular a verificação e relatar o código como pronto sem executar testes.

O guia tem os próprios parágrafos de prompt sugeridos pela Anthropic; uma sessão de corte reduziu o custo em cerca de um terço em max nos testes da Anthropic. Aqui está um conjunto mais curto em nossas próprias palavras para adaptar para seu CLAUDE.md:

## Como trabalhar neste repositório
- Continue trabalhando até que a tarefa seja concluída. Pare para perguntar apenas se estiver bloqueado ou prestes a excluir dados.
- Mude apenas o que a tarefa exige. Nenhum novo teste, documento ou arquivo a menos que eu peça.
- Antes de dizer que uma tarefa está concluída, execute os testes relevantes e mostre o comando e o resultado.
- Não inicie subagentes revisores a menos que eu peça uma revisão.

Modo rápido, opusplan e mistura de modelos

O modo rápido é apenas Opus: Opus 5.5, Opus 5 e Opus 4.8, conforme a documentação do modo rápido. Executar /fast no Sonnet 5.5 muda a sessão para Opus. A velocidade do Sonnet vem do modelo, que a Anthropic diz ser "30%+ mais rápido" que o Sonnet 5.

claude --model opusplan usa Opus no modo de planejamento e Sonnet para execução. Ele se encaixa em trabalhos onde o design é difícil e as edições são rotineiras. Kevin Ngo, da Creator, citado na página de lançamento da Anthropic, disse que deixaria o Sonnet 5.5 construir uma arquitetura de jogo que o Opus 5.5 definiu. Você também pode manter o Opus como o modelo principal e definir CLAUDE_CODE_SUBAGENT_MODEL=claude-sonnet-5-5 para subagentes. Nosso guia de fluxos de trabalho do Claude Code tem mais padrões.

Quando manter o Opus 5.5

A Anthropic diz que o Opus 5.5 "permanece claramente mais forte em trabalhos complexos e de final aberto", com o Sonnet 5.5 sendo melhor para tarefas bem delimitadas e correções de bugs. O cartão do sistema (gerenciado pela Anthropic) concorda: SWE-Bench Pro 81.3 vs 89.9 no esforço máximo, e ProgramBench, um teste de contexto longo, 79.7 vs 91.2.

Mantenha o Opus 5.5 para bugs ambíguos, decisões de arquitetura, sessões de grandes bases de código e modo rápido. Escolha o Sonnet 5.5 para correções pontuais, recursos especificados, testes, documentos e trabalhos de subagentes. O Sonnet lidera no Terminal-Bench 4.0 (70.6% em max vs 66.4% em xhigh), mas a Anthropic o executou, e o fallback afetou 10% dos testes do Opus contra 1.5% do Sonnet. Detalhes: Sonnet 5.5 vs Opus 5.5.

O que custa em uma sessão

Com uma chave de API, o Claude Code cobra o preço de tabela: $2/$10 por MTok para Sonnet 5.5, $4/$20 para Opus 5.5, $0.20 para leituras de cache em ambos. A Anthropic também afirma "até 30% menos por tarefa" do que o Sonnet 5.

No Pro, Max, Team ou Enterprise, as sessões consomem os limites de uso do seu plano, e /usage mostra sua posição. Não encontramos um número publicado sobre como cada modelo se compara a esses limites, então meça em suas próprias tarefas.

Cuidado com o max: Simon Willison relatou no Hacker News que seu teste pelicano em max queimou 128.000 tokens de pensamento em cerca de 15 minutos e esgotou antes de produzir o SVG. Mais contas: Preços do Sonnet 5.5.

Migre um projeto de API de dentro do Claude Code

Se seu aplicativo chama Sonnet 5 através da API, o Claude Code pode migrá-lo:

/claude-api migrate this project to claude-sonnet-5-5

Espere mudanças significativas: thinking: {"type": "disabled"} retorna um 400 e se torna between_tools, tool_choice forçado dá lugar a auto mais strict: true tools, e temperature, top_p ou top_k não padrão retornam um 400. Sonnet 5.5 vs Sonnet 5 aborda cada correção.

Em seguida, teste contra a API ao vivo. Salve a requisição antiga e nova como um par no Apidog, mantenha ANTHROPIC_API_KEY em uma variável de ambiente e faça asserções em stop_reason e usage, para que uma recusa ou um salto nos tokens de saída apareça como um teste falho.

Execute seus testes de API com o CLI do Apidog

Como o Sonnet 5.5 em low pode pular testes, dê a ele um teste para executar. O CLI do Apidog executa seus cenários de teste salvos do Apidog a partir do terminal, para que o Claude Code possa iniciar uma execução, ler os resultados, corrigir o manipulador e executar novamente. Adicione uma regra ao CLAUDE.md:

- Após alterar um endpoint de API, execute seu cenário de teste do Apidog com o CLI do Apidog e relate as contagens de aprovações e falhas.

A configuração está em CLI do Apidog no Claude Code, e a versão Copilot está em CLI do Apidog no GitHub Copilot. Baixe o Apidog para construir os cenários.

Sonnet 5.5 no GitHub Copilot e Cursor

GitHub Copilot. Conforme o changelog do GitHub, o Sonnet 5.5 foi lançado em GA em 28 de setembro para Copilot Pro, Pro+, Max, Business e Enterprise, cobrado pelos preços de tabela do provedor. Está disponível no VS Code, JetBrains, Copilot CLI, no agente de codificação e mais, com um lançamento gradual. Copilot Free e Student não o recebem; esses planos são limitados à seleção automática de modelo, que não inclui o Sonnet 5.5.

Cursor. A página de modelos do Cursor lista claude-sonnet-5-5 com contexto padrão de 200k e máximo de 1M, cobrado do pool Outros Modelos no Pro e superior pelas mesmas taxas de $2/$10. Endpoints apenas nos EUA custam 10% mais. O Cursor ainda não publicou uma entrada no changelog para isso.

FAQ

O Sonnet 5.5 é o padrão no Claude Code? Não. O default é o Opus 5.5 no Pro, Max, Team, Enterprise e na API Anthropic. Selecione o Sonnet 5.5 com --model ou /model.

Posso usá-lo no Claude Code no plano Gratuito? Não, o Claude Code é pago. Usuários gratuitos podem conversar com ele em Claude.ai; veja como usar o Sonnet 5.5 gratuitamente.

Por que /model sonnet me dá um modelo mais antigo? Você está em um provedor de nuvem (Bedrock, Google Cloud, Foundry, Plataforma Claude na AWS) ou em uma versão anterior à v2.1.284. Fixe o ID completo.

Quanto mais barato ele é do que o Opus 5.5? A metade, nos preços de tabela da API. Veja a análise de preços.

Seu próximo passo

Execute claude update, inicie sua próxima tarefa delimitada com claude --model claude-sonnet-5-5 e deixe o esforço em medium por alguns dias. Adicione as regras CLAUDE.md, envie trabalhos de design complexos através de opusplan e mantenha o Opus 5.5 a um /model de distância. Se o trabalho envolver APIs, conecte o CLI do Apidog para que cada "concluído" tenha um teste executado por trás. O Apidog é gratuito para começar.