SSD Nodes Learn Hosting plans →
Guide Matt ConnorDi Matt Connor

Come eseguire Claude Code in sicurezza su un server

Claude Code può eseguire comandi con i tuoi privilegi. Scopri cosa cambia con il flag skip permissions e come limitare i danni con sandbox, container o VPS usa e getta.

Cosa significa eseguire Claude Code in sicurezza su un server

Per eseguire Claude Code in sicurezza su un server, mantieni attive le richieste di conferma delle autorizzazioni, eseguilo con un utente dedicato senza privilegi e assegna alle esecuzioni non presidiate un confine di sicurezza reale invece di affidarti alla fiducia: il sandbox integrato, un container oppure un VPS usa e getta che non contenga dati importanti. Il flag `--dangerously-skip-permissions` rimuove il passaggio di approvazione tra il modello e la shell. Questo compromesso può essere ragionevole per le attività non presidiate, ma soltanto all'interno di un confine che limiti ciò che un singolo comando errato può raggiungere. Questa guida spiega che cosa modifica realmente il flag e come costruire quel confine con livelli di isolamento progressivi.

Cosa può fare Claude Code sul tuo server

Claude Code è un agente per la programmazione che viene eseguito nel terminale. Legge file, scrive file ed esegue comandi shell con l'utente che lo ha avviato. Questo è il valore principale dello strumento: può clonare un repository, modificare il codice, eseguire i test, leggere l'errore e correggere il codice in un ciclo continuo, senza che tu debba digitare ogni comando. Se non lo hai ancora configurato su un server, eseguire Claude Code su una VPS con tmux descrive l'installazione e la gestione della sessione. Questa pagina descrive i privilegi che gli concedi dopo la configurazione.

Il rischio è contenuto nella stessa frase, riletta attentamente. Un processo che esegue comandi shell con il tuo utente può fare tutto ciò che può fare il tuo utente. Può leggere ~/.ssh/id_ed25519, ~/.aws/credentials e ogni file .env che il tuo utente può aprire. Può eseguire curl e inviare dati a qualsiasi host raggiungibile dal server. Può eseguire git push --force. L'agente non ha obiettivi propri. Il pericolo nasce quando un'attività va male oppure quando il testo letto durante l'esecuzione contiene istruzioni scritte da qualcun altro: una pagina web recuperata dall'agente o un commento in una issue che gli è stato chiesto di correggere. Il secondo caso è chiamato prompt injection. Per questo motivo, pensare che "il modello sia solitamente ragionevole" non costituisce un piano di sicurezza. Le istruzioni possono arrivare anche da una fonte più vicina, perché due sessioni di Claude Code sullo stesso server possono inviarsi testo, e un messaggio proveniente da una sessione correlata è semplicemente altro testo che l'agente ricevente legge. Devi pianificare anche l'esecuzione anomala, non soltanto quella media.

Il sistema dei permessi in parole semplici

In modalità Manual, Claude Code chiede conferma prima di agire. La lettura dei file all'interno del progetto avviene senza richieste, ma la modifica di un file o l'esecuzione di un comando shell al di fuori dell'insieme integrato di comandi in sola lettura mostra prima l'operazione o il comando esatto e attende una conferma, a meno che non sia già approvato da una regola dei permessi. È possibile approvare una singola operazione oppure indicare di non chiedere più conferma. Per le modifiche ai file, la seconda scelta resta valida fino al termine della sessione; per un comando shell, invece, viene salvata in modo permanente per quel repository e quel comando. Quindi una conferma rapida su un server resta valida anche dopo la fine della sessione. Per le regole che si desidera mantenere intenzionalmente, il file delle impostazioni contiene elenchi persistenti di regole allow, ask e deny. Ad esempio: consentire git status, chiedere conferma per git push, negare le letture di .env. Le regole deny hanno sempre la precedenza. Anche questa impostazione di base è cambiata. La modalità Auto, in cui un classificatore esamina le operazioni al posto dell'utente, è la modalità iniziale integrata per le sessioni interattive nel terminale e in VS Code, con qualsiasi piano, a partire da Claude Code v2.1.283, salvo che sia stata impostata una modalità predefinita oppure che la modalità Auto non sia disponibile. Prima di decidere quale modalità di autorizzazione usare su un server che non è possibile controllare, è quindi utile sapere che cosa consente effettivamente ogni modalità di autorizzazione.

