Cursor Proxy: diagnóstico de red, configuración de proxy y corrección HTTP/2

En la esquina inferior derecha del editor Cursor hay un círculo girando desde hace cinco minutos. Estás a mitad de código y la IA se corta de repente con el mensaje «Network request failed». Cambias al navegador y YouTube va fluido; un ping a Google marca solo 20 ms de latencia.

Al día siguiente, en la red corporativa con proxies en cascada configurados por IT, Cursor se niega a arrancar. El registro de errores está lleno de ERR_HTTP2_PROTOCOL_ERROR, ECONNREFUSED y certificate verify failed: cada mensaje suena familiar por separado, pero juntos no encajan.

Pasé tres días enteros revisando GitHub Issues, canales de Discord y supuestas «soluciones definitivas», hasta descubrir que los problemas de red de Cursor no tienen una sola causa: proxy, HTTP/2, certificados y DNS se superponen.

Este artículo se revisó en junio de 2026 según la documentación oficial de Cursor: empieza por el diagnóstico en Cursor Settings > Network, luego aborda proxy, modo de compatibilidad HTTP/2, certificados y DNS. No cambies parámetros de arranque a ciegas; deja que el diagnóstico te indique dónde está el problema.

Conviene tener presente desde ya un detalle que se pasa por alto: mucha gente escribe la dirección de proxy correcta y aun así Cursor no conecta. El motivo es que http.proxySupport vale override por defecto. En ese modo, Cursor solo usa el http.proxy del settings.json e ignora el proxy del sistema; y en una instalación nueva ese valor está vacío. Más abajo hay una sección dedicada a esto.

No cambies la configuración aún: localiza el problema en tres pasos

Ante un fallo de red, muchos modifican el proxy, borran certificados o reinstalan. Al final el entorno queda más desordenado y el problema sigue ahí.

Mi recomendación: dedica cinco minutos a confirmar dónde falla realmente.

Paso 1: ¿Es Cursor o tu red?

Abre la terminal y ejecuta tres comandos:

# Probar conectividad básica
ping api.openai.com

# Probar resolución DNS
nslookup api.openai.com

# Probar conexión HTTPS
curl -I https://api.openai.com

Si ping responde pero curl falla, casi seguro es proxy o certificado. Si ni siquiera responde ping, el problema está en la capa de red, no en Cursor.

Paso 2: Revisa el registro de errores de Cursor

Muchos omiten este paso, pero el registro suele ser muy explícito.

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

Ábrelo con un editor de texto y busca ERROR o WARN. Errores habituales:

• ECONNREFUSED → proxy mal configurado o servidor caído
• ERR_HTTP2_PROTOCOL_ERROR → incompatibilidad HTTP/2 (el más engañoso)
• certificate verify failed → problema de certificado SSL
• ETIMEDOUT → tiempo de espera agotado; DNS lento o bloqueo de red

Paso 3: Comprueba si el proxy de Cursor funciona

Cursor usa Electron y no hereda el proxy del sistema por defecto; hay que configurarlo aparte. Para probarlo:

1. Abre la configuración de Cursor (Ctrl+, o Cmd+,)
2. Busca proxy
3. Comprueba si http.proxy y https.proxy están vacíos

Si están vacíos pero usas un cliente proxy local (Clash, V2Ray, Shadowsocks), Cursor no pasa por el proxy y no podrá conectar.

KiloClaw - OpenClaw gestionado para empresas: orquestación de agentes IA y enrutamiento inteligente

Empezar →Anuncio

Cuatro formas de configurar el proxy (una te servirá)

El proxy es la causa número uno de fallos de red en Cursor. Muchos no saben que hay cuatro métodos distintos, cada uno para un escenario diferente.

Antes de configurar el proxy, comprueba una cosa: ¿proxySupport está en override?

Si tu proxy local (Clash / V2Ray) está activo y el navegador navega sin problemas pero Cursor no conecta, no escribas una dirección a la primera. Cursor hereda de VS Code el ajuste http.proxySupport, con cuatro modos:

• off: no usa proxy
• on: siempre lee el proxy del sistema
• fallback: primero mira http.proxy en settings.json y, si está vacío, recurre al proxy del sistema
• override: solo usa el http.proxy del settings.json e ignora el proxy del sistema

