Ultracode no Claude Code 2026: como o ativar com um comando

Para obter informações sobre como utilizar o serviço, consulte a documentação da Ailoot.

O que é o ultracode e a quem se destina#

Até 28 de maio de 2026, o Claude Code só tinha o parâmetro /effort, com os níveis low / medium / high / xhigh. Este indica o nível de «pensamento» do modelo: quanto mais elevado for, mais tokens são utilizados no raciocínio, mais preciso é o resultado e mais tempo o Claude demora a responder.

O Ultracode não se enquadra na escala /effort low → xhigh. É uma opção paralela. Quando está ativado, o Claude analisa automaticamente a tarefa e decide: «É melhor dividir esta em 30 agentes em paralelo para poder juntar os resultados.» Antes, tinha de o fazer manualmente, escrevendo o seu próprio workflow ou compondo um comando para subagentes. Agora, o Claude decide por si quando faz sentido.

O principal público são as pessoas que atingiram o limite de um único pedido. Se:

• executou /code-review num repositório com 200 ficheiros e a sessão falhou no ficheiro 50
• pediu «encontra todos os locais onde usamos a API obsoleta» e o Claude indicou três, esquecendo outros quinze
• quer que o Claude verifique a própria hipótese a partir de três perspetivas antes de responder

o ultracode é para si. Se estiver a escrever uma função e precisar de uma solução, não precisa dele: o /effort high normal resolve o problema com três vezes menos tokens.

Em que difere o ultracode dos níveis de esforço low/medium/high/xhigh#

Comparação dos aspetos essenciais:

A principal diferença numa frase: /effort xhigh significa «pensa durante mais tempo»; ultracode significa «pensa durante mais tempo E decide por ti quando consegues resolver com um pedido e quando precisas de uma equipa de 30 agentes». Assim, na prática, o ultracode acrescenta uma camada ao xhigh: a orquestração automática.

A Anthropic afirma-o explicitamente na sua documentação oficial:

Isto significa que um único pedido seu pode desenrolar-se em três workflows sucessivos: compreender o código, fazer as alterações e verificá-las. Cada um pode lançar 10–30 agentes em paralelo.

Que versões e modelos suportam o ultracode#

Verifique a sua versão:

claude --version

Se for anterior à 2.1.154, atualize-a:

npm install -g @anthropic-ai/claude-code

Em seguida, consulte a lista de níveis de esforço:

claude /effort

Se vir ultracode no menu pendente, está tudo pronto. Se não aparecer, é provável que seja por um destes motivos:

• o modelo atual não é o Opus 4.8 (por exemplo, o Sonnet 4.7 não tem xhigh)
• tem o plano Pro e o modo está desativado em /config (ative a opção “Dynamic workflows”)
• o administrador da organização desativou os workflows nas definições geridas

Verifique o modelo:

claude /model

Se o modelo predefinido não for o Opus 4.8, altere-o: selecione o Opus 4.8 no menu de modelos ou defina-o como predefinido com a tecla d.

Como ativar o ultracode: dois métodos#

Método 1. Ativá-lo para toda a sessão.

Numa sessão do Claude Code:

/effort ultracode

A partir daí, o Claude decide por si se lança um workflow para cada tarefa substancial. A sessão mantém-se até a fechar. Quando fechar o Claude Code e voltar a abri-lo, o ultracode será reposto. É intencional: deve ativar este modo deliberadamente, em vez de o deixar «ativado por predefinição».

Método 2. Apenas para uma tarefa.

Coloque ultracode no início do pedido (antes da v2.1.160, a palavra-chave era workflow; depois do lançamento, a Anthropic mudou o acionador para evitar confusão com execuções normais):