Questo design presuppone che una persona controlli il terminale. Su un laptop, in genere, è così. Su un server, invece, spesso il punto è proprio che nessuno lo controlli. Si avvia un'attività lunga all'interno di tmux e si va a dormire; se un agent si ferma per porre una domanda alle 2 a.m., non farà progressi fino al mattino. La pausa costa tempo e denaro, perché una sessione Claude Code inattiva perde la cache dei prompt già caricata e il turno successivo deve ricostruirla a pagamento. Questo è il motivo concreto per cui si ricorre al flag skip sui server, e il problema che risolve è reale. Il resto di questa guida spiega come risolverlo senza rinunciare a tutte le protezioni.

Cosa cambia --dangerously-skip-permissions

claude --dangerously-skip-permissions disattiva il passaggio di approvazione. Le modifiche vengono applicate senza richiesta di conferma. I comandi della shell vengono eseguiti senza richiesta di conferma. Vengono saltati anche i controlli sui percorsi protetti che normalmente proteggono le posizioni sensibili. Le regole di negazione definite esplicitamente continuano ad applicarsi e alcune azioni particolarmente rischiose richiedono comunque una conferma, ma il riepilogo operativo è semplice: qualsiasi operazione che il modello decide di eseguire viene eseguita.

Sul server, per questo flag contano due aspetti. Primo, su Linux e macOS viene bloccato quando Claude Code viene eseguito come root o tramite sudo, tranne che all'interno di una sandbox riconosciuta, perché root senza richieste di conferma può modificare qualsiasi file o servizio del computer. In ogni caso, l'agent deve usare un proprio account senza privilegi. Secondo, il flag rimuove il passaggio di approvazione umana; non fornisce isolamento. Di conseguenza, ogni errore che una richiesta di conferma avrebbe bloccato viene ora eseguito.

Ecco quindi la valutazione corretta. Se si saltano le autorizzazioni, la domanda di sicurezza passa da "l'agent eseguirà un'operazione dannosa?" a "quali danni può causare una singola operazione errata?". Non si cerca più di controllare ogni decisione, ma di limitare l'impatto massimo. La risposta è il contenimento, che può essere applicato a più livelli.

La sandbox integrata di Claude Code

Prima di passare ai livelli, considera che Claude Code include ora una sandbox a livello di sistema operativo per i comandi che esegue. Questo elimina gran parte dei motivi per cui si ricorreva al flag skip. Su Linux usa bubblewrap per l'isolamento del filesystem e socat per instradare il traffico di rete tramite un proxy. Per impostazione predefinita, un comando eseguito nella sandbox può scrivere nella directory di lavoro, in una directory temporanea per utente e nelle directory aggiuntive specificate. I percorsi protetti restano in sola lettura. Può accedere alla rete soltanto tramite un proxy che confronta i domini con l'elenco degli host consentiti. In modalità Manual, un nuovo dominio richiede la conferma. In modalità automatica, il classificatore esamina gli host indicati dal comando.

Attivala con il comando /sandbox all'interno di una sessione. Su Ubuntu e Debian, installa prima i due pacchetti necessari:

sudo apt install bubblewrap socat

Le restrizioni AppArmor di Ubuntu possono impedire l'esecuzione di bubblewrap, ma questa non è una regola generale per Ubuntu 24.04 e versioni successive. Ubuntu 25.04 ha introdotto il profilo predefinito bwrap-userns-restrict, che consente la creazione dei namespace e la configurazione della sandbox, quindi limita le capability all'interno della sandbox. Il pannello della sandbox indica quando manca qualcosa. La documentazione sul sandboxing di Claude Code include il breve profilo AppArmor necessario per risolvere il problema.

