Problemas de rede no Cursor: proxy, diagnóstico e correção de HTTP/2

Um pequeno círculo fica girando por cinco minutos no canto inferior direito do Cursor. No meio do código, a IA perde a conexão de repente e mostra Network request failed. Você volta ao navegador: o vídeo do YouTube roda sem travar, e o ping para o Google fica em apenas 20 ms.

No dia seguinte, já na rede interna da empresa, o departamento de TI configurou várias camadas de proxy e o Cursor simplesmente se recusa a iniciar. O log está cheio de ERR_HTTP2_PROTOCOL_ERROR, ECONNREFUSED e certificate verify failed. Você entende cada erro isoladamente, mas o conjunto parece não fazer sentido algum.

Passei três dias inteiros vasculhando GitHub Issues, canais do Discord e todo tipo de “solução definitiva” duvidosa. No fim, descobri que os problemas de rede do Cursor não têm uma causa única: proxy, HTTP/2, certificado e DNS podem falhar ao mesmo tempo.

Este artigo foi revisado em junho de 2026 com base na documentação oficial do Cursor. Agora, o ponto de partida é o diagnóstico em Cursor Settings > Network; só depois vêm proxy, modo de compatibilidade HTTP/2, certificado e DNS. Não comece alterando parâmetros de inicialização às cegas. Deixe o diagnóstico indicar onde está o problema.

Há ainda um detalhe que passa facilmente despercebido: muita gente preenche o endereço do proxy corretamente, mas o Cursor continua sem conexão. Isso acontece porque o valor padrão de http.proxySupport no Cursor é override. Nesse modo, ele reconhece apenas http.proxy no settings.json, ignora totalmente o proxy do sistema e, em uma instalação nova, essa opção vem vazia. Voltaremos a essa armadilha adiante; por enquanto, basta guardá-la.

Antes de alterar configurações: identifique o problema em três passos

Ao encontrar um problema de rede, muita gente começa mudando o proxy, removendo certificados e reinstalando o programa. Depois de horas, o problema continua e o ambiente está ainda mais confuso.

Minha recomendação é simples: reserve cinco minutos para descobrir onde está a falha.

Passo 1: confirme se o problema está no Cursor ou na sua rede

Abra o terminal e execute três comandos:

# Testar a conectividade básica
ping api.openai.com

# Testar a resolução DNS
nslookup api.openai.com

# Testar a conexão HTTPS
curl -I https://api.openai.com

Se o ping funcionar, mas o curl falhar, quase sempre a causa está no proxy ou no certificado. Se nem o ping funcionar, o problema está na camada de rede, não no Cursor.

Passo 2: consulte o log de erros do Cursor

Muita gente pula esta etapa, embora o log geralmente deixe o problema bem claro.

• Windows: %APPDATA%\Cursor\logs\main.log
• macOS: ~/Library/Application Support/Cursor/logs/main.log
• Linux: ~/.config/Cursor/logs/main.log

Abra o arquivo em um editor de texto e pesquise ERROR ou WARN. Estes são alguns erros comuns:

• ECONNREFUSED → o proxy está configurado incorretamente ou o servidor de proxy caiu
• ERR_HTTP2_PROTOCOL_ERROR → incompatibilidade com o protocolo HTTP/2, uma das causas mais difíceis de perceber
• certificate verify failed → problema no certificado SSL
• ETIMEDOUT → tempo limite excedido; o DNS pode estar lento ou a rede, bloqueada

Passo 3: teste se a configuração de proxy do Cursor está funcionando

O Cursor é baseado em Electron e pode exigir uma configuração de proxy própria em vez de simplesmente seguir o proxy do sistema. Para verificar:

1. Abra as configurações do Cursor com Ctrl+, ou Cmd+,
2. Pesquise proxy
3. Confira se http.proxy e https.proxy estão vazios

Se estiverem vazios enquanto um aplicativo de proxy local, como Clash, V2Ray ou Shadowsocks, está ativo, o Cursor provavelmente não está usando o proxy — e por isso não consegue se conectar.

