> ## Documentation Index
> Fetch the complete documentation index at: https://docs.windsurf.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuración de proxy en Windsurf Editor

> Configura la proxy HTTP/HTTPS para Windsurf Editor en redes corporativas. Incluye detección automática, configuración manual y configuración de proxy remoto por SSH.

Algunas redes corporativas y empresariales enrutan el tráfico a través de proxies HTTP/HTTPS. Windsurf Editor necesita acceder a algunos servicios externos (para el inicio de sesión y funciones de IA), por lo que puede que debas configurar una proxy antes de que todo funcione de forma confiable.

En particular, puede ser necesaria la configuración del proxy si:

* Ves **"Failed to connect"** u otros errores de red similares

* El **editor o el panel de Cascade muestran una pantalla en blanco** y nunca llegan a cargar

* Cascade u otras funciones basadas en la nube **no cargan o no logran conectarse**

* Los flujos de inicio de sesión o activación fallan de forma inesperada

Todas las opciones de proxy están en **Windsurf Settings**. Puedes abrirlas desde el **menú desplegable superior derecho → Windsurf Settings**, o mediante la **Command Palette (Ctrl/⌘+Shift+P) → "Open Windsurf Settings Page"**.

***

<div id="1-check-whether-your-network-uses-a-proxy">
  ## **1. Comprueba si tu red utiliza un proxy**
</div>

Antes de cambiar nada en el editor:

1. **Consulta a tu equipo de TI/infraestructura/red**:

   * ¿Utilizamos un proxy HTTP/HTTPS para el tráfico saliente?

   * Si la respuesta es sí, ¿está configurado **automáticamente** (ajustes del sistema/archivo PAC) o debo configurarlo **manualmente** en las aplicaciones?

2. Si tu organización **no** utiliza un proxy, por lo general no necesitas cambiar estos ajustes.

3. Si tu organización sí utiliza uno, solicita a tu equipo de TI los detalles del proxy (dirección, puerto y credenciales, si aplica).

Puedes compartir una captura de pantalla de la configuración de proxy de Windsurf para que te indiquen exactamente qué debes completar.

***

<div id="2-use-your-system-proxy-detect-proxy">
  ## **2. Usa el proxy del sistema ("Detect proxy")**
</div>

Si tu proxy **ya está configurado en tu equipo** (por ejemplo, mediante la configuración de red del sistema o un archivo PAC), puedes permitir que Windsurf lo detecte y lo use:

1. Abre **Windsurf Settings**.

2. En la barra de búsqueda de configuración, escribe **"proxy"**.

3. Busca el conmutador **Detect proxy** (ver captura).

4. Activa **Detect proxy** (**ON**).

5. Cierra la página de configuración y **reinicia Windsurf Editor**.

6. Vuelve a intentar:

   * Recargar el editor / Cascade

   * Reintentar el inicio de sesión o cualquier operación que antes fallaba

<Frame style={{ border: 'none', background: 'none' }}>
  <img style={{ maxHeight: "500px" }} src="https://mintcdn.com/codeium/wMUgYjlL-wAQ3CJD/assets/windsurf/proxy-detect-proxy-setting.png?fit=max&auto=format&n=wMUgYjlL-wAQ3CJD&q=85&s=a1d3af3f5373df545673865fed24697f" width="1773" height="790" data-path="assets/windsurf/proxy-detect-proxy-setting.png" />
</Frame>

Si algo deja de funcionar después de habilitar esto, puedes volver a poner **Detect proxy** en **OFF** y usar la configuración manual en su lugar (consulta la siguiente sección), o sigue las indicaciones de tu equipo de TI.

***

<div id="3-manually-configure-a-proxy-in-windsurf-editor">
  ## **3. Configurar manualmente un proxy en Windsurf Editor**
</div>

Si tu organización requiere que **especifiques manualmente** el proxy en las aplicaciones:

1. Reúne la información necesaria de tu equipo de TI/infraestructura:

   * **Protocolo + dirección del proxy** (por ejemplo, `http://proxy.company.com:8080` o `https://proxy.company.com:8443`)

   * Si el proxy **requiere autenticación**

   * Tu **usuario/contraseña del proxy** u otras credenciales, si es necesario

2. Abre **Windsurf Settings**.

3. En la barra de búsqueda de Configuración, escribe **"proxy"** para abrir la sección de configuración del proxy (ver captura de pantalla).

