O editor do futuro, hoje. O Windsurf é um IDE de IA de próxima geração criado para manter você no fluxo. Nesta página, você encontrará instruções para instalar o Windsurf no seu computador, concluir o onboarding e iniciar seu primeiro projeto com IA.

Cascade

Seu chatbot agente que colabora com você como nunca.

Uso

Créditos e uso.

Terminal

Uma experiência de terminal aprimorada.

MCP

Os servidores MCP ampliam as capacidades do agente.

Memories

Memories e regras ajudam a personalizar o comportamento.

Context Awareness

Compreende sua base de código instantaneamente.

Advanced

Opções avançadas de configuração.

Workflows

Automatize fluxos de trabalho repetitivos.

App Deploys

Imple as aplicações com um clique.
Veja as novidades do Windsurf no nosso changelog!

​
Configuração

Para começar, verifique se o seu dispositivo atende aos requisitos, clique no link de download e siga as instruções para instalar e executar o Windsurf. Clique aqui se você estiver procurando como atualizar o Windsurf.
Versão mínima do SO: OS X Yosemite

​
Onboarding

Quando o Windsurf estiver em execução, você verá a página abaixo. Vamos começar! Vale lembrar que você pode reiniciar este fluxo de onboarding a qualquer momento usando o comando “Reset Onboarding”.

​
1. Selecionar o fluxo de configuração

Se você vem do VS Code ou do Cursor, pode importar suas configurações com facilidade. Caso contrário, selecione “Começar do zero”. Você também pode, opcionalmente, instalar o windsurf no PATH para poder executar windsurf pelo terminal.
Escolha aqui seus atalhos de teclado: os padrões do VS Code ou os do Vim.

​
2. Escolha o tema do editor

Escolha seu tema de cores favorito entre estas opções padrão! Não se preocupe, você sempre poderá mudar isso depois. Observe que, se você importou do VS Code, o tema importado substituirá este.

​
3. Crie uma conta / Faça login

Para usar o Windsurf, você precisa acessar com sua conta do Windsurf ou criar uma, caso ainda não tenha. O cadastro é totalmente gratuito!
Depois de se autenticar com sucesso, você verá esta página. Clique em “Open Windsurf” e pronto!

​
Com problemas?

Se você estiver com dificuldades neste fluxo de autenticação, também pode fazer login e fornecer manualmente um código de autenticação ao Windsurf.
Clique no botão “Copy link” para copiar um link de autenticação para a área de transferência e abra esse link no seu navegador.

​
4. Vamos navegar!

Plugins recomendados

Confira alguns dos nossos plugins recomendados para aproveitar ao máximo o Windsurf!

​
Atualizar o Windsurf

Para atualizar o Windsurf, clique no botão “Restart to Update ->” no canto superior direito da barra de menus.
Se você não estiver vendo esse botão, você pode:
  1. Clicar no menu do ícone de perfil > Check for Updates
  2. Na Paleta de Comando (Cmd/Ctrl+Shift+P) > “Check for Updates”

​
Coisas para experimentar

Agora que você abriu o Windsurf com sucesso, vamos testar alguns recursos! Todos eles ficam convenientemente acessíveis na página inicial. :)
No lado direito do IDE, você verá um novo painel chamado “Cascade”. Ele é seu assistente de código com IA! Você pode conversar, escrever código e executar código com o Cascade! Saiba mais sobre como ele funciona aqui.
Você pode criar projetos totalmente novos com o Cascade! Clique no botão “New Project” para começar.
Você pode abrir uma pasta ou conectar a um servidor remoto via SSH ou a um contêiner de desenvolvimento local. Saiba mais aqui.
Clique no botão “Windsurf - Settings” no canto inferior direito para abrir o painel de configurações. Para acessar as Configurações Avançadas, clique no botão nesse painel ou selecione “Windsurf Settings” no menu do perfil no canto superior direito.
Você pode abrir a Paleta de Comando com o atalho ⌘+⇧+P (no Mac) ou Ctrl+Shift+P (no Windows/Linux). Explore os comandos disponíveis!

​
Esqueceu de importar as configurações do VS Code?

Você pode importar facilmente suas configurações do VS Code/Cursor para o Windsurf caso decida fazer isso após o onboarding. Abra a Paleta de Comando (Mac: ⌘+⇧+P, Windows/Linux: Ctrl+Shift+P) e digite o seguinte:

​
Extensões incompatíveis

Há algumas extensões que são incompatíveis com o Windsurf. Isso inclui outras extensões de autocompletar de código com IA e extensões proprietárias. Não é possível instalar extensões por meio de nenhum marketplace no Windsurf.

​
Ícones de aplicativo personalizados (beta)

Para usuários pagos do Windsurf, é possível escolher entre diferentes ícones do Windsurf para o aplicativo no dock. No momento, esse recurso está disponível apenas no macOS; em breve estará disponível em outros sistemas operacionais. Para alterar o ícone do aplicativo, clique no ícone de perfil/ajustes no canto superior direito do editor e selecione “Personalizar ícone do aplicativo”.

​
Windsurf Next

Windsurf Next é a versão de pré-lançamento do Windsurf, na qual os usuários podem optar por aderir para acessar os recursos e funcionalidades mais recentes o mais cedo possível, mesmo que ainda não estejam totalmente finalizados. Normalmente, os recursos são lançados primeiro no Windsurf Next e, em seguida, na versão estável pouco depois. Você pode aderir ao Windsurf Next simplesmente baixando-o aqui.

​
Desinstalar o Windsurf

Para desinstalar o Windsurf do seu sistema, siga estas etapas:
1

Fechar o Windsurf

Certifique-se de que o Windsurf não esteja em execução antes de prosseguir com a desinstalação.
2

Excluir o aplicativo Windsurf

Arraste o aplicativo Windsurf da pasta Applications para a Lixeira.
3

Remover arquivos de configuração

Exclua a pasta de configuração do Windsurf:
rm -rf ~/.codeium/windsurf
4

Limpeza adicional

  • Se você adicionou o Windsurf ao PATH, remova-o da variável de ambiente PATH do sistema.
  • Se você instalou o Windsurf usando o gerenciador de pacotes do sistema ou o Painel de Controle, também pode usá-lo para desinstalar.
  • Esvazie a Lixeira ou a lixeira da Reciclagem para concluir a desinstalação.