Ejecutar Claude Code en un VPS: Configuración y Patrones de Acceso

Implementar y ejecutar Claude Code en un VPS ofrece a los desarrolladores un entorno centralizado y de alto rendimiento para el desarrollo agéntico que se mantiene independiente de las limitaciones del hardware local. Al mover el proceso del agente a un Servidor Privado Virtual, te aseguras de que las tareas de larga duración, las factorizaciones complejas y las suites de pruebas puedan seguir ejecutándose incluso si tu máquina local se desconecta. Esta guía explora las consideraciones arquitectónicas, las implicaciones de seguridad y los patrones de configuración específicos necesarios para mantener una conexión fluida entre tu interfaz local y una instancia remota de Claude Code.

La importancia de una configuración de agentes en la nube

El desarrollo local tradicional implica ejecutar herramientas de CLI directamente en tu computadora portátil. Sin embargo, al usar herramientas agénticas como Claude Code, las demandas de recursos pueden fluctuar significativamente durante la indexación intensa de archivos o el análisis de bases de código a gran escala. Un VPS proporciona una IP estable, entornos de construcción consistentes y la capacidad de aprovechar velocidades de red más rápidas para descargar dependencias o desplegar artefactos.

El uso de una configuración de agentes en la nube también facilita una mejor colaboración. Dado que la sesión vive en un servidor, puedes conectarte y desconectarte del proceso sin perder el contexto de la conversación o el estado actual del sistema de archivos. Esto es particularmente útil para equipos que trabajan en sistemas heredados donde la configuración del entorno es frágil y difícil de replicar en diferentes máquinas.

Preparación del entorno remoto

Antes de comenzar la instalación, debes asegurarte de que tu VPS cumpla con los requisitos básicos para los agentes de código modernos. Claude Code y herramientas CLI similares generalmente requieren una versión reciente de Node.js junto con utilidades del sistema específicas como git y curl para interactuar con tus repositorios.

1. Provee un VPS con al menos 4GB de RAM. Aunque las instancias más pequeñas pueden funcionar, los agentes a menudo realizan operaciones pesadas que pueden activar el cierre por falta de memoria (OOM) en máquinas de 1GB o 2GB.
2. Instala un administrador de procesos como tmux o screen. Esto es crítico porque permite que el agente sobreviva a una desconexión de SSH.
3. Configura tus claves de API. Dado que Claude Code requiere autenticación con Anthropic, debes almacenar tus claves en una variable de entorno segura o en un archivo protegido dentro de tu directorio personal.

Una vez que el entorno esté preparado, puedes instalar el agente a través de tu gestor de paquetes preferido. Generalmente se recomienda una instalación global para asegurar que el binario esté disponible en diferentes contextos de directorio dentro del servidor.

Patrones de seguridad y conectividad

Ejecutar un agente de código en un servidor remoto introduce riesgos de seguridad específicos. El agente tiene la autoridad para leer, escribir y borrar archivos basándose en sus instrucciones. Por lo tanto, debes limitar su alcance utilizando permisos estándar de Linux.

Túneles SSH y persistencia

El método más común para acceder a un VPS es a través de SSH. Para mantener una sesión persistente para Claude Code, debes iniciar una sesión de tmux inmediatamente después de iniciar sesión.

tmux new -s sesion-claude
claude-code

Si tu terminal se cierra, simplemente puedes volver a conectarte y ejecutar tmux attach -t sesion-claude para reanudar exactamente donde el agente se quedó. Este patrón es fundamental para cualquier flujo de trabajo de tipo local-first donde la ejecución ocurre en otro lugar pero el control permanece en tus manos.

Acceso directo a través de clientes de escritorio

Administrar múltiples sesiones SSH manualmente puede volverse tedioso a medida que tu proyecto crece. Algunas herramientas, como Deska, te permiten integrar estas sesiones remotas en un espacio de trabajo estructurado. Deska es una aplicación de escritorio gratuita para Mac, Windows y Linux que proporciona un espacio de trabajo de lienzo infinito donde puedes colocar paneles de terminal.

En Deska, puedes abrir múltiples terminales lado a lado. Un panel puede albergar una terminal local para operaciones de git, mientras que otro mantiene una conexión SSH persistente a tu VPS ejecutando Claude Code. Este enfoque de canvas te permite alejarte y ver el estado de tu agente remoto junto con tu documentación o código local.

