Claude Code /Ultraplan: ferramenta de planejamento baseada em nuvem

• Oferece um fluxo de trabalho em que uma tarefa de planejamento iniciada na CLI é enviada para a nuvem para redigir um rascunho no Claude Code on the web, revisá-lo e editá-lo no navegador e depois executá-lo onde preferir, na web ou no terminal local
• Como gera planos remotamente sem ocupar o terminal, é possível continuar trabalhando localmente enquanto o rascunho está sendo preparado
• Na tela de revisão no navegador, é possível fornecer feedback sobre seções específicas, em vez do documento inteiro, por meio de comentários inline, reações com emoji e um outline por seção
• É possível escolher no navegador onde executar e seguir por dois caminhos: implementar diretamente na web e criar um pull request, ou enviar o plano de volta ao terminal para executá-lo localmente
• Requer Claude Code v2.1.91 ou superior e uma conta do Claude Code on the web e um repositório GitHub; não pode ser usado em ambientes Amazon Bedrock, Google Cloud Vertex AI e Microsoft Foundry (research preview)

---

Visão geral do Ultraplan e como funciona

• Recurso que delega uma tarefa de planejamento da CLI local para uma sessão de plan mode no Claude Code on the web
• Enquanto o Claude redige um rascunho do plano na nuvem, o terminal local fica livre para outros trabalhos
• Quando o plano fica pronto, ele pode ser aberto no navegador para adicionar comentários em seções específicas, solicitar revisões e escolher onde executar
• Três principais vantagens:
  • Targeted feedback: permite comentar seções individuais do plano, em vez da resposta inteira
  • Hands-off drafting: a geração remota deixa o terminal livre
  • Flexible execution: escolha entre implementar na web e gerar um PR ou retornar ao terminal

Requisitos e limitações

• Requer Claude Code v2.1.91 ou superior (em fase de research preview)
• Conta do Claude Code on the web e repositório GitHub são obrigatórios
• Como roda na infraestrutura de nuvem da Anthropic, Amazon Bedrock, Google Cloud Vertex AI e Microsoft Foundry não são compatíveis
• A sessão em nuvem é executada no cloud environment padrão da conta

Como executar o Ultraplan pela CLI

• Há suporte para três formas de execução:
  • Command: inserir um prompt após /ultraplan (ex.: /ultraplan migrate the auth service from sessions to JWTs)
  • Keyword: incluir a palavra ultraplan em um prompt comum
  • From a local plan: após concluir um plano local, selecionar "No, refine with Ultraplan on Claude Code on the web" na caixa de diálogo de aprovação
• Nos modos Command e Keyword, é exibida uma caixa de diálogo de confirmação antes da execução; no caminho de plano local, a própria escolha já conta como confirmação, então a caixa é omitida
• Se o Remote Control estiver ativado, ele será desconectado ao iniciar o ultraplan (os dois recursos ocupam a mesma interface claude.ai/code, então não podem ser usados ao mesmo tempo)

Exibição de status na CLI

• Enquanto a sessão em nuvem está em execução, um indicador de status aparece no prompt do terminal:

Estado	Significado
◇ ultraplan	analisando a base de código e redigindo o rascunho do plano
◇ ultraplan needs your input	o Claude precisa de esclarecimentos; é necessário responder pelo link da sessão
◆ ultraplan ready	plano concluído e pronto para revisão no navegador

• Ao executar /tasks e selecionar o item ultraplan, é exibida uma visão detalhada com link da sessão, atividade do agente e a ação Stop ultraplan
• Ao interromper, a sessão em nuvem é arquivada, o indicador é resetado e nada é salvo no terminal

Revisão e edição do plano no navegador

• Quando o status muda para ◆ ultraplan ready, o plano pode ser aberto no claude.ai pelo link da sessão
• Recursos disponíveis na tela dedicada de revisão:
  • Inline comments: destacar um trecho específico e deixar um comentário para o Claude
  • Emoji reactions: marcar aprovação ou preocupação em uma seção sem escrever um comentário completo
  • Outline sidebar: navegação rápida entre as seções do plano
• O Claude incorpora os comentários, revisa o plano e apresenta um rascunho atualizado
• É possível repetir as revisões quantas vezes quiser antes de decidir onde executar

Escolha do local de execução

Executar na web

• Ao selecionar "Approve Claude's plan and start coding" no navegador, a implementação começa imediatamente na mesma sessão do Claude Code on the web
• Uma mensagem de confirmação é exibida no terminal e o indicador de status é resetado
• Depois que a implementação termina, é possível revisar o diff e criar um pull request na interface web

Voltar ao terminal para executar localmente

• Ao selecionar "Approve plan and teleport back to terminal" no navegador, o plano é implementado no ambiente local com acesso completo
• Essa opção só aparece quando a sessão foi iniciada pela CLI e o terminal ainda está fazendo polling
• A sessão web é arquivada e não continua executando em paralelo
• No terminal, é exibida a caixa de diálogo "Ultraplan approved" com três opções:
  • Implement here: injeta o plano na conversa atual e continua a partir dali
  • Start new session: limpa a conversa atual e inicia uma nova sessão tendo apenas o plano como contexto
  • Cancel: salva o plano em um arquivo (sem executar); o Claude imprime o caminho do arquivo
• Ao iniciar uma nova sessão, o comando claude --resume é mostrado no topo para que seja possível voltar à conversa anterior