Cosa Imparerai
Questa guida ti accompagnerà attraverso ogni metodo per utilizzare Claude Code da remoto — dalla funzione ufficiale Remote Control di Anthropic alle configurazioni SSH fai-da-te con tmux, mosh e Tailscale. Alla fine, avrai una configurazione di coding mobile funzionante dove potrai avviare task sul tuo desktop, lasciare l'ufficio e mantenere il pieno controllo dal tuo telefono.
Claude Code Remote Control: La Guida Completa 2026
Il February 25, 2026, Anthropic ha rilasciato Remote Control — la capacità di avviare un task di coding nel tuo terminale, mettere il laptop in borsa e mantenere il pieno controllo dal tuo telefono. Nessuna VPN, nessun port forwarding, nessuno strumento di terze parti richiesto. Fonte
Ma la funzione ufficiale è solo una parte della storia. La community di sviluppatori ha costruito un intero ecosistema di configurazioni per il coding mobile attorno a Claude Code, che va dai semplici tunnel SSH a sofisticati workflow multi-strumento con push notifications e voice input. Questa guida li copre tutti.
Parte 1: Remote Control Ufficiale
Cos'è
Remote Control è la funzione integrata di Anthropic per continuare le sessioni di Claude Code tra diversi dispositivi. Funziona facendo registrare la tua istanza locale di Claude Code presso l'API di Anthropic come server, consentendo poi ai client autorizzati (il tuo telefono) di connettersi e controllare la sessione da remoto. Fonte
Come Funziona Dietro le Quinte
Il modello di sicurezza è lineare e conservativo:
Your Desktop (Claude Code) Anthropic API Your Phone (Claude App)
│ │ │
├──── Register session ──────────►│ │
│ │ │
│◄─── Assign session URL ────────┤ │
│ │ │
│ Display QR code │ │
│ │◄──── Scan QR / Auth ─────┤
│ │ │
│◄─── Route messages ────────────┤──── Route messages ─────►│
│ │ │
│ (All traffic over TLS) │ │
Proprietà di sicurezza chiave:
- Nessuna porta in entrata — la tua macchina locale effettua solo richieste HTTPS in uscita
- Nessuna connessione diretta — il tuo telefono non si connette mai direttamente al tuo desktop
- Cifratura TLS — tutto il traffico scorre attraverso l'API di Anthropic su TLS
- Session-scoped — ogni sessione Remote Control ha un URL unico che scade
Passaggi per la Configurazione
Passaggio 1: Aggiorna Claude Code
Remote Control richiede Claude Code v2.1.51 o successiva:
# Check your version
claude --version
# Update if needed
npm update -g @anthropic-ai/claude-code
Passaggio 2: Inizia una Sessione
Inizia a lavorare normalmente sul tuo progetto:
cd ~/projects/my-app
claude
Passaggio 3: Abilita Remote Control
Dall'interno della tua sessione Claude Code, esegui:
/rc
# or
/remote-control
Questo avvia il server Remote Control. Il tuo terminale mostrerà:
Remote Control active
Session URL: https://code.claude.com/rc/abc123-def456
Press [space] to show QR code
Press [q] to stop Remote Control
Passaggio 4: Connettiti dal tuo Telefono
Due opzioni:
- QR Code: Premi la barra spaziatrice nel tuo terminale per visualizzare un QR code. Apri l'app Claude sul tuo telefono e scansionalo.
- URL: Copia l'URL della sessione e aprilo nell'app Claude sul tuo telefono.
Il tuo telefono ha ora il pieno controllo della sessione Claude Code. Puoi inviare messaggi, approvare modifiche ai file e revisionare l'output — la conversazione rimane sincronizzata su tutti i dispositivi connessi. Fonte
Abilitare Remote Control di Default
Se usi Remote Control frequentemente, abilitalo per tutte le sessioni:
/mobile
Questo visualizza un QR code per installare l'app Claude se non l'hai già fatto, e attiva l'impostazione "Enable Remote Control for all sessions" su true. Una volta abilitata, ogni sessione Claude Code si avvia automaticamente in modalità Remote Control. Fonte
Requisiti del Piano
| Piano | Prezzo | Remote Control |
|---|---|---|
| Free | $0 | Non disponibile |
| Pro | $20/month | Disponibile |
| Max | $100–200/month | Disponibile |
| Team | Custom | Disponibile |
| Enterprise | Custom | Disponibile |
Limitazioni di Remote Control
- Richiede l'app Claude — non puoi usare un browser generico; è necessaria l'app mobile Claude
- Dipendenza da Anthropic — tutto il traffico passa attraverso i server di Anthropic; se la loro API è giù, Remote Control è giù
- Nessun supporto offline — entrambi i dispositivi devono avere connettività internet
- Timeout della sessione — le sessioni inattive alla fine scadono
- Singolo provider — funziona solo con i modelli Claude, non se stai usando OpenCode o altri strumenti multi-provider
Parte 2: SSH + tmux + mosh (L'Approccio Fai-da-te)
Per gli sviluppatori che desiderano il pieno controllo del terminale, il supporto multi-provider o lavorano su reti inaffidabili, l'approccio basato su SSH è più robusto. Come ha scritto lo sviluppatore Harper Reed: "Quando ho cercato di capire come usare Claude Code su un telefono, la risposta ovvia è stata connettersi via ssh a un computer da un telefono ed eseguire claude." Fonte
Perché Tre Strumenti?
Hai bisogno di due diversi tipi di resilienza:
- mosh gestisce la connessione mobile instabile — transizioni da WiFi a cellulare, zone morte, telefono in standby
- tmux gestisce la persistenza della sessione — mantiene viva la sessione Claude Code anche quando il tuo telefono si disconnette completamente
Insieme rendono lo sviluppo mobile effettivamente fattibile. Fonte
Configurazione dello Stack
Passaggio 1: Installa Tailscale (Private Networking)
Tailscale crea una rete mesh WireGuard privata tra i tuoi dispositivi. Nessun port forwarding, nessuna configurazione del router, nessuna regola del firewall.
Sul tuo desktop:
# macOS
brew install tailscale
# Linux
curl -fsSL https://tailscale.com/install.sh | sh
# Start Tailscale
sudo tailscale up
Sul tuo telefono:
- Installa l'app Tailscale dal tuo app store
- Accedi con lo stesso account
- Entrambi i dispositivi sono ora sulla stessa rete privata
Il tuo desktop riceve un IP Tailscale (qualcosa come 100.64.x.x) che il tuo telefono può raggiungere direttamente, indipendentemente dalla rete WiFi o cellulare su cui si trova ciascun dispositivo. Fonte
Passaggio 2: Installa tmux (Persistenza della Sessione)
tmux mantiene vive le tue sessioni terminale indipendentemente dalla tua connessione SSH. Quando il tuo telefono si disconnette (blocco schermo, cambio rete, batteria scarica), la sessione tmux continua a girare.
# macOS
brew install tmux
# Ubuntu/Debian
sudo apt install tmux
Crea una configurazione tmux ottimizzata per l'uso mobile:
# ~/.tmux.conf
# Increase scrollback buffer
set -g history-limit 50000
# Enable mouse support (useful on mobile)
set -g mouse on
# Reduce escape-time for responsive mobile input
set -sg escape-time 10
# Status bar with useful info
set -g status-right '#H | %H:%M'
# Larger status bar for mobile readability
set -g status-style 'bg=colour235 fg=colour136'
Passaggio 3: Installa mosh (Resilienza della Connessione)
mosh (Mobile Shell) usa UDP invece di TCP, il che gestisce le transizioni di rete con eleganza. Quando il tuo telefono passa da WiFi a cellulare o attraversa un tunnel, mosh si riconnette automaticamente.
Sul tuo desktop:
# macOS
brew install mosh
# Ubuntu/Debian
sudo apt install mosh
Sul tuo telefono:
- iOS: Installa Blink Shell o Termius — entrambi supportano mosh nativamente
- Android: Installa JuiceSSH o Termux con il pacchetto mosh
Passaggio 4: Connettiti e Avvia Claude Code
Dal client SSH del tuo telefono:
# Connect via mosh through Tailscale
mosh user@100.64.x.x
# Start or attach to a tmux session
tmux new-session -s claude
# or if session already exists:
tmux attach -t claude
# Launch Claude Code
cd ~/projects/my-app
claude
Ora hai una sessione Claude Code che:
- Sopravvive ai cambi di rete (mosh)
- Sopravvive alle disconnessioni del telefono (tmux)
- È accessibile da qualsiasi dispositivo sulla tua rete Tailscale
- Funziona con qualsiasi provider AI, non solo Claude
Riconnettersi Dopo la Disconnessione
Quando riprendi il telefono più tardi:
# mosh will auto-reconnect if the session is still alive
# If mosh session died, start a new one:
mosh user@100.64.x.x
# Reattach to your tmux session
tmux attach -t claude
La tua sessione Claude Code è esattamente dove l'avevi lasciata — stessa conversazione, stessa working directory, stesse modifiche in sospeso.
Parte 3: Push Notifications con ntfy
Il problema con le configurazioni Remote Control e SSH è che devi continuare a controllare il telefono per vedere se Claude Code ha terminato il suo task. La soluzione sono le push notifications.
Cos'è ntfy?
ntfy è un servizio di push notification semplice e open-source. Puoi ospitarlo autonomamente per la privacy o usare l'istanza pubblica su ntfy.sh. Fonte
ntfy Ospitato Autonomamente con Tailscale
Per la massima privacy, esegui ntfy sul tuo desktop e accedivi tramite Tailscale:
# Install ntfy
brew install ntfy # macOS
# or
sudo apt install ntfy # Linux
# Start ntfy server (it listens on port 80 by default)
ntfy serve --listen-http :8090
Poiché il tuo telefono e il desktop sono sulla stessa rete Tailscale, il tuo telefono può raggiungere ntfy all'indirizzo http://100.64.x.x:8090. Nessun dato lascia la tua rete privata.
Configurazione dei Claude Code Hooks
I Claude Code hooks ti permettono di attivare comandi personalizzati quando si verificano determinati eventi. Configura un hook per inviare una notifica quando Claude Code richiede input:
// ~/.claude/settings.json
{
"hooks": {
"notification": {
"command": "curl -s -d 'Claude Code needs your attention' http://100.64.x.x:8090/claude-code",
"event": "stop"
}
}
}
Configurazione dell'App Mobile ntfy
- Installa l'app ntfy sul tuo telefono (iOS o Android)
- Aggiungi un'iscrizione al topic
claude-codesul tuo server ospitato autonomamente (http://100.64.x.x:8090/claude-code) - Abilita le push notifications per il topic
Ora, ogni volta che Claude Code si ferma e ha bisogno di input — che abbia finito un task, riscontrato un errore o abbia bisogno di approvazione — riceverai una push notification sul tuo telefono. Non c'è bisogno di tenere il terminale aperto o controllare costantemente.
Configurazione Notifiche Avanzata
Per notifiche più ricche di contesto, puoi includere l'ultimo messaggio di Claude Code:
#!/bin/bash
# ~/.claude/hooks/notify.sh
# Get the last few lines of Claude Code output
LAST_OUTPUT=$(tail -5 /tmp/claude-code-output.log 2>/dev/null || echo "Task completed")
# Send notification with context
curl -s \
-H "Title: Claude Code" \
-H "Priority: high" \
-H "Tags: robot" \
-d "$LAST_OUTPUT" \
http://100.64.x.x:8090/claude-code
Parte 4: Happy Coder (Alternativa Open-Source Gratuita)
Happy Coder è uno strumento gratuito e open-source che fornisce un'interfaccia web-based per controllare Claude Code da remoto, con push notifications integrate e voice input. Fonte
Caratteristiche Principali
- Gratuito e open source — nessun abbonamento richiesto oltre al tuo piano Claude Code
- Push notifications — sistema di notifiche integrato, nessuna configurazione ntfy necessaria
- Voice input — detta i comandi invece di scrivere su uno schermo piccolo
- Supporto multi-agente — funziona con Codex insieme a Claude Code
- Web-based — funziona in qualsiasi browser mobile, nessuna installazione di app richiesta
Configurazione
# Install Happy Coder
npm install -g happy-coder
# Start the server
happy-coder start --port 3000
# Access from your phone via Tailscale
# http://100.64.x.x:3000
Happy Coder fornisce un'interfaccia web ottimizzata per mobile che visualizza la tua conversazione Claude Code, ti permette di inviare messaggi e mostra le modifiche ai file — tutto attraverso il tuo browser.
Parte 5: Confronto delle Configurazioni Complete
Matrice di Confronto dei Metodi
| Caratteristica | Remote Control | SSH + tmux + mosh | Happy Coder |
|---|---|---|---|
| Complessità setup | Minima (1 comando) | Moderata (30 min) | Facile (5 min) |
| Costo | Incluso nel piano | Gratuito (Tailscale free tier) | Gratuito |
| Resilienza rete | Moderata | Eccellente (mosh) | Moderata |
| Persistenza sessione | Buona | Eccellente (tmux) | Buona |
| Push notifications | No | Con setup ntfy | Integrate |
| Voice input | No | No | Sì |
| Multi-provider | Solo Claude | Qualsiasi provider | Claude + Codex |
| Capacità offline | No | Parziale (tmux persiste) | No |
| Accesso terminale completo | No (solo chat) | Sì | No (solo chat) |
| App telefono richiesta | App Claude | Client SSH | Browser |
Configurazione Consigliata per Caso d'Uso
Utente occasionale (controlla i task ogni tanto): → Remote Control. Un comando, una scansione QR, fatto.
Coder mobile quotidiano (scrive codice frequentemente dal telefono): → SSH + tmux + mosh + ntfy. Massima resilienza e controllo.
Team lead (monitora più sessioni): → Happy Coder. Web-based, supporta più agenti, notifiche integrate.
Sviluppatore multi-provider (usa Claude, Codex e modelli locali): → SSH + tmux + mosh. Funziona con qualsiasi strumento che giri in un terminale.
Parte 6: Configurazioni Avanzate
Eseguire Più Sessioni Claude Code
Con tmux, puoi eseguire più sessioni Claude Code in parallelo e passare dall'una all'altra:
# Create named sessions for different projects
tmux new-session -d -s project-api
tmux new-session -d -s project-frontend
tmux new-session -d -s project-tests
# In each session, navigate and start Claude Code
tmux send-keys -t project-api 'cd ~/projects/api && claude' C-m
tmux send-keys -t project-frontend 'cd ~/projects/frontend && claude' C-m
tmux send-keys -t project-tests 'cd ~/projects/tests && claude' C-m
# From your phone, switch between sessions
tmux switch-client -t project-api
tmux switch-client -t project-frontend
Setup Linux VM Headless
Per i team che desiderano un ambiente di coding remoto dedicato, Claude Code Remote Control funziona su VM Linux headless tramite SSH + tmux. Fonte
# On your cloud VM (AWS, GCP, etc.)
# Install Claude Code
npm install -g @anthropic-ai/claude-code
# Start in a tmux session
tmux new-session -s remote-claude
# Launch Claude Code
claude
# Start Remote Control
/rc
Quindi scansiona il QR code dal tuo telefono. Questo ti offre un potente ambiente di sviluppo basato su cloud controllato interamente da mobile.
Combinare Remote Control con SSH
Puoi usare entrambi i metodi insieme per la massima flessibilità:
- SSH + tmux per la persistenza della sessione e l'accesso completo al terminale
- Remote Control all'interno della sessione tmux per l'interfaccia chat ottimizzata per mobile
# SSH into your machine
mosh user@100.64.x.x
# Attach to tmux
tmux attach -t claude
# Inside the session, Claude Code is running
# Enable Remote Control for phone access
/rc
Ora hai:
- tmux che mantiene viva la sessione
- mosh che mantiene stabile la connessione SSH
- Remote Control che fornisce un'interfaccia mobile rifinita
- Accesso completo al terminale quando ne hai bisogno
Parte 7: Sviluppare App Mentre Sei in Movimento
Il Workflow di Sviluppo Mobile
La combinazione di Claude Code + accesso remoto cambia radicalmente quando e dove puoi essere produttivo. Un workflow pratico:
- Tragitto mattutino: Revisiona i risultati CI notturni sul tuo telefono, avvia task di correzione tramite Remote Control
- Pausa pranzo: Controlla i progressi tramite notifiche ntfy, approva o reindirizza le modifiche
- Sera: Riprendi il tuo laptop e la sessione tmux è esattamente dove l'avevi lasciata
Quando il Coding Mobile ha Senso
Il coding mobile tramite Claude Code è più adatto per:
- Avvio di task — descrivi cosa vuoi costruire e lascia lavorare Claude Code mentre sei via
- Code review — leggi i diff e approva le modifiche dal tuo telefono
- Triage dei bug — investiga i problemi e indirizza Claude Code verso le correzioni
- Monitoraggio dei progressi — controlla i task a lunga esecuzione
È meno adatto per:
- Debugging complesso — gli schermi piccoli rendono dolorosa la lettura degli stack traces
- Lavoro visuale — le modifiche a CSS e layout necessitano di uno schermo intero
- Refactoring su larga scala — vorrai revisionare modifiche estese su un monitor adeguato
Costruire con ZBuild da Ovunque
Per gli sviluppatori che vogliono costruire e iterare su applicazioni mentre sono in movimento, piattaforme come ZBuild completano il workflow remoto di Claude Code. ZBuild fornisce un visual app builder che funziona bene su tablet e può essere accoppiato con Claude Code per logiche backend più complesse — offrendoti una capacità di sviluppo full-stack che non richiede una workstation desktop.
Parte 8: Risoluzione dei Problemi
Problemi Comuni e Soluzioni
Problema: "Remote Control not available on your plan" Soluzione: Verifica di essere su Pro, Max, Team o Enterprise. Il piano Free non supporta Remote Control.
Problema: Il QR code non viene scansionato Soluzione: Assicurati che la tua app Claude sia aggiornata all'ultima versione. Prova direttamente l'URL della sessione invece di scansionare.
Problema: La connessione mosh cade e non si riconnette
Soluzione: Verifica che mosh-server sia in esecuzione sul tuo desktop (which mosh-server). Controlla che Tailscale sia connesso su entrambi i dispositivi. Assicurati che le porte UDP 60000-61000 siano aperte se non usi Tailscale.
Problema: La sessione tmux mostra uno schermo vuoto dopo la riconnessione
Soluzione: Esegui tmux attach -t claude invece di creare una nuova sessione. Se la sessione è terminata, controlla se Claude Code è crashato revisionando ~/.claude/logs/.
Problema: Le notifiche ntfy non arrivano
Soluzione: Verifica che il server ntfy sia in esecuzione (curl http://100.64.x.x:8090/health). Controlla che l'URL di iscrizione nell'app ntfy corrisponda all'indirizzo del tuo server. Assicurati che la connessione Tailscale del tuo telefono sia attiva.
Problema: La sessione Claude Code è scaduta mentre il telefono era disconnesso Soluzione: Questo accade con Remote Control dopo un'inattività prolungata. Usa la configurazione basata su tmux per sessioni che devono persistere per ore. Le sessioni tmux sopravvivono indefinitamente indipendentemente dalle connessioni client.
Problema: Scrivere è lento su mobile Soluzione: Usa l'input vocale (Happy Coder) o mantieni i messaggi brevi e orientati ai task. In alternativa, prepara i prompt in un'app di note e incollali nel terminale.
Parte 9: Considerazioni sulla Sicurezza
Sicurezza di Remote Control
- Tutto il traffico è cifrato via TLS attraverso l'API di Anthropic
- Gli URL delle sessioni sono unici e scadono dopo l'uso
- Nessuna porta in entrata viene aperta sulla tua macchina
- Le tue credenziali e i tuoi file non lasciano mai la tua macchina (viene trasmesso solo l'output testuale di Claude Code)
Best Practices per la Sicurezza SSH
Quando esponi SSH per l'accesso mobile:
# Use key-based authentication only (disable password auth)
# In /etc/ssh/sshd_config:
PasswordAuthentication no
PubkeyAuthentication yes
# Restrict SSH to Tailscale interface only
ListenAddress 100.64.x.x
# Use a non-standard port
Port 2222
Sicurezza Tailscale
La rete mesh basata su WireGuard di Tailscale fornisce:
- Cifratura end-to-end tra i dispositivi
- Nessun instradamento di dati attraverso i server di Tailscale (connessioni dirette)
- MagicDNS per una facile risoluzione degli hostname
- Liste di controllo degli accessi (ACLs) per configurazioni di team
Conclusione
Utilizzare Claude Code da remoto nel 2026 spazia dal semplicissimo (un comando /rc) al completamente personalizzato (SSH + tmux + mosh + ntfy + Tailscale). La configurazione corretta dipende dal tuo workflow:
- Remote Control per rapidi controlli da mobile con zero configurazione
- Stack SSH per gli sviluppatori che vivono nel terminale e hanno bisogno della massima resilienza
- Happy Coder per una via di mezzo gratuita e ricca di funzionalità
L'impatto pratico è significativo. Lo sviluppo non è più vincolato a stare seduti a una scrivania con un laptop aperto. Puoi avviare un task, allontanarti e mantenere il controllo. Che tu stia costruendo un side project, gestendo il codebase di un team o prototipando un'app con ZBuild, l'accesso mobile a Claude Code significa che il tuo workflow di sviluppo ti segue, non il contrario.
Fonti
- Claude Code Remote Control Documentation — Anthropic
- Remote Claude Code: Programming Like the Early 2000s — Harper Reed
- Claude Code from the Beach: mosh, tmux, and ntfy — Rogs
- Claude Code Remote Control: Code From Your Phone — Medium
- Claude Code on Your Phone — Builder.io
- Perfect Claude Code Notifications with Tailscale and ntfy — Felipe Elias
- 3 Ways to Run Claude Code from Your Phone — Zilliz
- Run Claude Code from Your iPhone — Pete Sena / Medium
- Claude Code Remote Control Launch Analysis — Blockchain News
- Remote Control on Headless Linux VM — GitHub Issue #29479
- Claude Code Mobile Setup with tmux and Bitvise — GitHub Gist
- How to Use Claude Code on Your Phone — FelloAI
- Claude Code Mobile Setup — Sealos Blog