Eseguire Claude Code su un VPS

Eseguire Claude Code su un server invece che sul portatile ti dà tre cose. Continua a lavorare quando il portatile è chiuso. Sopravvive a una connessione caduta. E mette l'agente su una macchina che puoi buttare via, non su quella con le tue chiavi SSH e il tuo profilo del browser. Questa guida copre una configurazione che richiede circa quindici minuti su una macchina Debian o Ubuntu appena creata. Gli stessi passaggi funzionano su Alpine e Fedora con piccole modifiche.

Ti serve un piano Claude che includa Claude Code: Pro, Max, Team o Enterprise, oppure un account Console. Il piano gratuito di claude.ai non lo include. Accedi con il tuo abbonamento e non ci sono chiavi API da gestire né utilizzo fatturato in più.

1. Scegli una macchina

I requisiti di sistema di Anthropic indicano 4 GB di RAM o più e un processore x64 o ARM64. I sistemi Linux supportati sono Ubuntu 20.04+, Debian 10+ e Alpine 3.19+. In pratica è il toolchain del tuo progetto a decidere, più della CLI:

• 4 GB: il minimo documentato, va bene per una sessione su un progetto modesto.
• 8 GB: se compili qualcosa di consistente (un bundler, una suite di test, un container o due) o esegui più sessioni insieme.
• 16 GB: se esegui più agenti in parallelo, o un database accanto.

Hetzner, DigitalOcean, Scaleway, OVH, Vultr e altri vanno tutti bene, e lo stesso vale per una vecchia macchina sotto la scrivania. Scegli una regione vicina a te se ti capiterà di scrivere in un terminale su di essa. Le istanze ARM sono di solito le più economiche per gigabyte e Claude Code ci gira in modo nativo. La nostra guida al miglior VPS per agenti di coding confronta provider e dimensioni.

2. Crea un utente non root

Molte immagini VPS ti fanno accedere come root. Non eseguire l'agente come root: trasforma ogni errore in un errore a livello di sistema. Claude Code inoltre si rifiuta di partire in modalità bypass-permissions come root, quindi prima o poi ti servirà comunque un utente normale. Su Debian o Ubuntu:

adduser dev
usermod -aG sudo dev
rsync --archive --chown=dev:dev ~/.ssh /home/dev

Su Fedora il gruppo di amministrazione è wheel invece di sudo. Su Alpine, installa prima sudo o doas. L'ultima riga copia la chiave con cui hai già fatto l'accesso, così puoi ricollegarti come dev prima di blindare qualsiasi cosa. Provalo da un secondo terminale prima di chiudere il primo. Restare chiusi fuori da un VPS nuovo è un rito di passaggio che conviene saltare.

3. Chiavi SSH e hardening

Se accedi ancora con una password, passa prima a una chiave. Generane una sul tuo computer con ssh-keygen -t ed25519, poi copiala sul server con ssh-copy-id dev@your-server. Quando l'accesso con chiave funziona, modifica /etc/ssh/sshd_config:

PermitRootLogin no
PasswordAuthentication no
PubkeyAuthentication yes

Poi riavvia SSH: sudo systemctl restart ssh su Debian e Ubuntu. Su Fedora il servizio si chiama sshd, quindi esegui sudo systemctl restart sshd. Per andare oltre, aggiungi fail2ban e un firewall che consenta solo SSH. Se la macchina non ha bisogno di stare sull'internet pubblico, mettila su una rete Tailscale. Il telefono entra nella stessa rete e la raggiunge direttamente.

Dal telefono: le app SSH possono generare una chiave sul dispositivo e mostrarti la parte pubblica da incollare in ~/.ssh/authorized_keys. Maude lo fa per te: il suo pulsante «Configura accesso con chiave» crea una chiave tramite la connessione con cui hai già fatto l'accesso. Installa la parte pubblica, prova la nuova chiave e conserva la parte privata solo nel portachiavi del telefono.

4. Installa Claude Code

Anthropic ora consiglia l'installer nativo, che non richiede Node.js. Eseguilo con il tuo utente normale, non con sudo:

curl -fsSL https://claude.ai/install.sh | bash
claude --version
claude doctor

Mette il launcher in ~/.local/bin/claude e si aggiorna da solo in background. claude doctor controlla l'installazione e le impostazioni senza avviare una sessione. Alcune alternative, tutte dalla documentazione di setup:

• Repository apt, dnf e apk firmati se preferisci che se ne occupi il gestore di pacchetti del sistema. Non si aggiornano da soli; li aggiorni insieme al resto del sistema.
• npm funziona ancora (npm install -g @anthropic-ai/claude-code, Node.js 22 o successivo). Installa lo stesso binario nativo. Anthropic sconsiglia sudo npm install -g.
• Alpine richiede bash, curl, libgcc, libstdc++ e ripgrep, più USE_BUILTIN_RIPGREP=0 nelle impostazioni.

