Saltar al contenido principal
Algunas redes corporativas y empresariales enrutan el tráfico a través de proxys HTTP/HTTPS. El complemento de Windsurf en los IDEs de JetBrains necesita conectarse a servicios externos de Windsurf (para el inicio de sesión y las funciones de IA), por lo que es posible que debas configurar una proxy antes de que todo funcione de forma fiable.

​
Cuándo puede ser necesaria la configuración de un proxy

La configuración de un proxy puede ser necesaria si:
  • Ves “Failed to connect” u otros errores de red similares en Windsurf
  • El panel de Windsurf en el IDE permanece en blanco y no carga nunca
  • Cascade u otras funciones de Windsurf no pueden conectarse o se agota el tiempo de espera
Esta guía cubre:
  • Comprobar si tu red usa un proxy
  • Configurar el proxy del IDE
  • Habilitar la detección de proxy de Windsurf
  • Configurar el proxy para JetBrains Remote

​
Comprueba si tu red utiliza un proxy

Antes de cambiar nada: Consulta con tu equipo de TI/infraestructura/red:
  • ¿Usamos un proxy HTTP/HTTPS para el tráfico saliente?
  • Si es así, ¿se configura automáticamente (ajustes del sistema/archivo PAC/gestión de dispositivos) o debo configurarlo manualmente en las aplicaciones?
Si tu organización no usa un proxy, por lo general no necesitas cambiar estos ajustes. Si tu organización sí usa uno, reúne los datos del proxy (dirección, puerto y posibles credenciales). Puedes compartir capturas de pantalla de la configuración de JetBrains HTTP Proxy y de Windsurf para que te indiquen exactamente qué debes completar.

​
Configurar el proxy en IDEs de JetBrains

Primero, asegúrate de que el IDE pueda acceder a Internet a través de tu proxy; en particular, que pueda alcanzar windsurf.com.
  1. Abre Settings / Preferences en tu IDE de JetBrains. Por ejemplo: File → Settings… (Windows/Linux) o ⌘, → Settings… (macOS).
  2. Ve a Appearance & Behavior → System Settings → HTTP Proxy.
Configuración de proxy HTTP en JetBrains
  1. Elige la opción adecuada según las indicaciones de tu equipo de TI:
    • No proxy: si tu red no usa proxy.
    • Auto-detect proxy settings o Use system proxy settings: si el proxy está configurado globalmente en tu equipo.
    • Manual proxy configuration: si TI proporcionó un host/puerto de proxy específico (y nombre de usuario/contraseña opcionales) para ingresar aquí.
  2. Usa Check connection… (si está disponible) para verificar la configuración; idealmente, prueba la conectividad a https://windsurf.com desde este cuadro de diálogo.
  3. Aplica los cambios y reinicia el IDE si se te solicita.
