O que é ultracode no Claude Code: o que faz e quanto custa
Ultracode é uma configuração do Claude Code, não um nível de esforço: ativado, o Claude escreve um dynamic workflow, um script que lança vários subagentes, para cada tarefa de peso. Como ativar e desativar, por que não é o esforço max, e a mesma revisão de código executada duas vezes no Opus 5.5, uma em xhigh e outra com ultracode: cerca de quatro vezes os tokens, mais que o dobro do tempo e uma verificação que nunca voltou com claude -p.
“What is ultracode in Claude Code” está subindo no Google Trends há catorze noites seguidas, e o Google agora sugere “what does ultracode do in claude code”, “what does opus ultracode do” e “what does ultracode mode do”. As páginas que respondem se contradizem: uma diz que é o modo de esforço mais alto, outra diz que é xhigh. Nenhuma das duas está certa hoje.
Resposta curta: ultracode é uma configuração do Claude Code que faz o Claude organizar cada tarefa de peso como um dynamic workflow, vários subagentes conduzidos por um script, em vez de resolvê-la turno a turno numa única conversa. Não é um nível de esforço, e custa mais tokens. Quantos a mais, nós medimos numa tarefa real.
Tudo o que vem a seguir foi verificado em 19 de novembro de 2026 na documentação da Anthropic (code.claude.com, páginas Model configuration e Dynamic workflows), no changelog do Claude Code e no Claude Code 2.1.318 instalado na nossa máquina.
Ultracode em um parágrafo
Um dynamic workflow é um script em JavaScript que o Claude escreve para a sua tarefa. Um runtime o executa em segundo plano: o script lança subagentes, muitas vezes vários de uma vez, entrega a cada um a sua parte do trabalho e guarda os resultados em variáveis do script em vez de empilhá-los na sua conversa. Com o ultracode ativado, o Claude decide sozinho quando uma tarefa tem peso suficiente para merecer um workflow e, nas palavras da Anthropic, “um único pedido pode virar vários workflows em sequência: um para entender o código, um para fazer a mudança e um para verificá-la”. A página de configuração de modelos da Anthropic resume em uma linha: ultracode é “uma configuração do Claude Code, e não um nível de esforço do modelo”.
Como ativar e desativar
Há duas formas de usar, e elas não duram o mesmo tempo.
Para uma tarefa: a palavra-chave. Coloque ultracode em um prompt que você digita, por exemplo ultracode: audit every API endpoint under src/routes/ for missing auth checks. O Claude Code destaca a palavra e o Claude escreve um workflow só para aquela tarefa, sem mudar o nível de esforço da sessão. Dizer “use a workflow” com suas próprias palavras também funciona. Se você digitou por engano, Option+W no macOS ou Alt+W no Windows e no Linux remove o destaque para esse prompt.
Para a sessão inteira: a configuração.
/effort ultracodeativa para a sessão atual,/effort ultracode offdesativa. No controle deslizante do/effort,Tabalterna o interruptor Ultracode eEnteraplica.claude --effort ultracodeinicia uma sessão com ele ativado, e também define o nível de esforço comoxhigh."ultracode": trueem um arquivo de configurações ativa em todas as sessões. O Claude Code lê essa chave, mas nunca a escreve.
Para desligar de vez. Desative “Ultracode keyword trigger” em /config e a palavra deixa de iniciar workflows. Desative “Dynamic workflows” em /config, defina "disableWorkflows": true ou CLAUDE_CODE_DISABLE_WORKFLOWS=1, e os workflows somem junto com o ultracode. Uma organização pode fazer o mesmo nas configurações gerenciadas.
Dois casos em que ele simplesmente não é oferecido: os workflows estão desativados, ou o modelo não suporta o esforço xhigh. Os workflows em si estão disponíveis em todos os planos pagos, com acesso à API da Anthropic, e no Amazon Bedrock, Google Cloud e Microsoft Foundry; no Pro, você precisa primeiro ligar a linha Dynamic workflows em /config.
Ultracode não é o esforço max
| Configuração | O que muda |
|---|---|
low, medium, high | O quanto uma chamada ao modelo pensa antes de responder |
xhigh | Um raciocínio mais profundo, com mais tokens gastos |
max | O nível de raciocínio mais profundo, para problemas difíceis que você quer ver resolvidos sem você |
ultracode | Como o trabalho é organizado: um workflow de vários agentes, no nível em que a sessão estiver rodando |
Um nível de esforço age sobre cada chamada. O ultracode age sobre o formato do trabalho. Você pode rodar ultracode em medium e pode rodar max sem ultracode.
A confusão tem uma história. Os dynamic workflows chegaram no Claude Code v2.1.154 no fim de maio de 2026, com workflow como palavra de acionamento. Poucos dias depois, a v2.1.160 renomeou a palavra-chave para ultracode. Até a v2.1.284, no fim de setembro, ativar o ultracode também passava a sessão para xhigh, e escolher outro nível o desativava. É por isso que tantas páginas escritas durante o verão dizem “ultracode é xhigh”. Desde a v2.1.284, é um interruptor separado que continua ativo em qualquer nível. O único resquício: a opção de inicialização --effort ultracode ainda define xhigh ao mesmo tempo.
O que muda quando ele está ativado
Ativar o ultracode vale como aceitar execuções grandes, então três salvaguardas ficam em silêncio:
- o aviso “Large workflow”, normalmente exibido quando um workflow prevê mais de 25 agentes ou mais de 1,5 milhão de tokens, não aparece mais;
- o limite de subagentes simultâneos da sessão não é aplicado aos subagentes que o Claude lança com a ferramenta Agent;
- no modo de permissão auto, ninguém pede para você aprovar o primeiro lançamento de um workflow.
O que continua valendo é a diretriz de tamanho e os tetos do runtime. A diretriz é um conselho que o Claude Code passa ao Claude quando ele escreve o script: small significa menos de 5 agentes, medium menos de 10, large menos de 50. O padrão é medium, ou small num plano Pro. Você muda isso em /config (Dynamic workflow size) ou com a chave workflowSizeGuideline. Já o runtime roda no máximo 16 agentes ao mesmo tempo por padrão e se recusa a passar de 1.000 agentes numa mesma execução.
Durante uma execução, /workflows abre a visão de progresso, com o consumo de tokens de cada agente, e você pode pará-la por ali.
Rodamos a mesma revisão duas vezes
A documentação da Anthropic diz que o ultracode faz cada pedido gastar mais tokens e demorar mais. Queríamos um número nosso, numa tarefa real, então rodamos o mesmo trabalho duas vezes.
A tarefa. Seis scripts deste próprio site, as ferramentas que nossos agentes noturnos usam para verificar links, traduções e envios ao IndexNow: três arquivos Python e três arquivos TypeScript, 1.394 linhas no total. O prompt, idêntico nas duas execuções: revisar a pasta em busca de bugs reais (lógica errada, erros não tratados que derrubariam o programa, casos-limite errados), não modificar nenhum arquivo, indicar para cada bug o arquivo, a linha e uma correção em uma linha, ordenado por gravidade.
A montagem. Claude Code 2.1.318, Opus 5.5 com a janela de contexto de 1M, uma cópia nova dos seis arquivos numa pasta descartável, ferramentas somente leitura (Read, Grep, Glob, mais Agent e Workflow), diretriz de tamanho definida como small, iniciado com claude -p. A execução A com --effort xhigh. A execução B com --effort ultracode, que, como vimos acima, também significa xhigh. Mesmo modelo, mesmo nível de esforço: a única diferença é o ultracode.
Execução A: xhigh | Execução B: ultracode | |
|---|---|---|
| Tempo real | 6 min 8 s | 14 min 14 s |
| Agentes | 1, a sessão | a sessão e 4 agentes do workflow |
| Tokens de entrada processados | 99.400 | 735.111 |
| Tokens de saída (dos quais raciocínio) | 39.054 (35.105) | 148.602 (126.222) |
| Custo desses tokens a preço de tabela | 1,20 dólar | 4,87 dólares |
| O que o comando exibiu | 14 bugs, ordenados por gravidade | uma mensagem dizendo que a execução tinha começado |
A maioria dos tokens de entrada são leituras de cache (47.730 na execução A, 424.037 na execução B). A linha de custo é o preço de tabela que o Claude Code calculou para esses tokens na saída JSON: numa assinatura nada é cobrado por token, é uma medida do quanto a execução consome dos seus limites.
O que o Claude fez com o ultracode ativado. Primeiro ele mesmo leu os seis arquivos e listou 23 bugs suspeitos. Depois escreveu um script de workflow em duas fases que respeitava a diretriz small: três buscadores em paralelo, um por grupo de arquivos (os dois arquivos TypeScript acoplados, o verificador de links, os três scripts Python), e depois um cético cujo único trabalho era tentar refutar cada candidato, incluindo os 23 dele próprio. É o padrão de verificação cruzada que a documentação da Anthropic descreve e, no papel, é exatamente o que você quer de uma caça a bugs.
O que os buscadores encontraram. 23 achados. Eles cobrem todos os bugs da execução A que importam (arquivos novos que nunca chegam ao IndexNow, a fila apagada acima de 10.000 URLs, a falha num título sem aspas, a remoção de locale que deixa passar zh-TW, os links para a própria página que escondem páginas órfãs) mais 8 que a execução A não relatou, a maioria de baixa gravidade: uma verificação de nofollow que para no primeiro > dentro de um atributo JSX, uma regex de namespace que para num hífen, uma auditoria que deixa de fora os artigos do blog. Nada de alta gravidade que a execução A tivesse deixado passar.
O que nunca voltou. Com claude -p, o Claude lançou o workflow em segundo plano e encerrou o turno com “I'll send the final list, sorted by severity, when it finishes”. Essa frase foi o que o comando exibiu. O processo então esperou e saiu 601 segundos depois, enquanto o cético ainda verificava: a lista verificada nunca chegou, e os resultados dos buscadores só podiam ser lidos nos arquivos da execução, em ~/.claude/projects/. Não encontramos nenhum limite de espera documentado para trabalho em segundo plano em -p nas páginas que lemos; foi o que vimos na 2.1.318. Numa sessão interativa a conversa continua aberta e o resultado volta quando a execução termina.
Nossa leitura. Numa revisão de seis arquivos que uma única sessão consegue ler por inteiro, o ultracode comprou oito candidatos extras de baixa gravidade por cerca de quatro vezes os tokens e mais que o dobro do tempo, e num script não entregou sua lista verificada. Na auditoria de um repositório inteiro, que uma única conversa não consegue comportar, a conta é outra. Nesta tarefa, o xhigh puro deu o melhor retorno.
O que ele consome e quando deixá-lo desativado
A Anthropic é explícita sobre o preço: com o ultracode ativado, “cada pedido gasta mais tokens e demora mais do que o mesmo pedido sem workflow”, e numa assinatura “uma sessão com ultracode ativado chega mais cedo a um limite de sessão ou semanal do que o mesmo trabalho com ele desativado”. Nossa execução é um único ponto de dados numa tarefa, não um benchmark, mas aponta na mesma direção.
Deixe desativado:
- para o trabalho de rotina: uma renomeação, uma correção pequena, uma pergunta sobre o código;
- quando sua janela de 5 horas ou seu limite semanal já está baixo, já que um pedido pode virar vários workflows em sequência;
- em scripts e tarefas agendadas: ali a palavra-chave é ignorada, e com a opção nossa execução
claude -psaiu antes de a verificação voltar; - no Pro, onde a Anthropic já define o tamanho padrão como
small.
Ative, de preferência para uma tarefa com a palavra-chave em vez de para a sessão inteira:
- para trabalhos largos demais para uma única conversa: a auditoria de um repositório inteiro, a migração de centenas de arquivos, uma pesquisa cujas fontes precisam ser conferidas umas contra as outras;
- quando você quer que agentes independentes confiram os achados uns dos outros antes de você lê-los.
Antes de uma execução grande, o próprio conselho da documentação é o certo: teste primeiro o workflow numa fatia pequena, acompanhe o /workflows e pare a execução se o contador de tokens fugir do controle.
Como vemos um agente com ultracode no AgentsRoom
Rodamos a maioria dos nossos agentes no AgentsRoom, lado a lado, e o ultracode quebrou algo primeiro no nosso próprio produto. Enquanto um workflow roda, o loop principal do Claude Code volta ao prompt: o único sinal de vida que resta é uma linha de progresso no painel de tarefas, algo como 6/7 agents done · 5m 45s · 411.6k tokens, ou “Waiting for 1 dynamic workflow to finish”. Nossa detecção de status lia esse prompt silencioso como “concluído” e marcava o agente como ocioso enquanto os subagentes do workflow ainda trabalhavam. O AgentsRoom agora lê essa linha de progresso, então um agente que roda um workflow continua “trabalhando” no seu card, no desktop e no celular, até o último subagente voltar.
Duas observações práticas se você fizer o mesmo:
- O AgentsRoom inicia o Claude Code com o esforço de raciocínio padrão que você escolhe para cada CLI, de
lowamax. Ultracode não é um desses níveis, porque não é um nível: digite/effort ultracodeno terminal do agente quando uma tarefa merecer, e/effort ultracode offdepois. - A linha de progresso mostra a contagem de tokens da execução à medida que cresce. Nosso contador de tokens mostra o consumo da sessão ao lado, e a janela de 5 horas é a primeira coisa que uma execução longa com ultracode consome.
Perguntas frequentes
O que é ultracode no Claude Code?
Uma configuração do Claude Code, não um nível de esforço de raciocínio. Ativado, o Claude planeja um dynamic workflow para cada tarefa de peso: um script curto que lança vários subagentes e roda em segundo plano enquanto sua sessão continua utilizável. A palavra-chave ultracode num prompt digitado faz o mesmo só para aquela tarefa.
Ultracode é a mesma coisa que o esforço max?
Não. Os níveis de esforço definem o quanto uma chamada ao modelo pensa. O ultracode define como o trabalho é organizado, com vários agentes em vez de uma única conversa. Desde a v2.1.284 ele continua ativo em qualquer nível de esforço; a opção de inicialização --effort ultracode é o único lugar onde ele ainda vem junto com xhigh.
Como ativar e desativar o ultracode?
Para uma tarefa, a palavra-chave num prompt que você digita. Para a sessão, /effort ultracode e /effort ultracode off, ou Tab no controle deslizante do /effort. Na inicialização, claude --effort ultracode. Para todas as sessões, "ultracode": true num arquivo de configurações. Ultracode keyword trigger em /config desativa a palavra-chave; disableWorkflows remove os workflows e o ultracode juntos.
O ultracode gasta mais tokens?
Sim. A documentação da Anthropic diz que, com um workflow, cada pedido gasta mais tokens e demora mais, e que numa assinatura você chega mais cedo a um limite de sessão ou semanal. Na nossa execução medida, a mesma revisão de seis arquivos no Opus 5.5 produziu 148.602 tokens de saída com ultracode contra 39.054 em xhigh puro, cerca de quatro vezes o custo a preço de tabela (4,87 dólares contra 1,20), porque o Claude leu os arquivos ele mesmo e depois lançou mais quatro agentes.
Por que a palavra ultracode não faz nada no claude -p ou numa tarefa agendada?
A palavra só conta quando uma pessoa a digitou: prompt interativo, painel de IDE, cliente Remote Control ou um app do Agent SDK que marca a entrada como humana. Em -p, numa tarefa agendada, num webhook ou num comentário de pull request repassado, use --effort ultracode ou a configuração ultracode.
O ultracode tem a ver com o plano Claude Ultra ou com o ultrareview?
Não. Ultra é a assinatura que a Anthropic renomeou a partir do Max 20x, a 200 dólares por mês. Ultrareview é uma revisão de código na nuvem feita por vários agentes (/code-review ultra), em research preview, com três execuções gratuitas no Pro, Max e Ultra e depois créditos de uso. Ultracode é uma configuração da sua sessão local do Claude Code.
Baixar AgentsRoom
Rode todos os seus agentes de IA, em todos os seus projetos, de uma única janela.
App complementar: acompanhe seus agentes em qualquer lugar
Use Claude, Codex, Antigravity CLI ou outro provedor de IA.
Envie bugs e pedidos direto para o seu backlog público.
Continue lendo
Modo de voz no Codex, OpenCode, Antigravity e Claude Code: qual CLI tem um?
Verificamos cinco CLIs de agentes de código e dois apps em 13 de outubro de 2026. O Codex CLI e o oh-my-pi mantêm uma conversa falada, o Claude Code e o Antigravity CLI só ditam no prompt, o OpenCode não tem nada integrado. Como iniciar cada um, para onde vai o áudio e quanto a voz custa em tokens.
Leia o artigoO que são tokens no Claude e como funcionam? Contamos 3,8 bilhões
Um token é um pedaço de palavra, e o Claude conta quatro tipos: entrada, gravações de cache, leituras de cache e saída. Contamos 30 dias das nossas próprias sessões do Claude Code, 3,8 bilhões de tokens: 98% eram a conversa relida a partir do cache, 0,3% era o que o Claude escreveu. Quanto custa cada tipo, por que uma sessão fica mais pesada a cada turno e o que a janela de 5 horas mede.
Leia o artigoComo instalar o Claude Code e o Codex CLI no Windows
Os comandos exatos de PowerShell, CMD, WinGet e npm para instalar o Claude Code e o Codex CLI no Windows 10 e 11, quando escolher o WSL e como corrigir “claude não é reconhecido” e os outros erros que você vai encontrar.
Leia o artigo