Cómo gestiono un servidor VPS desde la terminal con Claude Code (sin ser programador)

El servidor que corre el ecosistema

Uso un VPS de Contabo en Alemania — Ubuntu 22.04, acceso root por SSH. No es la infraestructura más sofisticada del mundo, pero para lo que hace una agencia digital como la mía, es exactamente lo que necesito: control total, costo fijo bajo, y la posibilidad de instalar cualquier herramienta sin pedir permiso a nadie.

En ese servidor viven: digitalglowagency.com, percivalmonge.com, orbitravels.com, hostalloschamos.com, elalphadetail.com, terrawindseguros.com, critika.com.mx (WordPress), ghost.critika.com.mx (Ghost), y los contenedores Docker de n8n, Portainer, y otros servicios.

Antes de Claude Code, gestionar todo esto desde la terminal me tomaba el doble de tiempo y cometía el doble de errores.

SSH desde la terminal: el flujo básico

Para conectarme al servidor uso SSH con sshpass — una utilidad que me permite automatizar la autenticación sin tener que escribir la contraseña cada vez. El comando base es:

sshpass -p 'contraseña' ssh -o StrictHostKeyChecking=no root@IP_del_servidor

Claude Code conoce este patrón porque está documentado en el workspace. Cuando necesito ejecutar algo en el servidor — crear directorios, cambiar permisos, mover archivos — Claude construye el comando correcto y yo lo ejecuto con un clic de aprobación.

Para copiar archivos uso SCP: sshpass -p 'contraseña' scp archivo.php root@servidor:/ruta/destino/. Es como arrastrar un archivo a una carpeta, pero la carpeta está en Alemania.

Lo que aprendí sobre la estructura del servidor

Uno de los momentos más ilustrativos de trabajar con Claude Code fue cuando intenté subir los primeros artículos al servidor y Claude asumió la estructura estándar de Apache — archivos en /var/www/html/. Conexión correcta, directorio incorrecto.

Un ls /home/ resolvió el misterio en segundos: el servidor usa directorios de usuario en /home/[nombredeldominio]/public_html/. Cada sitio tiene su usuario propio, su carpeta de archivos y sus permisos específicos.

Ese descubrimiento lo documenté en el contexto del workspace. Desde entonces Claude llega sabiendo esa estructura — no tengo que redescubrirla en cada sesión.

El sistema de audio IA en producción

Uno de los proyectos más interesantes que construimos en el servidor fue un sistema de generación automática de audio para el blog de critika.com.mx. El flujo funciona así:

1. Se publica un artículo en Ghost (ghost.critika.com.mx)
2. Ghost dispara un webhook a n8n
3. n8n activa un script Python en el servidor (/usr/local/bin/ghost-audio-update.py)
4. El script usa edge-tts — una herramienta de texto a voz de Microsoft — para generar el audio del artículo
5. El audio se sube al servidor y se enlaza en el artículo automáticamente

Todo esto corre en el VPS, sin servicios de terceros, con costo de infraestructura cero (edge-tts es gratis). Claude Code me ayudó a construir y depurar el script Python y el workflow de n8n en una sola sesión de trabajo.

El patrón de permisos que no se puede olvidar

Cada vez que subo un archivo al servidor como root (el usuario administrador), ese archivo queda con propietario root. El servidor web no puede leerlo correctamente — necesita que el propietario sea el usuario del dominio correspondiente.

El comando es chown -R usuario:usuario /ruta/del/archivo. Parece un detalle técnico menor. En la práctica, olvidarlo significa que el artículo que acababas de publicar da error 500 cuando lo intentas abrir.

Claude Code nunca lo olvida. Forma parte del flujo estándar de deploy: subir el archivo con SCP → cambiar los permisos con chown → verificar que el PHP es válido. Esos tres pasos garantizan que el artículo quede live correctamente.

Python en el servidor para operaciones masivas

Cuando necesito hacer cambios en múltiples archivos al mismo tiempo — como actualizar el índice de blog de un sitio con varios artículos nuevos — usar el editor de texto línea por línea no es viable. La solución es un script Python inline que Claude construye en el momento:

python3 -c "content = open('archivo.php').read(); content = content.replace('texto_viejo', 'texto_nuevo'); open('archivo.php', 'w').write(content)"

Es una línea que Claude genera según el caso específico. Actualizar el índice de blog de DGA con 7 artículos nuevos tomó menos de un minuto de esa forma.

Lo que este flujo no puede hacer

Claude Code con acceso SSH a un servidor puede hacer muchas cosas. Pero no tiene criterio sobre qué debe hacerse. Si le pido que borre una carpeta, la borra — sin preguntarme si estoy seguro. Si le pido que modifique la configuración de Apache, lo intenta — sin saber si ese cambio va a romper algo más.

El criterio es mío. Claude ejecuta. Yo decido. Esa división de responsabilidades es lo que hace que el sistema funcione sin catástrofes.

En producción real con datos sensibles de clientes, Claude Code es un copiloto — no el piloto. La diferencia importa.