Como alterar o modelo padrão no Claude Code (e os novos hooks de troca de modelo em 2.1.251)

Defina seu modelo padrão do Claude Code com /model

A distinção principal é entre salvar uma preferência e trocar de modelo temporariamente. Em agosto de 2026, até o dia 29, /model já oferecia suporte aos dois fluxos de trabalho.

A versão 2.1.153 alterou /model para que uma seleção seja salva como padrão para novas sessões. Esse comportamento é anterior à versão 2.1.251: a versão de agosto introduziu hooks de troca de modelo, e não a capacidade de lembrar uma seleção interativa de modelo.

O registro de alterações fixado em uma versão é a referência histórica para essa distinção. Ele registra tanto o comportamento de seleção persistente quanto a ação do seletor para uma troca temporária.

Salve uma preferência para sessões futuras

Use o seletor de modelos:

/model

Selecione o modelo que você deseja usar como padrão. O comportamento de persistência introduzido na versão 2.1.153 significa que essa seleção é salva para novas sessões.

Esta é a resposta mais clara, com respaldo histórico, para “Como faço para que meu modelo preferido persista?”. Ela não exige tratar um recurso introduzido em uma versão anterior como uma nova capacidade da versão 2.1.251.

Troque apenas para a sessão atual

Pressione s no seletor para trocar de modelo apenas na sessão atual. Use essa ação quando a seleção deve ser temporária.

Essa distinção é importante ao seguir instruções antigas ou manter atalhos de teclado personalizados. A ação anterior do seletor d passou a ser s, e o atalho de teclado personalizado associado mudou de modelPicker:setAsDefault para modelPicker:thisSessionOnly.

Para um contexto mais amplo sobre a seleção de modelos, consulte o guia de modelos do Claude Code. O ponto específico dessa versão é simples: uma seleção comum salva um padrão, enquanto a ação restrita à sessão permite uma troca temporária.

Arquivos de configuração, ANTHROPIC_MODEL e substituições na inicialização

A configuração de modelos também pode ser feita por arquivos de configurações, variáveis de ambiente e flags de inicialização. No entanto, a pesquisa fornecida estabelece uma limitação histórica: a documentação exata e a precedência dessas opções não foram verificadas de forma independente em uma versão arquivada disponível até o dia 29 de agosto de 2026.

O documentação de configuração de modelos e documentação de configurações descrevem essas opções, mas essas páginas contêm atualizações posteriores. Elas não podem estabelecer todos os detalhes do comportamento na data de corte deste artigo.

A tabela a seguir separa as opções documentadas daquilo que as evidências datadas sustentam.

Qual configuração prevalece?

A pesquisa fornecida relata uma documentação que coloca a flag de inicialização acima de ANTHROPIC_MODEL, e a variável de ambiente acima do valor model do arquivo de configurações. Ela também indica explicitamente que essa ordem não foi verificada para a data de corte da publicação.

Consequentemente, este artigo não apresenta essa cadeia de precedência como um fato estabelecido em agosto de 29. A /model alteração de persistência tem como referência um registro de alterações datado; a hierarquia exata de configuração não.

E quanto a um padrão para um único projeto?

A pesquisa identifica na documentação arquivos de configurações do usuário, do projeto e pessoais do projeto. Ela não estabelece sua redação histórica exata nem o comportamento da configuração de modelos por meio de uma versão arquivada anterior à data de corte.

Isso limita a resposta em comparação com um tutorial de configuração de projeto: /model a persistência está confirmada, enquanto as instruções sobre arquivos específicos de projeto exigem verificação histórica. A referência da CLI oferece um complemento útil para a configuração pela linha de comando, mas não elimina o limite das evidências deste artigo.

O que os hooks de troca de modelo acrescentam na versão 2.1.251

O Claude Code 2.1.251 foi lançado no dia 28 de agosto de 2026. Suas notas oficiais da versão introduzem dois hooks com nomes exatos:

