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 ultracode ativa para a sessão atual, /effort ultracode off desativa. No controle deslizante do /effort, Tab alterna o interruptor Ultracode e Enter aplica.
  • claude --effort ultracode inicia uma sessão com ele ativado, e também define o nível de esforço como xhigh.
  • "ultracode": true em 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çãoO que muda
low, medium, highO quanto uma chamada ao modelo pensa antes de responder
xhighUm raciocínio mais profundo, com mais tokens gastos
maxO nível de raciocínio mais profundo, para problemas difíceis que você quer ver resolvidos sem você
ultracodeComo 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: xhighExecução B: ultracode
Tempo real6 min 8 s14 min 14 s
Agentes1, a sessãoa sessão e 4 agentes do workflow
Tokens de entrada processados99.400735.111
Tokens de saída (dos quais raciocínio)39.054 (35.105)148.602 (126.222)
Custo desses tokens a preço de tabela1,20 dólar4,87 dólares
O que o comando exibiu14 bugs, ordenados por gravidadeuma 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 -p saiu 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 low a max. Ultracode não é um desses níveis, porque não é um nível: digite /effort ultracode no terminal do agente quando uma tarefa merecer, e /effort ultracode off depois.
  • 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.

Baixar AgentsRoomGrátis

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