Was installiert wird
claude-vps setup führt neun Schritte nacheinander aus. Jeder ist eine einfache Bash-Funktion in lib/setup.sh. Du kannst also genau nachlesen, was auf deinem Server läuft. Mit --skip lässt du Schritte aus, mit --only führst du nur bestimmte aus.
1. base
apt upgradefür alle Paketegit curl jq ripgrep fd-find tmux htop build-essential python3und ein paar weitere- Node.js 20 oder neuer. Unter Ubuntu 24.04 hat apt nur Version 18, dort kommt Node.js aus dem NodeSource-Repo
unattended-upgradeswird aktiviert, damit Sicherheitsupdates ohne dein Zutun eingespielt werden- eine Swap-Datei mit 4 GB, wenn der Server keinen Swap und weniger als 8 GB RAM hat. So beendet der OOM-Killer weder Plasma noch deine Agenten
- die Zeitzone, wenn du
--timezoneangibst
2. user
Legt deinen Benutzer an, fügt ihn zur Gruppe sudo hinzu und kopiert /root/.ssh/authorized_keys zu ihm, falls er noch keine Schlüssel hat. Das Passwort, das du wählst, gibst du später beim RDP-Login ein.
3. ssh
Schreibt /etc/ssh/sshd_config.d/10-claude-vps.conf:
PasswordAuthentication no
KbdInteractiveAuthentication no
PermitRootLogin prohibit-passwordsshd nimmt den ersten Wert, den es liest. Deshalb beginnt der Dateiname mit 10-: So hat die Datei Vorrang vor der 50-cloud-init.conf, die die meisten Cloud-Images mitbringen. Hat dein Benutzer noch keinen SSH-Schlüssel, wird der Schritt mit einer Warnung übersprungen. So sperrst du dich nie selbst aus.
4. firewall
ufw lässt OpenSSH und den RDP-Port durch und blockiert alles andere. Mit --rdp-private bleibt auch RDP zu, und du erreichst es über einen SSH-Tunnel.
5. desktop
kde-plasma-desktop mit der X11-Sitzung (plasma-session-x11, kwin-x11 ab Ubuntu 25.10), dazu Konsole, Dolphin, Kate, Spectacle und die Schriften Noto und JetBrains Mono. SDDM wird abgeschaltet und das Standard-Target auf multi-user gesetzt. Vor einem Server sitzt niemand, er startet also direkt in die Konsole. Plasma startet erst, wenn du dich verbindest.
Warum X11
xrdp steuert eine Xorg-Sitzung. Plasma 6 hat unter Ubuntu 24.04 bis 26.04 noch eine X11-Sitzung, und die nutze ich jeden Tag über RDP.
6. rdp
xrdpundxorgxrdpauf Port 53389 (änderbar mit--rdp-port)- eine
~/.xsession, diestartplasma-x11mit den passendenXDG_*-Variablen startet - eine polkit-Regel, die die Abfrage "authentication is required to create a color managed device" abstellt. Ohne sie kommt sie bei jeder Anmeldung
7. apps
- Docker (
docker.io, compose v2, buildx), dein Benutzer kommt in die Gruppedocker - GitHub CLI (
gh) - Google Chrome aus Googles apt-Quelle (nur amd64). Praktisch, wenn Claude einen echten Browser braucht
8. claude
- Claude Code über den offiziellen nativen Installer nach
~/.local/bin/claude. Es aktualisiert sich selbst - claudegrid aus dem neuesten
.deb-Release. Damit öffnest du mit einem Befehl ein Raster aus Claude-Code-Agenten in Konsole oder tmux. Dazu kommen ein Konsole-Profil und ein Eintrag im Anwendungsmenü - dein ntfy.sh-Topic in
~/.claude/ntfy-topic, falls du eins angibst. Der Benachrichtigungs-Hook liest es von dort
9. dotfiles
Übergibt /opt/claude-vps an deinen Benutzer, verlinkt claude-vps nach /usr/local/bin und führt claude-vps apply als dein Benutzer aus. Dabei landet alles aus dotfiles/home in deinem Home-Verzeichnis: KDE-Einstellungen, Konsole-Profile, ~/.claude/settings.json, CLAUDE.md, Hooks und .tmux.conf.
Schritte erneut ausführen
Jeder Schritt prüft zuerst, was schon da ist. Du kannst ihn also gefahrlos noch einmal starten:
sudo claude-vps setup --only desktop,rdp # z. B. nach einem Release-Upgrade
sudo claude-vps setup --skip apps # alles außer Docker und Chrome
sudo claude-vps setup --no-desktop # Server nur mit Terminal