Skip to content

Un server Ubuntu vuoto, una macchina per Claude Code con un comando.

Un solo comando installa Claude Code, un desktop KDE Plasma a cui ti colleghi in RDP, un accesso SSH sicuro e le impostazioni che uso ogni giorno. Quando cambi un'impostazione sul tuo computer, si aggiorna anche il server.

$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
9passaggi di installazione
~10minuti
11lingue
Come funziona

Nove passaggi, tutto in bash open source.

01/09
==> base
✓ base system ready
Guarda i passaggi nel dettaglio →
  1. 01

    base

    Aggiorna il sistema, installa gli strumenti di base e lo swap, attiva gli aggiornamenti di sicurezza automatici.

  2. 02

    user

    Crea un utente con sudo che accede con la tua chiave SSH.

  3. 03

    ssh

    Disattiva l'accesso con password, anche per root. Questa impostazione ha la precedenza su quella dell'immagine cloud.

  4. 04

    firewall

    Attiva il firewall e lascia aperte solo le porte SSH e RDP.

  5. 05

    desktop

    Installa il desktop KDE Plasma. Il server non ha uno schermo, quindi non c'è la schermata di login.

  6. 06

    rdp

    Avvia xrdp sulla porta 53389. Quando ti colleghi parte Plasma, senza richieste di password inutili.

  7. 07

    apps

    Installa Docker, GitHub CLI e Chrome.

  8. 08

    claude

    Installa Claude Code con l'installer ufficiale e configura le notifiche sul telefono.

  9. 09

    dotfiles

    Applica il tuo layout KDE, le impostazioni di Claude, gli hook e la configurazione di tmux.

Cosa c'è dentro

Tutto quello che serve per far lavorare Claude per ore.

claude

Claude Code non si ferma mai

Grazie a tmux, Claude continua a lavorare anche se la connessione SSH cade. Impostazioni, hook e barra di stato sono già pronti.

plasma

Il tuo KDE, uguale a casa

Pannelli, scorciatoie, disposizione delle finestre e profili Konsole vengono presi dal tuo computer e ricreati uguali sul server.

security

Sicuro fin da subito

SSH accetta solo chiavi, a root non si accede con password, firewall e aggiornamenti automatici sono attivi.

ntfy

Notifiche sul telefono

Quando Claude ha una domanda, ricevi una notifica tramite ntfy. Non devi restare davanti al computer.

tools

Strumenti di sviluppo pronti

Docker, GitHub CLI, Node, ripgrep, strumenti di compilazione e Chrome sono già installati.

idempotent

Si può rilanciare senza rischi

Ogni passaggio controlla prima cosa è già installato. Puoi rilanciare lo script quando vuoi, oppure un solo passaggio con --only.

Sincronizzazione

Cambi un'impostazione sul tuo computer, arriva anche sul server.

Tutte le impostazioni stanno nel repository. Le invii dal tuo computer e il server le scarica a intervalli regolari.

01

Il tuo computer

claude-vps publish

Raccoglie le impostazioni di KDE e Claude, toglie i percorsi personali, poi fa commit e push.

02

GitHub

git push

Le impostazioni sono semplici file nella cartella dotfiles/home. È facile vedere cosa è cambiato.

03

Il server

claude-vps sync

Scarica le modifiche e le applica, salvando prima una copia dei vecchi file. Se vuoi, lo fa da solo ogni 30 minuti.

FAQ

Domande frequenti

Claude Code funziona su un VPS?

Sì. Claude Code è un programma da terminale e gira su qualsiasi server Linux. Accedi una volta con un link che apri sul tuo dispositivo. Dentro tmux continua a lavorare anche quando chiudi la connessione.

Che server serve per Claude Code?

Per il solo terminale bastano 2 vCPU e 4 GB di RAM. Con il desktop KDE Plasma, con 4 vCPU e 8 GB di RAM lavori come su un vero computer da scrivania.

Quali versioni di Ubuntu sono supportate?

Ubuntu 24.04 LTS e successive, compresa la 26.04 LTS. Su amd64 viene installato tutto. Su arm64 funziona tutto tranne Chrome.

Serve un abbonamento a Claude?

Sì, un piano che includa Claude Code (Pro o Max) oppure una chiave API Anthropic. claude-vps invece è gratuito e con licenza MIT.

È sicuro aprire RDP su internet?

xrdp cifra la sessione e usa una porta non standard. Se preferisci, con --rdp-private la porta resta chiusa e ti colleghi tramite un tunnel SSH.

Posso usare le mie impostazioni di KDE e Claude?

Sì. Fai un fork del repository, esegui claude-vps capture sul tuo computer e fai puntare l'installazione al tuo fork. Poi il server scarica ogni modifica che pubblichi.

Il tuo nuovo server è pronto in dieci minuti.

Hetzner, DigitalOcean o un vecchio computer di casa: funziona su qualsiasi macchina con Ubuntu 24.04 o successivo.

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

MIT licensed. Not affiliated with Anthropic.