Claude Code è uno degli assistenti di programmazione basati su IA più potenti oggi disponibili, ma usarlo da una finestra di console locale ha limiti reali: sei legato alla macchina su cui è installato, non puoi accedervi dal telefono e non c'è un modo semplice per condividere una sessione con un collega.
sgcClaudeCodeRemote risolve tutto questo. È un server Windows leggero che racchiude Claude Code dentro un terminale basato sul web, permettendoti di connetterti da qualsiasi browser, sul tuo desktop, laptop, tablet o telefono. Sotto il cofano, usa l'API pseudo-console Windows ConPTY per una vera sessione di terminale, e sgcWebSockets per inviare in streaming l'I/O del terminale al browser in tempo reale.
Questo articolo copre le funzionalità, le opzioni di configurazione e i vantaggi rispetto all'esecuzione di Claude Code direttamente dalla console.
Perché usare Claude Code da remoto?
sgcClaudeCodeRemote affronta i punti di frizione più comuni che gli sviluppatori incontrano quando lavorano con Claude Code da console.
|
Accesso da qualsiasi dispositivo Apri un browser sul tuo telefono, tablet o laptop e connettiti a Claude Code in esecuzione sulla tua macchina di sviluppo. Niente Node.js, niente installazione della CLI, solo un URL. |
Sessioni collaborative Più sviluppatori possono unirsi alla stessa sessione con nome e vedere l'output di Claude in tempo reale. Pair programming integrato, senza bisogno di strumenti di screen sharing. |
Sicuro di default Autenticazione con password con protezione brute-force, timeout configurabili, blocco IP e crittografia TLS 1.3 opzionale per i deployment esposti su Internet. |
Terminale ottimizzato per mobile
L'interfaccia web è progettata per funzionare su dispositivi mobili. Una barra dei tasti ottimizzata per il touch in fondo allo schermo fornisce i tasti speciali di cui Claude Code ha bisogno ma che mancano sulle tastiere mobili:
| Pulsante | Funzione |
|---|---|
| Esc | Annulla l'operazione corrente o torna indietro |
| Tab | Accetta suggerimenti e completamento automatico |
| Intro | Conferma input (tasto Invio) |
| Ctrl | Modificatore sticky: tocca una volta, poi tocca una lettera per combinazioni come Ctrl+C (interrupt) |
| ↑ ↓ ← → | Naviga la cronologia dei comandi e i menu |
La barra usa eventi pointerdown per una risposta istantanea sugli schermi touch e impedisce il furto del focus in modo che il terminale rimanga attivo. La viewport si adatta al chrome del browser mobile usando dynamic viewport units (dvh), assicurando che la barra sia sempre visibile senza scorrere.
Sessioni con nome
Ogni connessione può specificare un nome di sessione (es. “backend-refactor”, “devops”, “testing”). Le sessioni persistono per tutta la durata del server, quindi puoi disconnetterti e riconnetterti più tardi alla stessa istanza di Claude Code.
- Sessioni multi-client. Più browser possono unirsi alla stessa sessione simultaneamente: tutti vedono lo stesso output del terminale e possono scrivere nella stessa console.
- Cronologia delle sessioni. Il browser ricorda le tue 10 sessioni più recenti in localStorage, con un menu a tendina per riconnetterti rapidamente.
- Indicatore di sessione. Il nome della sessione attiva viene mostrato nella barra di intestazione dopo l'autenticazione.
Autenticazione e sicurezza
sgcClaudeCodeRemote include più livelli di protezione pronti all'uso:
|
Autenticazione con password Una singola password condivisa protegge l'accesso. Non è richiesto un nome utente, solo la password. Il modulo di login disabilita l'autocompletamento delle credenziali del browser per evitare salvataggi accidentali. |
Protezione brute-force Dopo 5 tentativi falliti dallo stesso IP, quell'indirizzo viene bloccato per 5 minuti. Gli IP bloccati vengono rifiutati a livello di connessione prima di qualsiasi ulteriore elaborazione. |
|
Timeout di autenticazione I client devono autenticarsi entro una finestra configurabile (di default 15 secondi). Le connessioni inattive che non inviano credenziali vengono disconnesse automaticamente. |
Crittografia TLS 1.3 Per i deployment esposti su Internet, abilita TLS con un file certificato e chiave. Tutto il traffico tra browser e server è cifrato end-to-end. |
Salta i prompt dei permessi. Una casella di controllo sulla schermata di login (selezionata di default) avvia Claude Code con il flag --dangerously-skip-permissions. Questo è essenziale per le sessioni remote in cui non puoi interagire con le finestre di dialogo dei permessi sulla console del server.
sgcClaudeCodeRemote vs. Claude Code da console
Un confronto fianco a fianco tra l'esecuzione di Claude Code in locale e tramite sgcClaudeCodeRemote.
| Funzionalità | Console | sgcClaudeCodeRemote |
|---|---|---|
| Accesso da qualsiasi dispositivo | No | Sì |
| Supporto mobile / tablet | No | Sì (barra touch) |
| Più utenti sulla stessa sessione | No | Sì |
| Sessioni persistenti con nome | No | Sì |
| Protezione con password | No | Sì (blocco brute-force) |
| Crittografia TLS | N/D | TLS 1.3 |
| Software client richiesto | Node.js + CLI | Solo un browser |
| Pair programming | Strumenti esterni | Integrato |
| Visualizzazione latenza in tempo reale | No | Sì |
| Piattaforme client | Solo la stessa macchina | Windows, macOS, Linux, Android, iOS |
Per iniziare
Scarica sgcClaudeCodeRemote ed eseguilo dalla riga di comando con una password:
sgcClaudeCodeRemote.exe --password MySecretPasswordPoi apri il browser e vai su http://your-server-ip:8765/. Inserisci la password, scegli un nome di sessione e sei dentro.
Esempi
Porta personalizzata con limite di connessioni più alto:
sgcClaudeCodeRemote.exe --port 9000 --password MyPass --max-conn 20Con crittografia TLS per un accesso sicuro su Internet:
sgcClaudeCodeRemote.exe --tls --tls-cert cert.pem --tls-key key.pem --password MyPassOpzioni da riga di comando
| Opzione | Descrizione | Predefinito |
|---|---|---|
--port |
Porta di ascolto del server | 8765 |
--password |
Password di accesso (obbligatoria quando l'autenticazione è abilitata) | — |
--command |
Comando da eseguire nel terminale | claude |
--cols / --rows |
Dimensioni iniziali del terminale | 120 × 40 |
--max-conn |
Numero massimo di connessioni concorrenti | 10 |
--timeout |
Timeout di autenticazione in secondi | 15 |
--no-auth |
Disabilita completamente l'autenticazione | — |
--tls |
Abilita la crittografia TLS 1.3 | — |
--tls-cert / --tls-key |
File PEM del certificato e della chiave privata | — |
--tls-password |
Password della chiave privata (se cifrata) | — |
--tls-port |
Porta di ascolto TLS | Stessa di --port |
Casi d'uso
- Lavora dal tuo telefono. Rivedi codice, fai domande a Claude o esegui comandi da qualsiasi posto: dal divano, dal treno o da un bar.
- Collaborazione di team. Più sviluppatori si connettono alla stessa sessione e interagiscono con Claude in tempo reale. Senza screen sharing.
- Server di build headless. Esegui Claude Code su una macchina remota potente e accedi da un thin client o da un ambiente senza terminale.
- Demo e presentazioni. Condividi un URL di sessione con il tuo pubblico. Tutti vedono lo stesso terminale live e seguono in diretta.
- Accesso remoto sicuro. Abilita TLS, imposta una password forte e usa Claude Code in sicurezza su Internet da qualsiasi posizione.
Come funziona
sgcClaudeCodeRemote è un'applicazione console Delphi costruita su tre tecnologie chiave:
|
Windows ConPTY L'API pseudo-console di Windows 10 crea una vera sessione di terminale con pieno supporto delle sequenze VT100/ANSI. Claude Code gira dentro questa console esattamente come farebbe in una normale finestra di terminale. |
sgcWebSockets La libreria sgcWebSockets gestisce tutta la comunicazione WebSocket, il serving HTTP e la crittografia TLS opzionale. I frame binari trasportano l'output del terminale; i frame testuali JSON gestiscono l'autenticazione e i messaggi di controllo. |
xterm.js Il browser renderizza il terminale usando xterm.js con l'addon fit (ridimensionamento automatico alla finestra) e l'addon web-links (URL cliccabili). Il tema scuro si abbina all'estetica di Claude Code. |
Requisiti di sistema. Il server richiede Windows 10 versione 1809 o successiva (per il supporto ConPTY) e Claude Code installato sulla macchina host. I client necessitano solo di un browser web moderno.
Funzionalità dell'interfaccia web
L'interfaccia utente web single-page è incorporata direttamente nell'eseguibile, niente file esterni da distribuire. Include:
- Indicatore di stato. Badge colorato (verde = connesso, rosso = disconnesso, blu = login richiesto, ambra = connessione in corso) con animazione a pulsazione.
- Latenza in tempo reale. Mostra la latenza di round-trip in millisecondi, aggiornata a ogni frame.
- Dimensioni del terminale. Mostra le colonne × righe correnti e si aggiorna dinamicamente al ridimensionamento.
- Pulsante Fit. Ridimensiona istantaneamente il terminale per riempire la finestra del browser.
- Copia e incolla. Pieno supporto degli appunti: Ctrl+C copia il testo selezionato, Ctrl+V incolla nel terminale.
- Riconnessione automatica. Se la connessione cade, il client tenta automaticamente di riconnettersi dopo 3 secondi.
- Scrollback di 10.000 righe. Scorri verso l'alto per rivedere l'output precedente di Claude Code senza perdere cronologia.
sgcClaudeCodeRemote è costruito con sgcWebSockets: componenti WebSocket ad alte prestazioni per Delphi e .NET.