Skip to content

Un servidor Ubuntu vacío, listo para Claude Code con un comando.

Un solo comando instala Claude Code, un escritorio KDE Plasma al que te conectas por RDP, SSH seguro y la misma configuración que uso a diario. Si cambias algo en tu ordenador, el servidor también se actualiza.

$curl -fsSL https://raw.githubusercontent.com/halitsever/claude-code-vps/main/install.sh | sudo bash
Ubuntu 26.04✦KDE Plasma 6✦xrdp✦tmux✦Claude Code✦Docker✦GitHub CLI✦Chrome✦ntfy.sh✦ufw✦systemd timers✦VitePress✦Ubuntu 26.04✦KDE Plasma 6✦xrdp✦tmux✦Claude Code✦Docker✦GitHub CLI✦Chrome✦ntfy.sh✦ufw✦systemd timers✦VitePress✦
1comando
9pasos de instalación
~10minutos
11idiomas
Cómo funciona

Nueve pasos, todo en bash que puedes leer.

01/09
==> base
✓ base system ready
Ver cada paso en detalle →
  1. 01

    base

    Actualiza el sistema, instala las herramientas básicas y swap, y deja activadas las actualizaciones de seguridad automáticas.

  2. 02

    user

    Crea un usuario con sudo que entra con tu clave SSH.

  3. 03

    ssh

    Desactiva el acceso con contraseña, también para root. Se aplica por encima de la configuración por defecto de la imagen del proveedor.

  4. 04

    firewall

    Activa el firewall y solo deja abiertos los puertos de SSH y RDP.

  5. 05

    desktop

    Instala el escritorio KDE Plasma. El servidor no tiene pantalla, así que no se instala pantalla de inicio de sesión.

  6. 06

    rdp

    Pone xrdp en el puerto 53389. Al conectarte arranca Plasma, sin avisos de contraseña innecesarios.

  7. 07

    apps

    Instala Docker, GitHub CLI y Chrome.

  8. 08

    claude

    Instala Claude Code con el instalador oficial y configura las notificaciones al móvil.

  9. 09

    dotfiles

    Aplica tu distribución de KDE, la configuración de Claude, los hooks y la configuración de tmux.

Qué incluye

Todo lo que necesita un Claude que trabaja durante horas.

claude

Claude Code siempre en marcha

Gracias a tmux, Claude sigue trabajando aunque se corte tu conexión SSH. Tu configuración, tus hooks y tu barra de estado vienen listos.

plasma

Tu propio KDE

Paneles, atajos, organización de ventanas y perfiles de Konsole se copian de tu ordenador y se aplican igual en el servidor.

security

Seguro desde el principio

SSH solo acepta claves, root no puede entrar con contraseña, y el firewall y las actualizaciones automáticas están activados.

ntfy

Avisos en el móvil

Cuando Claude te pregunta algo, te llega una notificación al móvil por ntfy. No hace falta quedarse delante del ordenador.

tools

Herramientas de desarrollo

Docker, GitHub CLI, Node, ripgrep, herramientas de compilación y Chrome vienen instalados.

idempotent

Puedes ejecutarlo otra vez

Cada paso comprueba primero lo que ya está instalado. Puedes volver a lanzar el script cuando quieras, o ejecutar solo un paso con --only.

Sincronización

Lo cambias en tu ordenador y llega al servidor.

Toda la configuración vive en el repo. La publicas desde tu ordenador y el servidor la descarga cada cierto tiempo.

01

Tu ordenador

claude-vps publish

Recoge la configuración de KDE y Claude, quita las rutas personales, hace commit y push.

02

GitHub

git push

La configuración se guarda como archivos normales en dotfiles/home. Es fácil ver qué ha cambiado.

03

Servidor

claude-vps sync

Descarga los cambios y los aplica, guardando copia de los archivos que reemplaza. También puede hacerlo solo cada 30 minutos.

FAQ

Preguntas frecuentes

¿Se puede usar Claude Code en un VPS?

Sí. Claude Code es una aplicación de terminal y funciona en cualquier servidor Linux. Inicias sesión una vez con un enlace que abres en tu propio dispositivo, y dentro de tmux sigue funcionando aunque te desconectes.

¿Qué servidor necesito para Claude Code?

Para usar solo la terminal bastan 2 vCPU y 4 GB de RAM. Con el escritorio KDE Plasma, 4 vCPU y 8 GB de RAM se sienten como un equipo de trabajo de verdad.

¿Qué versiones de Ubuntu son compatibles?

Ubuntu 24.04 LTS y posteriores, incluida la 26.04 LTS. En amd64 se instala todo, en arm64 todo menos Chrome.

¿Necesito una suscripción a Claude?

Necesitas un plan que incluya Claude Code (Pro o Max) o una clave de API de Anthropic. claude-vps es gratis y tiene licencia MIT.

¿Es seguro abrir RDP a internet?

xrdp cifra la sesión y usa un puerto distinto del habitual. Si lo prefieres, con --rdp-private el puerto queda cerrado y te conectas por un túnel SSH.

¿Puedo usar mi propia configuración de KDE y Claude?

Sí. Haz un fork del repo, ejecuta claude-vps capture en tu ordenador y apunta el instalador a tu fork. El servidor recibirá cada cambio que publiques.

Tu próximo servidor, listo en diez minutos.

Hetzner, DigitalOcean o un ordenador que tengas libre en casa: funciona en cualquier máquina con Ubuntu 24.04 o posterior.

$curl -fsSL https://raw.githubusercontent.com/halitsever/claude-code-vps/main/install.sh | sudo bash

MIT licensed. Not affiliated with Anthropic.