ultracode: percorre todos os endpoints /api/* em src/routes/ e encontra onde faltam verificações de autorização

O Claude Code destacará a palavra ultracode e lançará esta tarefa como workflow. O nível de esforço da sessão mantém-se (high ou medium, consoante a definição escolhida).

A Anthropic escreve que também é possível fazer o mesmo em linguagem natural:

Se escreveu ultracode por engano e não pretendia lançar um workflow, prima Option+W (macOS) ou Alt+W (Windows/Linux) quando o cursor estiver imediatamente a seguir à palavra destacada. O destaque desaparecerá e a tarefa prosseguirá normalmente.

O que muda no trabalho do Claude depois de o ativar#

Antes do ultracode: escreve um pedido, o Claude pensa durante 30 segundos e responde. Se a tarefa for grande, o contexto fica cheio de resultados intermédios e, no fim da sessão, tudo começa a «desviar-se».

Com o ultracode: escreve um pedido, o Claude percebe a dimensão da tarefa e escreve um script. O script é executado de forma isolada: os resultados intermédios ficam guardados em variáveis do script, não no contexto da sessão. Só recebe a resposta final.

Na prática, isto tem três efeitos:

1. O contexto da sessão não fica cheio. Pode trabalhar durante mais tempo sem /compact.
2. Pode paralelizar. Uma execução pode lançar até 16 agentes a trabalhar em simultâneo (menos em computadores com pouco CPU). O limite total de uma execução é 1000 agentes.
3. O resultado é verificado automaticamente. O Claude pode pedir a um agente que escreva uma solução e a outro que a reveja criticamente. Isto reduz as alucinações em tarefas complexas.

Pode acompanhar uma execução em direto:

/workflows

Abre-se uma lista dos workflows em execução e concluídos. Use as teclas de seta para selecionar um e prima Enter para abrir os detalhes das respetivas fases. Pode ver os agentes, a utilização de tokens de cada um e o tempo de execução. Prima p para pausar, x para parar ou r para reiniciar um agente.

Quando ativar o ultracode e quando não o fazer#

Três situações em que o ultracode se justifica:

1. Auditar uma base de código de grandes dimensões. Por exemplo: «encontra todos os locais do projeto onde registamos palavras-passe nos logs». Um único pedido só funcionará num repositório pequeno. Num repositório com 500 ficheiros, um Claude esquecer-se-á de metade, enquanto um workflow lançará 20 agentes em paralelo, cada um responsável por 25 ficheiros.

2. Uma migração que afeta muitos ficheiros. Substituir uma API obsoleta, mudar de uma biblioteca para outra ou refatorizar um padrão em todo o projeto. Um workflow pode processar ficheiros em lotes de 10 e verificar o próprio trabalho depois de cada lote.

3. Investigação que exige comparar fontes entre si. A Anthropic disponibilizou esta funcionalidade como o workflow /deep-research: divide uma questão em diferentes perspetivas, encontra fontes, verifica os factos e filtra tudo o que não foi possível confirmar. Utilizei-o para recolher dados sobre o mercado da programação com IA e obtive um relatório melhor do que uma hora de trabalho manual.

Três situações em que o ultracode desperdiça tokens:

1. Corrigir um erro numa única função. Um único pedido /effort high consegue fazê-lo por um décimo do custo. Não lance um workflow para isto.

2. Escrever uma função ou um componente novo. A mesma coisa: utilize /effort high ou até medium. A complexidade não aumenta com o número de agentes; aumenta com a profundidade de raciocínio, que o xhigh oferece por si só, sem orquestração.

3. Precisa de uma resposta rápida. Por definição, um workflow é mais lento do que um pedido normal: mesmo com agentes em paralelo, a coordenação demora tempo. Se precisar de algo «já, ainda no mesmo minuto», não o ative.

A estratégia do exemplo descrito aqui é utilizar /effort high como predefinição para alterações rotineiras. Ativo o ultracode seletivamente para uma tarefa específica, usando a palavra no pedido, em vez de o ativar para toda a sessão. Se se esquecer de o desativar, continuará o trabalho rotineiro depois da tarefa com ultracode, gastando tokens sem motivo.

Quantos tokens e quanto dinheiro custa#

Façamos uma estimativa aproximada. Um pedido normal no Opus 4.8 com effort high utiliza cerca de 5,000–15,000 tokens para raciocínio, além da resposta do modelo. Uma tarefa substancial bem executada utiliza 50,000–100,000 tokens no total.

Um workflow com 20 agentes significa 20 pedidos em paralelo, cada um com o seu próprio contexto de instrução de sistema (~5–10K), o seu próprio raciocínio (xhigh — 10–30K) e a sua própria resposta. Uma estimativa aproximada é de 600,000–1,5 milhões de tokens por execução. É 10–30 vezes mais caro do que um único pedido «normal».

O que significa em termos de dinheiro:

• Pro ($20/mês): Em fevereiro de 2026, a Anthropic clarificou a proibição do acesso programático a partir de software de terceiros e, a 15 de junho de 2026, separou o crédito para workflows da subscrição de chat. O Pro recebe $20 de crédito para cargas de trabalho programáticas. Um workflow grande consumirá metade desse valor. Quando o crédito se esgotar, os workflows deixarão de ser lançados até ativar as cobranças por utilização excedente.
• Max 5x ($100/mês): $100 de crédito. É suficiente para 5–10 workflows grandes por mês.
• Max 20x ($200/mês): $200 de crédito.
• Team ($30/$150 por membro): O crédito corresponde ao plano de subscrição de cada lugar.
• API: Paga simplesmente a tarifa por token.

A própria Anthropic recomenda estimar o custo antes de executar um workflow:

Ou seja, execute primeiro o workflow numa pasta, consulte /workflows para ver quanto custou e depois decida se o deve executar em todo o repositório. Uma execução tem um limite total de 1000 agentes, mas mesmo 100 agentes num repositório grande já representam centenas de milhares de tokens.

Se o objetivo for «reduzir a utilização», pode encaminhar explicitamente as fases secundárias para um modelo mais pequeno no script do workflow. No pedido: «utiliza o Sonnet 4.7 na fase de classificação de ficheiros e o Opus 4.8 apenas para a análise final». A Anthropic suporta esta opção.

O que acontece por dentro: workflows, /workflows e limites#

Cada execução escreve o seu próprio script num ficheiro dentro de ~/.claude/projects/. O Claude recebe o caminho do script quando a execução começa. Isto significa que pode:

• pedir ao Claude: «mostra-me o script deste workflow»
• abri-lo num editor e analisar a sua lógica
• compará-lo com a execução anterior
• editá-lo e pedir ao Claude que execute novamente a versão editada

O runtime estabelece limites:

Aplica-se um modo de permissões a cada execução. Por predefinição, o Claude Code pede autorização de cada vez. Pode escolher “Yes, and don't ask again for <name> in <path>”; nesse caso, esse workflow específico nesse projeto deixará de perguntar. No modo Auto, pergunta apenas na primeira execução e depois guarda a sua aprovação nas definições do utilizador. Em claude -p e no Agent SDK, não pergunta porque não há ninguém para responder.

Um detalhe importante: os subagentes nos workflows são sempre executados no modo acceptEdits e herdam a sua lista de ferramentas permitidas, independentemente do modo de permissões atual. As edições de ficheiros são aprovadas automaticamente. Tenha isto em conta se estiver a trabalhar em algo crítico.

Como guardar um workflow funcional como comando#

Cenário: executei /code-review com ultracode numa nova branch. O workflow fez três execuções: a primeira foi uma análise rápida de todo o diff, a segunda uma verificação aprofundada das funções de segurança e a terceira executou testes nas funções alteradas. Os resultados convergiram bem e foram detetados dois problemas.

Agora quero executá-lo em todas as branches antes da integração. Abro:

/workflows

Seleciono a execução concluída e primo s. Na caixa de diálogo, escolho onde a guardar — .claude/workflows/ (no projeto, no git e disponível para a equipa) ou ~/.claude/workflows/ (pessoal, em qualquer projeto). Dou-lhe um nome, por exemplo pre-merge-review. Primo Enter.

A partir de agora, em qualquer sessão futura:

/pre-merge-review

E o workflow começa com o mesmo script que depurei.

Se o workflow esperar argumentos, descreva-os no pedido quando o guardar; o script recebe então args como variável global. Pode passar-lhe uma lista de caminhos, números de issues, IDs de ficheiros ou qualquer outra coisa.

A Anthropic refere que os argumentos são recebidos como dados estruturados:

Isto significa que pode utilizar diretamente args.map(...) no script, sem analisar uma cadeia de caracteres. É útil para tarefas em massa: uma lista de tickets, pastas ou endpoints.

Como desativar o ultracode e porquê#

O principal motivo para o desativar é regressar ao trabalho rotineiro. Se mudou para ultracode para uma tarefa grande e já a concluiu, volte imediatamente ao modo anterior:

/effort high

Caso contrário, a próxima pequena alteração será executada como um workflow e consumirá tokens sem qualquer benefício.

Para usar só a palavra-chave, mantenha Dynamic workflows ativo e um esforço normal da sessão, como /effort high; acrescente ultracode apenas à tarefa escolhida. Não aplique a desativação global abaixo com esse objetivo: também desativa a palavra-chave. Se quiser proibir tanto os workflows de sessão como os iniciados por palavra-chave, use uma destas opções globais:

# nas definições do cliente
# /config → Dynamic workflows → off
# ou
# ~/.claude/settings.json
{
  "disableWorkflows": true
}

# ou através da variável de ambiente
export CLAUDE_CODE_DISABLE_WORKFLOWS=1

Depois disso, a palavra-chave ultracode num pedido deixará de iniciar um workflow e a opção ultracode desaparecerá do menu /effort. Isto é útil se trabalhar numa equipa que pretende uma regra partilhada: «sem workflows automáticos». Nesse caso, configure-a nas definições geridas da organização.

Mantenho /effort high como predefinição e ativo o ultracode seletivamente. É um compromisso entre «fazer bem quando for necessário» e «não desperdiçar o orçamento sem motivo». Para alterações rotineiras no projeto aqui descrito, o nível high normal é suficiente. Quando preciso de executar uma auditoria de segurança extensa ou reunir investigação de 20 fontes, utilizo /effort ultracode ou coloco a palavra no início do pedido.

O que fazer a seguir#

Se está a utilizar o Claude Code neste momento e confirmou que tem v2.1.154+ e o modelo Opus 4.8, experimente já. Não para toda a sessão, apenas para uma tarefa específica:

ultracode: percorre todos os ficheiros em src/components/ui/ e encontra onde o mesmo botão tem estilos diferentes

Consulte /workflows para ver quantos agentes foram lançados e quantos tokens foram utilizados. Isto dar-lhe-á uma ideia mais realista dos custos e benefícios do que qualquer texto.

Fontes#

Veja também:

• Workflows dinâmicos no Claude Code: como orquestrar centenas de agentes em paralelo
• Multiagente no Claude Code: como paralelizar subagentes
• Rotinas no Claude Code: automatize com um horário em vez de cron
• Sonnet ou Opus no Claude Code: que modelo utilizar para cada tarefa
• Modo de objetivos no Claude Code e no Codex: defina um objetivo e trabalhe para o alcançar

Conheça a Ailoot.