---
title: "Come collegare Claude Code a Telegram"
seoTitle: "Collegare Claude Code a Telegram: configurazione nativa"
navTitle: "Claude Code + Telegram"
description: "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."
slug: how-to-connect-claude-code-to-telegram
lang: it
date: 2026-06-08
updated: 2026-07-30
author: "Chatcode"
category: guide
faq:
  - q: "Claude Code ha un'integrazione ufficiale con Telegram?"
    a: "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."
  - q: "Posso approvare da Telegram le richieste di permesso di Claude Code?"
    a: "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."
  - q: "Qual è la differenza tra Channels e Remote Control?"
    a: "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."
  - q: "Il bot Telegram funziona quando Claude Code è chiuso?"
    a: "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."
---

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](https://code.claude.com/docs/en/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](https://bun.sh/) installato sull'host: il plugin ufficiale del canale
  gira su Bun.
- Un account Telegram e un token del bot ottenuto da
  [@BotFather](https://t.me/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:

```text
/plugin install telegram@claude-plugins-official
```

Se il marketplace non è ancora registrato, aggiungilo e riprova:

```text
/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:

```text
/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:

```bash
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:

```bash
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:

```text
/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](https://github.com/anthropics/claude-plugins-official/blob/main/external_plugins/telegram/server.ts)
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](https://code.claude.com/docs/en/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](/articles/claude-code-telegram-with-chatcode).
