Common Issues

Solutions for common problems and FAQs

Abaixo estão problemas comuns e suas soluções.

Networking Issues

Primeiro, confere tua conectividade de rede. Vai em Cursor Settings > Network e clica em Run Diagnostics. Isso vai testar tua conexão com os servidores do Cursor e ajudar a identificar qualquer problema de rede que possa estar afetando os recursos de IA, atualizações ou outras funcionalidades online.

O Cursor depende de HTTP/2 para recursos de IA porque lida com respostas em streaming de forma eficiente. Se tua rede não suporta HTTP/2, tu pode ter falhas de indexação e problemas com recursos de IA.

Isso acontece em redes corporativas, VPNs ou ao usar proxies como Zscaler.

Pra resolver, ativa o fallback pra HTTP/1.1 nas configurações do app (não nas configurações do Cursor): pressiona CMD/CTRL + ,, busca por HTTP/2 e ativa Disable HTTP/2. Isso força o uso de HTTP/1.1 e resolve o problema.

A gente planeja adicionar detecção e fallback automáticos.

Resource Issues (CPU, RAM, etc.)

Alto uso de CPU ou RAM pode deixar tua máquina lenta ou disparar alertas de recursos.

Embora bases de código grandes exijam mais recursos, o alto consumo geralmente vem de extensões ou de configurações.

Se tu tá vendo um alerta de pouca RAM no macOS, fica ligado que tem um bug pra alguns usuários que pode mostrar valores totalmente incorretos. Se isso estiver acontecendo, abre o Monitor de Atividade e olha a aba “Memory” pra ver o uso correto de memória.

Se tu tá enfrentando alto uso de CPU ou RAM, tenta estes passos:

Check Your Extensions

Extensões podem impactar a performance.

O Extension Monitor mostra o consumo de recursos de todas as tuas extensões instaladas e embutidas.

Ativa o monitor de extensões em Settings > Application > Experimental e alterna Extension Monitor: Enabled. Isso vai pedir pra reiniciar o Cursor.

Abre: Cmd/Ctrl + Shift + P → Developer: Open Extension Monitor.

O Cursor executa tuas extensões em um ou mais extension hosts. Geralmente, a maioria das tuas extensões roda no mesmo extension host, o que significa que uma extensão consumindo muito tempo de CPU pode sufocar as extensões vizinhas!

O Extension Monitor vai mostrar:

• Todo processo de longa duração iniciado por uma extensão (apenas macOS e Linux).
• % Ext Host: A porcentagem do tempo total do extension host consumida por essa extensão. Ajuda a identificar quais extensões estão usando mais tempo em relação às outras.
• Max Blocking: O maior bloco contínuo de execução de uma extensão, por intervalo de monitoramento.
• % CPU:
  • Para extensões: A porcentagem do uso total de CPU atribuída ao código da extensão.
  • Para processos: A porcentagem do uso total de CPU atribuída ao processo iniciado (apenas macOS e Linux).
• Memory:
  • Para extensões: A quantidade de memória de heap JS usada pelo código da extensão (alocações externas não contam).
  • Para processos: A quantidade de memória do sistema usada pelo processo iniciado (apenas macOS e Linux).

Tu também pode testar executando cursor --disable-extensions pela linha de comando. Se a performance melhorar, reativa as extensões uma a uma pra identificar as problemáticas.

Tenta o Extension Bisect pra identificar extensões problemáticas. Lê mais aqui. Observação: isso funciona melhor pra problemas imediatos, não pra degradação gradual de performance.

Use the Process Explorer

O Process Explorer mostra quais processos consomem recursos.

Abre: Command Palette (Cmd/Ctrl + Shift + P) → Developer: Open Process Explorer.

Revisa processos em:

• extensionHost: Problemas relacionados a extensões
• ptyHost: Consumo de recursos do terminal

O Process Explorer exibe cada terminal e seus comandos em execução pra diagnóstico.

Pra outros processos de alto consumo, relata no fórum.

Monitor System Resources