Railway - Plataforma de deploy moderna, sem ops complexas, no ar em minutos

Começar agora →Anúncio

Quatro formas de configurar o proxy

O proxy é a principal causa das falhas de rede no Cursor. O que nem todo mundo sabe é que o editor aceita quatro formas diferentes de configuração, cada uma adequada a um cenário.

Antes de configurar o proxy, confirme se proxySupport está em override

Se o proxy local, como Clash ou V2Ray, está sempre ativo e o navegador acessa a internet normalmente, mas o Cursor não se conecta, não comece preenchendo endereços. Herdada do VS Code, a opção http.proxySupport tem quatro modos:

• off: não usa proxy
• on: sempre lê o proxy do sistema
• fallback: verifica primeiro http.proxy no settings.json e, se estiver vazio, recorre ao proxy do sistema
• override: usa apenas http.proxy no settings.json e ignora o proxy do sistema

É aí que surge o problema: o valor padrão de http.proxySupport é override, enquanto http.proxy vem vazio. Com essa combinação, o Cursor não lê um endereço manual — porque nenhum foi preenchido — nem o proxy do sistema. A conexão é feita diretamente, e tanto o login quanto as solicitações à IA falham.

A correção é simples. Abra as configurações com Ctrl+,, pesquise proxy support e mude Http: Proxy Support de override para on ou fallback. Reinicie o Cursor e teste novamente. Se você quer apenas que o editor siga o proxy do sistema, isso costuma bastar. As quatro alternativas abaixo são para quem precisa de controle mais preciso.

Opção 1: preencher o endereço do proxy nas configurações

Cenário indicado: você conhece o endereço do servidor de proxy, como um proxy HTTP fornecido pela empresa.

Passos:

1. Abra as configurações do Cursor
2. Pesquise proxy
3. Preencha http.proxy com http://127.0.0.1:7890, substituindo pelo endereço e pela porta do seu proxy

Pontos de atenção:

• Se o proxy exigir usuário e senha, use o formato http://username:[email protected]:7890
• Preencha também https.proxy; do contrário, apenas as solicitações HTTP usarão o proxy
• Alguns aplicativos, como Clash, usam a porta 7890 por padrão; outros, como V2Ray, usam 10808. Não confunda as portas

Opção 2: variáveis de ambiente para iniciar pelo terminal

Cenário indicado: você costuma abrir o Cursor pelo terminal ou precisa alternar temporariamente entre proxies.

Windows (PowerShell):

$env:HTTP_PROXY="http://127.0.0.1:7890"
$env:HTTPS_PROXY="http://127.0.0.1:7890"
cursor

macOS/Linux:

export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890
cursor

A vantagem é não alterar a configuração global: ao fechar o terminal, as variáveis deixam de valer.

Opção 3: detecção automática do proxy do sistema

Cenário indicado: o departamento de TI configurou um arquivo PAC ou um proxy transparente.

O Cursor consegue ler o proxy do sistema, mas esse comportamento fica desativado por padrão. Para ativá-lo:

1. Encontre a configuração de inicialização do Cursor

   • Windows: clique com o botão direito no atalho da área de trabalho → Propriedades → Destino
   • macOS: edite /Applications/Cursor.app/Contents/Info.plist

2. Adicione o parâmetro de inicialização --proxy-auto-detect

Assim, o Cursor detecta a configuração de proxy do sistema sem exigir que você preencha o endereço manualmente.

Opção 4: ignorar erros de certificado

Cenário indicado: o proxy da empresa inspeciona o tráfego HTTPS, fazendo a validação do certificado falhar.

Aviso importante: esta opção reduz a segurança e deve ser usada apenas temporariamente.

Parâmetro de inicialização: --ignore-certificate-errors

Comando completo no Windows:

& "C:\Users\seu_usuario\AppData\Local\Programs\Cursor\Cursor.exe" --ignore-certificate-errors

Com esse parâmetro, o Cursor deixa de validar certificados SSL e consegue contornar vários problemas de certificado em proxies corporativos. Ainda assim, este é o último recurso; evite usá-lo se houver outra solução.

