Tutoriales de VPS
VS Code Remote SSH a VPS: claves, servidor y agentes (2026)
Prepara Linux compatible, verifica claves y abre el workspace remoto. Reenvía puertos y diagnostica instalación del servidor y agentes.

Para editar un proyecto del VPS desde VS Code local y ejecutar un agente en el mismo directorio remoto, no necesitas instalar un escritorio en el servidor. Remote - SSH de Microsoft instala VS Code Server mediante SSH. Archivos, terminales y la mayoría de extensiones de trabajo se ejecutan en el VPS; tu equipo muestra el editor. La guía usa Ubuntu y un desarrollador, incluyendo instalación del servidor atascada.
A diferencia de code-server en navegador, necesitas VS Code local y un host SSH compatible. El código sigue remoto. Desconectar el editor no conserva procesos interactivos; usa tmux para agentes prolongados.
Comprueba SSH desde terminal y revisa sistema, memoria, disco y herramientas:
ssh [email protected]
uname -m
cat /etc/os-release
free -h
df -h "$HOME"
command -v bash tar curl || true
Sustituye usuario/IP: 203.0.113.10 es dirección documental. La guía Remote - SSH indica mínimo 1 GB y recomienda 2 GB y dos núcleos. Reserva más para build, tests y agentes. Los requisitos Linux incluyen kernel 4.18+, glibc 2.28+, libstdc++ 3.4.25+, OpenSSH Server, Bash, tar y curl o wget. Ubuntu 22.04/24.04/26.04 con glibc facilita la instalación; Alpine con musl queda fuera de este host.
Instala herramientas ausentes en la terminal ya conectada al VPS:
sudo apt update
sudo apt install -y openssh-server bash curl tar ca-certificates git tmux
sudo systemctl status ssh --no-pager
SSH funcionando no requiere cambiar puerto/autenticación por VS Code. Verifica claves antes de modificar sshd_config y conserva una sesión abierta.
Ejecuta en tu ordenador, no el VPS. Reutiliza clave dedicada o comprueba destino antes de crear:
ls -l ~/.ssh/vps_dev ~/.ssh/vps_dev.pub 2>/dev/null || true
ssh-keygen -t ed25519 -f ~/.ssh/vps_dev -C "vps-remote-dev"
Protege la privada con frase de contraseña; SSH agent puede recordarla. Añade la pública .pub a ~/.ssh/authorized_keys del usuario remoto. En macOS/Linux con ssh-copy-id:
ssh-copy-id -i ~/.ssh/vps_dev.pub [email protected]
ssh -i ~/.ssh/vps_dev [email protected] 'whoami'
Sin ssh-copy-id, usa la función de claves del proveedor o añade la salida pública de cat ~/.ssh/vps_dev.pub a ~/.ssh/authorized_keys por sesión fiable. No subas la privada. Verifica huella; ante cambios investiga reinstalación/IP antes de aceptar. StrictHostKeyChecking no oculta problemas de identidad.
Edita ~/.ssh/config local:
Host dev-vps
HostName 203.0.113.10
User ubuntu
Port 22
IdentityFile ~/.ssh/vps_dev
IdentitiesOnly yes
Pon el puerto real en Port si no es 22. Prueba antes de VS Code:
chmod 600 ~/.ssh/config ~/.ssh/vps_dev
ssh -G dev-vps | grep -E '^(hostname|user|port|identityfile) '
ssh dev-vps 'whoami; pwd'
Ante rechazo, consulta usuario/clave real con ssh -v dev-vps. Permission denied (publickey) suele deberse a pública en otro usuario, IdentityFile incorrecto o permisos ~/.ssh/authorized_keys. Repetir contraseña root no lo corrige.
Instala Remote - SSH local. Usa F1 o paleta, ejecuta Remote-SSH: Connect to Host... y elige dev-vps. Espera VS Code Server; con File → Open Folder abre la carpeta remota, por ejemplo /home/ubuntu/app. Abajo a la izquierda debe aparecer SSH: dev-vps.
Ejecuta hostname y pwd: nombre del VPS y ruta confirman terminal remota. Instala extensiones de trabajo donde indique Install in SSH: dev-vps. Las de interfaz suelen ser locales; las del workspace, remotas.
Escucha servicios de desarrollo en loopback, como 127.0.0.1:3000; reenvía 3000 en Ports y usa la URL local mostrada. Comprueba si el framework exige localhost para redirecciones. Si el puerto local está ocupado puede asignar otro. No necesitas abrir 3000 públicamente. Consulta reenvío de puertos.
Confirma pwd y usa agente instalado bajo usuario de desarrollo normal. Código y recursos son del VPS; las peticiones de modelo siguen servicio/autenticación de la herramienta. Usa usuario y rama de desarrollo en vez de acceso ilimitado a producción.
Consulta Codex CLI remoto o Claude Code en VPS. Para interrupciones inicia tmux new -s agent remoto y ejecuta dentro; vuelve con tmux attach -t agent. tmux conserva sesión, no código sin guardar, commits ni copias.
| Síntoma | Revisar | Acción |
|---|---|---|
ssh dev-vps agota tiempo | IP, puerto, firewall y red local | Confirmar IP/SSH del proveedor; VS Code no repara SSH |
Permission denied (publickey) | Usuario/clave de ssh -v dev-vps y pública remota | Revisar User/IdentityFile y usuario |
| SSH funciona, instalar servidor no | Output → Remote - SSH, disco y red | df -h "$HOME" y descarga local oficial |
VS Code Server failed to start | Bibliotecas, disco y logs | Requisitos; Remote-SSH: Kill VS Code Server on Host... y reconectar |
| Prompt oculto/spinner | Frase de clave o segundo factor | Activar remote.SSH.showLoginTerminal |
| Abre archivos, falla extensión/agente | Ubicación, salida y memoria | Extensión remota, free -h y endpoints |
La guía de descargas explica intento remoto y fallback local con transferencia. remote.SSH.localServerDownload en always fuerza descarga local. Extensiones pueden seguir necesitando Marketplace/dependencias desde el VPS. Usa Kill/Uninstall oficiales y logs, sin borrar indiscriminadamente ~/.vscode-server.
Verifica ssh dev-vps local repetible, espacio df -h "$HOME" y puertos accesibles solo a usuarios previstos. Mantén sesión y prueba otra conexión antes de cambios SSH. Separa repositorios, claves y procesos del agente de cuentas productivas.
Referencias: Remote - SSH, requisitos Linux, diagnóstico remoto.