Claude Code Ultraplan

O teu terminal fica refém. Cada vez que o Claude Code entra em modo de planeamento, o prompt fica congelado até o plano estar pronto. Para uma funcionalidade rápida, está bem. Para um plano de migração que toca 40 ficheiros em três serviços, ficas a olhar para um spinner durante minutos enquanto a máquina local faz todo o trabalho.

O Ultraplan resolve isso ao enviar toda a fase de planeamento para a cloud da Anthropic, correndo o Opus 4.6 num container remoto durante até 30 minutos enquanto o teu terminal fica livre para trabalho real. O plano é redigido em segundo plano. Revisas-o num browser com comentários inline e reações emoji. Depois escolhes: executa na cloud (e recebe um PR) ou teleporta-o de volta para a tua sessão local.

Esta é a maior adição ao stack de planeamento do Claude Code desde que o plan mode foi lançado pela primeira vez. O que se segue é como funciona de facto, o que o código-fonte vazado revela sobre as suas entranhas, e como obter bons resultados dele.

O que o Ultraplan Realmente É

O Ultraplan é uma funcionalidade de research preview que passa uma tarefa de planeamento do teu CLI local para uma sessão do Claude Code na web a correr em plan mode. A sessão cloud corre no Cloud Container Runtime (CCR) da Anthropic com o Opus 4.6. O teu terminal local faz polling a cada 3 segundos para verificar o estado.

As diferenças principais em relação ao planeamento local:

Requisitos: Precisas de uma conta do Claude Code na web (Pro, Max, Team ou Enterprise) e um repositório GitHub ligado.

Três Formas de Lançar o Ultraplan

1. O Comando Slash

O mais explícito dos três. Escreve /ultraplan seguido do teu prompt:

/ultraplan migrate the auth service from sessions to JWTs

Um diálogo de confirmação aparece antes de a sessão cloud ser realmente lançada.

2. O Ativador por Palavra-Chave

Usa a palavra "ultraplan" em qualquer lugar num prompt normal:

I need an ultraplan for refactoring the payment module to support multi-currency

O Claude apanha a palavra-chave e abre o mesmo diálogo de confirmação. Conveniente quando queres descrever a tarefa de forma conversacional, não como comando.

3. A Partir de um Plano Local

O caminho mais suave. Quando o Claude conclui um plano local e mostra o diálogo de aprovação, escolhe "No, refine with Ultraplan on Claude Code on the web" para enviar o rascunho para a cloud. Sem prompt de confirmação extra, porque a tua seleção já conta como um.

Este caminho é forte porque a sessão cloud começa com o teu plano local como contexto em vez de começar do zero.

Monitorizar a Partir do Teu Terminal

Uma vez lançado, o teu prompt do CLI mostra uma linha de estado ao vivo:

Corre /tasks no terminal para ver a entrada do ultraplan. A partir daí podes abrir o link da sessão, ver a atividade do agente ou clicar em Stop ultraplan para arquivar a sessão cloud e limpar o indicador.

Uma coisa a observar: se o Remote Control estiver ativo, desliga-se no momento em que o Ultraplan começa. Ambas as funcionalidades usam a interface claude.ai/code, e apenas uma pode estar ligada de cada vez.

A Interface de Revisão no Browser

É aqui que o Ultraplan se destaca do planeamento local. Em vez de ler um plano no scrollback do terminal (onde só podes aceitar, rejeitar ou escrever um follow-up), tens uma UI dedicada no browser com três ferramentas de revisão:

Comentários inline: Destaca qualquer passagem no plano e deixa um comentário. Este é o upgrade real. Em vez de dizer "a secção de migração de base de dados precisa de mais detalhe", aponta para o parágrafo que está fraco e explicas o que falta. O Claude revê apenas essa secção.

Reações emoji: Reage a secções individuais do plano para sinalizar aprovação ou preocupação sem escrever um comentário completo. Forma rápida de marcar quais as partes que estão sólidas e quais precisam de trabalho.

Sidebar de estrutura: Salta entre secções do plano. Essencial para planos longos onde o scroll se torna doloroso.

Podes iterar quantas vezes quiseres. Pede ao Claude que trate dos teus comentários, revê o rascunho revisto, deixa mais comentários e repete até o plano estar certo.

Quatro Caminhos de Execução Após Aprovação

Uma vez que o plano parece certo, escolhes onde corre:

Caminho 1: Executar na Cloud

Clica em "Approve Claude's plan and start coding" no browser. O Claude implementa o plano dentro da mesma sessão cloud e, quando termina, revisas o diff e abres um pull request a partir da UI web. O teu terminal mostra uma confirmação e a linha de estado limpa.

Este é o caminho mais limpo para alterações autónomas. A sessão cloud tem acesso total ao teu repositório e a criação de PR está ligada diretamente à UI web.

Caminho 2: Implementar na Sessão Terminal Atual

Clica em "Approve plan and teleport back to terminal" no browser. A sessão web é arquivada e o teu terminal mostra o plano num diálogo com o título "Ultraplan approved". Escolhe "Implement here" para injetar o plano na tua conversa atual e continuar a partir de onde paraste.

