Come usare Claude Code su Telegram con Chatcode
Configura Claude Code sul tuo server con il terminale nel browser e Telegram di Chatcode: compromessi chiari su host, inoltro, credenziali e plugin nativo.
Chatcode offre un terminale nel browser e un complemento su Telegram per le sessioni degli agenti di coding che girano su un server che controlli tu. In questa guida configuriamo Claude Code e chiariamo il confine che conta di più: il repository e il processo dell’agente restano sul tuo host, ma il piano di controllo di Chatcode inoltra il traffico leggibile del terminale tra quell’host, il browser e Telegram.
Se ti serve solo un bot Telegram per una sessione di Claude attiva, il plugin ufficiale Channels di Anthropic è un punto di partenza più semplice. Usa questo flusso di lavoro quando il terminale completo nel browser, un host persistente o il supporto a più agenti fanno parte dei requisiti.
Com’è fatta la configurazione
Browser / Telegram
↕
Chatcode control plane
↕ outbound TLS WebSocket
Your server + gateway
↕
Claude Code session
Per il normale traffico di Chatcode il gateway non ha bisogno di una porta in ingresso. Avvia le sessioni degli agenti sulla macchina collegata e mantiene una connessione in uscita verso il piano di controllo. Vale comunque la pena tenere SSH come via separata per l’amministrazione e il ripristino.
1. Scegli l’host
Ci sono due scelte comuni:
- Un server Linux sempre acceso. Collega un VPS esistente oppure usa la procedura DigitalOcean per crearne uno.
- Un Mac che usi già. Eviti un altro server, ma la disponibilità dipende dall’alimentazione, dalla rete e dallo stato di accesso del Mac.
L’installazione su Linux crea un utente dedicato vibe e usa
/home/vibe/workspace. Su macOS il gateway gira con il tuo utente attuale e
usa ~/workspace, quindi eredita i permessi sui file di quell’utente. Leggi
come funziona il gateway prima di decidere quale modello di
fiducia si adatta all’host.
2. Collega il gateway
Accedi su app.chatcode.dev, aggiungi un server e usa il comando di installazione generato. Contiene un identificativo del gateway e un token di autenticazione, quindi non incollarlo in una issue pubblica, in una chat o in una registrazione della shell.
L’installer configura il gateway come servizio in background. Quando nell’app risulta online, verifica l’host e il percorso del workspace prima di aprire una sessione dell’agente.
3. Apri un workspace e autentica Claude Code
Scegli una directory di progetto sotto la radice del workspace configurata, crea una sessione e seleziona Claude Code. Completa l’autenticazione di Claude nel terminale dell’host, esattamente come faresti fuori da Chatcode.
Limita le credenziali al lavoro da fare:
- usa un token del repository specifico per il progetto, quando possibile;
- evita di mettere segreti di produzione nella home directory dell’utente del gateway;
- comincia da un branch o da un worktree che si possa rivedere e scartare;
- scegli l’impostazione sandbox della sessione prima di chiedere l’esecuzione di comandi su larga scala.
Su Linux, l’utente del gateway segue un modello documentato di
amministrazione senza supervisione. Su macOS, il sudo facoltativo senza
password e le richieste di autorizzazione per la privacy di sistema vanno
valutati a parte. La
documentazione del gateway tratta questi dettagli.
4. Collega Telegram
Collega l’account Telegram da Chatcode, poi apri la Mini App o una chat di sessione collegata. Usa prima un prompt innocuo in sola lettura e verifica che arrivi alla stessa sessione mostrata nel browser.
Le due superfici hanno compiti diversi:
- Browser: interazione completa con il terminale, comandi, output ricco e amministrazione delle sessioni.
- Telegram: continuità, notifiche, interazione compatta e viste supportate di file o sessioni.
Tenere presente questa distinzione evita di aspettarsi che una conversazione su Telegram si comporti come una trascrizione completa del terminale.
5. Verifica persistenza e ripristino
Prima di affidarti alla configurazione lontano dalla scrivania:
- Avvia un’attività non distruttiva nel browser.
- Chiudi il browser e verifica che la sessione sul server continui.
- Segui l’aggiornamento da Telegram.
- Riapri il browser e verifica che sia la stessa sessione.
- Prova l’accesso SSH e individua i log del gateway, così hai una via di ripristino.
Un server sempre acceso migliora la disponibilità, ma aumenta anche il tempo in cui un agente e le sue credenziali sono raggiungibili. Tieni aggiornato l’host, controlla l’uso del disco e rimuovi i workspace e le credenziali abbandonati.
Channels nativo o Chatcode?
| Claude Code Channels | Chatcode | |
|---|---|---|
| Interfaccia principale | Telegram | Terminale nel browser più Telegram |
| Processo sull’host | Claude Code con il plugin abilitato | Servizio gateway e sessione dell’agente |
| Richieste di permesso | Le richieste supportate possono essere inoltrate a Telegram | Gestite tramite il terminale dell’agente e le impostazioni di sicurezza della sessione |
| Agenti | Claude Code | Claude Code, Codex, Gemini e OpenCode |
| Dipendenze di fiducia | Plugin di Anthropic e Telegram | Gateway/piano di controllo di Chatcode e Telegram |
| Ideale per | Una sessione di Claude attiva su Telegram | Un flusso di lavoro persistente nel terminale tra dispositivi o agenti diversi |
Channels è ufficiale, più limitato e ha meno parti in movimento. Chatcode offre un’interfaccia più ampia, ma aggiunge un piano di controllo che può leggere il contenuto del terminale che inoltra. Scegli in base all’interfaccia e al modello di fiducia, non partendo dal presupposto che «gestito» significhi automaticamente più sicuro.
Per la strada nativa, segui Come collegare Claude Code a Telegram.
Domande frequenti
Chatcode richiede un VPS?
No. Puoi collegare un server Linux supportato o un Mac che possiedi già. Un VPS è utile quando la sessione deve restare disponibile mentre il tuo computer personale è in sospensione.
Telegram è l'interfaccia completa del terminale?
No. Il browser è il terminale principale. Telegram offre viste collegate, notifiche, anteprime dei file e continuità attorno alla stessa sessione sul server.
Posso usare invece il plugin Telegram ufficiale di Claude Code?
Sì. Usa il plugin ufficiale Channels di Anthropic quando ti serve solo l’accesso da Telegram a una sessione di Claude in esecuzione. Chatcode diventa più rilevante quando ti servono anche un terminale nel browser, un host gestito sempre acceso o più agenti di coding.
Chatcode può leggere il traffico del terminale?
Sì. Le connessioni sono cifrate con TLS su ogni tratta, ma il piano di controllo di Chatcode è un nodo di inoltro fidato, non un canale cifrato end-to-end. Elabora il contenuto del terminale per la formattazione su Telegram, le anteprime, la trascrizione e le notifiche.