> ## Documentation Index
> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Planejar na nuvem com ultraplan

> Inicie um plano a partir da sua CLI, elabore-o no Claude Code na web e execute-o remotamente ou de volta no seu terminal

<Note>
  Ultraplan está em visualização de pesquisa. O comportamento e as capacidades podem mudar com base no feedback.
</Note>

Ultraplan entrega uma tarefa de planejamento da sua CLI local para uma sessão de [Claude Code na web](/pt/claude-code-on-the-web) em execução no [modo de plano](/pt/permission-modes#analyze-before-you-edit-with-plan-mode). Claude elabora o plano na nuvem enquanto você continua trabalhando no seu terminal. Quando o plano estiver pronto, você o abre no seu navegador para comentar em seções específicas, solicitar revisões e escolher onde executá-lo.

Isso é útil quando você deseja uma superfície de revisão mais rica do que a oferecida pelo terminal:

* **Feedback direcionado**: comente em seções individuais do plano em vez de responder ao todo
* **Elaboração sem intervenção**: o plano é gerado remotamente, então seu terminal fica livre para outro trabalho
* **Execução flexível**: aprove o plano para ser executado na web e abra uma solicitação de pull, ou envie-o de volta para seu terminal

Ultraplan requer uma conta de [Claude Code na web](/pt/claude-code-on-the-web) e um repositório GitHub. Como é executado na infraestrutura de nuvem da Anthropic, não está disponível ao usar Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry. A sessão na nuvem é executada no [ambiente de nuvem](/pt/claude-code-on-the-web#the-cloud-environment) padrão da sua conta. Se você ainda não tiver um ambiente de nuvem, o ultraplan cria um automaticamente quando é iniciado pela primeira vez.

<h2 id="launch-ultraplan-from-the-cli">
  Iniciar ultraplan a partir da CLI
</h2>

A partir da sua sessão CLI local, você pode iniciar o ultraplan de três maneiras:

* **Comando**: execute `/ultraplan` seguido do seu prompt
* **Palavra-chave**: inclua a palavra `ultraplan` em qualquer lugar em um prompt normal
* **A partir de um plano local**: quando Claude termina um plano local e mostra a caixa de diálogo de aprovação, escolha **Não, refinar com Ultraplan no Claude Code na web** para enviar o rascunho para a nuvem para iteração adicional

Por exemplo, para planejar uma migração de serviço com o comando:

```
/ultraplan migrate the auth service from sessions to JWTs
```

Os caminhos de comando e palavra-chave abrem uma caixa de diálogo de confirmação antes de iniciar. O caminho do plano local ignora essa caixa de diálogo porque essa seleção já serve como confirmação. Se [Remote Control](/pt/remote-control) estiver ativo, ele se desconecta quando o ultraplan é iniciado porque ambos os recursos ocupam a interface claude.ai/code e apenas um pode estar conectado por vez.

Após o lançamento da sessão na nuvem, o prompt de entrada da sua CLI mostra um indicador de status enquanto a sessão remota funciona:

| Status                         | Significado                                                                     |
| :----------------------------- | :------------------------------------------------------------------------------ |
| `◇ ultraplan`                  | Claude está pesquisando sua base de código e elaborando o plano                 |
| `◇ ultraplan needs your input` | Claude tem uma pergunta de esclarecimento; abra o link da sessão para responder |
| `◆ ultraplan ready`            | O plano está pronto para revisão no seu navegador                               |

Execute `/tasks` e selecione a entrada ultraplan para abrir uma visualização de detalhes com o link da sessão, atividade do agente e uma ação **Stop ultraplan**. Parar arquiva a sessão na nuvem e limpa o indicador; nada é salvo no seu terminal.

<h2 id="review-and-revise-the-plan-in-your-browser">
  Revisar e revisar o plano no seu navegador
</h2>

Quando o status muda para `◆ ultraplan ready`, abra o link da sessão para visualizar o plano em claude.ai. O plano aparece em uma visualização de revisão dedicada:

* **Comentários inline**: destaque qualquer passagem e deixe um comentário para Claude abordar
* **Reações com emoji**: reaja a uma seção para sinalizar aprovação ou preocupação sem escrever um comentário completo
* **Barra lateral de estrutura de tópicos**: pule entre seções do plano

Quando você pede a Claude para abordar seus comentários, ela revisa o plano e apresenta um rascunho atualizado. Você pode iterar quantas vezes forem necessárias antes de escolher onde executar.

<h2 id="choose-where-to-execute">
  Escolha onde executar
</h2>

Quando o plano parecer correto, você escolhe no navegador se Claude o implementa na mesma sessão na nuvem ou o envia de volta para seu terminal em espera.

<h3 id="execute-on-the-web">
  Executar na web
</h3>

Selecione **Approve Claude's plan and start coding** no seu navegador para que Claude o implemente na mesma sessão Claude Code na web. Seu terminal mostra uma confirmação, o indicador de status é limpo e o trabalho continua na nuvem. Quando a implementação terminar, [revise a diferença](/pt/claude-code-on-the-web#review-changes) e crie uma solicitação de pull a partir da interface web.

<h3 id="send-the-plan-back-to-your-terminal">
  Enviar o plano de volta para seu terminal
</h3>

Selecione **Approve plan and teleport back to terminal** no seu navegador para implementar o plano localmente com acesso total ao seu ambiente. Esta opção aparece quando a sessão foi iniciada a partir da sua CLI e o terminal ainda está pesquisando. A sessão web é arquivada para que não continue funcionando em paralelo.

Seu terminal mostra o plano em uma caixa de diálogo intitulada **Ultraplan approved** com três opções:

* **Implement here**: injete o plano em sua conversa atual e continue de onde parou
* **Start new session**: limpe a conversa atual e comece do zero com apenas o plano como contexto
* **Cancel**: salve o plano em um arquivo sem executá-lo; Claude imprime o caminho do arquivo para que você possa retornar a ele mais tarde

Se você iniciar uma nova sessão, Claude imprime um comando `claude --resume` no topo para que você possa retornar à sua conversa anterior mais tarde.

<h2 id="related-resources">
  Recursos relacionados
</h2>

* [Claude Code na web](/pt/claude-code-on-the-web): a infraestrutura de nuvem em que o ultraplan é executado
* [Modo de plano](/pt/permission-modes#analyze-before-you-edit-with-plan-mode): como o planejamento funciona em uma sessão local
* [Encontrar bugs com ultrareview](/pt/ultrareview): a contrapartida de revisão de código do ultraplan para detectar problemas antes da mesclagem
* [Remote Control](/pt/remote-control): use a interface claude.ai/code com uma sessão em execução em sua própria máquina