Configurare i channels di Claude Code con Telegram

Cosa sono i channels

Un channel è un server MCP. Invia eventi in una sessione di Claude Code già in esecuzione. Può essere bidirezionale. Claude legge il messaggio, lavora e risponde nella stessa chat. La documentazione di Anthropic elenca Telegram, Discord e iMessage nella research preview (code.claude.com/docs/en/channels, ottobre 2026).

È diverso da Remote Control. Remote Control ti fa guidare la tua sessione dall’app Claude. I channels portano dentro messaggi da altre piattaforme, e anche webhook, come quello di una CI fallita.

Requisiti

• Claude Code con login tramite un account claude.ai o una chiave API della Console. I channels non funzionano su Amazon Bedrock, Google Cloud o Microsoft Foundry.
• Sui piani Team ed Enterprise un amministratore deve prima attivare i channels. Gli utenti Pro e Max senza organizzazione possono usarli subito. La documentazione dice anche che la disponibilità viene estesa in modo graduale.
• Bun. I plugin dei channels sono script Bun.
• Un token di bot Telegram da BotFather, per il channel Telegram.

Installa i pezzi

Installa Claude Code e Bun con i loro script ufficiali.

curl -fsSL https://claude.ai/install.sh | bash
curl -fsSL https://bun.com/install | bash

In Telegram, apri BotFather e invia il comando newbot. Scegli un nome e uno username che finisce in bot. Copia il token che ti restituisce. Poi installa il plugin. Dentro Claude Code è uno slash command.

/plugin install telegram@claude-plugins-official

Da una shell normale, la CLI dei plugin fa la stessa cosa. Se manca il marketplace, aggiungilo prima.

claude plugin marketplace add anthropics/claude-plugins-official
claude plugin install telegram@claude-plugins-official

Li abbiamo eseguiti su una macchina macOS 26 in hosting su GitHub, il 2 ottobre 2026, senza login. L’installazione ha funzionato. Questo è ciò che ha stampato.

$ claude --version
2.1.287 (Claude Code)
$ bun --version
1.4.2
$ claude plugin install telegram@claude-plugins-official
Successfully installed plugin: telegram@claude-plugins-official (scope: user)
$ claude plugin list
  telegram@claude-plugins-official
    Version: 0.0.7
    Scope: user
    Status: enabled

Collega il bot e fai l’abbinamento

Dentro Claude Code, salva il tuo token. Viene conservato nella cartella telegram, sotto channels, nella cartella di configurazione di Claude.

/telegram:configure <token>

Poi esci e avvia di nuovo Claude Code dalla shell, con il flag del channel.

claude --channels plugin:telegram@claude-plugins-official

Invia un messaggio qualsiasi al tuo bot. Risponde con un codice di abbinamento. Approva il codice in Claude Code, poi limita il bot al solo tuo account.

/telegram:access pair <code>
/telegram:access policy allowlist

Qui due cose confondono. Durante la preview il flag del channel non compare nell’output di aiuto, ma funziona. E il terminale mostra il messaggio in arrivo e una nota di invio, non il testo della risposta. La risposta compare in Telegram.

Discord invece di Telegram

I passaggi per Discord seguono lo stesso schema. Crea un’applicazione nel Discord Developer Portal e copia il token del bot. Attiva Message Content Intent. Invita il bot nel tuo server con i permessi per vedere i canali, inviare messaggi e leggere la cronologia. Poi installa, configura e fai l’abbinamento allo stesso modo. La riga di riavvio va eseguita nella shell. Le altre righe vanno eseguite dentro Claude Code.

/plugin install discord@claude-plugins-official
/discord:configure <token>
claude --channels plugin:discord@claude-plugins-official
/discord:access pair <code>
/discord:access policy allowlist

Puoi passare più plugin al flag channels, separati da spazi. Così una sola sessione può ascoltare su entrambe le app.

Tieni la sessione aperta giorno e notte

Gli eventi arrivano solo a una sessione aperta. Chiudi il terminale, lascia andare il Mac in stop o riavvialo, e il bot tace. Tre cose risolvono il problema. Disattiva lo stop. Esegui Claude Code dentro tmux. Avvia quella sessione tmux al login.

sudo pmset -a sleep 0
sudo pmset -a disksleep 0
sudo pmset -a displaysleep 10

Questo LaunchAgent avvia una sessione tmux chiamata channels con Claude Code e il channel Telegram. Controlla ogni minuto e non fa nulla se la sessione esiste già. Salvalo come dev.local.claude-channels.plist nella tua cartella LaunchAgents.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
  "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
  <key>Label</key><string>dev.local.claude-channels</string>
  <key>ProgramArguments</key>
  <array>
    <string>/bin/zsh</string>
    <string>-lc</string>
    <string>export PATH="$HOME/.local/bin:$HOME/.bun/bin:/opt/homebrew/bin:$PATH"; tmux has-session -t channels 2>/dev/null || tmux new -d -s channels -c "$HOME" "claude --channels plugin:telegram@claude-plugins-official"</string>
  </array>
  <key>RunAtLoad</key><true/>
  <key>StartInterval</key><integer>60</integer>
</dict>
</plist>

Se non hai tmux, installalo prima. Poi carica l’agente e riattaccati per controllare Claude.

brew install tmux
launchctl load ~/Library/LaunchAgents/dev.local.claude-channels.plist
tmux attach -t channels

Abbiamo testato esattamente questo file su una macchina macOS 26 in hosting su GitHub, il 2 ottobre 2026. Venti secondi dopo il caricamento, launchd aveva creato la sessione nella cartella home, con Claude Code in attesa al suo interno.

$ tmux ls
channels: 1 windows (created Fri Oct  2 04:21:09 2026)
$ tmux capture-pane -pt channels
Welcome to Claude Code v2.1.287

La sessione parte nella tua cartella home. Se vuoi che Claude parta dal tuo progetto, metti il suo percorso al posto della variabile home. La prima volta, riattaccati, rispondi alle domande del primo avvio e fai il login.

C’è un altro blocco da prevedere. Se Claude incontra una richiesta di permesso mentre sei via, la sessione ti aspetta. La documentazione cita un flag per saltare i permessi sulle macchine fidate. Prima di usarlo, leggi come far girare Claude Code senza supervisione in sicurezza.

Note di sicurezza

• Ogni channel ha una allowlist dei mittenti. I messaggi di chiunque altro vengono scartati in silenzio.
• Chiunque sia nella allowlist può guidare la tua sessione. Se il plugin inoltra le richieste di permesso, può anche approvare l’uso degli strumenti. Aggiungi solo persone a cui affideresti la tua macchina.
• Il token del tuo bot è una password. Se trapela, revocalo in BotFather e configura quello nuovo.
• iMessage legge il database di Messaggi e richiede l’Accesso completo al disco. Su un Mac a noleggio, vuol dire fare login con il tuo Apple ID in Messaggi su hardware che non è tuo. Telegram o Discord lo evitano.

Farlo girare su un Mac di MacRun

Il nostro piano Agent ha già Claude Code installato. Fai il login con il tuo piano Claude. Il Mac non va mai in stop e la sua sessione sopravvive ai riavvii. Aggiungi Bun e il plugin, e bastano pochi minuti. A quel punto puoi chiudere il portatile, e il bot risponde lo stesso.

Chi non ne ha bisogno. Se vuoi solo guidare una sessione dal telefono, Remote Control dell’app Claude lo fa senza bot. E se l’amministratore del tuo piano Team non ha attivato i channels, un nuovo Mac non cambia le cose.

Per il quadro completo, leggi far girare Claude Code 24/7 su un Mac.