Claude Sonnet 4 ainda funciona? O que acontece com uma versão antiga do modelo

Fala aí, beleza? Se o teu projeto ainda tem claude-sonnet-4-20250514 escrito em algum canto, essa conversa é contigo

Poucas coisas dão mais frio na barriga que abrir o painel de manhã e ver a integração devolvendo erro sem ninguém ter tocado em uma linha sequer

O Claude Sonnet 4 é o caso concreto disso: ele foi aposentado na Claude API em 15/06/2026, e as requisições ao model ID dele não são mais atendidas, elas voltam com erro

A parte boa é que nada disso é aleatório, existe um ciclo de vida documentado, com estágios, aviso prévio e data marcada no calendário

Bora entender o ciclo inteiro, o que muda pra quem tem código rodando e o que dá pra checar hoje mesmo?

Os quatro estágios do ciclo de vida de um modelo Claude

Antes do como, o porquê: modelo não é software eterno, ele nasce, envelhece e sai de cena

A Anthropic organiza isso em quatro estágios, e cada nome tem definição oficial na documentação de depreciações:

Formação Recomendada

Formação Claude Code

Domine Claude Code do absoluto zero até o avançado

• 120 aulas
• 4 projetos
• 9h 45min

Conhecer formação

• Active: totalmente suportado, é o estado normal de um modelo em uso
• Legacy: não recebe mais atualizações
• Deprecated: ainda funciona, já não é recomendado e tem data de aposentadoria marcada
• Retired: não está mais disponível para uso

Se você já lidou com versão de linguagem ou de framework saindo de suporte, o desenho é bem semelhante: primeiro para de evoluir, depois ganha data de validade, depois some

E tem uma regra de convivência importante: para um modelo lançado publicamente, o aviso vem com no mínimo 60 dias de antecedência, com notificação aos clientes que têm implantações ativas naquele modelo

Com o Sonnet 4 foi exatamente assim: a notificação saiu em 14/04/2026 pra quem usava Claude Sonnet 4 e Claude Opus 4, e a aposentadoria foi efetivada em 15/06/2026

Ou seja, quebrou do nada? Não, o e-mail chegou antes… o problema é que ninguém lê 😅

O que acontece com a sua chamada em cada estágio

Vocabulário oficial é bonito, mas o que interessa pra quem tem produção rodando é uma coisa só: a minha requisição vai passar?

Repare no pulo perigoso: entre Deprecated e Retired a diferença não é de qualidade, é de existir ou não existir

Enquanto está Deprecated, o código roda e ninguém sente nada, então é fácil empurrar a migração com a barriga até o dia em que a resposta vira erro

O que muda para quem ainda aponta para o Claude Sonnet 4

Depende de por onde a sua chamada passa, e isso muda MUITO o cenário

Na Claude API, é o cenário fechado: o Sonnet 4 está aposentado desde 15/06/2026 e as requisições ao claude-sonnet-4-20250514 falham e retornam erro

Em plataformas operadas por parceiros, a história é outra: Amazon Bedrock e Google Cloud definem os próprios cronogramas de aposentadoria, então o status e as datas de um mesmo modelo podem divergir do calendário publicado pela Anthropic

Traduzindo: não assuma que o que vale num lugar vale no outro, cheque o cronograma da plataforma onde o teu projeto realmente roda

E tem o detalhe que pega gente experiente: alias curto ou ID com data?

Modelos anteriores à geração 4.6 trazem a data do snapshot no ID (tipo claude-sonnet-4-5-20250929) e têm um alias curto na Claude API (tipo claude-sonnet-4-5), que aponta pro snapshot mais recente daquela versão menor

Da geração 4.6 em diante o formato mudou, e isso está na documentação de IDs e versões de modelo: o ID vem sem data e é o identificador canônico daquele lançamento, mapeado pra um snapshot fixo

A recomendação oficial é direta: alias serve pra experimentação, e em aplicação de produção você usa a versão específica do modelo pra garantir comportamento consistente

O Sonnet 4 rendeu bastante assunto por aqui na época, inclusive o salto de janela de contexto na API, e é curioso ver o mesmo modelo virando linha numa tabela de aposentados

Erro ao chamar o modelo: como identificar e resolver

O sintoma:

A requisição pro model ID retorna erro, do nada, sem deploy novo e sem mudança de código

Costuma aparecer primeiro num job de fundo ou numa rotina agendada, aquele pedaço que ninguém olha no dia a dia

A causa:

O modelo entrou no estágio Retired, ou seja, não está mais disponível para uso

Não é rate limit, não é chave errada, não é rede: o identificador aponta pra algo que a plataforma não serve mais

A solução:

Trocar o model ID por um modelo que esteja realmente disponível

E aqui vai o pulo do gato: em vez de chutar um nome que você viu num post ou lembrou de cabeça, confirme na fonte, existe um endpoint pra isso

GET /v1/models