Ahí está la trampa: http.proxySupport vale override por defecto y http.proxy está vacío por defecto. Sumados, Cursor no lee ni tu dirección (no la hay) ni el proxy del sistema; conecta «en crudo», así que el inicio de sesión y las peticiones de IA fallan.

La solución es sencilla: abre la configuración (Ctrl+,), busca proxy support y cambia Http: Proxy Support de override a on o fallback, luego reinicia Cursor. Si solo quieres que Cursor siga el proxy del sistema, ese único cambio suele bastar; los cuatro métodos siguientes son para quien necesita un control más fino.

Método 1: Dirección de proxy en la configuración (lo más simple)

Escenario: tienes una dirección de proxy HTTP explícita (por ejemplo, la que proporciona la empresa).

Pasos:

1. Abre la configuración de Cursor
2. Busca proxy
3. Rellena http.proxy: http://127.0.0.1:7890 (cambia por tu host y puerto)

Puntos a vigilar:

• Si el proxy requiere usuario y contraseña: http://username:[email protected]:7890
• Rellena también https.proxy; si no, solo el tráfico HTTP usará el proxy
• Clash suele usar el puerto 7890; V2Ray, 10808. No los confundas

Método 2: Variables de entorno (arranque desde terminal)

Escenario: inicias Cursor desde la terminal o necesitas cambiar de proxy temporalmente.

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

Ventaja: no altera la configuración global; al cerrar la terminal, deja de aplicarse.

Método 3: Detección automática del proxy del sistema (recomendado en empresa)

Escenario: IT configuró un archivo PAC o un proxy transparente.

Cursor puede leer el proxy del sistema, pero viene desactivado por defecto. Para activarlo:

1. Localiza la configuración de arranque de Cursor

   • Windows: clic derecho en el acceso directo → Propiedades → Destino
   • macOS: edita /Applications/Cursor.app/Contents/Info.plist

2. Añade el argumento: --proxy-auto-detect

Así Cursor usará la configuración de proxy del sistema sin rellenar direcciones a mano.

Método 4: Ignorar errores de certificado (no recomendado, pero efectivo)

Escenario: el proxy corporativo descifra HTTPS y falla la verificación del certificado.

Advertencia grave: reduce la seguridad; úsalo solo de forma temporal.

Argumento de arranque: --ignore-certificate-errors

Comando completo (Windows):

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

Con este parámetro Cursor no validará certificados SSL y puede sortear muchos proxies corporativos. Es el último recurso; evítalo si puedes.

Alibaba Cloud - Opción preferida para desarrolladores, 15 % de descuento exclusivo en Lighthouse

Obtener 15% dto. →Anuncio

La trampa de HTTP/2: ¿por qué el navegador funciona y Cursor no?

El síntoma: el navegador accede a la API de OpenAI sin problemas, curl también responde, pero Cursor muestra ERR_HTTP2_PROTOCOL_ERROR.

No lo atribuyas de inmediato a un «bug de versión». Lo más fiable: confirma en el diagnóstico de Network si hay incompatibilidad HTTP/2 y prueba con HTTP/1.1.

Opción preferida: modo de compatibilidad HTTP/2 en la configuración

1. Abre la configuración de Cursor
2. Entra en ajustes de Network
3. Ejecuta Run Diagnostics
4. Si el diagnóstico o el registro apuntan a HTTP/2, activa Disable HTTP/2 o cambia HTTP Compatibility Mode a HTTP/1.1
5. Cierra Cursor por completo y reinícialo; no basta con cerrar la ventana

Si prefieres no abrir el panel cada vez, defínelo directamente en settings.json:

{
  "cursor.general.disableHttp2": true
}

Es una clave con soporte oficial, con el mismo efecto que la opción Disable HTTP/2, y queda junto a tus claves de proxy. Solo recurre al parámetro de arranque cursor --disable-http2 en versiones antiguas que no expongan ni la opción ni esta clave.

Cambia el DNS: a veces el fallo de HTTP/2 es un problema de enrutado

Algunos errores HTTP/2 no se originan en Cursor, sino en el nodo al que resuelve tu DNS. Ciertos proveedores de DNS resuelven los dominios de la API de Cursor a un nodo de Cloudflare donde el handshake falla y aparece un error SSL handshake. Varios usuarios del foro oficial cuentan que, al cambiar el DNS del sistema a Cloudflare (1.1.1.1) o Google (8.8.8.8), HTTP/2 volvió a funcionar sin más. Si desactivar HTTP/2 te ralentiza de forma notable y no quieres quedarte en HTTP/1.1, cambia primero el DNS y vuelve a activar HTTP/2 una vez.