• PreModelSwitch
• PostModelSwitch

A versão descreve suas capacidades como bloquear, confirmar ou anotar uma troca de modelo. Esses hooks ampliam o fluxo de seleção de modelos com controles sobre a troca.

Esse é o novo recurso que deve ser distinguido da persistência do padrão. Salvar uma preferência de modelo já estava disponível; os novos eventos de hook acrescentam formas de participar de uma mudança de modelo.

Um hook pode bloquear ou solicitar confirmação?

Sim, bloqueio e confirmação são capacidades explicitamente citadas no anúncio da versão. A anotação também está listada.

O anúncio não fornece os esquemas completos de entrada e saída, as regras de correspondência nem os JSON de decisão. Portanto, ele permite descrever essas capacidades, mas não publicar uma configuração executável baseada apenas no anúncio.

O mesmo limite se aplica a detalhes como quais campos do payload identificam os modelos antigo e novo ou como uma resposta de confirmação deve ser estruturada. Esses detalhes estão ausentes das evidências fornecidas anteriores à data de corte.

O que é necessário antes de implementar um?

Uma implementação funcional precisa de mais do que os nomes dos eventos: ela precisa do formato de configuração aplicável e do contrato de resposta compatível. As notas da versão não fornecem esses elementos.

Use o guia de hooks do Claude Code para um contexto mais amplo sobre hooks. Para esta versão, mantenha o escopo confirmado preciso: PreModelSwitch e PostModelSwitch existem, e o anúncio descreve capacidades de bloqueio, confirmação e anotação.

Inspecione o comportamento do cache de prompts e os custos de retomada

A versão 2.1.251 também acrescenta diagnósticos que ajudam a explicar o comportamento do cache de prompts. Essas adições expõem a atividade do cache e o custo estimado de reconstrução; a versão não anuncia novos preços de tokens nem limites numéricos de cache.

Leia a nova linha de cache em /cost

O comando existente ganha uma linha de cache de prompts por sessão:

/cost

Essa linha informa quatro itens:

• Taxa de acertos
• Falhas de cache
• Tokens armazenados novamente em cache
• Estado quente ou frio

Juntos, esses itens oferecem uma visão mais detalhada do cache do que apenas um valor de custo. Eles distinguem os acertos das falhas de cache e mostram quantos tokens foram armazenados novamente em cache.

Os scripts da linha de status também ganham um objeto correspondente prompt_cache . Isso disponibiliza os diagnósticos de cache na interface da linha de status, assim como por meio de /cost.

O anúncio não fornece um esquema completo para esse objeto. Trate prompt_cache como um nome de objeto confirmado, sem presumir campos adicionais além dos diagnósticos descritos na versão.

Inspecione informações de retomada por meio de SessionStart

Ao retomar, SessionStart os hooks agora recebem informações sobre há quanto tempo a sessão está inativa e o custo estimado de reconstrução do cache de prompts.

Isso é diferente da /cost exibição: a adição na retomada fornece informações aos hooks, enquanto o comando apresenta diagnósticos de cache por sessão. Ambas as adições tratam da visibilidade do cache, mas expõem essas informações por interfaces diferentes.

As notas de versão não informam os nomes exatos das chaves do payload referentes ao tempo de inatividade da sessão ou ao custo estimado de reconstrução. Um exemplo de hook que presumisse esses nomes iria além das evidências disponíveis.

Outros padrões de modelo e diagnósticos mudaram

Várias mudanças relacionadas em 2.1.251 são relevantes ao interpretar um “modelo padrão”. Elas dizem respeito a subagentes, padrões da conta, preferências de esforço e visibilidade dos gastos no gateway.

Precedência do modelo de subagentes

CLAUDE_CODE_SUBAGENT_MODEL agora fornece um padrão. O valor de model: na definição de um agente e um modelo selecionado explicitamente ao iniciar um agente têm precedência sobre essa variável.

