Não uses o ultracode para tudo

O que é e porque importa

No Claude Code podes decidir quanto o Claude raciocina antes de te responder e de mexer no código. Chama-se nível de effort, ou seja, de esforço, e tem cinco degraus: low, medium, high, xhigh e max. Em português chamo-lhes baixo, médio, alto, muito alto e máximo.

Quanto mais raciocina, mais lento é e mais tokens gasta. Num trabalho difícil esse raciocínio extra salva-te. Numa alteração banal é só espera e consumo. O truque é não pagar por raciocínio de que não precisas.

Nos modelos de hoje o ponto de partida é médio. Eu mantenho-o em alto para quase tudo, e o máximo só o ligo quando é mesmo preciso. A própria documentação do Claude Code avisa que o máximo pode render menos do que gasta e tende a pensar demais: experimenta-o antes de o usares sempre.

Depois há o ultracode, que não é um sexto degrau. É uma definição que põe muitos agentes a trabalhar em paralelo. Útil em poucos casos, um desperdício em todos os outros. Falo disso mais abaixo.

1. Como se muda o nível

1. Escreve /effort no Claude Code: abre-se um cursor com os níveis. Mexes-lhe com as setas e confirmas com Enter.
2. Se já sabes qual queres, dá-lo diretamente, por exemplo /effort high.
3. Também o podes fazer dentro do /model: enquanto escolhes o modelo, com as setas esquerda e direita ajustas o nível.
4. Para uma só sessão podes arrancar a partir do terminal com claude --effort high.

/effort high

Uma coisa que convém saber. Quando escolhes baixo, médio, alto ou muito alto com Enter, ou o escreves depois de /effort, o Claude Code lembra-se dele também nas sessões seguintes. O máximo não: só vale para a sessão em curso. Por isso, se subires para muito alto, cabe-te a ti lembrar-te de descer depois.

2. A tabela: que nível para que trabalho

Baixo (low): tarefas mecânicas

Trabalhos em que não há nada a decidir: o Claude só tem de executar. Por exemplo:

Muda o nome desta variável em todo o lado

corrige as gralhas nos textos

Médio (medium): o ponto de partida nos modelos de hoje

Trabalhos pequenos e claros, em um ou dois ficheiros, em que já sabes o que queres. Por exemplo:

adiciona um campo de email ao formulário

escreve o teste para esta função

Alto (high): o que eu uso para quase tudo

Um botão, uma página, um bug normal. É o trabalho de todos os dias, em que o Claude tem de perceber como a app está feita antes de lhe mexer. Por exemplo:

cria a página de preços com três planos

o login não funciona no telemóvel: descobre porquê e resolve

Muito alto (xhigh): quando alto não chega

O degrau antes do máximo. Uma funcionalidade que mexe em várias partes da app, um bug que volta mesmo depois de o teres resolvido. Em alguns modelos menos recentes este nível não existe: o Claude Code usa o mais alto disponível abaixo, ou seja, alto.

Máximo (max): só os casos mesmo difíceis

Um refactoring que mexe em tudo, um bug que ninguém encontra há dias. Por exemplo:

passa a gestão dos utilizadores para um só módulo, sem partir nada

Lembra-te de que o máximo só vale para a sessão em que o ligas.

3. E o ultracode?

O ultracode não é um nível a mais. É uma definição do Claude Code: quando está ligado, o Claude organiza cada trabalho com algum peso como um fluxo de trabalho, ou seja, um plano executado por muitos subagentes a trabalhar em paralelo. Um só pedido pode transformar-se em vários fluxos seguidos: um para perceber o código, outro para fazer a alteração e outro para a verificar.

Funciona por cima do nível que já tens: podes ter o ultracode ligado com alto ou com máximo. Se o ligares ao arrancar, o nível passa também para muito alto.

Gasta muitos mais tokens e demora mais. Faz sentido quando o trabalho se divide mesmo em muitas peças independentes: uma revisão completa de um projeto grande, uma migração em dezenas de ficheiros. Para uma alteração normal é só desperdício.

• /effort ultracode liga-o para a sessão em curso.
• /effort ultracode off desliga-o quando voltas ao trabalho normal.
• claude --effort ultracode arranca uma sessão com o ultracode já ligado.

Se precisas dele para uma só tarefa, não é preciso ligá-lo para a sessão inteira. Escreve a palavra ultracode dentro do prompt e o Claude prepara um fluxo de trabalho só para esse pedido. Por exemplo:

ultracode: verifica todas as páginas da app, encontra os textos que ainda não estão traduzidos e faz-me uma única lista, página a página.

4. A regra em 3 passos

1. Para o trabalho de todos os dias põe «alto», com /effort high.
2. Se depois de duas tentativas não sai nada, sobe (xhigh, depois máximo) e explica-lhe o que já experimentaste.
3. Acabado o trabalho difícil, volta a descer.

Para o segundo passo uso uma mensagem assim. Subir de nível sem lhe dar o contexto serve de pouco: o raciocínio extra precisa de alguma coisa com que trabalhar.

Já tentámos duas vezes e não funciona. Isto é o que fizemos: [o que experimentaste]. Isto é o que acontece agora: [o problema]. Antes de mexeres no código, pensa no porquê de as tentativas anteriores não terem funcionado e diz-me o que queres mudar.

Para o terceiro passo basta /effort high. Se estavas no máximo, na sessão seguinte voltas de qualquer forma ao nível guardado. Se estavas em muito alto, pelo contrário, fica guardado até o mudares tu.

O nível mais alto não é aquele de que precisas. Quase nunca.

Os erros mais comuns

• Deixar tudo no máximo «por precaução». É mais lento, gasta mais e pode pensar demais: guarda-o para os casos mesmo difíceis.
• Ligar o ultracode para uma alteração normal. Muitos agentes não fazem melhor um trabalho pequeno: usa-o só quando o trabalho se divide em peças independentes.
• Esquecer o ultracode ligado. Vale para cada pedido da sessão: quando acabares o trabalho grande, escreve /effort ultracode off.
• Subir o nível em vez de explicares melhor. Se o pedido é vago, mais raciocínio não o torna claro: primeiro acrescenta o contexto e o que já experimentaste.
• Ficar em muito alto depois do trabalho difícil. O nível fica guardado também nas sessões seguintes: acabado o trabalho, volta para alto com /effort high.
• Usar baixo num trabalho que mexe em várias partes da app. Poupas no início e depois refazes tudo: se é preciso perceber como as peças se ligam, no mínimo alto.

Checklist

• Trabalho do dia a dia em alto (/effort high)
• Baixo ou médio para as alterações mecânicas e pequenas
• Muito alto, depois máximo, só depois de duas tentativas falhadas
• Quando subo, explico o que já experimentei
• Ultracode só para trabalhos que se dividem em muitas peças
• Acabado o trabalho difícil, desço e desligo o ultracode

Perguntas frequentes