Claude Code com erros no Sonnet 5.5: como continuar trabalhando com --fallback-model
Voltar para o Blog
Artigoclaudetroubleshootingmodelos de IAagente de programaçãodev tools

Claude Code com erros no Sonnet 5.5: como continuar trabalhando com --fallback-model

Mafra27 de outubro de 20264 min de leitura

Você manda um pedido no Claude Code e volta uma falha em vez da resposta. Em 27/10/2026, a página de status da Anthropic registrou o incidente "Elevated errors for Claude Sonnet 5.5": erros elevados em requisições ao Sonnet 5.5.

Resposta curta: confirme em status.claude.com, e se o problema for do lado deles, rode claude --fallback-model sonnet,haiku ou troque de modelo com /model. O incidente de hoje já foi resolvido, mas o passo a passo vale para o próximo.

Fluxograma: confirmar o incidente em status.claude.com, ligar o --fallback-model, trocar de modelo com /model e, para deixar fixo, gravar fallbackModel nas settings
Três passos para seguir trabalhando, e o ramo para deixar a cadeia fixa.

O que aconteceu com o Sonnet 5.5 em 27/10/2026?

A página de status da Anthropic publicou três atualizações no mesmo dia, todas em UTC:

Horário (UTC)EstadoTexto publicado
09:14Investigating"We are investigating elevated errors on requests to Claude Sonnet 5.5."
09:38Monitoring"A fix has been deployed for the issue affecting Claude services and we are monitoring for recovery."
09:56Resolved"The issue affecting Claude services has been resolved."

Foram cerca de 40 minutos entre a investigação e a resolução. Em horário de Brasília (UTC-3), das 06:14 às 06:56. A fonte é o feed status.claude.com/history.atom, consultado em 27/10/2026.

Como saber se o erro é seu ou da Anthropic?

Abra status.claude.com antes de mexer em qualquer configuração. Se houver um incidente aberto para o modelo que você usa, o erro é do lado deles e reinstalar, relogar ou apagar cache não resolve nada.

Se a página estiver limpa, o problema é outro: autenticação, cobrança, limite de uso ou rede. Esses casos não entram no fallback, como mostra a tabela abaixo.

Como fazer o Claude Code trocar de modelo sozinho?

Use a flag --fallback-model com uma lista de modelos separados por vírgula. Segundo a referência oficial do CLI, ela ativa a troca automática quando o modelo principal está sobrecarregado ou indisponível, e tenta os modelos na ordem em que você listou.

claude --fallback-model sonnet,haiku

Pela documentação de configuração de modelos, o comportamento é este:

  • A cadeia aceita no máximo 3 modelos, depois de remover duplicados. Entradas extras são ignoradas.
  • Cada entrada aceita um nome de modelo ou um alias. "default" expande para o modelo padrão.
  • A troca vale só para o turno atual. Na sua próxima mensagem, o Claude Code tenta o modelo principal de novo.
  • Quando troca, mostra um aviso. O /status não exibe a cadeia, então esse aviso é o primeiro sinal de que o fallback está ativo.
  • Subagentes também usam a cadeia. O modelo da sua sessão não muda.

Quando o fallback dispara e quando não dispara?

SituaçãoTroca de modelo?
Modelo sobrecarregadoSim
Modelo indisponívelSim
Outro erro de servidor sem nova tentativa possívelSim
Erro de autenticaçãoNão
Erro de cobrançaNão
Limite de uso (rate limit)Não
Requisição grande demais ou erro de redeNão

Por isso o fallback não é remédio para "estourei meu limite". Ele cobre falha do provedor, não falta de cota.

Como trocar de modelo no meio da sessão?

Digite /model sonnet (ou outro alias) para trocar na hora, sem sair da conversa. Sem argumento, /model abre o seletor. Um detalhe que muda o resultado, segundo a documentação:

  • Enter troca o modelo e salva como padrão.
  • s troca só nesta sessão e deixa o padrão como está.

Digitar /model <nome> direto se comporta como Enter, ou seja, grava nas suas settings. Se a troca é só para atravessar o incidente, abra o seletor e use s, senão você continua no modelo reserva amanhã sem perceber.

Como deixar a cadeia de fallback sempre ligada?

Grave o campo fallbackModel nas settings, como lista:

{
  "fallbackModel": ["sonnet", "haiku"]
}

Vale para toda sessão nova. Se você passar --fallback-model na linha de comando, a flag tem prioridade sobre a setting.

Atenção: o modelo reserva costuma ser menor. A documentação diz que, durante a compactação do contexto, o Claude Code não cai para um modelo com janela de contexto menor que a do principal. Se todos os reservas forem menores, você vê o erro original e pode tentar de novo.

E se você não quiser depender de um único provedor?

O fallback ajuda, mas continua dentro do mesmo provedor. A Verboo Code deixa você escolher entre mais de um modelo, com tokens ilimitados, e roda no terminal como o Claude Code. Vale ter como segunda opção para dias como este.

Gostou deste artigo?
Compartilhe conhecimento com sua rede.
// Leia também

Artigos relacionados