Essa é uma mudança de precedência confirmada no registro de alterações da versão identificada por tag. Ela deve ser mantida separada da ordem histórica não verificada entre a opção de inicialização, a variável de ambiente e o valor no arquivo de configurações do modelo principal.

Ao examinar a seleção de modelo de um subagente, considere essas escolhas explícitas antes de tratar a variável de ambiente como decisiva. O guia de subagentes fornece um contexto mais amplo para a configuração de agentes.

Padrões da conta e preferências de esforço

As assinaturas Enterprise por usuário agora usam Opus 5 como padrão, assim como outros planos premium.

Essa mudança no nível da conta é separada de uma preferência de modelo salva por meio de /model. A versão também altera a persistência de /effort : agora, salva um nível de esforço padrão separado para cada modelo.

A distinção prática é que a seleção do modelo e a persistência do esforço são configurações separadas. O novo comportamento de esforço memoriza um padrão para cada modelo, em vez de definir um único padrão de esforço compartilhado.

Visibilidade dos gastos no gateway

O /usage ganha uma barra de Limite de gastos para desenvolvedores que usam um gateway de aplicativos Claude com limites de gastos:

/usage

Os scripts da linha de status ganham o campo correspondente rate_limits.spend_limit . Essa é uma adição de diagnóstico para esse contexto de gateway.

O registro de alterações não anuncia um limite universal em dólares. Portanto, a presença de uma exibição de limite de gastos não deve ser interpretada como um limite fixo aplicável a todos os usuários do Claude Code.

Principais conclusões

• /model já salvava um padrão para novas sessões antes de 2.1.251; esse comportamento remonta a 2.1.153.
• Pressione s no seletor de modelos para fazer uma troca válida apenas para a sessão atual. Os atalhos de teclado personalizados usam modelPicker:thisSessionOnly.
• O Claude Code 2.1.251 adiciona PreModelSwitch e PostModelSwitch, com recursos de bloqueio, confirmação e anotação descritos na versão.
• /cost, os dados de cache na linha de status e as informações de SessionStart na retomada proporcionam visibilidade sobre a atividade do cache de prompts e os custos estimados de reconstrução.
• CLAUDE_CODE_SUBAGENT_MODEL fornece um padrão que escolhas explícitas de modelo do agente podem substituir. A precedência histórica exata da configuração do modelo principal permanece não verificada na pesquisa fornecida.

Perguntas frequentes

O /model salva o modelo padrão no Claude Code?

Sim. A versão 2.1.153 alterou /model para que uma seleção seja salva como padrão para novas sessões, e esse comportamento já existia antes de 2.1.251. Pressione s no seletor quando quiser uma troca válida apenas para a sessão atual.

Qual tem precedência: settings.json, ANTHROPIC_MODEL ou --model?

A pesquisa fornecida relata uma documentação que coloca a opção de inicialização acima de ANTHROPIC_MODEL, e essa variável acima do valor de modelo no arquivo de configurações. No entanto, a ordem exata não foi verificada de forma independente em um retrato anterior a agosto de 29, 2026, portanto este artigo não a estabelece como um comportamento específico dessa data de corte.

Um hook de troca de modelo do Claude Code pode bloquear uma mudança?

A versão 2.1.251 descreve PreModelSwitch e PostModelSwitch como compatível com bloqueio, confirmação e anotação de trocas de modelo. Ela não fornece esquemas completos nem JSON de decisão, portanto o anúncio por si só é insuficiente para implementar um hook executável.

Onde posso ver falhas de cache e custos estimados de reconstrução?

Em 2.1.251, /cost informa a taxa de acertos do cache por sessão, as falhas, os tokens recolocados em cache e o estado aquecido ou frio; os scripts da linha de status ganham um objeto correspondente prompt_cache . Separadamente, SessionStart os hooks na retomada recebem informações sobre há quanto tempo a sessão está inativa e o custo estimado de reconstrução do cache de prompts, embora as notas de versão não especifiquem os nomes dessas chaves do payload.