Conteúdo
Aquele controle deslizante ao lado do nome do modelo no Claude Code — o controle de “Esforço” que vai de “Mais rápido” a “Mais inteligente” — decide quanto trabalho (raciocínio e tokens) a IA aplica em cada resposta. Deslize para a esquerda para algo rápido e barato; para a direita, para algo profundo e inteligente.
Vejamos primeiro o panorama geral. A própria configuração de esforço (os níveis de esforço da API) tem 5 passos: de low a max. O controle deslizante do /effort no Claude Code mostra esses passos mais o seu próprio modo Ultracode, totalizando 6 itens. Ou seja: “5 níveis + Ultracode = 6 itens.” Tenha isso em mente e o resto se encaixa.
Um único botão de “Mais rápido” a “Mais inteligente”
— ele ajusta, juntos, a profundidade do raciocínio e as chamadas de ferramentas
= os 5 níveis de esforço da API (low–max)
O controle deslizante exibe Baixo · Médio · Alto · Extra · Máximo, mais Ultracode à direita.
Portanto, “Extra” = xhigh, e o esforço máximo é o “Máximo.” O Ultracode não é um passo — é um modo adicional.
1. O que é o “esforço”
Esforço é a configuração que controla quantos tokens o Claude gasta em uma única resposta. Mais baixo significa mais curto, mais rápido e mais barato; mais alto significa mais profundo, mais minucioso e mais inteligente. Se você pesquisou “Claude Code effort” ou se perguntou o que faz o botão de “Mais rápido / Mais inteligente”, é exatamente isto.
O ponto-chave é que o esforço afeta toda a sua resposta, não apenas o raciocínio. Em concreto, ele influencia estes três aspectos (fonte: a documentação oficial “Effort” da Anthropic — Raciocínio estendido / Chamadas de ferramentas e argumentos de função / Respostas em texto e explicações).
Profundidade do raciocínio
Quanto ele raciocina antes de responder. Um esforço maior permite análise em várias etapas e revisão de hipóteses.
Chamadas de ferramentas
Quantas vezes ele lê, pesquisa ou edita. Um esforço menor agrupa e reduz o número de chamadas.
Quantidade de texto na resposta
Explicações, resumos, comentários. Um esforço menor significa menos preâmbulo e saída mais concisa.
💡 Em poucas palavras: o esforço é um sinal de comportamento, não um orçamento fixo de tokens. Mesmo no esforço low o Claude ainda raciocina em problemas genuinamente difíceis — apenas menos do que faria em um esforço mais alto para o mesmo problema.
2. Os 6 itens e rótulos do controle deslizante
Como configuração de API, o esforço tem 5 níveis: low → medium → high → xhigh → max. O padrão é high, que se comporta exatamente como deixar o esforço sem definição. O controle deslizante do /effort no Claude Code adiciona o seu próprio modo Ultracode, de modo que ele lista 6 itens.
Uma coisa confunde as pessoas: “Extra” não é o máximo. O controle deslizante exibe Baixo · Médio · Alto · Extra · Máximo, em que “Extra” = xhigh e “Máximo” = max. Portanto, “Extra” é o segundo a partir do topo, não o topo. E o Ultracode não é um passo de esforço — é um modo adicional com comportamento diferente (veja a seção 6).
Menos tokens, menor latência
Tarefas curtas e delimitadas, formatação, código repetitivo, subagentes. Velocidade e custo em primeiro lugar.
Meio-termo econômico
Qualidade sólida mantendo os tokens sob controle no trabalho do dia a dia.
O equilíbrio ideal entre qualidade e custo
O padrão para raciocínio complexo e programação difícil. “Na medida certa” para a maior parte do trabalho.
Trabalho agêntico de longa duração
Para programação com chamadas de ferramentas repetidas e busca profunda. Usa muito mais tokens do que o high.
Raciocínio máximo, sem limite
O raciocínio mais profundo, sem limite de tokens. Apenas para problemas realmente difíceis; pode pensar demais.
xhigh + multiagente
Não é um “passo” de esforço, mas um modo exclusivo do Claude Code. Veja a seção 6.
⚠️ O que persiste e o que não persiste: low, medium, high e xhigh são salvos e levados para a sua próxima sessão. “Máximo” e “Ultracode” valem apenas na sessão (o Máximo só persiste se for definido pela variável de ambiente CLAUDE_CODE_EFFORT_LEVEL; o Ultracode não pode ser salvo nem mesmo assim).
3. Suporte por modelo e rebaixamento automático
Os níveis que você pode escolher dependem do modelo. O xhigh (“Extra”) está limitado a modelos de ponta mais recentes. No Opus 4.8 ou no Fable 5 você tem acesso a todos os níveis.
| Modelo | Níveis de esforço da API (low–max) | Padrão |
|---|---|---|
| Fable 5 / Opus 4.8 | low · medium · high · xhigh · max | high |
| Opus 4.7 | low · medium · high · xhigh · max | xhigh |
| Opus 4.6 / Sonnet 4.6 | low · medium · high · max (sem xhigh) | high |
※ Esta tabela mostra os níveis de esforço da API. O controle deslizante do Claude Code acrescenta o Ultracode (o modo na extremidade direita), totalizando 6 itens. O Ultracode só está disponível em modelos com suporte a xhigh (Fable 5 / Opus 4.8 / Opus 4.7, etc.) — no Opus 4.6 e no Sonnet 4.6 ele não aparece no menu do /effort.
※ O “Padrão” aqui é o padrão do Claude Code (xhigh no Opus 4.7, high nos demais). O padrão da API é high para todos os modelos.
Se você escolher um nível que o modelo não suporta, não dá erro — ele é rebaixado automaticamente para o nível suportado mais próximo, igual ou inferior. Por exemplo, o xhigh (“Extra”) no Opus 4.6 roda como high (esses dois modelos saltam de high direto para max, sem xhigh no meio). Note também que o mesmo nome de nível significa quantidades diferentes em modelos diferentes — a escala de esforço é calibrada por modelo.
4. Como configurar (/effort e mais)
Comece por aqui: o comando /effort. Execute-o sem argumentos e um controle deslizante interativo se abre (o botão da captura de tela), navegado com as teclas de seta. Só isso já basta para a maioria das pessoas.
# Abrir o controle deslizante (teclas de seta, depois Enter)
/effort
# Definir um nível diretamente
/effort low
/effort xhigh
# Voltar ao padrão do modelo
/effort autoOutras opções, conforme a sua necessidade (as últimas são para usuários avançados):
- O controle deslizante dentro do
/model: no seletor de modelo, use as teclas de seta esquerda/direita para ajustar o botão de esforço. - Flag
--effort: inicie comclaude --effort medium(apenas para aquela sessão). - Variável de ambiente
CLAUDE_CODE_EFFORT_LEVEL: um nome de nível ouauto. Tem a maior prioridade. effortLevelnas configurações: salvalow/medium/high/xhigh(maxeultracodevalem apenas na sessão e não podem ser salvos aqui).- frontmatter de skill / subagente: substitui o esforço enquanto aquele skill ou subagente está em execução.
💡 Prioridade: variável de ambiente ＞ frontmatter (somente enquanto aquele skill/subagente roda; nunca supera a variável de ambiente) ＞ o seu valor configurado/de sessão ＞ o padrão do modelo. O nível atual aparece ao lado do logotipo e do indicador de carregamento, por exemplo “with low effort,” para que você confirme o que está ativo.
5. Referência rápida: qual nível e quando
A orientação oficial é simples. Comece em xhigh (“Extra”) para programação e trabalho agêntico, recue para high quando estiver em dúvida, caia para medium/low para economizar custo e reserve o max para problemas realmente difíceis. Recorra ao Ultracode apenas quando quiser concluir de uma vez uma tarefa grande e de várias etapas.
| Item (exibição) | Quando usar |
|---|---|
| low | Tarefas curtas, delimitadas e sensíveis à latência que não exigem muita inteligência |
| medium | Trabalho cotidiano sensível ao custo, em que dá para abrir mão de um pouco de inteligência |
| high | Raciocínio complexo e implementação difícil. O padrão equilibrado |
| xhigh (Extra) | Execuções longas de programação/agênticas com chamadas de ferramentas repetidas e busca profunda |
| max (Máximo) | Apenas os problemas mais difíceis. Os ganhos estagnam e há risco de pensar demais — teste antes |
| Ultracode | Tarefas grandes e de várias etapas (grandes refatorações, auditorias) que você quer dividir entre vários agentes. Vale apenas na sessão; não é para uso diário (→ §6) |
Quando você aumenta o esforço para trabalho pesado, defina um max_tokens generoso (em torno de 64k ou mais) para que o modelo tenha espaço para pensar e agir ao longo das chamadas de ferramentas.
6. O que é o Ultracode (em detalhe)
O Ultracode aparece na extremidade direita do controle deslizante do /effort e é um modo exclusivo do Claude Code. O ponto crucial: ele não é um nível de esforço da API (low–max). Por baixo dos panos, ele tem duas camadas.
Ele envia esforço xhigh
Cada mensagem chega ao modelo com raciocínio em nível xhigh (“Extra”) — a base para um trabalho agêntico profundo e de longa duração.
Ele inicia fluxos de trabalho dinâmicos automaticamente
Para cada tarefa substancial, o Claude planeja e inicia por conta própria um fluxo de trabalho multiagente, executando vários subagentes em paralelo.
“Fluxos de trabalho dinâmicos” (camada 2) significa que o Claude escreve um script na hora que executa muitos subagentes em segundo plano, em paralelo. Os resultados intermediários ficam no script; apenas o resultado final volta para o contexto do Claude. Uma única solicitação pode se desdobrar em vários fluxos de trabalho (por exemplo, “entender o código → alterá-lo → verificar”). A simultaneidade é limitada a 16 agentes ao mesmo tempo, com até 1.000 agentes por execução.
🔑 Ultracode vs. xhigh: xhigh = apenas profundidade de raciocínio. Ultracode = xhigh MAIS o início automático de fluxos de trabalho multiagente por tarefa. Ambos ficam à direita do controle deslizante, mas o xhigh é um passo de esforço e o Ultracode é um modo aplicado por cima.
Como ativá-lo
/effort ultracode: ativo durante toda a sessão (cada tarefa substancial é convertida automaticamente em um fluxo de trabalho).- Escolha “Ultracode” no menu do
/effortou no controle deslizante do/model. - Para um uso pontual, coloque a palavra-chave
ultracodeno seu prompt (por exemplo, “ultracode: audite todos os endpoints em src”). O esforço da sua sessão permanece inalterado. - Passe
"ultracode": truevia--settingsou por uma solicitação de controle do Agent SDK.
⚠️ Suporte por modelo e validade só na sessão: o Ultracode exige um modelo com suporte a xhigh (Fable 5 / Opus 4.8 / Opus 4.7, etc.); ele não aparece no menu do /effort no Opus 4.6 nem no Sonnet 4.6. Ele vale apenas na sessão e não pode ser salvo (nem mesmo pela variável de ambiente). Para voltar ao trabalho de rotina, execute /effort high.
Quando usá-lo
✅ Boa escolha
Grandes refatorações, migrações entre centenas de arquivos, auditorias de bugs ou de autorização em toda a base de código, verificações cruzadas sob múltiplas perspectivas — trabalho de várias etapas grande demais para conduzir em uma única conversa.
⛔ Má escolha
Tarefas pequenas e delimitadas, trabalho sensível à latência, edições de rotina. Cada solicitação custa bem mais tokens e tempo, então aqui é desperdício.
Nota sobre custo: como toda solicitação roda em xhigh e se desdobra em fluxos de trabalho, o Ultracode consome muito mais tokens e tempo do que o normal e pode esgotar rapidamente o uso do seu plano e os seus limites de taxa. Experimente-o primeiro em uma fatia pequena (um diretório) para avaliar a escala. O próprio recurso de fluxos de trabalho dinâmicos pode ser desativado via /config, pela configuração "disableWorkflows": true ou pela variável de ambiente CLAUDE_CODE_DISABLE_WORKFLOWS=1 — o que também remove o Ultracode do menu do /effort.
※ O comportamento segue a documentação oficial da Anthropic (Effort / Configuração de modelo / Workflows); os rótulos do controle deslizante foram confirmados na interface ao vivo do Claude Code para desktop (tudo conforme junho de 2026). O esforço e o Ultracode evoluem rapidamente — consulte a documentação oficial e o seu aplicativo para as informações mais recentes.
7. Recursos relacionados e confusões comuns
Alguns recursos são fáceis de confundir com o esforço. Veja como eles diferem.
ultrathink
Uma palavra-chave que faz o Claude pensar com mais afinco apenas naquele turno; o esforço da sua sessão permanece inalterado. Expressões como “think” ou “think hard” são tratadas como texto comum e não fazem nada.
/fast (modo rápido)
Um eixo separado. Ele executa o mesmo modelo de forma mais rápida (não troca por um menor), a um custo maior. Combine-o com o esforço low para um trabalho de rotina ágil.
Ultracode
Não é um passo de esforço, mas um modo que adiciona xhigh + automação multiagente. Detalhes na seção 6.
A confusão comum é “escolher ‘Extra’ é o mais inteligente.” Na verdade, “Extra” = xhigh, e o esforço máximo é o “Máximo” à sua direita. Nem mesmo o Máximo é sempre o melhor — em saídas estruturadas ou tarefas leves ele pode pensar demais e prejudicar a qualidade. A orientação oficial é começar a programação em xhigh (“Extra”), e o padrão high é mais do que suficiente na maioria das situações. Se a sua configuração travar, veja os erros comuns do Claude Code e suas correções.
Resumo
Três pontos para levar sobre a configuração de esforço do Claude Code.
- O que é: a configuração de tokens por resposta — o seu botão de “Mais rápido ↔ Mais inteligente”. Ele afeta igualmente o raciocínio, as chamadas de ferramentas e o texto da resposta.
- Passos e rótulos: a API tem 5 níveis de esforço (low–max). O controle deslizante adiciona o Ultracode, totalizando 6 itens, exibidos como Baixo · Médio · Alto · Extra · Máximo · Ultracode. “Extra” = xhigh; o topo é o “Máximo.” O padrão é high (xhigh no Opus 4.7); o xhigh só existe nos modelos de ponta; níveis não suportados são rebaixados automaticamente.
- Qual e quando: a programação começa em xhigh (“Extra”), high quando estiver em dúvida, medium/low para custo, max só para problemas difíceis. Grandes tarefas de várias etapas → Ultracode (xhigh + multiagente, apenas na sessão).
Um único botão lhe dá o equilíbrio entre velocidade e inteligência. Leia este artigo junto com o comando loop e a nossa comparação de ferramentas de programação com IA para tirar o máximo do Claude Code.
O outro seletor que fica logo ao lado do botão de esforço são os modos de permissão do Claude Code. Enquanto o esforço decide o quanto o Claude raciocina, o modo de permissão decide até onde ele pode executar por conta própria — combinar os dois elimina as dúvidas no uso diário.
FAQ
Q. Escolher “Extra” no controle deslizante é a configuração mais inteligente?
A. Não. “Extra” é xhigh (o segundo a partir do topo), não o máximo. O esforço máximo é o “Máximo”, logo à sua direita. Mas o Máximo nem sempre é o melhor — em saídas estruturadas ou tarefas leves ele pode pensar demais. Para programação, a orientação oficial recomenda começar em xhigh (“Extra”).
Q. Qual nível de esforço devo usar?
A. Na dúvida, o padrão high está bom. Para programação séria ou trabalho agêntico, o xhigh (“Extra”) é o ponto de partida recomendado. Para formatação ou trabalho leve em que a velocidade importa, caia para low/medium.
Q. Em que o Ultracode difere do Máximo?
A. O Máximo é um nível de esforço (o raciocínio mais profundo). O Ultracode não é um passo de esforço — ele adiciona, por cima do raciocínio em nível xhigh, o início automático de fluxos de trabalho multiagente. É para tarefas grandes e de várias etapas, e está limitado a modelos com suporte a xhigh e à sessão atual.
Q. Por que não consigo escolher xhigh (“Extra”) ou Ultracode?
A. Ambos exigem um modelo com suporte a xhigh (Fable 5, Opus 4.8, Opus 4.7, etc.). O Opus 4.6 e o Sonnet 4.6 não têm xhigh, e o Ultracode não aparece no menu do /effort neles (as solicitações de xhigh são rebaixadas automaticamente para high). Troque de modelo para tê-los.
Q. Como faço para a minha configuração persistir entre sessões?
A. low/medium/high/xhigh são salvos na configuração effortLevel e levados adiante. O Máximo normalmente vale apenas na sessão, mas persiste se for definido pela variável de ambiente CLAUDE_CODE_EFFORT_LEVEL. O Ultracode não pode ser salvo nem mesmo assim — ele vale sempre apenas na sessão.
