Pular para o conteúdo principal

​
Perguntas frequentes gerais

Primeiro, aguarde alguns minutos para atualizar. Se não funcionar, tente sair do Windsurf no site, reiniciar seu IDE e entrar novamente no Windsurf. Além disso, verifique se você está com a versão mais recente do Windsurf instalada.
Você pode cancelar seu plano pago acessando seu Perfil ao clicar no seu ícone no canto superior direito do site do Windsurf.Para cancelar sua assinatura Pro, vá até a página Cobrança no painel de navegação à esquerda e clique em “Cancel Plan”.Para cancelar sua assinatura Teams, vá até a página Manage Team no painel de navegação à esquerda e clique em “Cancel Plan”.
Conforme mencionado em nossa página de segurança, você pode desativar a telemetria de trechos de código acessando suas configurações de conta. Para mais informações, consulte nossos Termos de Serviço.
Você pode excluir sua conta acessando suas configurações de conta, rolando até o final e clicando em “Delete Account”.
Se você for membro de uma organização, entre em contato com seu administrador.
Você pode votar, comentar e solicitar recursos em nosso fórum de solicitações de recursos.Você também pode falar conosco no Twitter/X! @windsurf

​
Estou enfrentando problemas com limite de taxa

Estamos sujeitos a limites de taxa e, infelizmente, às vezes atingimos a capacidade dos modelos de IA premium com os quais trabalhamos. Estamos trabalhando ativamente para aumentar esses limites e distribuir de forma justa a capacidade disponível! Isso não deve ser um problema permanente. Se você receber esse erro, aguarde alguns instantes e tente novamente.

​
Pylance ou Pyright não está funcionando / Realce de sintaxe em Python está com problema ou aquém do ideal

Nós desenvolvemos uma extensão do Pyright especificamente para o Windsurf. Procure por “Windsurf Pyright” ou cole @id:codeium.windsurfPyright na pesquisa de extensões.

​
Como faço para baixar os logs de diagnóstico para enviar à equipe de suporte da Windsurf?

Você pode baixar os logs de diagnóstico acessando o painel do Cascade, clicando nos três pontos no canto superior direito e, em seguida, selecionando “Download Diagnostics”.

​
No macOS, vejo um pop-up: ‘Windsurf’ está danificado e não pode ser aberto.

Esse pop-up ocorre devido a um falso positivo nos recursos de segurança do macOS. Normalmente, você pode resolver indo em “Ajustes do Sistema -> Privacidade e Segurança” e clicando em “Permitir” ou “Abrir mesmo assim” para o Windsurf. Se isso não funcionar ou não for possível, tente o seguinte:
  1. Certifique-se de que o Windsurf esteja na pasta /Applications e que você o esteja executando a partir de lá.
  2. Verifique o tipo de processador: se o seu Mac tiver um chip Intel, garanta que você tenha a versão para Intel. Se for Apple Silicon (como M1, M2 ou M3), garanta que você tenha a versão para Apple Silicon. Você pode selecionar o tipo de processador na página de download para Mac.
  3. Tente baixar novamente o DMG e reinstalar a partir da página oficial de download, pois o recurso de segurança que falha geralmente é acionado no download.
  4. Certifique-se de que o Windsurf (e o pop-up “Windsurf está danificado”) esteja fechado e execute xattr -c "/Applications/Windsurf.app/".

​
Recebi uma mensagem de erro sobre atualizações no Windows, ou as atualizações não estão aparecendo no Windows.

Por exemplo:
As atualizações estão desativadas porque você está executando a instalação do Windsurf no escopo de usuário como Administrador.
Não é possível atualizar o Windsurf automaticamente quando ele é executado como Administrador. Reinicie o Windsurf no escopo de usuário para atualizar.

​
No macOS, o Remote SSH falha com “Undefined error: 0”, mas o SSH funciona no Terminal

Se o Remote SSH no Windsurf falhar imediatamente enquanto a mesma conexão SSH funciona no Terminal, no VS Code ou em outros aplicativos, isso geralmente é causado pelo macOS bloqueando o acesso de rede local do Windsurf. No log de saída do Remote - SSH (View → Output → Remote - SSH), você verá: 
debug1: Connecting to <hostname> port 22.
ssh: connect to host <hostname> port 22: Undefined error: 0
seguido por SSH server closed unexpectedly. Error code: 255. A mensagem Undefined error: 0 (em vez de “Connection refused” ou “Network unreachable”) é o principal indicativo — este é o erro que o macOS retorna quando um aplicativo não recebe permissão de Rede Local em Privacidade & Segurança. Para corrigir isso:
  1. Abra Configurações do Sistema → Privacidade & Segurança → Rede Local.
  2. Encontre Windsurf na lista e ative a opção.
  3. Reinicie o Windsurf e tente a conexão novamente.
Se o Windsurf não aparecer na lista de Rede Local, tente iniciar primeiro uma conexão SSH a partir do Windsurf para acionar o prompt de permissão do macOS. Se o prompt tiver sido ignorado anteriormente e a opção não aparecer, desinstalar e reinstalar o Windsurf fará com que o prompt seja exibido novamente no próximo início.