Alibaba Cloud - Escolha dos desenvolvedores, 15% de desconto exclusivo em Lighthouse

Ganhar 15% off →Anúncio

A armadilha do HTTP/2: por que o navegador funciona, mas o Cursor não?

O cenário é este: o navegador abre a API da OpenAI normalmente e o comando curl também retorna dados, mas o Cursor apresenta ERR_HTTP2_PROTOCOL_ERROR.

Não atribua esse problema imediatamente a um “bug da versão”. O diagnóstico mais seguro é verificar primeiro em Network se existe uma incompatibilidade com HTTP/2 e, em seguida, testar HTTP/1.1.

Solução preferencial: mude o modo de compatibilidade HTTP/2 nas configurações

1. Abra as configurações do Cursor
2. Entre nas opções relacionadas a Network
3. Execute Run Diagnostics
4. Se o diagnóstico ou o log indicar HTTP/2, ative Disable HTTP/2 ou mude HTTP Compatibility Mode para HTTP/1.1
5. Encerre o Cursor por completo e abra-o novamente; não feche apenas a janela

Se você não quiser abrir o painel sempre, adicione a opção diretamente ao settings.json:

{
  "cursor.general.disableHttp2": true
}

Essa configuração tem suporte oficial e produz o mesmo efeito de Disable HTTP/2 no painel. Ela também pode ficar junto das opções de proxy. Se uma versão antiga não tiver nem o painel nem essa chave, use cursor --disable-http2 como alternativa.

Troque o DNS: algumas falhas de HTTP/2 são problemas de rota

Certos erros de HTTP/2 não estão no Cursor, mas no nó para o qual o DNS resolve o domínio. Alguns servidores DNS podem direcionar os domínios da API do Cursor para um nó da Cloudflare com problemas no handshake, causando SSL handshake. Vários usuários relataram no fórum oficial que trocar o DNS do sistema pelo Cloudflare (1.1.1.1) ou Google (8.8.8.8) restabeleceu o HTTP/2. Se desativar o HTTP/2 reduzir muito a velocidade e você não quiser permanecer em HTTP/1.1, troque o DNS e teste o HTTP/2 novamente.

Alternativa: altere a configuração do aplicativo de proxy

Usando o Clash como exemplo, abra o arquivo config.yaml, encontre a regra do proxy e adicione:

proxies:
  - name: "nome-do-seu-proxy"
    type: http
    server: 127.0.0.1
    port: 7890
    http-version: "1.1"  # Forçar o uso de HTTP/1.1

Depois, reinicie o Clash e o Cursor. Se o HTTP/2 estiver falhando apenas durante a negociação na cadeia de proxy, isso normalmente estabiliza as solicitações. Se o erro persistir, volte ao relatório de diagnóstico e aos logs, em vez de acumular mais parâmetros de inicialização.

Solução completa para redes corporativas

A rede de uma empresa é o cenário mais difícil porque reúne todos os problemas anteriores: proxy obrigatório, intermediário SSL, firewall e DNS interno. Qualquer um deles pode impedir o Cursor de funcionar.

Organizei uma configuração que funciona em redes corporativas, desde que seja seguida na ordem indicada:

Lista de configuração

1. Obtenha os dados do proxy corporativo

Peça estas informações ao departamento de TI:

• Endereço e porta do servidor de proxy, por exemplo proxy.company.com:8080
• Se há necessidade de usuário e senha
• Se a rede usa configuração automática PAC
• Se há inspeção SSL; nesse caso, peça também o certificado raiz

2. Configure o proxy no Cursor

Adicione ao settings.json:

{
  "http.proxy": "http://username:[email protected]:8080",
  "https.proxy": "http://username:[email protected]:8080",
  "http.proxySupport": "override",
  "http.proxyStrictSSL": false,
  "cursor.general.disableHttp2": true
}