Se una guida più vecchia ti diceva di installare prima Node, ora puoi saltare quel passaggio.

5. Accedi senza browser

Esegui claude (o claude auth login) e segui le istruzioni. Un VPS non ha un browser, quindi aprirai l'URL di accesso su un altro dispositivo. Claude Code ti permette di premere c per copiarlo. Accedi lì. Quando il browser non riesce a raggiungere il callback locale di Claude Code, cosa normale via SSH, mostra invece un codice. Incollalo alla riga Paste code here if prompted e l'accesso si completa sul server.

La credenziale viene salvata in ~/.claude/.credentials.json con permessi 0600. Tratta la macchina di conseguenza: chiunque abbia una shell con quell'utente può usare il tuo abbonamento Claude. Per script e CI c'è anche claude setup-token, che stampa un token valido un anno da impostare come CLAUDE_CODE_OAUTH_TOKEN. Secondo la documentazione sull'autenticazione, quel token può solo fare richieste al modello e non può avviare sessioni Remote Control.

6. Tienilo in vita

Tutto ciò che avvii in primo piano in una sessione SSH muore con quella connessione. La soluzione abituale è tmux:

sudo apt install tmux
tmux new -s work
# start claude, then detach with Ctrl-B then D
tmux attach -t work

Puoi staccarti, perdere il segnale, ricollegarti ore dopo e riagganciarti, e la sessione è intatta. tmux però non sopravvive a un riavvio. Dopo un riavvio, claude --continue riprende la conversazione più recente in quella cartella. La nostra guida su come tenere Claude Code attivo dopo aver chiuso il portatile copre le altre opzioni, tra cui systemd e i daemon di sessioni.

7. Stessa macchina, più agenti

Un server che esegue Claude Code può eseguire gli altri agenti di coding accanto. Ognuno si installa nella tua home e mantiene il proprio accesso, quindi non si intralciano. Lascia RAM sufficiente per ciascuno di quelli che girano contemporaneamente.

Fonti: autenticazione di Codex, documentazione di OpenCode, documentazione di Grok Build, installazione di Antigravity CLI, verificate a ottobre 2026. Codex e Antigravity hanno le loro guide dedicate: Codex CLI su un VPS e Antigravity CLI su un server. Gemini CLI non è più un'opzione per gli account Google personali, e Antigravity CLI è il suo sostituto secondo Google.

8. Raggiungilo dal telefono

Ci sono tre modi, dal più manuale al meno manuale:

Un'app SSH e tmux. Termius, Blink o qualsiasi altro client, collegato alla tua sessione tmux. È gratis e completo, e guidi un terminale a schermo intero con una tastiera virtuale. Ecco il confronto.

Remote Control. Avvia claude remote-control dentro tmux e apri la sessione dalla scheda Code dell'app Claude. È incluso in Pro, Max, Team ed Enterprise. La documentazione di Anthropic suggerisce tmux o screen proprio per questo caso. Funziona solo per Claude, e le richieste di permesso della sessione arrivano sul telefono perché tu risponda. L'app non può passare la sessione ad Auto o a Bypass permissions.

Maude. Maude si occupa per te dei passaggi 4 e 6, e il passaggio 5 si sposta sul telefono. Aggiungi il server tramite indirizzo, incollando un comando ssh … o scansionando un QR code da curl -fsSL https://maude.pilotdev.fr/setup | sh. Se hai fatto l'accesso come root, un pulsante crea per te l'utente non root del passaggio 2. Maude poi distribuisce il proprio daemon via SSH e installa ogni agente in una versione che abbiamo testato e fissato. Accedi a Claude, Codex o a uno qualsiasi degli altri dal telefono. Le sessioni continuano a girare sul server quando l'app è chiusa, ed è il server a collegarsi al relay di Maude, quindi funziona dietro NAT senza porte aperte.

9. Decidi i permessi

Ora la domanda interessante: quanto gli lasci fare senza supervisione? Un server che puoi ricostruire è il posto giusto per allentare i permessi, purché tu l'abbia davvero trattato come usa e getta. La modalità auto di Claude Code, in cui un classificatore approva le azioni sicure, copre buona parte della distanza. Il bypass completo ha regole proprie, compresa la restrizione per root vista al passaggio 2. Hanno una pagina dedicata: eseguire Claude Code con tutti i permessi, in sicurezza.

Gestiscilo dal telefono

Una volta che il server è pronto, Claude Code sul telefono spiega come lo gestisce Maude. Se Claude non è il tuo unico agente, parti dalla panoramica degli agenti.

Domande frequenti

Cosa è cambiato

• 1 ottobre 2026 — Installazione passata all'installer nativo di Anthropic (Node.js non più necessario); indicazioni sulla RAM allineate al minimo documentato di 4 GB; aggiunti il flusso di accesso headless con codice incollato e setup-token; nuova sezione su Codex, OpenCode, Grok Build e Antigravity sulla stessa macchina.
• 25 luglio 2026 — Prima pubblicazione.