Como defino qual modelo o Claude Code usa?

Você define um modelo padrão na configuração, que vale quando você não pede outro, e pode trocar de modelo na hora com um comando. Um bom padrão é o modelo equilibrado, que serve à maioria das tarefas. A troca sob demanda ajusta para casos específicos, sem mudar o seu padrão.

A troca de modelo na hora muda o meu padrão?

Não. A troca vale só para aquela sessão ou tarefa; o seu padrão continua o mesmo. Assim você não precisa lembrar de voltar depois: o padrão fica lá, e a troca foi uma exceção momentânea para uma necessidade específica, como mais capacidade num problema difícil.

O que é ajustar o esforço?

É controlar quanto o modelo pensa antes de responder. Mais esforço rende respostas mais cuidadosas em problemas difíceis, ao custo de tempo; menos esforço é mais rápido, bom para tarefas simples. É uma dimensão diferente da capacidade: qual modelo é uma coisa, quão fundo ele raciocina é outra.

Preciso ajustar o esforço manualmente?

Não sempre. O Claude Code costuma ajustar o esforço por conta própria, dedicando mais raciocínio a tarefas difíceis e menos a simples. O controle manual é para quando o seu conhecimento da tarefa supera o julgamento automático, como forçar mais raciocínio numa tarefa que você sabe ser traiçoeira.

Módulo 14 - Configuração avançada

Escolhendo o modelo e o esforço

7 min de leitura · por Cesar Gargiulo, revisado pela equipe ValorFinal e GuardiaSec · Atualizado em 13/07/2026

O que você vai aprender

Escolher o modelo que o Claude Code usa.
Definir um modelo padrão ou trocar na hora.
Entender a ideia de ajustar o esforço.
Equilibrar qualidade, velocidade e custo por tarefa.

Definir um padrão e trocar na hora

No módulo dos modelos, você conheceu a família Claude, o mais capaz, o equilibrado e o mais rápido, e a ideia de escolher conforme a tarefa. Agora vamos ao lado prático dessa escolha. Você pode definir um modelo padrão na configuração, aquele que o Claude Code usa quando você não pede outro. Um bom padrão, geralmente o modelo equilibrado, evita ter que decidir toda vez e serve bem à maioria das tarefas. E, sempre que uma tarefa específica pedir, você troca de modelo na hora, com um comando, subindo para o mais capaz num problema difícil ou descendo para o mais rápido numa tarefa simples. Padrão para o dia a dia, troca sob demanda para os casos especiais.

Essa combinação de padrão e troca dá o melhor dos dois mundos: a conveniência de não escolher sempre e a flexibilidade de ajustar quando importa. Na prática, muita gente deixa o modelo equilibrado como padrão e só troca em momentos pontuais, quando trava num problema e quer mais capacidade, ou quando vai fazer muitas tarefas simples e quer velocidade e economia. A troca na hora vale só para aquela sessão ou tarefa, sem mudar o seu padrão. Assim, você não precisa lembrar de voltar ao padrão depois; ele continua lá, e a troca foi uma exceção momentânea para aquela necessidade específica.

Diagrama mostrando um modelo padrão definido na configuração para o dia a dia, e setas de troca temporária para o modelo mais capaz numa tarefa difícil e para o mais rápido numa tarefa simples, ilustrando padrão mais troca sob demanda. — Um modelo padrão para o dia a dia, com troca na hora quando a tarefa pede mais capacidade ou mais velocidade.

A ideia de ajustar o esforço

Além de escolher o modelo, há um ajuste mais fino: o esforço, ou seja, quanto o modelo pensa antes de responder. É uma dimensão diferente da capacidade. A capacidade é qual modelo; o esforço é quão fundo ele raciocina. Mais esforço rende respostas mais cuidadosas em problemas difíceis, porque o modelo considera mais possibilidades antes de agir, ao custo de um pouco mais de tempo. Menos esforço é mais rápido e direto, ideal para tarefas simples que não pedem tanto raciocínio. Ajustar o esforço é afinar o equilíbrio entre qualidade e velocidade sem necessariamente trocar de modelo, uma alavanca a mais no seu controle.

Mais esforço