Alguns detalhes: depois de preencher http.proxy, usar override em http.proxySupport é a opção mais direta, pois garante que o Cursor passe apenas pelo proxy corporativo. Se houver um intermediário SSL, inclua http.proxyStrictSSL: false. Como muitos proxies corporativos bloqueiam HTTP/2, definir cursor.general.disableHttp2 como true também pode poupar uma etapa da investigação.

3. Importe o certificado raiz da empresa

Se a empresa inspeciona SSL, é necessário importar o certificado raiz. Caso contrário, o Cursor continuará mostrando certificate verify failed.

Windows:

1. Dê dois cliques no arquivo do certificado raiz, com extensão .crt ou .cer
2. Selecione “Instalar Certificado” → “Computador Local” → “Autoridades de Certificação Raiz Confiáveis”

macOS:

KiloClaw - OpenClaw gerenciado para empresas: orquestração de agentes IA e roteamento inteligente

Começar →Anúncio

sudo security add-trusted-cert -d -r trustRoot -k /Library/Keychains/System.keychain certificado-raiz-da-empresa.crt

4. Combine os parâmetros em um script de inicialização

Crie um script de inicialização: .bat no Windows ou .sh no macOS/Linux.

Windows (start-cursor.bat):

@echo off
set HTTP_PROXY=http://proxy.company.com:8080
set HTTPS_PROXY=http://proxy.company.com:8080
start "" "C:\Users\seu_usuario\AppData\Local\Programs\Cursor\Cursor.exe" --proxy-auto-detect --disable-http2

macOS/Linux (start-cursor.sh):

#!/bin/bash
export HTTP_PROXY=http://proxy.company.com:8080
export HTTPS_PROXY=http://proxy.company.com:8080
/Applications/Cursor.app/Contents/MacOS/Cursor --proxy-auto-detect --disable-http2

Depois, use sempre esse script para abrir o Cursor, em vez de clicar diretamente no ícone.

5. Teste a conexão

Após iniciar, abra as ferramentas de desenvolvedor do Cursor com Ctrl+Shift+I ou Cmd+Option+I, entre na aba Network e faça qualquer pergunta à IA. Verifique se a solicitação retorna normalmente.

Se ainda houver erro, volte ao arquivo de log no caminho mostrado anteriormente, encontre a mensagem mais recente e repita as etapas de diagnóstico correspondentes.

Resumo

Apesar de todos os detalhes, os problemas de rede do Cursor se resumem a quatro pontos:

1. O proxy não funciona → verifique primeiro se http.proxySupport está em override; depois, confira http.proxy e as variáveis de ambiente
2. Conflito com o protocolo HTTP/2 → use primeiro Disable HTTP/2 ou HTTP Compatibility Mode: HTTP/1.1 nas configurações de Network; se necessário, troque o DNS
3. Falha na validação do certificado SSL → importe o certificado raiz ou desative temporariamente a validação
4. Restrições da rede corporativa → combine proxy, certificado e parâmetros de inicialização

Levei três dias para resolver porque não sabia que os quatro problemas podiam se acumular. Ajustei o proxy, mas o HTTP/2 continuou falhando; desativei o HTTP/2 e surgiu o problema de certificado; importei o certificado e o DNS deixou de resolver. A cada tentativa eu achava que tinha terminado, mas apenas trocava um erro por outro.

Hoje, olhando para trás, vejo que teria resolvido tudo em meia hora se tivesse seguido esta ordem desde o início.

Um último conselho: não trate o log de erros como enfeite. Sempre que houver um problema, procure primeiro a mensagem ERROR mais recente. Em 90% dos casos, a resposta está ali. Nos 10% restantes, leve o log ao GitHub Issues ou ao Discord; assim, outras pessoas também conseguem identificar a causa mais rapidamente.

Problemas de rede são administráveis. O risco está em alterar tudo sem diagnóstico. Espero que este artigo poupe você daquelas 72 horas.

Fontes oficiais e próximas leituras

• Documentação oficial do Cursor para solucionar problemas de rede e proxy
• Documentação oficial do Cursor
• Preços do Cursor
• Guia para corrigir erros comuns do Cursor
• Guia completo da assinatura Cursor Pro
• Guia completo da cota gratuita do Cursor