La sandbox dispone di una modalità di autorizzazione automatica. La maggior parte dei comandi eseguiti nella sandbox viene eseguita senza richiesta di conferma, perché ora è il perimetro di sicurezza applicato a svolgere il lavoro che prima spettava alla richiesta. Le regole di rifiuto, le regole che richiedono conferma per comandi specifici e i controlli per la rimozione di percorsi critici restano comunque attivi. I comandi che non possono essere eseguiti nella sandbox passano al normale flusso delle autorizzazioni. In questo flusso, le autorizzazioni già concesse o la modalità automatica possono consentirne l'esecuzione senza una nuova richiesta. Per la maggior parte dei flussi di lavoro sui server, questa è la sostituzione corretta del flag skip: le richieste diminuiscono sensibilmente, mantenendo un perimetro imposto dal sistema operativo, invece di eliminarlo.

Considera con attenzione i limiti. Per impostazione predefinita, un comando eseguito nella sandbox può ancora leggere gran parte del filesystem, inclusi i file che contengono credenziali, a meno che tu non neghi l'accesso a quei percorsi. L'impostazione sandbox.credentials esiste esattamente per questo. Il proxy di rete controlla i nomi dei domini, ma non esamina il traffico. Un'autorizzazione ampia come github.com lascia quindi comunque la possibilità di trasferire dati all'esterno. Docker non funziona al suo interno. La sandbox innalza notevolmente il livello minimo di protezione. Non costituisce un perimetro di isolamento completo. Per questo i livelli descritti di seguito restano importanti.

La scala di isolamento

Tre livelli, in ordine crescente di isolamento. Scegli il livello più basso compatibile con gli altri servizi presenti sul server.

Livello 1: un utente non privilegiato dedicato. Assegna all’agente un account dedicato, la relativa home directory, una directory di progetto dedicata e nessun accesso sudo:

sudo adduser --disabled-password --gecos "" agent

Il confine dell’account impedisce all’agente di accedere ai tuoi file, alle tue chiavi SSH e agli altri progetti presenti sul server. Inoltre rende utilizzabile il flag skip al di fuori di una sandbox riconosciuta, dove il flag impedisce l’esecuzione come root. È lo stesso principio di eseguire ogni servizio come utente non privilegiato, applicato a un agente. Il livello 1 non limita la rete né gli elementi del server leggibili globalmente.

Livello 2: un container. Anthropic pubblica un devcontainer di riferimento che esegue Claude Code come utente non-root, con regole firewall che limitano gli host raggiungibili dall’agente. Anche un container creato autonomamente svolge la stessa funzione. Il filesystem si riduce ai volumi montati e il traffico in uscita si limita a quanto consentito dalle regole del container. È il livello intermedio corretto quando il server ospita altri servizi da proteggere. Il limite è che i container condividono il kernel dell’host e un mount configurato senza attenzione annulla il confine: assegna al container /var/run/docker.sock e potrà raggiungere l’intero host.

Livello 3: un VPS dedicato. Il livello più sicuro è anche il più diretto: assegna all’agente un’intera macchina che non contiene nulla di importante. Un VPS di piccole dimensioni costa pochi dollari al mese. Configuralo seguendo la procedura dei primi dieci minuti su un nuovo VPS, crea uno snapshot dello stato pulito e lascia lavorare l’agente. Non ci sarà altro. Nessuna chiave SSH personale, ma solo una deploy key limitata all’unico repository. Nessuna credenziale cloud e nessun dato di produzione. Se un’esecuzione causa problemi, oppure vuoi semplicemente ripartire da uno stato pulito, ripristina lo snapshot oppure elimina e ricrea il server in pochi minuti. Il raggio d’azione dell’incidente è limitato al costo del VPS. In questa configurazione --dangerously-skip-permissions non è più preoccupante, perché il risultato realistico peggiore è un server ricreato e un token revocato.

