Come collegare Claude Code a Telegram
Collega Claude Code a Telegram con il plugin ufficiale Channels: abbinamento del bot, richieste di permesso da remoto, limiti della sessione e scelte più sicure.
Claude Code ha un’integrazione ufficiale con Telegram chiamata Channels. È la scelta giusta quando vuoi inviare un’attività a una sessione che hai già in esecuzione, ricevere la risposta su Telegram e gestire le normali approvazioni degli strumenti senza aprire il portatile.
Il vincolo importante è semplice: Telegram non esegue Claude Code. Il lavoro lo fa comunque un processo di Claude Code sul tuo computer o server, e quel processo deve restare online.
Risposta rapida
Crea un bot privato con BotFather di Telegram, installa il plugin Telegram ufficiale in Claude Code, configura il token, avvia Claude con il canale abilitato e abbina il tuo account Telegram. Tieni il bot in allowlist invece di renderlo pubblico.
Al momento l’integrazione è una research preview (anteprima di ricerca). Consulta la documentazione di Channels di Anthropic prima di automatizzarla su una macchina sensibile, perché comandi e funzionalità possono cambiare.
Cosa ti serve
- Un’installazione aggiornata di Claude Code, autenticata con un account Anthropic supportato.
- Bun installato sull’host: il plugin ufficiale del canale gira su Bun.
- Un account Telegram e un token del bot ottenuto da @BotFather.
- Un terminale che possa restare aperto, oppure una sessione persistente come
tmux.
Tratta il token del bot come una password. Non incollarlo in un repository, in una cronologia della shell condivisa con altri utenti o in uno screenshot.
1. Crea un bot Telegram privato
Apri BotFather in Telegram, invia /newbot e segui le istruzioni. Lo username
del bot deve terminare con bot. Copia il token in un posto temporaneo e
privato.
Per una sessione di coding personale non c’è motivo di aggiungere il bot a un gruppo. I messaggi diretti con un’allowlist sono più facili da tenere sotto controllo.
2. Installa il plugin ufficiale
Dentro Claude Code, installa il plugin Telegram:
/plugin install telegram@claude-plugins-official
Se il marketplace non è ancora registrato, aggiungilo e riprova:
/plugin marketplace add anthropics/claude-plugins-official
/plugin install telegram@claude-plugins-official
/reload-plugins
Usa il nome del marketplace ufficiale e non un pacchetto di terze parti con un nome simile.
3. Configura il token del bot
Esegui il comando del plugin dentro Claude Code:
/telegram:configure <BOT_TOKEN>
Il plugin salva il token nella configurazione locale del canale. Se il token è comparso in un log o in una chat, revocalo tramite BotFather e configurane uno nuovo.
4. Avvia Claude Code con Telegram abilitato
Esci dalla sessione corrente, poi riavviala con il canale:
claude --channels plugin:telegram@claude-plugins-official
Eseguilo dentro il repository su cui Claude deve lavorare. Su un host sempre
acceso, avvialo in una sessione tmux con nome, così una disconnessione SSH
non termina il processo:
tmux new -s claude-telegram
claude --channels plugin:telegram@claude-plugins-official
tmux preserva il processo; non impedisce a un portatile di andare in
sospensione e non ripristina una connessione di rete caduta.
5. Abbina il tuo account e mettilo in allowlist
Invia un messaggio al bot. Ti risponde con un codice di abbinamento. Nel terminale di Claude Code, approva quel codice e mantieni l’accesso limitato:
/telegram:access pair <PAIRING_CODE>
/telegram:access policy allowlist
Fai una prova con una richiesta in sola lettura, per esempio chiedendo a Claude di riassumere la directory corrente. Verifica che il messaggio compaia nella sessione giusta prima di concedere un accesso più ampio agli strumenti.
Come funzionano oggi le richieste di permesso
Le descrizioni meno recenti di Channels dicono spesso che ogni richiesta di permesso obbliga a tornare al terminale. Non è più così. L’attuale plugin Telegram ufficiale dichiara la capacità di Claude Code di inoltrare i permessi (permission relay) e può inviare a Telegram le richieste supportate per gli strumenti con i pulsanti Allow e Deny.
Questo non rende prive di rischi le approvazioni date lontano dal terminale. Una piccola scheda in chat può nascondere un contesto che sarebbe evidente nel diff di un terminale. Leggi il comando e il percorso interessato, evita regole ampie del tipo «consenti sempre» e usa un account con privilegi minimi per una sessione sempre attiva. La fiducia iniziale nel progetto, il consenso MCP e la configurazione del plugin possono richiedere ancora un’interazione nel terminale locale.
I limiti che contano nella pratica
- Il processo sull’host deve restare attivo. Chiudere Claude Code ferma il canale.
- Telegram è un flusso di eventi, non un archivio della sessione. La Bot API consegna i nuovi aggiornamenti; non fornisce al plugin una cronologia completa e ricercabile.
- La risposta vive su Telegram. Il terminale può mostrare l’evento in arrivo e lo stato di consegna, anziché una trascrizione identica alla chat.
- È specifico per Claude. Il plugin non espone Codex né altri agenti.
- È software in anteprima. Ricontrolla la documentazione ufficiale dopo ogni aggiornamento ed evita di fare affidamento su comportamenti non documentati.
Channels vs Remote Control
Remote Control di Anthropic è un’opzione separata. Permette a Claude sul web o all’app per iOS/Android di pilotare una sessione in esecuzione sull’host. File e strumenti restano sull’host, e il telefono fa da interfaccia remota.
Scegli Channels quando l’interfaccia che vuoi è Telegram o quando eventi esterni devono raggiungere una sessione. Scegli Remote Control quando vuoi l’interfaccia ufficiale di Claude e una vista più ravvicinata della sessione attiva. Entrambi dipendono comunque dal processo sull’host.
Quando ha senso un altro livello remoto
Per una singola sessione di Claude, il plugin nativo è di solito la risposta più semplice. Una configurazione diversa diventa rilevante quando cambiano i requisiti: per esempio un terminale completo nel browser, più agenti di coding o un VPS sempre acceso gestito separatamente dal portatile.
Chatcode è una di queste opzioni: collega un server a un terminale nel browser e a Telegram e può eseguire Claude Code insieme a Codex, Gemini e OpenCode. Questo aggiunge un nodo di inoltro di terze parti e la responsabilità di gestire il server, quindi non è un upgrade automatico. La configurazione pratica e i compromessi sono trattati in Claude Code su Telegram con Chatcode.
Domande frequenti
Claude Code ha un'integrazione ufficiale con Telegram?
Sì. Claude Code Channels include un plugin Telegram ufficiale. Collega un bot Telegram autorizzato tramite allowlist a una sessione di Claude Code che resta in esecuzione sul tuo computer o server.
Posso approvare da Telegram le richieste di permesso di Claude Code?
Sì. L’attuale plugin Telegram ufficiale inoltra le richieste di permesso supportate per gli strumenti sotto forma di pulsanti Allow e Deny. La fiducia iniziale nel progetto, il consenso al plugin e parte della configurazione locale richiedono ancora il terminale.
Qual è la differenza tra Channels e Remote Control?
Channels permette a Telegram o a un altro servizio di inviare eventi a una sessione di Claude Code in esecuzione. Remote Control espone la sessione tramite Claude sul web o sul telefono. Entrambi usano un processo di Claude sull’host, ma cambiano l’interfaccia e il modo in cui l’interazione viene avviata.
Il bot Telegram funziona quando Claude Code è chiuso?
No. Il server del canale gira insieme alla sessione di Claude Code. Se vuoi che resti raggiungibile, mantieni attivo il processo in un terminale persistente o su un host sempre acceso.