Cómo instalar Claude Code
en un VPS Ubuntu 24.04

Claude Code es el CLI oficial de Anthropic para trabajar con modelos de IA directamente desde la terminal. Instalarlo en un VPS te permite tener un entorno de desarrollo IA persistente, accesible desde cualquier lugar y sin depender de los recursos de tu máquina local.

En este artículo te explicamos qué implica configurarlo desde cero para que entiendas el proceso — y puedas decidir si quieres hacerlo tú mismo o tenerlo listo en minutos.

Requisitos previos

• VPS con Ubuntu 24.04 LTS (mínimo 2 GB RAM)
• Acceso SSH con usuario sudo y claves configuradas correctamente
• Node.js 20 LTS instalado y en PATH
• API key de Anthropic activa (console.anthropic.com)

El punto de partida importa: un VPS recién creado requiere configuración de seguridad base antes de instalar cualquier herramienta de IA — firewall, fail2ban, usuario no-root, swap.

Paso 1 — Preparar el servidor

Antes de instalar Claude Code, el servidor necesita estar endurecido: UFW activo, SSH configurado solo con claves públicas, usuario dedicado con permisos correctos y swap configurado para evitar OOM bajo carga.

Este paso es el que más tiempo toma y donde más errores ocurren en servidores nuevos.

Paso 2 — Instalar Node.js 20 LTS

Claude Code requiere exactamente Node.js 20. La instalación desde los repositorios por defecto de Ubuntu suele traer versiones desactualizadas. Se recomienda usar el repositorio oficial de NodeSource o nvm para gestionar versiones.

Paso 3 — Instalar y verificar Claude Code CLI

El CLI se instala vía npm de forma global. El detalle está en los permisos: instalaciones globales en ciertos setups de Linux requieren configuración adicional para evitar errores de permisos.

Paso 4 — Gestión segura de la API key

Guardar la API key de Anthropic de forma segura es crítico. No debe estar en variables globales de bash ni en archivos de historia del shell. La práctica correcta es usar variables de entorno por proyecto con archivos .env excluidos de git.

Un error común en servidores compartidos es exponer la key en procesos visibles con ps aux.

Paso 5 — Configuración para producción

Para que Claude Code esté disponible 24/7 se necesita más que la instalación: sesiones persistentes con tmux o screen, gestión de procesos con PM2 si hay scripts Node.js asociados, y monitoreo básico para detectar caídas. Sin esto, una desconexión SSH interrumpe cualquier tarea en curso.

¿Cuánto tiempo toma configurarlo desde cero?

En un VPS limpio, con experiencia en Linux y sin errores: entre 45 minutos y 2 horas. Sin experiencia previa, puede tomar medio día y varios intentos — especialmente la parte de seguridad y la gestión de permisos de Node.js.

La alternativa

Nuestros VPS para Claude Code vienen con todo esto preconfigurado y probado: Node.js 20, Claude CLI, Python 3.12, UV, PM2, Caddy y las configuraciones de seguridad listas. Te conectas por SSH y empiezas a trabajar.