Como voltar do Claude Sonnet 5.5 para o Sonnet 5 se o resultado piorar

Trocar de modelo sem plano de volta é apostar o fluxo inteiro numa ficha só

Fala aí, beleza? O Claude Sonnet 5.5 saiu em 28/09/2026 com o mesmo preço do Sonnet 5

E tem um detalhe que pegou muita gente de surpresa: no Claude Code, a versão 2.1.284 fez o alias sonnet apontar para o Sonnet 5.5 na Anthropic API

Ou seja, tem dev que migrou sem nem perceber haha

E tem quem migrou de propósito, rodou uns dias e não curtiu o resultado no próprio fluxo

Se é o seu caso, se liga: o Sonnet 5 continua ativo (como legado) e dá para voltar para o Sonnet 5 sem adivinhação, desde que você saiba o que mexer 🙂

Bora montar esse plano de rollback?

O que guardar antes de trocar para o Sonnet 5.5:

Rollback bom é rollback chato, mecânico, sem precisar lembrar de nada de cabeça

Por isso o trabalho pesado acontece ANTES da troca, não depois que deu ruim

É a mesma lógica de fazer backup antes de atualizar qualquer ferramenta que roda coisa importante: se você não guardou o estado anterior, voltar vira chute

O checklist que eu sugiro como processo:

• Qual ID ou alias cada fluxo usa hoje: anote fluxo por fluxo. Lembrando que o alias sonnet mudou de alvo na Anthropic API, e no Amazon Bedrock, Google Cloud e Microsoft Foundry ele ainda aponta para um Sonnet mais antigo, então nesses provedores o caminho é fixar o ID completo
• Onde o modelo é definido no Claude Code: pode estar no campo model das configurações do usuário, numa flag --model dentro de script ou na variável ANTHROPIC_MODEL. Mapeie os três, porque o modelo pode estar vindo de um lugar que você esqueceu
• Cópia do código que você alterou por causa da migração: thinking desligado, tool_choice any ou tool forçada, uso de between_tools, toolset de computer use e regras de advisor. Guarde o antes e o depois
• Tarefas de referência com saídas do Sonnet 5: um conjunto fixo de pedidos reais do seu dia a dia, com as respostas que o Sonnet 5 deu. É isso que vai te dizer se o 5.5 piorou mesmo ou se foi impressão

Que mudanças são essas que quebram compatibilidade?

Segundo o guia de migração do Sonnet 5.5, são cinco mudanças que quebram compatibilidade e uma mudança no formato da resposta

Na prática:

• thinking com {type: disabled} retorna erro 400 (sem o campo thinking, o modelo usa adaptive thinking)
• No lugar entra o between_tools, que só funciona até effort high (em xhigh ou max dá 400)
• tool_choice any ou tool forçada retorna 400, só auto e none funcionam
• Thinking blocks ficam presos ao modelo que os gerou: o Sonnet 5.5 lê os blocos do Sonnet 5, Opus 4.8, Haiku 4.5 e anteriores, mas não lê os do Opus 5, Opus 5.5, Fable ou Mythos
• Notas longas entre tool calls voltam como blocos de thinking de progresso
• Mudaram o toolset de computer use e as regras de advisor

Se você adaptou qualquer uma dessas coisas pra fazer o 5.5 rodar, esse código adaptado precisa estar versionado junto com o original

Como voltar para o Sonnet 5 no Claude Code:

Aqui é o caminho mais rápido, são poucos comandos

1. Troque o modelo direto com o comando /model passando o nome completo:

/model claude-sonnet-5

2. Se preferir escolher na lista, rode /model sem argumento para abrir o seletor. Nele, Enter troca e salva como padrão para novas sessões (grava o campo model nas configurações do usuário) e s troca só para a sessão atual

Erro comum deste passo: apertar s, fechar o terminal e estranhar que a próxima sessão voltou para o 5.5

Não é bug, é o comportamento esperado: s não mexe no padrão

3. Para valer só numa sessão específica, abra o Claude Code já com a flag ou com a variável de ambiente:

claude --model claude-sonnet-5

ANTHROPIC_MODEL=claude-sonnet-5 claude

A flag --model e a ANTHROPIC_MODEL valem só para a sessão iniciada com elas, beleza?

4. No Amazon Bedrock, Google Cloud e Microsoft Foundry, fixe o ID completo do Sonnet 5 que o seu provedor lista, em vez de confiar no alias sonnet

Erro comum deste passo: usar sonnet achando que ele aponta para o Sonnet 5 na Anthropic API

Desde a 2.1.284 ele aponta para o 5.5, então o alias é justamente o que te levou pro modelo novo 😛

Regra prática: no rollback, nada de alias, sempre o nome completo

O passo a passo completo de configuração de modelo está na documentação do Claude Code

Como voltar para o Sonnet 5 na Claude API:

Na API dá um pouco mais de trabalho, porque além do ID tem o código que você adaptou

1. Troque o ID claude-sonnet-5-5 pelo ID fixo do Sonnet 5. O pinning segue disponível, então o ID explícito continua funcionando:

