> ## 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.
# Visão geral do Cascade
> O Cascade traz programação baseada em agentes com IA para o JetBrains, com modos Write/Chat, entrada por voz, acesso a ferramentas, modo turbo e colaboração em tempo real.
O Cascade do Windsurf traz o melhor da programação baseada em agentes para a suíte JetBrains.
Para abrir o Cascade, pressione `Cmd/Ctrl+L` ou clique no ícone do Cascade.
# Seleção de modelo
Selecione o modelo de IA desejado no menu abaixo da caixa de entrada da conversa do Cascade. Clique abaixo para ver a visão geral completa dos modelos disponíveis e sua disponibilidade em diferentes planos e faixas de preço.
Disponibilidade de modelos no Windsurf.
# Modos Write/Chat
O Cascade tem dois modos: **Write** e **Chat**.
O modo Write permite que o Cascade crie e faça modificações na sua base de código, enquanto o modo Chat é otimizado para perguntas sobre sua base de código ou sobre princípios gerais de programação.
# Mensagens na fila
Enquanto você aguarda o Cascade concluir a tarefa atual, é possível colocar novas mensagens na fila para serem executadas em ordem assim que a tarefa terminar.
Para adicionar uma mensagem à fila, basta digitar enquanto o Cascade estiver trabalhando e pressionar `Enter`.
* **Enviar imediatamente**: Pressione Enter novamente em uma caixa de texto vazia para enviar na hora.
* **Excluir**: Remova qualquer mensagem da fila antes que ela seja enviada
# Acesso a ferramentas
O Cascade tem uma variedade de ferramentas à disposição, como Search, Analyze, [Web Search](/pt-BR/windsurf/cascade/web-search) e o [terminal](/pt-BR/windsurf/terminal).
Ele consegue detectar quais pacotes e ferramentas você está usando, quais precisam ser instalados e até instalá-los para você. Basta pedir ao Cascade para executar seu projeto e clicar em Accept.
O Cascade pode fazer até 25 chamadas de ferramenta por prompt. Se a execução parar, basta digitar `continue` e o Cascade retomará de onde parou. Cada `continue` contará como um novo prompt.
# Entrada de voz
Use a Entrada de voz para interagir com o Cascade usando a sua voz. Na versão atual, ele transcreve sua fala em texto.
# Reverter para etapas anteriores
Você pode reverter as alterações feitas pelo Cascade, se quiser. Basta passar o mouse sobre o prompt original e clicar na seta de reversão à direita ou reverter diretamente pelo sumário. Isso restaurará todas as alterações de código para o estado da sua base na etapa desejada.
As reversões não podem ser desfeitas no momento. Tenha cuidado!
# Modos de autoexecução
Cascade oferece três níveis de autoexecução de comandos no JetBrains: **Off**, **Auto** e **Turbo**. Você pode selecionar o nível preferido no painel de configurações do Windsurf.
| Nível | Descrição |
| --------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| **Off** | Nunca autoexecutar comandos de terminal, exceto aqueles na sua lista de permissões (allow list). |
| **Auto** | O modelo de IA decide se deve autoexecutar comandos com base em uma avaliação de segurança. Disponível apenas com modelos de IA premium. |
| **Turbo** | Sempre autoexecutar comandos de terminal e controles do navegador, exceto aqueles na sua lista de bloqueio (deny list). |
Para usuários dos planos Teams e Enterprise, os administradores podem definir um nível máximo permitido de autoexecução. Os usuários podem selecionar qualquer nível até esse máximo, mas não podem excedê-lo.
Para mais detalhes sobre níveis de autoexecução e listas de permissões/bloqueio (allow/deny lists), consulte a [documentação do Terminal](/pt-BR/windsurf/terminal#auto-executed-cascade-commands).
# Colaboração em tempo real
Um diferencial do Cascade é que ele percebe suas ações em tempo real.
Você não precisa mais fornecer contexto sobre suas ações anteriores, pois o Cascade já está ciente.
Tente fazer uma alteração manual no editor de código e, em seguida, peça ao Cascade para “continuar meu trabalho”!
# Ignorando arquivos
Se você quiser que o Cascade ignore arquivos, adicione-os ao `.codeiumignore` na raiz do seu workspace. Isso impedirá que o Cascade visualize, edite ou crie arquivos nos caminhos especificados. Você pode declarar os caminhos de arquivo em um formato semelhante ao do `.gitignore`.
## .codeiumignore global
Para clientes Enterprise que gerenciam vários repositórios, é possível aplicar regras de exclusão em todos eles colocando um arquivo `.codeiumignore` global na pasta `~/.codeium/`. Essa configuração global se aplicará a todos os workspaces do Windsurf no seu sistema e funcionará em conjunto com quaisquer arquivos `.codeiumignore` específicos de cada repositório.