I livelli possono essere combinati. Un agente in sandbox, eseguito come utente non privilegiato su un VPS usa-e-getta, richiede un costo aggiuntivo quasi nullo e rende banali gli scenari di errore. Questo è l’obiettivo.

Proteggere le credenziali

La regola da cui dipende tutto il resto è questa: l'utente dell'agente non deve poter leggere i secret appartenenti ad altri componenti.

Fornisci la chiave API all'agente e a nessun altro. Inseriscila in un file di proprietà dell'utente dell'agente con modalità 600 e caricala all'avvio della shell:

install -m 600 /dev/null /home/agent/claude.env
echo 'export ANTHROPIC_API_KEY=your-key-here' >> /home/agent/claude.env
echo 'source ~/claude.env' >> /home/agent/.bashrc

Poi chiudi l'altra direzione. Nelle installazioni meno recenti di Debian e Ubuntu, le directory home possono essere leggibili da ogni utente del sistema. Rendi quindi privata la tua: chmod 750 /home/youruser. Verifica con ls -ld /home/* e correggi tutto ciò che l'account dell'agente può elencare.

Limita ogni token al minimo necessario. Un token GitHub con autorizzazioni granulari limitato a un solo repository, oppure una deploy key specifica per repository, fa sì che una credenziale compromessa esponga un solo progetto e non l'intero account. Se usi la sandbox, aggiungi le relative impostazioni delle credenziali in modo che ~/.ssh e ~/.aws siano negati anche per le operazioni di lettura. Inoltre, non tenere mai sul server le credenziali di produzione: un agente non può divulgare un secret che non è mai stato presente. Se questi secret sono archiviati in un password manager self-hosted, installalo su un server diverso da quello dell'agente e sottoponilo a una revisione specifica, perché i punti deboli di Vaultwarden sono il token amministrativo e il file di backup, non il vault cifrato in sé.

Git è la rete di sicurezza

Ogni modifica sottoposta a commit dall'agente può essere revisionata e annullata. Git offre entrambe le possibilità senza costi aggiuntivi se l'agente lavora su un branch ed esegue i commit man mano che procede:

git switch -c agent/refactor-auth

Le modifiche che l'agente non sottopone mai a commit non hanno questa protezione: un git reset --hard elimina le modifiche non sottoposte a commit nei file tracciati, mentre git non copre in alcun modo ciò che si trova al di fuori del repository. Al termine, revisiona l'esecuzione con git diff main...agent/refactor-auth per verificare ciò che ha sottoposto a commit, quindi usa git status e git diff HEAD sul branch per individuare le modifiche che ha lasciato senza commit. Unisci le modifiche corrette ed elimina il branch se l'esecuzione non ha prodotto risultati. Un'esecuzione che modifica tre file è molto più semplice da esaminare a colazione rispetto a una che riscrive metà del modulo: in pratica, è questo l'obiettivo di una skill che impone all'agente di applicare la modifica minima funzionante. Proteggi il branch principale sul forge, in modo che il token dell'agente non possa eseguirvi il push e non possa eseguire force-push in alcun punto. La cronologia dei commit funge anche da registro di audit di ciò che è accaduto mentre dormivi, e vale più di qualsiasi quantità di output precedente nel terminale.

La rete fa parte del perimetro dell’impatto

Un agent può eseguire curl. Questa frase riassume l’intero problema del traffico in uscita: tutto ciò che l’agent può leggere, può anche inviarlo altrove, e un agent sottoposto a prompt injection potrebbe farlo. Un normale utente senza privilegi non limita affatto questo comportamento, perché qualsiasi utente può raggiungere tutto ciò che il server può raggiungere. La sandbox lo limita per dominio tramite il proprio proxy. Un container può applicare un limite con le proprie regole firewall. Un VPS dedicato limita innanzitutto la quantità di dati che può essere sottratta, ed è la risposta più robusta tra le tre.