​
Quais domínios devo incluir na lista de permissões para filtros/firewalls de rede, VPNs ou proxies?

Se você utiliza filtragem de rede, firewalls, serviços de VPN ou trabalha em ambientes com acesso de rede restrito, pode enfrentar problemas de conectividade com o Windsurf. Para garantir o funcionamento adequado, inclua os seguintes domínios na lista de permissões da sua configuração de rede:
  • *.codeium.com
  • *.windsurf.com
  • *.codeiumdata.com

​
No Linux, o Windsurf não inicia silenciosamente ou trava ao iniciar

Isso geralmente acontece por causa de um problema de permissões do Electron — o mesmo que ocorre no VSCode — e é esperado ao usar o tarball no Linux. A maneira mais simples de corrigir é executar o seguinte: 
            sudo chown root:root /caminho/para/windsurf/chrome-sandbox
            sudo chmod 4755 /caminho/para/windsurf/chrome-sandbox
Você deverá conseguir abrir o Windsurf. Você também pode simplesmente executar windsurf com a opção --no-sandbox, embora não recomendemos isso. Se isso não funcionar, tente o seguinte.

​
Recebi uma mensagem de erro dizendo “Windsurf failed to start”

Aviso: excluir essas pastas removerá seu histórico de conversas e as configurações locais!
Exclua a seguinte pasta: Windows: C:\Users\<YOUR_USERNAME>\.codeium\windsurf\cascade Linux/Mac: ~/.codeium/windsurf/cascade e tente reiniciar o IDE.

​
Meu painel do Cascade fica em branco

Entre em contato conosco se isso acontecer! Um vídeo da tela seria muito bem‑vindo. Isso geralmente pode ser resolvido limpando o histórico do Chat (~/.codeium/windsurf/cascade).

​
Sessão do terminal parece travada no Cascade

Se um comando no terminal tiver terminado de ser executado, mas o Cascade ainda mostrar a sessão como em andamento ou travada, isso pode ser causado por vários problemas: Perfil padrão do terminal não definido Isso pode ser causado pelo fato de o perfil padrão do terminal não estar definido explicitamente. Para resolver isso, você pode definir o perfil padrão do terminal nas configurações do editor. Abra a interface de Configurações (Cmd/Ctrl + ,), pesquise por “terminal default profile” e defina o valor apropriado para o seu sistema operacional. Como alternativa, você pode adicionar o seguinte ao seu settings.json: Para macOS: 
"terminal.integrated.defaultProfile.osx": "zsh"
Para Windows: 
"terminal.integrated.defaultProfile.windows": "PowerShell"
Para Linux: 
"terminal.integrated.defaultProfile.linux": "bash"
Substitua o valor pelo shell de sua preferência (por exemplo, bash, zsh, PowerShell, Command Prompt, etc.). Temas zsh personalizados Em alguns casos, um tema zsh altamente personalizado (por exemplo, temas do Oh My Zsh, Powerlevel10k ou outros frameworks de prompt) também pode fazer com que o Cascade considere que um comando ainda está em execução mesmo depois que ele termina. Para verificar se esse é o problema:
  1. Abra o seu arquivo ~/.zshrc em um editor de texto.
  2. Desative temporariamente o seu tema comentando as linhas que o definem ou carregam, como ZSH_THEME="...", source ~/.p10k.zsh ou eval "$(oh-my-posh init zsh)".
  3. Salve o arquivo, reinicie o Windsurf (ou abra um novo terminal no Windsurf) e execute um comando novamente.
Se a sessão do terminal não parecer mais travada no Cascade, você pode manter um tema mais simples em ~/.zshrc ou criar uma configuração zsh separada e mínima, usada apenas pelo terminal do Windsurf, para que seus outros terminais possam continuar usando o tema mais complexo. Rastreamento de contexto de terminal do systemd (Linux) Em algumas distribuições Linux mais recentes (relatado no Fedora 43 e posteriores), a cadeia de inicialização do shell (~/.bashrc → /etc/bashrc → /etc/profile.d/80-systemd-osc-context.sh) pode ativar o “rastreamento de contexto de terminal” do systemd, que emite sequências de escape OSC 3008 via PS0 ou PROMPT_COMMAND. Essas sequências de controle extras podem interferir na análise da saída do Cascade, fazendo com que um comando pareça travado ou resultando em uma saída capturada que pareça ausente ou truncada — mesmo que o terminal a exiba corretamente. Para contornar esse problema, evite que as sequências de contexto OSC sejam emitidas no terminal do Cascade, deixando de fazer source de /etc/bashrc a partir do seu ~/.bashrc, ou criando um arquivo de configuração de shell mínimo usado apenas para o Windsurf/Cascade.

​
Container Docker não visível no Remote Explorer ao usar WSL

Ao se conectar a contêineres Docker dentro do WSL, a janela do Remote Explorer pode não exibir os contêineres disponíveis para conexão, exigindo que os usuários usem a solução alternativa pela Paleta de Comando. Use Cmd+P (macOS) ou Ctrl+P (Windows) → “Dev Containers: Attach to Running Container” para ver a lista completa de contêineres em execução.