Configuração de esforço do Claude Code: o guia do controle deslizante

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, e o controle deslizante do /effort no Claude Code escolhe entre eles. O Ultracode não é um sexto passo: é um interruptor à parte, de ligar e desligar, que funciona em qualquer nível (v2.1.284 e posteriores). Ou seja: pense em “um seletor de 5 passos + o interruptor do Ultracode.” Tenha isso em mente e o resto se encaixa.

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).

2. Os 5 níveis 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 depende do modelo: high na maioria e medium no Opus 5.5 e em alguns outros (veja a seção 3). O controle deslizante do /effort no Claude Code é o seletor que escolhe entre esses 5.

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 interruptor à parte com comportamento diferente (veja a seção 6). Antes da v2.1.284, o Ultracode ficava na extremidade direita do controle deslizante como sexta posição; agora é um interruptor independente que se alterna com a tecla Tab dentro do /effort (na extensão do VS Code, um interruptor abaixo do controle deslizante).

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 relativamente recentes. Os atuais Fable 5.1, Opus 5.5, Sonnet 5.5 e Haiku 5.5 dão acesso a todos os níveis, enquanto o modelo legacy Haiku 4.5 não tem suporte a esforço (no Haiku, o esforço chegou com o Haiku 5.5, lançado em 7 de outubro de 2026). Como escolher o nível de esforço no Haiku 5.5 está no capítulo 6 do guia do Claude Haiku 5.5.

Atenção aos padrões. O Opus 5.5, modelo padrão do Claude Code, começa em medium — um nível abaixo do high que era o padrão do Opus 5.

* Em 12 de outubro de 2026. “Legacy” são os modelos que a Anthropic classifica como legacy (ainda disponíveis). Fontes: configuração de modelos do Claude Code (níveis e padrões do Claude Code), documentação de Effort da API e lista de modelos (padrões da API).
* O Sonnet 5.5 e o Opus 4.7 têm padrões diferentes no Claude Code e na API. No Claude Code, sem definir o esforço, vale a coluna “Padrão no Claude Code”.
* O Claude Code precisa da v2.1.293 ou posterior para usar o Haiku 5.5. O alias haiku aponta para o Haiku 5.5 na API da Anthropic; no Amazon Bedrock, no Google Cloud, no Microsoft Foundry e em outros provedores, ainda aponta para o Haiku 4.5.
* O Ultracode (um interruptor à parte do esforço) só está disponível em modelos com suporte a xhigh (Fable 5.1 / Opus 5.5 / Sonnet 5.5, etc.) — no Opus 4.6 e no Sonnet 4.6 o interruptor não aparece no /effort.

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

# Apagar o nível salvo e voltar ao padrão do modelo
/effort auto

# Ligar / desligar o Ultracode (o esforço não muda)
/effort ultracode
/effort ultracode off

Outras 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 com claude --effort medium (apenas para aquela sessão).
• Variável de ambiente CLAUDE_CODE_EFFORT_LEVEL: um nome de nível ou auto. Tem a maior prioridade.
• modelSettings / effortLevel nas configurações: o nível low/medium/high/xhigh que você confirma no /effort ou no /model é salvo por modelo em modelSettings nas suas configurações de usuário (v2.1.251 e posteriores; antes, gravava-se um único effortLevel). Para editar à mão, defina um nível por modelo em modelSettings, ou use effortLevel como padrão para os modelos sem nível salvo (mas o effortLevel das suas configurações de usuário, ~/.claude/settings.json, não se aplica ao Opus 5.5 nem aos modelos posteriores). max não é aceito em nenhuma das duas chaves, e o Ultracode tem a sua própria chave "ultracode": true.
• frontmatter de skill / subagente: substitui o esforço enquanto aquele skill ou subagente está em execução.

Para mudar de uma vez o esforço e o modelo de várias sessões abertas no Claude Code Desktop, basta pedir ao assistente; o passo a passo e os cuidados estão em Modelo e esforço de todas as sessões: Claude Code e Codex.

5. Referência rápida: qual nível e quando

A orientação oficial é simples. O padrão do modelo atende à maior parte do trabalho de programação (medium no Opus 5.5 e no Sonnet 5.5, high no Fable 5.1). Suba para high quando a verificação importar, para xhigh (“Extra”) em trabalhos longos e mais profundos, desça para low em trocas rápidas 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.

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 e como difere do esforço Máximo (em detalhe)

O Ultracode é uma configuração do Claude Code: um interruptor de ligar e desligar que se alterna com a tecla Tab dentro do /effort. O ponto crucial: ele não é um nível de esforço da API (low–max). Há dois pontos a saber.

“Fluxos de trabalho dinâmicos” (ponto 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”). Por padrão, até 16 agentes rodam ao mesmo tempo (menos em máquinas com menos CPUs; a variável de ambiente CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS altera isso), com até 1.000 agentes por execução.

Como ativá-lo

• /effort ultracode: ligado pelo resto da sessão (cada tarefa substancial é convertida automaticamente em um fluxo de trabalho). /effort ultracode off o desliga. Nenhum dos dois altera o seu nível de esforço.
• No controle deslizante do /effort, pressione Tab para alternar o interruptor do Ultracode e depois Enter para aplicar (na extensão do VS Code, use o interruptor abaixo do controle deslizante).
• Inicie com claude --effort ultracode: começa com o Ultracode ligado e o esforço em xhigh (“Extra”).
• Para começar toda sessão com ele ligado, escreva "ultracode": true em um arquivo de configurações (também é possível passá-lo via --settings ou por uma solicitação de controle do Agent SDK).
• Para um uso pontual, coloque a palavra-chave ultracode no seu prompt (por exemplo, “ultracode: audite todos os endpoints em src”). O esforço da sua sessão permanece inalterado.

Quando usá-lo

Nota sobre custo: como toda solicitação substancial 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 interruptor do Ultracode do /effort.

* O comportamento segue a documentação oficial da Anthropic (Effort / Configuração de modelo / Workflows / referência de configurações); o Ultracode como interruptor e o salvamento por modelo conforme 29 de setembro de 2026 (v2.1.284). Os rótulos do controle deslizante foram confirmados na interface ao vivo do Claude Code para desktop (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.

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 de começar a programação em xhigh (“Extra”) foi escrita para o Opus 4.7 e o 4.8; no atual Opus 5.5, o ponto de partida é o seu padrão, medium. Na dúvida, o padrão do modelo costuma bastar. 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 exibe Baixo · Médio · Alto · Extra · Máximo, e o Ultracode é um interruptor à parte, não um passo. “Extra” = xhigh; o topo é o “Máximo.” O padrão varia por modelo (medium no Opus 5.5, no Sonnet 5.5 e no Haiku 5.5, high no Fable 5.1); o xhigh exige um modelo relativamente recente; o legacy Haiku 4.5 não tem suporte a esforço (o Haiku 5.5 tem todos os níveis); níveis não suportados são rebaixados automaticamente.
• Qual e quando: parta do padrão do modelo, high quando a verificação importar, xhigh (“Extra”) para trabalhos longos e profundos, low para tarefas rápidas, max só para problemas difíceis. Grandes tarefas de várias etapas → Ultracode (automação multiagente que você pode ligar em qualquer nível de esforço; /effort ultracode off a desliga).

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

Relacionado: Guia de lançamento do Claude Opus 5, O pensamento adaptativo do Claude.