Como mudar o Claude Code para o Opus 5.5 e manter o modelo fixo

Você executa /model, escolhe Opus e o Claude Code parece continuar em outro modelo, ou retorna um erro 400 antes da primeira resposta. Para mudar para o Opus 5.5 com segurança, separe três verificações: o comando do modelo, a versão do Claude Code e qualquer fallback acionado por uma recusa de segurança.

Use o ID completo quando precisar de uma configuração reproduzível. Use o alias opus somente depois de confirmar para qual modelo ele é resolvido. Também considere que o Opus 5.5 usa medium como effort padrão, em vez do padrão high do Opus 5.

Use o ID completo para fixar o Opus 5.5

O comando mais explícito é:

/model claude-opus-5-5

A Anthropic documenta claude-opus-5-5 como um ID fixo, sem sufixo de data. Essa é a opção mais segura para instruções de equipe, documentação de projeto e provedores personalizados, porque deixa claro qual modelo cada cliente deve solicitar.

A alternativa curta é:

/model opus

Use o alias apenas quando o Claude Code, ou o serviço por trás da sua Base URL, mostrar que ele é resolvido para o Opus 5.5. O alias é prático no uso interativo, mas o ID completo é mais fácil de auditar quando uma sessão ou um gateway se comporta de forma inesperada.

Objetivo	Opção recomendada	Motivo
Fixar o modelo exato	/model claude-opus-5-5	O ID solicitado fica explícito e reproduzível
Selecionar rapidamente o Opus atual	/model opus	É mais curto, mas o modelo resolvido precisa ser conferido
Diagnosticar um provedor externo	Começar pelo ID completo	Separa problemas de alias de falta de disponibilidade

Se você usa o Claude Code por uma Base URL compatível com a Anthropic, como a BetterToken, o procedimento com /model não muda; confirme que o provedor realmente expõe claude-opus-5-5 antes de confiar no resultado de um alias.

Atualize o Claude Code antes da troca

Um cliente lançado antes do modelo pode rejeitar a seleção mesmo que sua conta ou seu provedor já ofereça suporte. Atualize primeiro:

claude update

Depois, reinicie a sessão ativa do Claude Code. Caso use o aplicativo Claude para desktop, atualize-o também e execute novamente o comando com o ID completo.

Uma issue da comunidade registrou um caso específico em 22 de setembro de 2026: o Claude Code 2.1.257 foi rejeitado com claude_code_version_too_old, e a resposta exigia 2.1.280 ou superior. Esse relato é um exemplo útil da barreira de versão, não um mínimo universal e permanente. Siga o requisito indicado no erro que você realmente receber, pois versões futuras podem elevar esse limite.

Troque o modelo e confirme o resultado

Siga esta ordem para que um problema não esconda outro:

1. Execute claude update e reinicie o Claude Code.
2. Digite /model claude-opus-5-5 na sessão em que você vai trabalhar.
3. Confira a seleção que o Claude Code exibe após o comando. Não presuma sucesso apenas porque a entrada foi aceita.
4. Antes de uma tarefa longa ou cara, abra /model novamente e confirme a seleção atual.

Se o ID completo funcionar, mas /model opus não escolher o modelo esperado, continue usando o ID completo. Isso aponta para a resolução do alias, e não para uma impossibilidade geral de usar o Opus 5.5.

Se nenhuma opção funcionar e você usar um endpoint de terceiros, verifique a disponibilidade e o mapeamento do modelo nesse provedor. A Claude API oficial pode aceitar o ID padrão enquanto um gateway compatível mantém outro catálogo ou ainda não habilitou o modelo.

O effort padrão é medium

O Claude Opus 5.5 usa adaptive thinking o tempo todo, e o effort padrão documentado é medium. O Opus 5 usava high, então a troca pode alterar latência, consumo de tokens e profundidade de raciocínio mesmo sem nenhuma outra mudança visível no Claude Code.

No uso comum do Claude Code, não é necessário inventar um nível de effort apenas para concluir a troca. Primeiro confirme o modelo e depois avalie se o comportamento padrão serve para a tarefa. Se o cliente ou gateway expuser esse controle, defina o nível conscientemente em vez de presumir que o padrão antigo continua valendo.

Integrações personalizadas também precisam respeitar as regras de solicitação do Opus 5.5. O modelo rejeita pedidos que desativam thinking ou enviam um thinking budget manual. Se a seleção funcionar, mas a primeira solicitação retornar 400, inspecione transformações do payload no gateway em vez de repetir /model.

Uma mensagem sinalizada pode seguir um fallback

Uma recusa de segurança é diferente da seleção normal de modelo. Na camada da API, o Opus 5.5 pode responder com HTTP 200, stop_reason: "refusal" e um objeto stop_details. Se o cliente ou provedor tiver fallback habilitado, aquela solicitação específica pode ser repetida em outro modelo.

Trate o caso como um fallback por solicitação, não como prova de que sua escolha salva em /model mudou de forma permanente. Antes de continuar um trabalho importante, abra /model novamente e verifique o modelo ativo. A Anthropic também informa que, ao sair do Opus 5.5 para a maioria dos outros modelos, os turnos seguintes são executados sem os thinking blocks anteriores do Opus 5.5; repita as restrições essenciais em vez de assumir que todo o raciocínio foi preservado.

A sequência prática é:

1. Leia o aviso de recusa ou de mensagem sinalizada; não envie o mesmo pedido sem alterações.
2. Se a solicitação for legítima, remova ou reformule a parte que acionou o classificador.
3. Verifique se o cliente ou provedor usou um modelo de fallback.
4. Confirme o Opus 5.5 novamente antes de retomar uma tarefa que dependa de um modelo fixo.

Resolva os problemas mais comuns

Sintoma	Primeira verificação	Próxima ação
400 com claude_code_version_too_old	Versão do Claude Code ou do app	Executar claude update, reiniciar e testar o ID completo
Opus 5.5 não aparece na lista	Catálogo do cliente ou provedor desatualizado	Atualizar o cliente e verificar a disponibilidade no provedor
/model opus escolhe um modelo inesperado	Resolução do alias	Usar /model claude-opus-5-5 e conferir a seleção exibida
O ID é aceito, mas a primeira solicitação retorna 400	Payload upstream incompatível	Revisar thinking desativado/manual e reescritas do gateway
Uma mensagem é sinalizada e outro modelo responde	Fallback após recusa	Ler a recusa, verificar o modelo e repetir as restrições principais
A troca no meio da sessão perde continuidade	Thinking blocks podem não ser transferidos	Confirmar o modelo e fornecer o contexto necessário ao novo turno

Checklist final antes de começar

• O Claude Code foi atualizado e reiniciado.
• /model claude-opus-5-5 é aceito sem erro de versão.
• A seleção exibida realmente corresponde ao Opus 5.5.
• Você espera medium como effort padrão, salvo configuração explícita.
• Após uma mensagem sinalizada ou recusada, você verificou se houve fallback.

Com os cinco pontos confirmados, o ID completo é a forma mais segura de manter a sessão reproduzível. O alias opus continua útil para trocas rápidas, mas seu resultado deve ser verificado, não presumido.

Fontes

• Anthropic: guia de migração para o Opus 5.5
• Anthropic: novidades do Claude Opus 5.5
• GitHub issue #12870: um caso de erro em cliente antigo