Proxies para VS Code: configuración de la sincronización de extensiones y Settings Sync a través de un proxy corporativo o residencial

```html

Visual Studio Code puede sincronizar extensiones, configuraciones y fragmentos entre dispositivos, pero todo esto funciona a través de los servidores de Microsoft, que a menudo no están disponibles detrás de un firewall corporativo, en redes de oficina con filtrado estricto o en regiones con acceso limitado. El resultado es que el Marketplace de Extensiones se queda colgado, Settings Sync no se conecta y las actualizaciones no se descargan. En este artículo, analizaremos cómo configurar correctamente un proxy en VS Code para que todos estos problemas desaparezcan de una vez por todas.

Por qué VS Code no funciona sin proxy en algunas redes

Visual Studio Code no es solo un editor de texto. Bajo el capó, constantemente se conecta a servidores externos: descarga actualizaciones de extensiones desde marketplace.visualstudio.com, sincroniza configuraciones a través de vscode.dev y servidores de GitHub/Cuenta de Microsoft, verifica actualizaciones del propio editor y envía telemetría (si no está desactivada).

Todas estas solicitudes se realizan a través de conexiones HTTPS estándar. Y aquí es donde comienzan los problemas:

• Redes corporativas — los administradores de sistemas bloquean el acceso directo a Internet, exigiendo que todo el tráfico pase a través de un servidor proxy corporativo. VS Code "no sabe" esto y simplemente no puede conectarse.
• Firewalls de oficina con lista blanca — solo se permiten dominios específicos, y marketplace.visualstudio.com no está en esta lista.
• Restricciones regionales — en varios países y regiones, el acceso a los servicios de Microsoft es limitado o inestable. Un proxy con IP del país necesario resuelve el problema.
• Conflictos de VPN — algunas VPN corporativas interceptan el tráfico, pero no lo transmiten correctamente, lo que provoca que VS Code pierda la conexión con el Marketplace.
• Internet inestable + proxy con caché — un servidor proxy puede almacenar en caché los paquetes de extensiones y acelerar la instalación en equipos con un canal lento.

Los síntomas de todos estos problemas son similares: las extensiones no se instalan o se quedan atascadas en la carga, Settings Sync muestra un error de autorización o "no se puede conectar", las actualizaciones de VS Code no se descargan, y en el panel de salida se ven errores ECONNREFUSED o ETIMEDOUT.

Cómo maneja VS Code el proxy: lo que es importante saber

VS Code está construido sobre Electron, que utiliza el motor Chromium para solicitudes de red. Esto significa que las configuraciones de proxy funcionan de manera similar a las de un navegador: el editor admite proxies HTTP, HTTPS y SOCKS5.

Es importante entender la jerarquía por la cual VS Code busca configuraciones de proxy:

1. Configuraciones de proxy del sistema — si en Windows/macOS/Linux se ha configurado un proxy del sistema, VS Code lo recogerá automáticamente (parámetro http.systemProxy).
2. Variables de entorno — HTTP_PROXY, HTTPS_PROXY, NO_PROXY — forma estándar para Linux/macOS.
3. Configuraciones en settings.json — especificación explícita del proxy a través de los parámetros http.proxy y opciones relacionadas.
4. Argumentos de línea de comandos — se puede iniciar VS Code con banderas de proxy directamente.

Prioridad: las configuraciones explícitas en settings.json anulan las variables de entorno, que a su vez anulan las configuraciones del sistema. Si algo no funciona, verifique en este orden.

Configuración del proxy a través de settings.json: paso a paso

Este es el método más confiable y recomendado. Las configuraciones en settings.json se aplican globalmente a todas las solicitudes de red de VS Code.

Paso 1: Abra settings.json

Presione Ctrl+Shift+P (o Cmd+Shift+P en Mac), escriba «Open User Settings (JSON)» y seleccione esta opción. Se abrirá el archivo de configuraciones del usuario.

Paso 2: Agregue los parámetros del proxy

Inserte las líneas necesarias dentro del objeto JSON. Ejemplos para diferentes tipos de proxy:

Proxy HTTP/HTTPS (sin autenticación):

{
  "http.proxy": "http://192.168.1.100:3128",
  "http.proxyStrictSSL": false
}

Proxy HTTP/HTTPS con nombre de usuario y contraseña:

{
  "http.proxy": "http://username:password@proxy-host:3128",
  "http.proxyStrictSSL": false
}

Proxy SOCKS5:

{
  "http.proxy": "socks5://username:password@proxy-host:1080",
  "http.proxyStrictSSL": false
}

Paso 3: Familiarícese con los parámetros

Parámetro	Valor	Cuándo usar
http.proxy	URL del proxy	Parámetro principal, obligatorio
http.proxyStrictSSL	true / false	false — si el proxy utiliza un certificado autofirmado
http.proxyAuthorization	Cadena Base64	Método alternativo para pasar nombre de usuario/contraseña
http.noProxy	Lista de dominios	Dominios que deben evitar el proxy (localhost, hosts internos)
http.systemProxy	on / off / override	Controlar el proxy del sistema (nuevo parámetro en VS Code 1.87+)

Paso 4: Reinicie VS Code

Después de guardar settings.json, cierre completamente y vuelva a abrir VS Code. A veces, un reinicio parcial (Reload Window) no aplica las nuevas configuraciones de red.

Proxy a través de variables de entorno (HTTP_PROXY / HTTPS_PROXY)

Este método es especialmente conveniente en Linux y macOS, así como en equipos donde el proxy se configura a nivel de sistema y debe aplicarse a todas las herramientas de desarrollo, no solo a VS Code, sino también a npm, pip, git, etc.

Linux / macOS — configuración permanente

Agregue a ~/.bashrc, ~/.zshrc o ~/.profile:

export HTTP_PROXY="http://username:password@proxy-host:3128"
export HTTPS_PROXY="http://username:password@proxy-host:3128"
export NO_PROXY="localhost,127.0.0.1,*.local,*.internal"

Después de esto, ejecute source ~/.bashrc (o vuelva a iniciar sesión) y ejecute VS Code desde la terminal con el comando code . — las variables serán heredadas.

Windows — a través de variables del sistema

Abra "Propiedades del sistema" → "Configuración avanzada del sistema" → "Variables de entorno". Agregue las variables HTTP_PROXY y HTTPS_PROXY en la sección "Variables de usuario" (o "Variables del sistema" para aplicar a todos los usuarios). Después de guardar, reinicie VS Code.

Ejecutar VS Code con proxy directamente desde la línea de comandos

Si necesita verificar rápidamente sin configuración permanente:

# Linux/macOS
HTTP_PROXY=http://proxy-host:3128 HTTPS_PROXY=http://proxy-host:3128 code .

# Windows PowerShell
$env:HTTP_PROXY="http://proxy-host:3128"; $env:HTTPS_PROXY="http://proxy-host:3128"; code .

Settings Sync a través de proxy: diagnóstico y solución de problemas

Settings Sync es una función integrada de VS Code que sincroniza configuraciones, extensiones, fragmentos, atajos de teclado y perfiles entre dispositivos a través de una cuenta de Microsoft o GitHub. Funciona a través de solicitudes HTTPS a los servidores de Microsoft y GitHub, y aquí es donde el proxy es críticamente importante.

Errores típicos de Settings Sync a través de proxy

Error	Causa	Solución
«Cannot connect to the server»	Proxy no configurado o bloqueado	Configurar http.proxy en settings.json
«Authentication failed»	El proxy intercepta el token de OAuth	Desactivar la inspección SSL para *.microsoft.com
«Sync is turned on but not syncing»	El proxy corporativo bloquea WebSocket	Utilizar un proxy que soporte WebSocket
La sincronización se queda atascada en «Syncing...»	Timeout de conexión a través de un proxy lento	Cambiar a un proxy más rápido

Diagnóstico a través de Output

Abra View → Output y en el menú desplegable seleccione «Settings Sync». Aquí se ven todos los intentos de conexión y códigos de error. Busque líneas con ECONNREFUSED, 407 Proxy Authentication Required o CERT_UNTRUSTED — cada uno de estos códigos indica un problema específico con el proxy.

Si ve el error 407 — el proxy requiere autorización, agregue el nombre de usuario y la contraseña a la URL del proxy. Si CERT_UNTRUSTED — establezca "http.proxyStrictSSL": false o agregue el certificado raíz del CA corporativo.

Dominios que deben ser accesibles para Settings Sync

Asegúrese de que a través de su proxy sean accesibles los siguientes hosts:

• login.microsoftonline.com — autorización a través de Cuenta de Microsoft
• github.com — autorización a través de GitHub
• api.github.com — API de GitHub para sincronización a través de Gist
• vscode.dev — servicio de sincronización de VS Code
• *.vscode-cdn.net — CDN para recursos de VS Code

Marketplace de Extensiones: por qué no se instalan extensiones y cómo solucionarlo

El Marketplace de VS Code funciona a través del dominio marketplace.visualstudio.com y servidores CDN de Microsoft. Si el proxy está configurado correctamente, la instalación de extensiones funciona de manera transparente. Pero hay algunos problemas específicos.

La extensión se instala, pero no funciona

Muchas extensiones realizan sus propias solicitudes de red al iniciarse — por ejemplo, descargan servidores de lenguaje (LSP), dependencias binarias o actualizaciones de bases de datos. Estas solicitudes pasan a través de Node.js dentro de la extensión, y están sujetas a las configuraciones de proxy de VS Code, pero solo si la extensión está escrita teniendo en cuenta las variables HTTP_PROXY.

Si la extensión aún no funciona detrás del proxy, verifique su documentación. Muchas extensiones populares tienen sus propias configuraciones de proxy. Por ejemplo:

• Python (Pylance/Pylint) — utiliza variables de entorno del sistema
• ESLint, Prettier — funcionan localmente, no se necesita proxy
• GitHub Copilot — requiere acceso a api.github.com, recoge el proxy de settings.json
• Remote - SSH — el proxy es necesario para el túnel SSH, se configura por separado en el archivo de configuración SSH
• Docker — utiliza el proxy del sistema del daemon de Docker

Instalación manual de extensiones (offline)

Si el proxy no está disponible o es inestable, las extensiones se pueden instalar manualmente a través de un archivo .vsix. Descargue el archivo de extensión desde marketplace.visualstudio.com en una máquina con acceso a Internet, luego en VS Code: Extensiones → ··· → Instalar desde VSIX.

Qué tipo de proxy elegir para VS Code

La elección del tipo de proxy depende de la tarea. Analicemos las opciones principales en relación con el desarrollo.

Tipo de proxy	Velocidad	Confiabilidad	Cuándo es adecuado para VS Code
Proxy de centros de datos	⚡ Alta	✅ Estables	Eludir restricciones corporativas, descargar extensiones, pipelines de CI/CD
Proxies residenciales	🔄 Media	✅ Alta confianza	Acceso a recursos geobloqueados, pruebas desde una región específica
Proxies móviles	🔄 Media	✅ Máxima confianza	Rara vez necesarios para VS Code, pero útiles al desarrollar aplicaciones móviles con pruebas geográficas
Proxy corporativo (Squid, ISA)	⚡ Alta	⚠️ Depende de la configuración	Entorno de oficina, obligatorio por política de la empresa

Para la mayoría de los desarrolladores que solo necesitan eludir restricciones corporativas o trabajar desde un país con acceso inestable a los servidores de Microsoft, la opción óptima serán los proxies de centros de datos: son rápidos, estables y adecuados para tareas técnicas como la descarga de paquetes y la sincronización de configuraciones.

Si la tarea es probar una aplicación desde una región geográfica específica (por ejemplo, verificar cómo funciona su servicio para usuarios en Alemania o EE. UU.), entonces serán útiles los proxies residenciales con IP reales de usuarios domésticos del país necesario.

Proxy corporativo con inspección SSL: un caso especial

Los proxies corporativos con función de inspección SSL (man-in-the-middle) son un dolor de cabeza separado para los desarrolladores. Este tipo de proxy descifra el tráfico HTTPS, lo verifica y lo vuelve a cifrar, firmándolo con su certificado corporativo. Como resultado, VS Code ve un certificado "desconocido" y se niega a funcionar.

Síntomas

• Error CERT_UNTRUSTED o unable to verify the first certificate en Output
• Las extensiones no se instalan, aunque el proxy está configurado correctamente
• Settings Sync no se autoriza
• npm y pip también se quejan de los certificados

Solución 1: Desactivar la verificación SSL (rápido, pero menos seguro)

{
  "http.proxyStrictSSL": false
}

Esta es una solución rápida que desactiva la verificación del certificado SSL del proxy. Adecuada para una red corporativa interna donde el proxy es de confianza.

Solución 2: Agregar el certificado CA corporativo (el camino correcto)

Obtenga del administrador del sistema el certificado raíz corporativo (archivo .pem o .crt) y agréguelo a la configuración:

{
  "http.proxy": "http://corporate-proxy:3128",
  "http.proxyStrictSSL": true,
  "http.proxyCertificates": true
}

También agregue el certificado al almacén de certificados del sistema operativo — VS Code utiliza certificados del sistema a partir de la versión 1.40. En Windows, basta con instalar el certificado en "Centros de certificación raíz de confianza" a través de certmgr.msc. En Linux, agregue el certificado a /usr/local/share/ca-certificates/ y ejecute update-ca-certificates.

Solución 3: Variable NODE_EXTRA_CA_CERTS

VS Code y sus extensiones funcionan en Node.js, por lo que se pueden especificar certificados CA adicionales a través de una variable de entorno:

# Linux/macOS
export NODE_EXTRA_CA_CERTS="/path/to/corporate-ca.pem"

# Windows PowerShell
$env:NODE_EXTRA_CA_CERTS="C:\certs\corporate-ca.pem"

Lista de verificación: VS Code + proxy funciona correctamente

Utilice esta lista de verificación para asegurarse de que todo esté configurado correctamente, o para encontrar rápidamente la causa del problema.

Conclusión

Configurar un proxy en VS Code es una tarea que se resuelve una vez y para siempre, eliminando problemas con un Marketplace colgado, un Settings Sync que no funciona y extensiones que no pueden descargar dependencias. Las conclusiones clave de este artículo son:

• El método más confiable es especificar http.proxy en settings.json: funciona tanto para el editor como para la mayoría de las extensiones.
• Las variables de entorno (HTTP_PROXY, HTTPS_PROXY) son convenientes para unificar la configuración del proxy para todo el entorno de desarrollo.
• Un proxy corporativo con inspección SSL requiere desactivar proxyStrictSSL o instalar el certificado CA corporativo.
• Settings Sync funciona a través del proxy sin configuraciones adicionales: lo principal es que los dominios de Microsoft y GitHub sean accesibles.
• El diagnóstico siempre comienza con Output → Settings Sync y Output → Extensions: allí se ven todos los errores de red con códigos.

Si trabaja en un entorno con acceso limitado a Internet o necesita probar una aplicación desde una región geográfica específica, le recomendamos utilizar proxies de centros de datos para un funcionamiento estable y rápido con herramientas de desarrollo: proporcionan alta velocidad de conexión y son excelentes para tareas técnicas como la descarga de paquetes, la sincronización de configuraciones y el trabajo con repositorios remotos.