Cursor não abre ou trava ao iniciar? Como descobrir se é extensão, cache, conta ou o serviço

Fala aí, beleza? Tu clica no ícone do Cursor e… nada

Ou abre uma janela branca, ou fica carregando pra sempre, ou o login funciona no navegador e o editor continua parado em Sign In 😛

O roteiro aqui segue sempre a mesma ordem: primeiro você confere se o problema é do serviço, depois isola a causa na sua máquina (extensão, estado e cache, rede, conta) e só no fim pensa em resetar ou abrir chamado

Editor tem causas bem próprias, então bora por partes

É o Cursor fora do ar ou é a sua máquina? Comece pela página de status

A primeira checagem é a página de status do Cursor, onde a Anysphere publica os incidentes oficiais

Se liga num detalhe: a página não mostra um status único, ela separa componentes, entre eles IDE, CLI, Cloud Agents e cursor.com

Então olha o componente certo

Se o problema é o editor desktop que não abre, o que importa é o IDE, e não o site ou os Cloud Agents

Mas tome cuidado: tudo verde não garante que vai funcionar pra você

Mesmo com o serviço operacional, falha de extensão, de autenticação ou de rota de rede continua acontecendo do seu lado

Como prevenir: consulta o status ANTES de sair apagando arquivo. Se tem incidente aberto no IDE, a melhor jogada é esperar e não mexer em nada

Cursor trava ao iniciar por causa de extensão: como iniciar sem extensões

Sintoma: o editor abre lento, trava depois de carregar, ou abre mas o Tab e a edição inline ficam esquisitos

Por quê? Segundo a ajuda oficial do Cursor sobre extensões, as que mais conflitam com o Cursor são outros assistentes de código com IA, que têm autocomplete próprio, e as que capturam atalhos de teclado

Faz sentido né? São dois copilotos brigando pelo mesmo Tab haha

O teste isolado é abrir o Cursor sem nenhuma extensão e ver se o problema some:

1. Fecha o Cursor e abre pelo terminal com as extensões desligadas:

cursor --disable-extensions

2. Se o editor abriu normal, a culpada é uma extensão. Reativa uma por vez até o problema voltar, e aí tu achou a responsável
3. Se o Cursor até abre, dá pra fazer o mesmo por dentro: paleta de comandos > Disable All Installed Extensions, depois reativa uma por vez

O erro comum aqui é reativar tudo de uma vez e perder a pista de qual extensão causou o travamento

E se o editor abriu mas parou de responder no meio do trabalho? Um contorno temporário relatado no fórum é o Ctrl+Shift+P > Reload Window, que destrava o extension host sem reiniciar o Cursor inteiro

É contorno, não correção: se repetir, volta pro teste sem extensões

Esse raciocínio de separar conta, extensão e serviço é o mesmo de quando o GitHub Copilot não funciona no VS Code

Como prevenir: evita deixar dois assistentes de IA ativos ao mesmo tempo no Cursor

Tela branca ou travada na abertura: estado e cache corrompidos

Sintoma: a janela fica branca, preta ou congelada antes de carregar qualquer coisa

A causa mais citada no fórum é o state.vscdb

Que arquivo é esse? É o banco de estado global do Cursor. Ele cresce com o tempo e, grande ou corrompido, pode travar a inicialização

Outra suspeita são os caches do Electron (GPU, código e etc)

No Windows:

1. Fecha o Cursor e confere no Gerenciador de Tarefas se ele fechou de verdade, sem processo sobrando em segundo plano
2. Vai em %APPDATA%\Cursor\User\globalStorage\ e renomeia state.vscdb para state.vscdb.old e state.vscdb.backup para state.vscdb.backup.old
3. Abre o Cursor de novo
4. Se continuar travado, fecha tudo (confere de novo no Gerenciador de Tarefas) e apaga %LOCALAPPDATA%\Cursor\GPUCache e %LOCALAPPDATA%\Cursor\Code Cache
5. Outra correção relatada no fórum para tela branca: com o Cursor fechado, apaga %APPDATA%\Cursor\CachedData e reinicia o PC

Repara que no Windows o cache fica espalhado em DUAS pastas: %APPDATA%\Cursor e %LOCALAPPDATA%\Cursor

Quem limpa só uma delas costuma achar que não resolveu

No macOS:

O arquivo fica em ~/Library/Application Support/Cursor/User/globalStorage/state.vscdb, junto com o state.vscdb.backup

A orientação da equipe do Cursor no fórum é:

• Checar o tamanho do state.vscdb
• Fazer uma cópia dele e do backup
• Apagar SÓ esses dois arquivos
• Reabrir o Cursor, que recria o banco sozinho

Tome cuidado: não apaga a pasta Cursor inteira, o problema está só nesse banco

E no Linux?

Pra globalStorage no Linux eu não tenho caminho verificado, então não vou te mandar apagar nada às cegas

No Linux, usa o teste sem extensões e a parte de workspaceStorage logo abaixo, que tem caminho confirmado

Como prevenir: sempre faz cópia antes de apagar e, de tempos em tempos, dá uma olhada no tamanho do state.vscdb

Janela em branco só ao abrir um projeto específico

Sintoma: o Cursor abre normal, mas um workspace específico fica com a janela em branco

Aqui a suspeita é o estado de layout daquele workspace, que pode corromper

Apagar a pasta workspaceStorage resolveu para alguns usuários no fórum:

• Windows: %APPDATA%\Cursor\User\workspaceStorage
• macOS: ~/Library/Application Support/Cursor/User/workspaceStorage
• Linux: ~/.config/Cursor/User/workspaceStorage

Agora o aviso importante: isso perde o histórico de chat

Já pensou apagar meses de conversa com a IA por causa de uma janela branca? Pois é…

Como prevenir: renomeia a pasta (algo como workspaceStorage.old) em vez de apagar. Se não resolver, é só voltar o nome original

Tela preta ou branca no Windows: driver de vídeo

Se a janela fica preta ou branca e nada acima resolveu, olha o driver de vídeo

A indicação do fórum é que o driver instalado pelo Windows Update pode conflitar com o sandbox do Chromium, que roda por baixo do Cursor

Solução: baixa o driver direto do site oficial da fabricante da sua placa (NVIDIA, AMD ou Intel) e instala por cima

Como prevenir: mantém o driver atualizado pela fabricante, e não só pelo Windows Update

Cursor abre, mas não conecta: rede, proxy e firewall

Sintoma: o editor abre, mas a IA não responde, fica num carregamento infinito ou mostra erro de conexão

O Cursor tem um diagnóstico de rede embutido: Cursor Settings > Network > Run Diagnostics

Ele testa a conexão com os servidores do Cursor, então é o primeiro passo antes de culpar qualquer coisa

Proxy corporativo bloqueando HTTP/2

Aqui vale entender o porquê: o Cursor usa HTTP/2 pra fazer streaming das respostas, e alguns proxies corporativos (o Zscaler é um exemplo) bloqueiam HTTP/2

A correção oficial, descrita na ajuda de rede do Cursor:

1. Abre Cursor Settings > Network
2. Muda o HTTP Compatibility Mode para HTTP/1.1
3. Reinicia o Cursor

O erro comum é mudar a opção e não reiniciar, aí parece que não funcionou

Domínios que o firewall precisa liberar

Se a rede da empresa filtra tudo, estes domínios precisam estar liberados:

*.cursor.sh
*.cursor-cdn.com
*.cursorapi.com
*.cursorvm.com

O .cursor.sh inclui authenticate.cursor.sh e authenticator.cursor.sh, e o .cursorapi.com inclui o marketplace.cursorapi.com

Usa Remote SSH?

Se liga nessa pegadinha: no Remote SSH, as requisições de IA saem da sua máquina local para os servidores do Cursor, e não do host remoto

Ou seja, quem precisa de internet funcionando é o seu PC, não o servidor

Teste isolado: troca de rede (um roteador do celular serve) ou desliga a VPN. Se funcionar fora da rede da empresa, o problema está no caminho, não no Cursor

Como prevenir: pede pra TI liberar os domínios da lista acima de uma vez

Login não conclui e o Cursor fica parado em Sign In

Sintoma: tu faz login no navegador, dá tudo certo lá, mas o retorno não chega no app e o IDE continua parado em Sign In

O ponto-chave é o aviso pra abrir o link cursor://, que é o jeito do navegador devolver o login pro editor