Usa as ferramentas de monitoramento do teu sistema operacional pra determinar se o problema é específico do Cursor ou do sistema como um todo.

Testing a Minimal Installation

Se os problemas persistirem, testa uma instalação mínima do Cursor.

FAQs gerais

Vejo uma atualização no changelog, mas o Cursor não atualiza

As novas versões são distribuídas em etapas — usuários aleatórios recebem primeiro. Teu app deve atualizar em alguns dias.

Estou com problemas no meu login do GitHub no Cursor / Como faço logout do GitHub no Cursor?

Usa Sign Out of GitHub no command palette Ctrl/⌘ + Shift + P.

Não consigo usar GitHub Codespaces

GitHub Codespaces ainda não é compatível.

Estou com erros ao conectar via Remote SSH

SSH para máquinas Mac ou Windows não é compatível. Para outros problemas, relata no fórum com logs.

Problemas de conexão SSH no Windows

Se aparecer “SSH is only supported in Microsoft versions of VS Code”:

1. Desinstala o Remote-SSH:

   • Abre a visualização de Extensões (Ctrl + Shift + X)
   • Busca por “Remote-SSH”
   • Clica no ícone de engrenagem → “Uninstall”

2. Instala o Anysphere Remote SSH:

   • Abre o marketplace do Cursor
   • Busca por “SSH”
   • Instala a extensão Anysphere Remote SSH

3. Após a instalação:

   • Fecha todas as instâncias do VS Code com conexões SSH ativas
   • Reinicia o Cursor
   • Reconecta via SSH

Verifica se tua configuração e chaves SSH estão corretamente definidas.

Cursor Tab e Inline Edit não funcionam atrás do meu proxy corporativo

Cursor Tab e Inline Edit usam HTTP/2 para menor latência e uso de recursos. Alguns proxies corporativos (por exemplo, Zscaler) bloqueiam HTTP/2. Corrige definindo "cursor.general.disableHttp2": true nas configurações (Cmd/Ctrl + ,, busca por http2).

Acabei de assinar o Pro, mas ainda estou no plano gratuito no app

Faz logout e login de novo nas Configurações do Cursor.

Quando meu uso vai resetar de novo?

Assinantes Pro: Clica em Manage Subscription no Dashboard pra ver a data de renovação.

Usuários Free: Confere a data do teu primeiro e-mail do Cursor. O uso reseta mensalmente a partir dessa data.

Meu histórico do Chat/Composer sumiu após uma atualização

Pouco espaço em disco pode fazer o Cursor limpar dados históricos durante atualizações. Pra evitar isso:

1. Mantém espaço livre suficiente em disco antes de atualizar
2. Limpa arquivos de sistema desnecessários regularmente
3. Faz backup de conversas importantes antes de atualizar

Como desinstalo o Cursor?

Segue este guia. Substitui “VS Code” ou “Code” por “Cursor”, e “.vscode” por “.cursor”.

Como excluo minha conta?

Clica em Delete Account no Dashboard. Isso exclui permanentemente tua conta e todos os dados associados.

Como abro o Cursor pela linha de comando?

Executa cursor no teu terminal. Se o comando não existir:

1. Abre o command palette ⌘⇧P
2. Digita install command
3. Seleciona Install 'cursor' command (opcionalmente instala o comando code pra substituir o do VS Code)

Não consigo fazer login no Cursor

Se clicar em Sign In redireciona pra cursor.com mas não te autentica, desativa teu firewall ou antivírus — eles podem estar bloqueando o processo de login.

Mensagem de atividade suspeita

Devido ao aumento recente de uso indevido do nosso sistema, tua solicitação pode ter sido bloqueada como medida de segurança. Como resolver:

Primeiro, confere tua VPN. Se estiver usando, tenta desligar, porque VPNs às vezes acionam nossos sistemas de segurança.

Se isso não resolver, tu pode tentar:

• Criar um novo chat
• Esperar um pouco e tentar de novo depois
• Criar uma nova conta usando autenticação do Google ou GitHub
• Fazer upgrade pro Cursor Pro