Respaldo: ajustar el software proxy (ejemplo con Clash)

Abre la configuración de Clash (config.yaml), localiza la regla del proxy y añade:

proxies:
  - name: "nombre-de-tu-proxy"
    type: http
    server: 127.0.0.1
    port: 7890
    http-version: "1.1"  # Forzar HTTP/1.1

Reinicia Clash y Cursor. Si HTTP/2 era solo un problema de negociación en la cadena de proxy, esto suele estabilizar las solicitudes; si sigue fallando, vuelve al informe de diagnóstico y al registro en lugar de acumular más parámetros de arranque.

Solución integral para red corporativa

La red de empresa combina todo lo anterior: proxy obligatorio, SSL intermediario, firewall, DNS interno… cualquiera puede dejar Cursor inoperativo.

Aquí tienes un esquema que suele funcionar en entorno corporativo:

Lista de configuración (en este orden)

1. Obtén la información del proxy de la empresa

Pide a IT:

• Dirección y puerto del proxy (por ejemplo proxy.company.com:8080)
• Si requiere usuario y contraseña
• Si usan PAC automático
• Si hay descifrado SSL (y, en ese caso, el certificado raíz)

2. Configura el proxy en Cursor

Añade en 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
}

Tres notas: una vez que has escrito http.proxy a mano, mantener http.proxySupport en override es lo más limpio, porque garantiza que Cursor pase solo por este proxy corporativo. Con SSL intermediario, incluye "http.proxyStrictSSL": false. Y como los proxies corporativos suelen bloquear HTTP/2, poner "cursor.general.disableHttp2": true aquí te ahorra una ronda de diagnóstico.

3. Importa el certificado raíz corporativo

Si la empresa descifra SSL, debes importar el certificado raíz; si no, Cursor seguirá mostrando certificate verify failed.

Windows:

1. Haz doble clic en el archivo .crt o .cer
2. Elige instalar en «Equipo local» → «Entidades de certificación raíz de confianza»

macOS:

Railway - Plataforma de despliegue moderna, sin ops complejas, en producción en minutos

Empezar ahora →Anuncio

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

4. Combina argumentos de arranque en un script

Crea un script de arranque (.bat en Windows, .sh en 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\TuUsuario\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

A partir de ahí, inicia Cursor con el script, no con el icono directamente.

5. Prueba la conexión

Tras arrancar, abre las herramientas de desarrollo (Ctrl+Shift+I o Cmd+Option+I), pestaña Network, haz una pregunta a la IA y comprueba que las solicitudes respondan bien.

Si aún falla, vuelve al archivo de registro (rutas anteriores), localiza el ERROR más reciente y repite los pasos de diagnóstico.

Resumen

En la práctica, los problemas de red de Cursor se reducen a cuatro trampas:

1. Proxy ignorado → primero comprueba si http.proxySupport está en override, luego http.proxy y variables de entorno
2. Conflicto HTTP/2 → primero Disable HTTP/2 / HTTP Compatibility Mode: HTTP/1.1 en Network, cambia de DNS si hace falta
3. Fallo de verificación SSL → importa el certificado raíz o desactiva la verificación temporalmente
4. Restricciones de red corporativa → combo: proxy + certificado + argumentos de arranque

Yo perdí tres días porque no sabía que estos cuatro problemas se superponen. Arreglé el proxy y seguía HTTP/2; desactivé HTTP/2 y apareció el certificado; importé el certificado y falló el DNS… cada vez parecía resuelto, pero solo cambiaba el mensaje de error.

Con retrospectiva, seguir el orden de este artículo habría bastado en media hora.

Por último: no ignores el registro de errores. Ante cualquier fallo, busca el ERROR más reciente; el 90 % de las respuestas están ahí. Para el 10 % restante, lleva el registro a GitHub Issues o Discord: ayudará a que te orienten más rápido.

Los problemas de red no asustan; lo que sí lo hace es tocar configuraciones a ciegas. Espero que este artículo te ahorre esas 72 horas.

Documentación oficial y lecturas siguientes

• Cursor: red, proxy y conexiones remotas
• Documentación oficial de Cursor
• Cursor Pricing
• Guía de errores frecuentes de Cursor
• Guía completa de suscripción Cursor Pro
• Guía completa del plan gratuito de Cursor