1. Depois de logar no navegador, confere se aparece o aviso pedindo pra abrir cursor:// e aceita
2. Se o aviso não aparecer e você está no Windows, roda o Cursor como administrador uma vez e tenta de novo
3. Se ainda empacar, os outros passos relatados no fórum são: sair e entrar de novo na conta, limpar o cache do navegador para cursor.com, testar sem VPN e com firewall ou antivírus desligado temporariamente
4. Por último, abre as Settings (Ctrl+Shift+, no Windows/Linux ou Cmd+Shift+, no Mac), muda Http: Proxy Support de override para on e reinicia o Cursor

Tome cuidado no passo 3: firewall e antivírus desligados é só pra testar, liga tudo de volta depois

Se tu também usa o Claude Code e o login dele empaca de um jeito parecido, tem um guia de erros ao instalar o Claude Code com esse cenário

Como prevenir: em rede corporativa, garante que authenticate.cursor.sh e authenticator.cursor.sh estejam liberados

Antes de reinstalar o Cursor: como resetar sem perder configurações

Antes de partir pro next, next e finish, tem um reset que não destrói nada: renomear a pasta de dados em vez de apagar

Por que renomear? Porque o Cursor, ao abrir, não acha a pasta antiga e começa limpo, enquanto a sua cópia continua lá, intacta, caso você precise recuperar alguma coisa

No macOS, o comando relatado no fórum é:

cd ~/Library/Application\ Support/ && mv Cursor CursorBackup

Depois é só abrir o Cursor

Como checar o resultado: o Cursor abre limpo e a pasta CursorBackup continua no mesmo lugar, com tudo dentro

Se resolveu, você recupera o que precisar da cópia com calma

No Windows e no Linux a lógica é a mesma (renomear em vez de apagar), mas eu não tenho um comando de reset verificado pra esses sistemas, então prefiro não te passar um palpite

Nesses casos, fica com os passos de state.vscdb e workspaceStorage das seções acima

Quando abrir chamado no fórum do Cursor e o que mandar

Hora de escalar: o status está operacional, o Cursor continua quebrado sem extensões, o estado já foi renomeado e outra rede também não resolveu

Aí não adianta insistir, o caminho é o fórum oficial do Cursor, que é o canal indicado pra reportar bugs

Antes de postar, junta as provas:

• Versão e sistema: Cursor > Help > About
• Erros do console: Cursor > Help > Toggle Developer Tools > Console
• Request ID, se o problema envolve o chat: abre a conversa no Chat, menu ... > Copy Request ID

No post, inclui:

• Versão do Cursor e sistema operacional
• Passos pra reproduzir o problema
• O que você esperava que acontecesse e o que aconteceu de fato
• Prints ou gravação de tela
• Request ID e erros do console

O erro comum é postar só "meu Cursor não abre, alguém ajuda?" sem versão e sem console

Aí a primeira resposta vai ser pedir essas informações, e você perde uma rodada inteira de conversa

Backup antes de mexer em pasta: o lado da segurança

Boa parte deste roteiro envolve renomear ou apagar pasta de dados, então vale pensar em backup como hábito, e não como plano B

No canal tem um vídeo sobre como uma IA pode apagar arquivos do seu PC e como se proteger usando Claude Code, Codex e Cursor

Vale assistir pra criar o hábito de proteger seus arquivos antes de deixar qualquer agente de IA mexer em pasta, e fugir dos rm -rf da vida 😅

Próximo passo se o Cursor não abre agora

Salva essa ordem em algum lugar fácil: status, sem extensões, renomear state.vscdb, rede, login, fórum

Quando o Cursor quebrar de novo, tu segue a lista em vez de sair apagando pasta no desespero

E se ele está funcionando agora, aproveita: faz uma cópia da pasta de dados do Cursor enquanto ela está saudável

No dia que precisar renomear alguma coisa, você já tem um ponto de volta garantido 🙂

Até o próximo post!

Perguntas frequentes

Limpar o cache ou renomear a pasta de dados do Cursor apaga os arquivos do meu projeto?

Não. Todo esse processo mexe só nos dados internos do Cursor (cache, state.vscdb, workspaceStorage), que ficam em pastas separadas da sua pasta de projeto. O código do seu repositório continua intacto onde ele estava antes.

Quer aprender mais sobre inteligência artificial e programação na prática? Conheça o canal Hora de Codar no YouTube e acompanhe os próximos vídeos.