Melhor quando o plano toca em contexto local (variáveis de ambiente, serviços locais, ficheiros fora do repo) que a sessão cloud não consegue ver.

Caminho 3: Iniciar uma Sessão Local Nova

Mesmo diálogo de teleporte, botão diferente: "Start new session". Isso limpa a tua conversa atual e começa limpo apenas com o plano como contexto. O Claude imprime um comando claude --resume para poderes voltar à tua conversa anterior mais tarde.

Bom quando a tua sessão atual já está pesada de contexto que apenas ficaria no caminho. Janela nova, foco num único objetivo.

Caminho 4: Guardar e Cancelar

Escolhe "Cancel" no diálogo de teleporte. O Claude escreve o plano num ficheiro e imprime o caminho. Nada corre. Podes voltar a ele mais tarde, partilhá-lo com colegas para revisão ou usá-lo como especificação para implementação manual.

O que o Vazamento do Código-Fonte Revelou

A 31 de março de 2026, o código-fonte do Claude Code vazou através de um erro de packaging npm. Dentro das 512 000+ linhas de TypeScript estavam os system prompts que alimentam o Ultraplan. Eles mostram que o Ultraplan não é uma coisa só. São pelo menos três variantes que parecem ser atribuídas através de A/B testing.

Variante 1: simple_plan

A opção lightweight. Sem subagentes envolvidos. O system prompt diz ao Claude para:

Run a lightweight planning process, consistent with how you would
in regular plan mode:
- Explore the codebase directly with Glob, Grep, and Read.
- Do not spawn subagents.
When you've settled on an approach, call ExitPlanMode with the plan.

Basicamente plan mode normal em hardware cloud. Mais rápido, menos minucioso.

Variante 2: visual_plan

Igual ao simple_plan, mais um parágrafo a pedir ao Claude para incluir diagramas Mermaid ou ASCII para alterações estruturais. Os diagramas mostram ordem de dependências, fluxo de dados ou a forma da alteração.

Se o teu Ultraplan voltar com diagramas de arquitetura, ficaste com esta variante. Texto puro sem imagens significa que não ficaste.

Variante 3: three_subagents_with_critique

A variante profunda. Esta é a que o rastreador oficial do sistema de prompts Piebald-AI capturou na versão 2.1.88:

Produce an exceptionally thorough implementation plan using
multi-agent exploration.
1. Spawn parallel agents to explore: existing code/architecture,
   files needing modification, risks/edge cases/dependencies
2. Synthesize findings into detailed step-by-step plan
3. Spawn a critique agent to review the plan
4. Incorporate critique feedback, then call ExitPlanMode

Três agentes de investigação paralelos atingem dimensões diferentes da tua codebase ao mesmo tempo. Depois um quarto agente revê o plano sintetizado para lacunas. Esta é a variante que ganha a janela de 30 minutos. Em trabalho arquitetural profundo, múltiplos agentes a olhar para superfícies de risco, cadeias de dependências e padrões existentes produzem planos notavelmente melhores do que uma única passagem.

Se leste o nosso guia sobre padrões de design de sub-agentes, este é o padrão explorar-sintetizar-criticar em ação. A Anthropic está a usar a mesma abordagem multi-agente para planeamento que utilizadores avançados do Claude Code já constroem manualmente.

A Lotaria de Variantes

As três variantes de system prompt do Ultraplan parecem ser atribuídas silenciosamente. Ninguém escolhe qual variante recebe, e nada na UI diz qual está a correr. O código também contém um teste A/B separado chamado tengu_pewter_ledger com quatro variantes (null, trim, cut, cap) que mudam a verbosidade geral do output de planos, embora não seja claro se esse teste se aplica especificamente a sessões Ultraplan.

O que isso significa na prática: alguns utilizadores relatam que o Ultraplan produz planos minuciosos e com múltiplas secções com análise de riscos, enquanto outros recebem esboços finos que mal superam o planeamento local. Se a diferença vem da atribuição de variante, do teste de verbosidade, ou de ambos, a inconsistência é real e bem documentada em threads iniciais do Hacker News.

Histórico de Versões

O rastreador Piebald-AI traça a evolução do Ultraplan nas versões do Claude Code:

Retirar /ultraplan na v2.1.89 e devolvê-lo na v2.1.91 sugere que a Anthropic tentou brevemente um modelo de invocação apenas por palavra-chave antes de voltar atrás. A funcionalidade ainda está marcada como "research preview" na documentação oficial, e nunca apareceu no CHANGELOG.md oficial da Anthropic. Vive atrás de feature flags.

Dicas Práticas para Melhores Resultados com o Ultraplan

1. Carrega Contexto no Início do Teu Prompt

A sessão cloud do Ultraplan pode ler a tua codebase, mas começa a frio. Mais contexto à frente significa menos tempo a explorar e um plano melhor do outro lado:

/ultraplan migrate auth from express-session to JWTs.
Key files: src/middleware/auth.ts, src/routes/api/*.ts, src/models/User.ts.
Current session store is Redis. 47 protected routes.
Must maintain backward compatibility during rollout.

Compara com apenas /ultraplan migrate auth to JWTs. A primeira versão dá ao planeador um arranque em corrida.

2. Usa o Caminho do Plano Local para Trabalho Complexo

Para os teus planos de maior risco, ignora o lançamento direto. Começa com um plano local para obter um esboço, depois envia-o para o Ultraplan para refinamento. A sessão cloud abre com uma base mais forte do que a exploração a frio.

Esse fluxo de dois passos também significa que já verificaste a direção antes de gastar ciclos de cloud. Se o plano local revelar que estás a resolver o problema errado, apanhas antes de uma execução de 30 minutos no Ultraplan.

3. Usa Comentários Inline de Forma Agressiva

A UI de revisão no browser é o ponto forte do Ultraplan. Não te limites a ler o plano e clicar em aprovar. Destaca secções específicas e deixa feedback direcionado:

• "Esta secção assume uma única base de dados. Temos três: utilizadores, analytics e faturação."
• "A estratégia de testes precisa de testes de integração para o webhook handler, não apenas testes unitários."
• "O passo 4 depende do passo 7. Reordena."

Comentários inline precisos levam a revisões mais fortes do que feedback geral como "torna o plano mais detalhado."

4. Escolhe o Caminho de Execução Baseado no Âmbito

5. Sabe Quando NÃO Usar o Ultraplan

O Ultraplan adiciona latência. A sessão cloud tem de clonar o teu repo, percorrer a codebase e redigir um plano antes de qualquer coisa aparecer. Para alterações simples onde já sabes a abordagem, o plan mode local (Shift+Tab duas vezes) é mais rápido.

Usa o Ultraplan quando: o próprio planeamento é a parte difícil. Migrações, refactorizações em muitos ficheiros, decisões arquiteturais com múltiplos caminhos válidos, ou qualquer tarefa onde 10 a 30 minutos de planeamento poupa horas de retrabalho do outro lado.

Ignora o Ultraplan quando: precisas de um plano rápido para uma alteração focada, estás a iterar rapidamente na implementação ou não tens um repo GitHub ligado (requisito obrigatório).

Como o Ultraplan Se Enquadra no Ecossistema de Planeamento

O Claude Code agora tem quatro níveis de planeamento, cada um combinado com um nível de complexidade diferente:

Cada nível traz mais capacidade ao custo de mais overhead. A competência é combinar o nível certo com a tarefa. Para leitores que já usam as estratégias de gestão de contexto do Claude Code, o Ultraplan também dá uma vantagem de contexto: o planeamento corre numa janela de contexto separada da tua sessão de trabalho. O teu contexto local fica limpo para implementação.

Limitações Atuais

O Ultraplan é uma research preview, e nota-se:

Sem seleção de variante. Não podes escolher entre as variantes de planeamento simples, visual ou profunda. Recebes aquela que o teste A/B te atribui.

Apenas GitHub. Um repositório GitHub ligado é necessário. GitLab, Bitbucket e repos apenas locais estão fora.

Sem iniciação na web. Só podes iniciar o Ultraplan a partir do CLI. Lançá-lo diretamente a partir da interface web é uma funcionalidade que vários utilizadores pediram, mas ainda não está lá.

Fricção na UX. Utilizadores iniciais no Hacker News relataram dificuldade em perceber como deixar comentários inline e descreveram o processo como "lento". A superfície de revisão no browser funciona, mas a descoberta é difícil.

Mecânica opaca. Como a sincronização de ficheiros funciona entre a tua máquina local e a sessão cloud não está bem documentada. Os utilizadores relatam incerteza sobre o que acontece se abandonam uma sessão a meio do plano.

Sem entrada no changelog oficial. Apesar de ser totalmente funcional, o Ultraplan tem zero entradas no CHANGELOG.md oficial da Anthropic. A funcionalidade inteira vive atrás de feature flags, o que significa que pode mudar ou desaparecer sem aviso.

O que Vem a Seguir

O Ultraplan é a aposta da Anthropic de que o planeamento é o gargalo no desenvolvimento assistido por IA. Não a geração de código, não os testes, não o deployment. O planeamento. Dedicar uma sessão cloud de 30 minutos no Opus 4.6 apenas para a fase de planeamento diz-te onde eles pensam que o maior benefício está.

A forma de três variantes também sugere a direção. Agora, a atribuição de variantes é silenciosa e aleatória. Mas a infraestrutura para suportar "escolhe a tua profundidade de planeamento" já está construída. Uma versão futura poderia deixar-te pedir explicitamente planeamento simples, visual ou profundo baseado no que a tarefa precisa.

Por agora, o Ultraplan é melhor tratado como uma ferramenta de planeamento avançada para trabalho complexo e de alto risco. Usa o plan mode local para tarefas diárias. Guarda o Ultraplan para os planos que precisam de estar certos à primeira.