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

# Modos do Cascade

> O Devin Desktop oferece vários modos de agente distintos, cada um otimizado para diferentes tipos de tarefas.

O Devin Desktop oferece três modos de agente distintos, cada um com um conjunto diferente de recursos voltados a fluxos de trabalho específicos.

| Mode | Use case | Tools |
| - | - | - |
| [Code](#code-mode) | Recursos complexos, refatoração | Todas as ferramentas ativadas |
| [Plan](#plan-mode) | Recursos complexos que exigem planejamento | Todas as ferramentas ativadas |
| [Ask](#ask-mode) | Aprendizado, planejamento, perguntas | Apenas ferramentas de busca |

Você pode alternar entre os diferentes modos usando o seletor de modo abaixo do campo de entrada ou com o atalho de teclado `⌘+.` (Mac) ou `Ctrl+.` (Windows/Linux). O seletor também oferece modos de permissão, que controlam o quanto o agente pergunta antes de agir — consulte [Permissões](/pt-BR/cli/reference/permissions).

<h2 id="code-mode">
  Modo de Código
</h2>

O **modo Code** é o modo totalmente autônomo padrão do Devin Desktop, projetado para fazer alterações na sua base de código.

No modo Code, o agente pode:

* Criar, editar e excluir arquivos
* Executar comandos no terminal
* Pesquisar e analisar sua base de código
* Instalar dependências
* Executar tarefas com várias etapas de forma autônoma

Use o modo Code quando quiser que o agente trabalhe ativamente no seu projeto e implemente alterações.

<Tip>Recomendamos usar o modo Code como modo padrão para a maioria das tarefas.</Tip>

<h2 id="plan-mode">
  Plan Mode
</h2>

O **modo Plan** ajuda você a pensar em tarefas complexas criando um plano de implementação detalhado antes de escrever qualquer código.

No modo Plan, o agente vai:

* Explorar sua base de código para entender o estado atual
* Fazer perguntas para esclarecer pontos e garantir que o plano esteja alinhado aos seus objetivos
* Apresentar várias opções para você escolher em uma interface interativa
* Apresentar um plano detalhado, escrito em um arquivo Markdown externo, com etapas de implementação

O arquivo do plano fica fora do seu repositório e persiste durante a sessão, portanto o planejamento pode abranger várias mensagens. Quando o agente terminar, ele pedirá para iniciar a implementação — ou você pode clicar em "Implement" no arquivo do plano para alternar para o modo Code e começar.

<h3 id="planning-more-deeply">
  Planejamento mais aprofundado
</h3>

Incluir a palavra-chave `megaplan`, `ultraplan` ou `masterplan` em qualquer ponto da sua mensagem alterna a conversa para o modo Plan e faz o agente planejar mais detalhadamente, fazendo pelo menos uma pergunta para esclarecer pontos antes de escrever o plano. O modo anterior é restaurado quando você remove a palavra-chave.

<Frame caption="No modo Plan, o Cascade costuma fazer perguntas de múltipla escolha para esclarecer seus requisitos">
  <img style={{ maxHeight: "500px" }} src="https://mintcdn.com/cognitionai/hxeMffzXgF_RWx-U/desktop/assets/windsurf/cascade/cascade-questions.png?fit=max&auto=format&n=hxeMffzXgF_RWx-U&q=85&s=1fe92e67df16b83e30f5d59d42b94ae3" width="1196" height="698" data-path="desktop/assets/windsurf/cascade/cascade-questions.png" />
</Frame>

<h3 id="continuing-from-a-plan">
  Continuando a partir de um plano
</h3>

O arquivo Markdown criado no modo Plan pode ser particularmente útil para continuar o trabalho ao longo de várias sessões.

Os planos são armazenados no seu diretório `~/.windsurf/plans` ou `~/.devin/plans`, dependendo do agente, e ficam disponíveis no menu [@mentions](/pt-BR/desktop/chat/overview#%40-mentions).
Ao mencionar um arquivo do plano, você pode continuar a implementação com um novo contexto.

Isso pode ser particularmente útil quando uma implementação inicial não saiu como esperado: basta descartar as alterações originais, ajustar o arquivo de plano e clicar em "Implement" para tentar implementar novamente em uma nova conversa.

<h3 id="exiting-plan-mode">
  Saindo do modo Plan
</h3>

Existem várias maneiras de passar do planejamento para a implementação:

* Clique no botão "Implement" no arquivo do plano
* Aprove a solicitação do agente para sair do modo Plan quando o plano estiver pronto
* Altere seu modo para o modo Code no campo de entrada
* Deixe o agente alternar *automaticamente* para o modo Code quando detectar que você está pronto para implementar

<h2 id="ask-mode">
  Modo Ask
</h2>

O **modo Ask** é um modo somente leitura otimizado para perguntas e exploração.

No modo Ask, o agente pode pesquisar e analisar sua base de código, mas não pode fazer alterações.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.