Si el IDE no puede acceder a la red (por ejemplo, fallan el marketplace de plugins, las actualizaciones o las funciones web integradas, o no puedes acceder a https://windsurf.com desde el IDE), soluciona eso aquí primero. Windsurf depende de esta conectividad.

​
Habilitar la detección de proxy de Windsurf en JetBrains

Una vez que el proxy a nivel de IDE esté configurado (o confirmado como innecesario), define cómo usará Windsurf esa configuración. El complemento de Windsurf tiene su propia opción Detectar proxy dentro de su configuración:
  1. En tu IDE de JetBrains, abre Settings / Preferences.
  2. Ve a Tools → Windsurf Settings.
  3. Busca la opción (conmutador) Detectar proxy.
Windsurf Proxy Detection Settings
  1. Activa Detectar proxy si:
    • El proxy está configurado a nivel del sistema operativo o del IDE, y
    • El área de TI espera que las aplicaciones “detecten automáticamente” esa configuración.
  2. Haz clic en Apply y OK si es necesario, luego reinicia el IDE.
  3. Vuelve a intentar usar Windsurf:
    • Abre el panel de Windsurf desde la barra lateral del IDE
    • Ejecuta Cascade o vuelve a intentar la operación que fallaba con “Failed to connect” o mostraba una pantalla en blanco
Si aparecen nuevos problemas de conexión tras habilitar Detectar proxy, puedes:
  • Desactivar nuevamente Detectar proxy,
  • Verificar la configuración de HTTP Proxy del IDE (incluido que pueda acceder a https://windsurf.com), y
  • Confirmar con TI si se requiere configuración manual adicional.

​
Configuración de proxy en JetBrains Remote

Si usas JetBrains Remote Development (por ejemplo, a través de JetBrains Gateway, un backend remoto o un entorno de desarrollo en la nube), en la práctica hay dos lugares donde importan los ajustes de proxy:
  • Tu máquina local, que ejecuta el cliente ligero.
  • La máquina remota, donde se ejecuta el backend real del IDE (y Windsurf).
Cuando te conectas con JetBrains Remote, las solicitudes de red de Windsurf se originan en la máquina remota, no en tu laptop local. Esto significa:
  • La configuración de proxy en el IDE remoto afecta cómo Windsurf se conecta a los servicios de Windsurf.
  • La máquina remota puede necesitar su propia configuración de proxy, incluso si tu máquina local ya está configurada correctamente.
Para el desarrollo remoto de JetBrains, debes usar el complemento dedicado “Windsurf (Remote Development)”, no el complemento estándar de Windsurf. Asegúrate de haber instalado Windsurf (Remote Development) como se describe en la sección de Remote Development de la guía de inicio de Windsurf para JetBrains.

​
Configurar el proxy para el entorno remoto

  1. Conéctate a tu backend remoto usando JetBrains Remote / Gateway.
  2. Abre Settings / Preferences en la sesión de IDE remota (esto abre la configuración del IDE que se ejecuta en la máquina remota).
  3. Configura el proxy para el IDE remoto:
    • Ve a Appearance & Behavior → System Settings → HTTP Proxy en el IDE remoto.
    • Configura el proxy según las instrucciones de tu equipo de TI (No proxy / Auto-detect / Use system proxy / Manual).
    • Si el IDE ofrece un botón Check connection…, úsalo para probar la conectividad a https://windsurf.com desde la máquina remota.
  4. Configura Windsurf en el IDE remoto:
    • Ve a Tools → Windsurf Settings (aún en la sesión remota).
    • Habilita Detect proxy si tu equipo de TI espera que las aplicaciones en el host remoto usen la configuración de proxy del sistema o del IDE.
  5. Aplica los cambios y luego reinicia el backend del IDE remoto o desconéctate y vuelve a conectarte a tu sesión remota.
  6. Abre nuevamente el panel de Windsurf en el IDE remoto y vuelve a intentar la acción que falló anteriormente.
Es común en entornos corporativos que tanto tu máquina local como la máquina remota tengan sus propias reglas de proxy. Asegúrate de seguir las indicaciones de TI para cada lado; corregir solo el proxy local no ayudará si el host remoto no puede acceder a Internet (incluido https://windsurf.com) sin su propia configuración de proxy.

​
Cuándo cambiar cada cosa

​
Cambia solo el proxy HTTP local del IDE

Si:
  • No usas JetBrains Remote, y
  • Otras funciones de JetBrains ya funcionan tras configurarlo, y
  • Windsurf funciona sin modificar su propia configuración, y
  • El IDE puede acceder a https://windsurf.com.

​
Habilitar “Detect Proxy” de Windsurf

(Local o remoto) si:
  • El proxy ya está configurado a nivel del sistema operativo o del IDE en esa máquina, y
  • Windsurf es lo único que no puede conectarse, o muestra un panel de Windsurf en blanco.

​
Configurar el proxy en el IDE remoto

Si:
  • Usas JetBrains Remote,
  • Tienes instalado el plugin de Windsurf (Remote Development) para ese entorno, y
  • Los errores ocurren solo cuando te conectas a un backend remoto, o
  • El departamento de TI indica que el servidor remoto también debe salir a internet a través de un proxy (incluido https://windsurf.com).

​
Habla con TI / Infra

Si:
  • No estás seguro de si tu entorno usa un proxy, o
  • Configuraste el proxy HTTP + el proxy Windsurf Detect (en local y/o de forma remota) y verificaste la conexión a https://windsurf.com, pero sigues viendo paneles de Windsurf en blanco o errores de conexión.
Tu equipo de TI / infra es la autoridad final: pueden confirmar si necesitas un proxy en tu máquina local, en tu máquina remota o en ambas, cómo debe configurarse en JetBrains y si la opción de proxy Windsurf Detect debe estar habilitada en tu entorno.