Integración de agentes de IA en tu flujo de trabajo

Cuando tienes Claude Code ejecutándose en tu VPS, puedes emparejarlo con otras herramientas para crear una suite de desarrollo integral. Muchos desarrolladores prefieren ejecutar agentes de código como Codex CLI o OpenCode en paralelo para comparar sugerencias o manejar diferentes partes de una arquitectura de microservicios.

Ejecución simultánea de agentes

Una ventaja significativa de usar un espacio de trabajo dedicado es la capacidad de ejecutar estos agentes como paneles independientes. Por ejemplo, puedes tener:

• Claude Code investigando un cuello de botella de rendimiento en el VPS.
• Una terminal local ejecutando suites de pruebas para verificar cambios.
• Un panel de navegador especializado para consultar documentación.

Deska admite esto permitiéndote colocar paneles de terminal en cualquier lugar del lienzo. Debido a que es una aplicación local-first, tus archivos y metadatos de sesión permanecen en tu máquina, incluso cuando el agente se comunica con un servidor remoto.

Integración de voz y chat

Las herramientas de desarrollo modernas incorporan cada vez más entradas multimodales. Deska incluye Ask Deska, un asistente de voz y chat que puede dirigir el espacio de trabajo. Por ejemplo, podrías usar comandos de voz para abrir nuevas terminales o verificar el estado de una sesión remota sin escribir comandos SSH manualmente cada vez. Esto reduce la carga cognitiva de gestionar una configuración de agentes en la nube.

Manejo de acceso móvil y monitoreo

Uno de los mayores desafíos con una configuración de VPS es monitorear tareas de larga duración cuando estás lejos de tu escritorio. Los métodos tradicionales requieren configurar VPNs complejas o exponer puertos, lo que aumenta la superficie de ataque de tu servidor.

Deska ofrece una aplicación mobile que resuelve esto a través de un relevo seguro. Te permite monitorear y continuar el trabajo desde tu teléfono vinculando los dispositivos directamente. Debido a que no se exponen puertos, mantienes un alto nivel de seguridad mientras permaneces conectado a la sesión de Claude Code que se ejecuta en tu VPS. Esto es particularmente útil para verificar si una construcción remota se completó o si el agente requiere más aclaraciones sobre una tarea.

FAQ

¿Cómo usar Claude Code vía SSH en un servidor remoto?

Para usar Claude Code vía SSH, conéctate a tu VPS usando una terminal y luego inicia un administrador de sesiones como tmux para asegurar que el proceso continúe si te desconectas. Instala el agente usando npm, exporta tus claves de API y ejecuta el binario dentro de esa sesión persistente.

¿Mejores prácticas para configurar agentes en la nube?

Las mejores prácticas incluyen usar un usuario no root con permisos restringidos para el agente, implementar claves SSH en lugar de contraseñas y utilizar un espacio de trabajo de múltiples paneles para monitorear la salida del agente junto con tu código y registros.

¿Puedo ejecutar múltiples agentes de IA lado a lado?

Sí, puedes ejecutar múltiples agentes lado a lado abriendo múltiples instancias de terminal. Herramientas como Deska facilitan esto al proporcionar un workspace donde diferentes paneles de agentes pueden organizarse en un lienzo infinito, permitiendo la comparación en tiempo real de sus resultados.

Primeros pasos con espacios de trabajo avanzados

Transicionar tu desarrollo a un VPS con Claude Code es un paso significativo hacia una arquitectura más robusta. Al desacoplar tu entorno de ejecución de tu hardware físico, ganas flexibilidad y potencia. Para aquellos que buscan gestionar estas conexiones remotas dentro de una interfaz visual unificada, pueden explorar las funciones disponibles en Deska.

El espacio de trabajo en sí es de uso gratuito y puedes traer tus propias claves de API para el nivel "lifetime". Puedes descargar la aplicación para tu sistema operativo preferido y comenzar a construir tu entorno personalizado hoy mismo. Ya sea que estés usando terminales para hablar con un VPS remoto o simplemente organizando tus notas locales, tener un lienzo centralizado simplifica la complejidad del desarrollo agéntico moderno.