Non cercare di risolvere il traffico in uscita usando solo ufw. Per impostazione predefinita, ufw consente tutto il traffico in uscita; scrivere regole outbound che continuino a permettere apt, npm, git e Claude API è un lavoro complesso e soggetto a errori che possono passare inosservati. Scegli invece il perimetro a livello di sandbox, container o macchina, dove una allow list di domini o una macchina isolata svolgono lo stesso compito in modo chiaro.

Se stai sviluppando un tuo agent tramite API invece di eseguire Claude Code, lo stesso ragionamento resta valido. Sviluppare un agent AI con Claude su un VPS descrive questo percorso e anche questo agent deve usare lo stesso utente dedicato, gli stessi token con ambito limitato e la stessa macchina usa e getta.

Metti prima in sicurezza il server

Qualunque livello tu scelga, il server deve comunque avere le configurazioni di base prima che l'agent vi venga installato: solo chiavi SSH, accesso root disabilitato, firewall con criterio predefinito deny e aggiornamenti di sicurezza automatici. Genera qui la checklist e completala una volta:

ToolHarden the box before the agent moves in

FAQ

È sicuro usare --dangerously-skip-permissions su un server?

Non da solo. Il flag rimuove le richieste di approvazione ordinarie, quindi un comando errato può essere eseguito non appena il modello lo genera. Diventa un compromesso ragionevole quando l'ambito dell'eventuale danno è limitato: almeno un utente dedicato senza privilegi e, per attività realmente non presidiate, un container o un VPS usa e getta che contenga un solo progetto e un solo token con ambito limitato. Non usarlo mai su una macchina che contiene credenziali di produzione o dati che non puoi perdere.

Claude Code dispone di una sandbox?

Sì. Claude Code include una sandbox integrata per i comandi shell, avviata con il comando /sandbox. Usa bubblewrap su Linux e Seatbelt su macOS, limita le scritture nel filesystem e instrada l'accesso alla rete tramite un proxy che consente soltanto i domini approvati. La modalità di autorizzazione automatica esegue la maggior parte dei comandi nella sandbox senza richieste, riducendo le interruzioni come fa il flag di esclusione, ma mantenendo un confine applicato dal sistema operativo. Non costituisce un isolamento completo, quindi per le esecuzioni non presidiate va affiancata a un utente dedicato o a una macchina dedicata.

Perché il flag di esclusione rifiuta l'esecuzione come root?

Perché root, senza richieste di autorizzazione, può modificare qualsiasi file e qualsiasi servizio del sistema. Per questo Claude Code blocca --dangerously-skip-permissions quando viene eseguito come root o tramite sudo su Linux e macOS, salvo che si trovi all'interno di una sandbox riconosciuta. La soluzione non consiste nell'eludere il controllo. Crea un utente senza privilegi per l'agente ed eseguilo con quell'account; il confine dell'account è il primo livello di contenimento e anche il meno costoso.

Claude Code può leggere le mie chiavi SSH e i file .env?

Può leggere tutto ciò che l'utente con cui viene eseguito può leggere; inoltre, la policy predefinita della sandbox consente persino la lettura dei percorsi che contengono credenziali finché non la neghi. Esegui quindi l'agente con un utente dedicato, mantieni la tua home directory con permessi 750 o più restrittivi, nega i percorsi delle credenziali nelle impostazioni della sandbox e tieni completamente fuori dalla macchina i secret di produzione. Un secret che la macchina non ha mai contenuto non può essere letto né divulgato.

Qual è il modo più sicuro per eseguire Claude Code senza supervisione?

Un VPS dedicato ed economico, usato soltanto per le attività dell'agente: hardening completato in dieci minuti, snapshot iniziale pulito, Claude Code eseguito con un utente senza privilegi e sandbox attiva, un file con permessi 600 che contiene la chiave API, una deploy key per ogni repository e tutto il lavoro svolto su branch che controlli prima del merge. Se un'esecuzione causa problemi, revochi un solo token e ripristini lo snapshot, senza conseguenze per il resto delle risorse che possiedi.

Questo articolo ti è stato utile?