Resposta curta
Para alternar entre Sonnet, Opus ou outro modelo no Claude Code, use de preferência o comando/model compatível ou o caminho oficial de configuração de modelos.
Aliases, IDs completos e mapeamentos de provedores nem sempre são idênticos. O nome comercial exibido em uma interface web pode não ser o ID reconhecido pela API.
Se você usa um gateway de terceiros, utilize o ID de modelo exibido por ele ou pela documentação do provedor.
Quando isso é importante
- Você quer alternar entre modelos mais econômicos e mais avançados
- Você vê aliases de Sonnet / Opus / Haiku, mas não sabe o que informar
- Você usa uma Base URL ou um gateway de modelos de terceiros
- Você quer controlar o custo de tokens do Claude Code
- A mensagem de modelo não encontrado aparece ou a seleção não entra em vigor
Três níveis de nomes de modelo
Para que a solicitação funcione, o provedor atual precisa reconhecer o ID de modelo.
Prática recomendada
- Confirme quais modelos são aceitos pelo provedor atual.
- Use
/modelno Claude Code ou o caminho oficial de configuração de modelos. - Se você usa um gateway de terceiros, copie o ID disponível na model plaza correspondente.
- Avalie em conjunto a escolha do modelo e o custo.
- Não tente adivinhar nomes de modelos.
Sobre a BetterToken
Se você conectar o Claude Code pela BetterToken, copie o ID de modelo atual da model plaza. Os modelos dos provedores Claude e GPT usam protocolos diferentes; não misture as configurações. A escolha do modelo afeta qualidade, velocidade e custo. Os registros de uso ajudam a comparar o consumo real entre modelos.Documentos relacionados
- Por que o Claude Code usa tantos tokens
- Como configurar API Key e Base URL no Claude Code
- Permissões e hooks do Claude Code
- API compatível com OpenAI versus API compatível com Anthropic