A Models API devolve, pra cada modelo disponível, o id, o display_name, o created_at, o max_input_tokens, o max_tokens e um objeto capabilities, com os mais recentes listados primeiro

A prevenção:

Três hábitos simples e você não passa por isso de novo:

• consultar a Models API de tempos em tempos, comparando com o que o projeto usa de fato
• fixar a versão específica do modelo em produção, deixando alias só pra experimentar
• tratar notificação de depreciação como tarefa, não como e-mail de marketing, ela chega com no mínimo 60 dias

Tome cuidado com um detalhe: aviso só chega pra quem tem implantação ativa naquele modelo, então projeto parado, cliente antigo e ambiente esquecido são os que mais quebram

Checklist: como auditar um projeto que ainda usa Sonnet 4

Bora ver na prática? É rápido, dá pra fazer numa sentada

1. Ache todo model ID fixo no código e nas variáveis de ambiente

grep -r "claude-sonnet-4-20250514" .

O erro comum deste passo é varrer só o repositório e esquecer do resto: arquivo de ambiente do servidor, variável do CI e configuração do deploy também guardam model ID, e é justamente lá que ele fica escondido por meses

2. Rode GET /v1/models e compare com o que o projeto usa

A lista da API é a verdade do momento, memória e print antigo não são

O erro comum deste passo é generalizar o resultado: se o teu projeto roda em Bedrock ou Google Cloud, o cronograma daquela plataforma é próprio e pode divergir, confira lá também

3. No Claude Code, entenda ONDE o modelo está definido

A flag --model e a variável ANTHROPIC_MODEL valem apenas para a sessão iniciada com elas, então não adianta esperar que a escolha sobreviva pra próxima vez

Pra fixar de forma permanente, o caminho é o campo model no arquivo de settings, e a documentação de configuração de modelo do Claude Code registra que, a partir da v2.1.153, o comando /model já salva a escolha como padrão para novas sessões, gravando o campo model nas configurações de usuário

O erro comum deste passo (e é o campeão) é editar a variável de ambiente com o claude já aberto: ele lê as variáveis na inicialização, então ou você exporta antes de abrir, ou reinicia a sessão

Se no meio da auditoria bater a dúvida de qual modelo usar em cada tarefa, vale separar essa decisão da migração, primeiro tire o ID morto do caminho

4. Precisa testar um model ID que o seletor não mostra?

Use ANTHROPIC_CUSTOM_MODEL_OPTION, que segundo a mesma documentação adiciona uma entrada personalizada ao seletor do /model

O erro comum deste passo é achar que isso troca tudo de lugar: ele adiciona a opção sem substituir os aliases nativos, os dois convivem

Aposentado some para sempre? O que a Anthropic faz com o modelo antigo

Essa é a dúvida que quase todo mundo faz depois do susto: o modelo foi apagado da face da Terra?

Não exatamente

A Anthropic assumiu o compromisso de preservar os pesos de todos os modelos lançados publicamente, e também dos modelos usados internamente de forma significativa, por no mínimo o tempo de vida da empresa

A ideia declarada é manter a possibilidade de disponibilizar modelos antigos de novo no futuro

Calma que isso não é promessa de volta, e nem deve virar plano B de arquitetura… é só a diferença entre "tirado do ar" e "deletado"

Tem ainda uma parte que eu achei bem curiosa: ao depreciar um modelo, a empresa entrevista o próprio modelo sobre o desenvolvimento, o uso e a implantação dele, registra as respostas e documenta preferências sobre modelos futuros, num relatório pós-deployment

Na mesma página de compromissos ela conta que uma versão piloto desse processo foi feita com o Claude Sonnet 3.6, antes da aposentadoria dele

Estranho? Um pouco haha, mas é um sinal de que aposentar modelo virou processo com etapas, não um botão que alguém aperta na sexta à tarde

Conclusão

Recapitulando o que importa:

O Claude Sonnet 4 está aposentado desde 15/06/2026 e chamadas ao claude-sonnet-4-20250514 na Claude API falham e retornam erro

Aposentadoria não é surpresa: são quatro estágios (Active, Legacy, Deprecated e Retired) e no mínimo 60 dias de aviso pra modelo lançado publicamente, com notificação a quem tem implantação ativa

E o padrão se repete, é só olhar a fila de 2026: Claude Opus 3 em 05/01/2026, Claude Sonnet 3.7 em 19/02/2026 e Claude Opus 4.1 em 05/08/2026 (esse com notificação em 05/06/2026)

O próximo passo concreto é chato de tão simples: rode GET /v1/models hoje, compare com o que o teu projeto usa, fixe a versão específica em produção e, se você roda em Bedrock ou Google Cloud, cheque o cronograma da plataforma parceira, que é próprio

A fila anda pra frente de qualquer jeito, tanto que a Anthropic anunciou o Claude Sonnet 5 em 30/06/2026

Melhor migrar num dia calmo que num alerta às 3 da manhã, né? 😀

até o próximo post!