{
  "model": "claude-sonnet-5",
  "max_tokens": 64000,
  "messages": [
    { "role": "user", "content": "..." }
  ]
}

2. Restaure o código guardado antes da migração. Se você trocou thinking disabled por between_tools ou tirou o tool_choice any/tool forçada para escapar do erro 400 no 5.5, decida conscientemente se volta à configuração antiga

Não é automático: às vezes a adaptação até melhorou o fluxo, e aí faz sentido manter

O ponto é decidir olhando pro código, não deixar do jeito que ficou

3. Revise o limite de saída. O Sonnet 5.5 tem saída máxima padrão de 128.000 tokens e o Sonnet 5 tem 64.000

Se o seu fluxo passou a gerar respostas mais longas no 5.5, elas podem ficar cortadas quando você voltar

4. Trate o parsing das notas entre tool calls. No 5.5 elas voltavam como blocos de thinking de progresso, então se você mexeu no parser pra lidar com isso, confira se ele ainda faz sentido no Sonnet 5

Erro comum deste passo: mudar só o ID e esquecer o limite de saída e o código adaptado

O request até roda, mas o comportamento fica meio Frankenstein haha

E tome cuidado com histórico de conversa: o Sonnet 5.5 lê thinking blocks do Sonnet 5, mas o caminho contrário não está documentado

Então não reaproveite histórico com blocos de thinking gerados pelo 5.5 numa chamada pro Sonnet 5 sem checar antes

Voltar tudo ou só uma parte do fluxo?

Essa é a pergunta que mais importa, porque rollback não precisa ser tudo ou nada

Se liga nos cenários:

Por que vale a pena considerar a volta parcial?

Porque o preço por token é o mesmo nos dois: US$ 2 por milhão de tokens de entrada, US$ 10 por milhão de saída e US$ 0,20 por milhão em leitura de cache

E, segundo a Anthropic, o 5.5 sai até 30% mais barato por tarefa e gera texto mais de 30% mais rápido

Então jogar fora o modelo novo inteiro por causa de uma tarefa específica pode sair caro

No Claude Code, rodar os dois lado a lado é simples: abra cada terminal com a sua própria flag

# terminal 1
claude --model claude-sonnet-5

# terminal 2
claude --model claude-sonnet-5-5

Aí tu roda as mesmas tarefas de referência nos dois e compara com as saídas que você guardou

Outra opção: usar s no seletor do /model pra testar um modelo na sessão atual sem mudar o padrão

Decisão com base em tarefa real, não em achismo 🙂

Já passou por um dilema parecido com outro modelo? A lógica é a mesma de quando discutimos se dá pra voltar ao Claude Fable 5

O Claude trocou sozinho para o Sonnet 5: o que aconteceu?

Esse aqui confunde muita gente que está comparando os modelos

Sintoma: no Claude, o chat passa a rodar no Sonnet 5 sem você ter pedido

Causa: é um fallback de segurança. Um conjunto restrito de pedidos de cibersegurança de maior risco cai para o Sonnet 5 ou é bloqueado

E a checagem não olha só a sua última mensagem: ela considera tudo o que o modelo lê, como memória, conectores, busca web e arquivos

Solução: entender que, quando o fallback dispara, o pedido roda de novo no Sonnet 5 e o seletor fica no Sonnet 5 pelo resto daquele chat

Isso NÃO é o seu rollback, e também não é sinal de que o 5.5 piorou

Como prevenir: separe contexto sensível do resto do trabalho e, na hora de comparar resultados, saiba distinguir o que foi fallback automático do que foi troca manual

Se você mistura os dois, a comparação fica contaminada e tu conclui coisa errada sobre o modelo

Os detalhes estão no artigo de suporte da Anthropic sobre o assunto

Por quanto tempo dá para ficar no Sonnet 5?

O Sonnet 5 está ativo como legado e a aposentadoria não acontece antes de 30/06/2027

E a Anthropic avisa com pelo menos 60 dias de antecedência antes de aposentar modelos lançados publicamente, conforme a página de descontinuação de modelos da própria Anthropic

Ou seja: o rollback compra tempo, mas não é permanente

Quer prova de que o ciclo chega? O Sonnet 4.5 foi descontinuado em 30/09/2026, com aposentadoria provisória em 30/11/2026, e o substituto recomendado é justamente o claude-sonnet-5-5

Recapitulando o plano:

• Guarde IDs, onde o modelo é definido e o código adaptado antes de migrar
• No Claude Code, volte com /model claude-sonnet-5 ou --model, sempre com nome completo
• Na API, troque o ID, restaure o código e revise o limite de saída
• Considere voltar só a parte do fluxo que piorou
• Não confunda fallback de segurança com rollback

O próximo passo é manter o ID fixado, guardar o checklist da migração e reavaliar o Sonnet 5.5 nas suas tarefas de referência antes de o prazo apertar

Assim, quando chegar a hora de migrar de vez, você já sabe exatamente o que muda…

Até o próximo post!