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

# Modos do Cascade

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

O Cascade oferece três modos distintos, cada um com um conjunto diferente de recursos, projetados para fluxos de trabalho específicos.

| Modo               | Caso de uso                                       | Ferramentas                       |
| ------------------ | ------------------------------------------------- | --------------------------------- |
| [Code](#code-mode) | Funcionalidades complexas, refatoração            | Todas as ferramentas ativadas     |
| [Plan](#plan-mode) | Funcionalidades complexas que exigem planejamento | Todas as ferramentas ativadas     |
| [Ask](#ask-mode)   | Aprendizado, planejamento, dúvidas                | Apenas as ferramentas de pesquisa |

Você pode alternar entre os diferentes modos usando o seletor de modo abaixo da caixa de entrada do Cascade ou usando o atalho de teclado `⌘+.` (Mac) ou `Ctrl+.` (Windows/Linux).

<div id="code-mode">
  ## Modo Code
</div>

O **modo Code** é o modo totalmente baseado em agente padrão do Windsurf, projetado para fazer alterações na sua base de código.

No modo Code, o Cascade pode:

* Criar, editar e excluir arquivos
* Executar comandos de terminal
* Pesquisar e analisar sua base de código
* Instalar dependências
* Executar tarefas de múltiplas etapas de forma autônoma

Use o modo Code quando quiser que o Cascade trabalhe ativamente no seu projeto e implemente mudanças.

<Tip>Recomendamos que você use o modo Code como seu modo padrão para a maior parte das tarefas.</Tip>

<div id="plan-mode">
  ## Modo de planejamento
</div>

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

No modo de planejamento, o Cascade irá:

* Explorar sua base de código para entender o estado atual
* Fazer perguntas para esclarecer dúvidas e garantir que o plano esteja alinhado com seus objetivos
* Fornecer 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

Quando o Cascade terminar, você poderá clicar em "Implement" no arquivo do plano para alternar automaticamente para o modo Código e começar a implementar o plano.

<Frame caption="No modo de planejamento, o Cascade frequentemente faz perguntas de múltipla escolha para esclarecer seus requisitos">
  <img style={{ maxHeight: "500px" }} src="https://mintcdn.com/codeium/7b7uIe0WThZtJJHO/assets/windsurf/cascade/cascade-questions.png?fit=max&auto=format&n=7b7uIe0WThZtJJHO&q=85&s=e78c8a5a8227b5f8fbba3b81ca069454" width="1196" height="698" data-path="assets/windsurf/cascade/cascade-questions.png" />
</Frame>

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

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

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

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

<div id="exiting-plan-mode">
  ### Saindo do modo de plano
</div>

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

* Clique no botão "Implement" no arquivo do plano
* Altere o modo para Code na caixa de entrada
* Deixe o agente alternar *automaticamente* para o modo Code quando detectar que você está pronto para implementar

<div id="ask-mode">
  ## Modo Ask
</div>

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

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