4. Completa los campos:

   * **URL/dirección del proxy** – incluye el protocolo y el puerto (p. ej., `http://proxy.company.com:8080`)

   * **Autenticación** – si tu proxy lo requiere, introduce el nombre de usuario y la contraseña en los campos que aparecen en la interfaz

5. (Opcional, si TI lo recomienda) Activa **Detect proxy** en **ON** si tu configuración aún depende de la detección del sistema/PAC junto con los ajustes manuales.

6. Cierra la página de configuración y **reinicia Windsurf Editor** para que la nueva configuración de proxy se aplique por completo.

7. Vuelve a intentarlo:

   * Recarga el editor o Cascade si anteriormente veías una **pantalla en blanco**

   * Reintenta la operación que fallaba con **"Failed to connect"** u errores similares

<Frame style={{ border: 'none', background: 'none' }}>
  <img style={{ maxHeight: "500px" }} src="https://mintcdn.com/codeium/wMUgYjlL-wAQ3CJD/assets/windsurf/proxy-manual-configuration.png?fit=max&auto=format&n=wMUgYjlL-wAQ3CJD&q=85&s=7bc6103beb74c91208fe342992217dea" width="1418" height="1430" data-path="assets/windsurf/proxy-manual-configuration.png" />
</Frame>

***

<div id="4-proxy-settings-for-remote-development-ssh-dev-containers">
  ## **4. Configuración de proxy para desarrollo remoto (SSH / contenedores de desarrollo)**
</div>

Si usas **desarrollo remoto** (por ejemplo, un contenedor de desarrollo o un remoto SSH de Windsurf), hay un conjunto independiente de configuraciones de proxy que controlan el tráfico entre tu editor de Windsurf local y el entorno **remoto**.

Es posible que debas ajustar estas configuraciones si:

* La conexión a un **contenedor de desarrollo** o a un **remoto SSH** falla o se agota el tiempo de espera

* Se abre la ventana remota, pero las herramientas que dependen de la red no funcionan como se espera

* Tu equipo de TI/infraestructura indica que el **host remoto** también debe pasar por un proxy

Para configurar el proxy para entornos remotos:

1. Abre **Windsurf Settings**.

2. En la barra de búsqueda, escribe **"proxy"**.

3. En **User → Extensions → Windsurf Remote…**, ubica:

   * **Remote › Windsurf SSH: Http Proxy**

   * **Remote › Windsurf SSH: Https Proxy**

4. Ingresa la(s) dirección(es) de proxy proporcionada(s) por tu equipo de TI/infraestructura (normalmente incluyen protocolo y puerto; por ejemplo, `http://proxy.company.com:8080`).

5. Reinicia la sesión remota (cierra la ventana remota y vuelve a conectarte, o reinicia el contenedor de desarrollo) e inténtalo de nuevo.

<Note>Estas configuraciones de proxy **remotas** son independientes de las opciones generales de proxy/Detect proxy descritas arriba. En algunos entornos, puede que necesites configurar **tanto** el proxy del editor local como los valores de proxy de Windsurf Remote SSH.</Note>

<Frame style={{ border: 'none', background: 'none' }}>
  <img style={{ maxHeight: "500px" }} src="https://mintcdn.com/codeium/wMUgYjlL-wAQ3CJD/assets/windsurf/proxy-remote-ssh-settings.png?fit=max&auto=format&n=wMUgYjlL-wAQ3CJD&q=85&s=195e25ee466aab96a8cde2965d2222f3" width="1938" height="903" data-path="assets/windsurf/proxy-remote-ssh-settings.png" />
</Frame>

***

<div id="5-when-to-use-which-option">
  ## **5. Cuándo usar cada opción**
</div>

* **Usa "Detectar proxy" únicamente** si:

  * Tu organización configura los proxies de forma centralizada en tu dispositivo (configuración de red del sistema, archivo PAC), **y**

  * El equipo de TI te indica que las aplicaciones deberían “usar automáticamente el proxy del sistema”.

* **Usa la configuración manual (con o sin Detectar proxy)** si:

  * TI te proporciona una URL de proxy específica y credenciales para introducir en cada aplicación, o

  * La detección automática en tu entorno es poco fiable o no está admitida.

Si no estás seguro de cuál de estas opciones aplica a tu caso, tu **equipo de TI/infraestructura es la referencia**: pueden confirmar si necesitas configuración de proxy, qué debes introducir y si el conmutador de **Detectar proxy** debe estar activado o desactivado.