O modelo pensa mais fundo antes de responder.
Respostas mais cuidadosas em problemas difíceis.
Um pouco mais lento.

Menos esforço

O modelo responde de forma mais direta.
Bom para tarefas simples e diretas.
Mais rápido.

🎮 Jogo da aula

Mais ou menos esforço?

Classifique cada tarefa conforme ela pede mais esforço (pensar fundo) ou menos esforço (ser rápido).

Na prática, o Claude Code costuma ajustar o esforço de forma inteligente por conta própria, dedicando mais raciocínio a tarefas difíceis e menos a simples, como você viu no módulo do fluxo agêntico. O controle manual do esforço é para quando você quer influenciar esse comportamento, por exemplo, forçando mais raciocínio numa tarefa que você sabe ser traiçoeira, ou economizando tempo numa sequência de tarefas simples. Não é algo que você precise mexer sempre; é uma alavanca extra para casos em que o seu conhecimento da tarefa supera o julgamento automático. Conhecer que ela existe já te dá mais controle quando precisar.

O equilíbrio por tarefa

Modelo e esforço, juntos, são as suas alavancas para equilibrar três coisas que puxam umas contra as outras: qualidade, velocidade e custo. Um modelo mais capaz com mais esforço maximiza qualidade, ao custo de tempo e dinheiro. Um modelo mais rápido com menos esforço maximiza velocidade e economia, sacrificando um pouco de capacidade. A arte está em casar esse equilíbrio com a tarefa: pagar por qualidade onde ela importa, economizar onde não importa. Não existe um ajuste certo universal; existe o ajuste certo para cada tipo de trabalho, e ter essas alavancas na mão é o que permite otimizar o seu uso do Claude Code conforme o que você faz.

Com o modelo e o esforço sob controle, você afina o cérebro do Claude Code para cada tarefa. A próxima aula muda o foco do cérebro para a voz: os estilos de resposta, que mudam o tom e o formato com que o agente se comunica com você. Você vai ver que dá para fazer o Claude Code explicar mais, para aprender enquanto trabalha, ou ir direto ao ponto, para produzir mais rápido, ajustando não o que ele pensa, mas como ele fala. É mais uma dimensão de personalização, e uma que muda bastante a experiência do dia a dia.

Teste rápido

Qual é uma boa estratégia para escolher o modelo no Claude Code?

Perguntas frequentes

Como defino qual modelo o Claude Code usa?: Você define um modelo padrão na configuração, que vale quando você não pede outro, e pode trocar de modelo na hora com um comando. Um bom padrão é o modelo equilibrado, que serve à maioria das tarefas. A troca sob demanda ajusta para casos específicos, sem mudar o seu padrão.
A troca de modelo na hora muda o meu padrão?: Não. A troca vale só para aquela sessão ou tarefa; o seu padrão continua o mesmo. Assim você não precisa lembrar de voltar depois: o padrão fica lá, e a troca foi uma exceção momentânea para uma necessidade específica, como mais capacidade num problema difícil.
O que é ajustar o esforço?: É controlar quanto o modelo pensa antes de responder. Mais esforço rende respostas mais cuidadosas em problemas difíceis, ao custo de tempo; menos esforço é mais rápido, bom para tarefas simples. É uma dimensão diferente da capacidade: qual modelo é uma coisa, quão fundo ele raciocina é outra.
Preciso ajustar o esforço manualmente?: Não sempre. O Claude Code costuma ajustar o esforço por conta própria, dedicando mais raciocínio a tarefas difíceis e menos a simples. O controle manual é para quando o seu conhecimento da tarefa supera o julgamento automático, como forçar mais raciocínio numa tarefa que você sabe ser traiçoeira.
Como equilibro qualidade, velocidade e custo?: Casando modelo e esforço com a tarefa. Modelo capaz com mais esforço maximiza qualidade, ao custo de tempo e dinheiro; modelo rápido com menos esforço maximiza velocidade e economia. Pague por qualidade onde ela importa e economize onde não importa. O ajuste certo é o certo para cada tipo de trabalho.

Fontes

Seu progresso fica salvo neste aparelho. Assinantes sincronizam entre os aparelhos.

← O arquivo de configuração Concluir e avançar →