Claude Code Ultracode e níveis de effort: o guia do /effort
O effort decide o quanto Claude pensa — e a velocidade com que queima seus limites. Este guia explica os cinco níveis de effort, os padrões por modelo, o /effort auto e o ultracode: o interruptor de orquestração que a v2.1.284 transformou em um toggle independente que você pode empilhar em qualquer nível.
TL;DR — effort e ultracode em quatro linhas
- Cinco níveis de effort: low, medium, high, xhigh, max — calibrados por modelo. O padrão é high na maioria dos modelos, mas Opus 5.5 e Sonnet 5.5 começam em medium, e Opus 4.7 em xhigh.
- Troque com /effort (slider) ou /effort <level>; o /effort auto apaga o nível salvo e devolve o modelo ao padrão. Enter salva como padrão; s vale só nesta sessão.
- Ultracode é uma configuração do Claude Code, não um nível de effort: faz o Claude orquestrar dynamic workflows para tarefas de fôlego. Desde a v2.1.284 ele é um toggle próprio — Tab dentro do /effort, ou /effort ultracode on|off — e não força mais o xhigh.
- Ultracode vs max em uma linha: max é o nível mais profundo de raciocínio cru (propenso a pensar demais); o ultracode adiciona orquestração de fluxos de trabalho por cima do nível que você escolheu. Eles respondem perguntas diferentes — profundidade vs. coordenação.
Model configuration & effort — Claude Code documentation
Docs:code.claude.com
Claude Code CHANGELOG — v2.1.284 (Ultracode becomes its own toggle)
Changelog:github.com/anthropics/claude-code
How to Use Claude Effort Levels (Full Guide)
Canal:Ryan & Matt Data Science13:24
Os fatos desta página vêm da documentação oficial de effort e do changelog da v2.1.284; o diagrama é uma ilustração original deste guia. O vídeo listado testa os mesmos cinco níveis de effort no app de co-work da Claude — dados reais de queima de tokens bem úteis, embora a tela dele mostre uma superfície diferente do Claude Code. Nenhum frame dele é usado aqui.
Níveis de effort e ultracode, passo a passo
1 · Conheça a régua
- 1
Entenda o que o effort realmente controla
O effort é o botão de raciocínio do Claude Code: define quanto esforço mental o modelo coloca nos seus pedidos, o que mexe direto na qualidade da resposta, na latência e na velocidade com que você queima seu limite de uso. A documentação oficial é direta: a escala é calibrada por modelo — o mesmo nome de nível não é o mesmo valor por baixo em todos os modelos.
A escala do /effort num relance: cinco níveis mais o toggle de ultracode (diagrama desenhado para este guia). - 2
Aprenda os cinco níveis e quando cada um vale os tokens
low vai para trocas rápidas que você mesmo revisa — brainstorms, rascunhos, renomeações. medium cuida do trabalho do dia a dia com escopo claro. high serve para trabalho onde verificação importa ou edge cases espreitam. xhigh compra raciocínio mais profundo pagando mais tokens, para tarefas de agente longas. max é para problemas difíceis que você quer que Claude enfrente sozinho — a doc avisa que pode dar retornos decrescentes e overthinking.
- 3
Confira o padrão do seu modelo antes de culpar o modelo
Os padrões não são uniformes: high em todo modelo que suporta effort, exceto Opus 5.5 e Sonnet 5.5, que começam em medium, e Opus 4.7, que começa em xhigh. Se as respostas andam lentas ou o limite evapora rápido, olhe a linha de effort antes de condenar o modelo — e anote: desde a v2.1.284 o Sonnet 5.5 é o modelo Sonnet padrão, com 1M de contexto a $2/$10 por milhão de tokens.
2 · Troque com convicção
- 4
Troque ao vivo com /effort
Digite /effort numa sessão e um slider abre — as setas andam entre os níveis, e o Tab chega ao toggle de ultracode. Dentro do seletor de /model, esquerda/direita ajusta o mesmo controle. Para execuções pontuais, a flag --effort define o nível daquela sessão, e a variável de ambiente CLAUDE_CODE_EFFORT_LEVEL serve para automação.
- 5
Defina o nível direto — e entenda o que o auto significa
/effort <level> define o nível sem abrir o slider. O comando discretamente útil é o /effort auto: ele apaga o nível salvo do modelo ativo, então o Claude Code volta ao padrão desse modelo. A variável de ambiente também aceita auto. Se a sessão ficou estranha depois dos seus experimentos, o auto é o botão de reset.
- 6
Torne sua escolha permanente (do jeito certo)
No slider do /effort, Enter salva o nível como seu padrão enquanto o s aplica só nesta sessão. Nas settings, você pode definir effort por modelo em modelSettings ou usar um fallback global effortLevel — com uma pegadinha: o max não é aceito em nenhuma das duas chaves, e se não vier da variável de ambiente, o max vale só para a sessão atual. Skills e subagents podem carregar seu próprio effort no frontmatter, com teto no maxEffortLevel.
3 · Ultracode, o novo toggle
- 7
Entenda o que é o ultracode
Ultracode é uma configuração do Claude Code, não um nível de effort do modelo: segundo a documentação oficial, faz o Claude orquestrar dynamic workflows para tarefas substanciais — quebrar o trabalho grande em passos coordenados em vez de uma maratona solitária de raciocínio. É por isso que ele nasceu grudado no xhigh: orquestração por cima do raciocínio profundo.
- 8
Se atualize com a mudança da v2.1.284
Antes da v2.1.284, o ultracode era o topo do slider do /effort, e ativá-lo forçava xhigh. O changelog de setembro de 2026 mudou isso: o ultracode agora é um toggle próprio — Tab no /effort, ou /effort ultracode on|off — e não força mais xhigh; ele fica ligado em qualquer nível de effort. A extensão do VS Code substituiu o ponto de ultracode do slider por um interruptor liga/desliga (a pílula do modelo mostra “· Ultracode”), e novas ações de keybinding do effortSlider cobrem decreaseEffort, increaseEffort e toggleUltracode.
- 9
Decida entre ultracode e max
São eixos diferentes. O max responde “pense o máximo possível neste problema” — o raciocínio cru mais profundo, sem restrição de tokens, com risco documentado de overthinking. O ultracode responde “coordene o trabalho” — orquestração de fluxos por cima do nível que você escolheu, agora até com max, se quiser os dois. Regra de bolso: debug de um problema cabeludo → max; builds de vários passos onde sequência e delegação importam → ultracode; os dois → max effort com ultracode ligado.
- 10
Conheça as restrições antes de depender dele
A doc lista o ultracode como indisponível quando os workflows estão desligados, quando o modelo não suporta xhigh, ou quando vale um teto de effort abaixo de xhigh. Um maxEffortLevel gerenciado e tetos por papel da organização podem encolher a lista de níveis por modelo, e níveis não suportados caem para o nível suportado mais alto igual ou abaixo — xhigh roda como high no Opus 4.6. Se o CLAUDE_CODE_EFFORT_LEVEL estiver fixado num nível diferente de xhigh, as requisições rodam naquele nível com a orquestração inativa. Para um boost de uma rodada sem tocar em nada, a palavra-chave ultrathink adiciona raciocínio mais profundo só naquela rodada.
Padrões por modelo e a lista de níveis
Quatro fatos poupam a maior parte dos tickets de suporte:
- 1A maioria dos modelos começa em high; medium é a exceção, não a regra — só é o padrão no Opus 5.5 e no Sonnet 5.5.
- 2O Opus 4.7 começa em xhigh. Opus 4.6 e Sonnet 4.6 nem oferecem xhigh — níveis acima do teto deles caem para o nível suportado mais alto.
- 3Modelos fora da tabela de effort da doc não suportam effort; o Sonnet 5.5 entrou na tabela na v2.1.284 como o novo Sonnet padrão (1M de contexto, $2/$10 por Mtok, $0.20/Mtok em leituras de cache).
- 4A escala é calibrada por modelo: “o mesmo nome de nível não representa o mesmo valor por baixo entre modelos”. A orientação de migração da doc é direta — Opus 5.5 em medium empata ou supera o Opus 5 em high.
Ordem de resolução quando nada está salvo: a escolha explícita vence (variável de ambiente, flag --effort ou /effort na sessão), depois as settings salvas (modelSettings por modelo, ou um fallback global effortLevel), e por fim o padrão do modelo.