Vai al contenuto principale
I canali sono in anteprima di ricerca e richiedono Claude Code v2.1.80 o versione successiva. Richiedono l’accesso a claude.ai. L’autenticazione tramite console e chiave API non è supportata. Le organizzazioni Team ed Enterprise devono abilitarli esplicitamente.
Un canale è un server MCP che invia eventi nella tua sessione Claude Code in esecuzione, in modo che Claude possa reagire alle cose che accadono mentre non sei al terminale. I canali possono essere bidirezionali: Claude legge l’evento e risponde attraverso lo stesso canale, come un ponte di chat. Gli eventi arrivano solo mentre la sessione è aperta, quindi per una configurazione sempre attiva esegui Claude in un processo in background o in un terminale persistente. A differenza delle integrazioni che avviano una nuova sessione cloud o attendono di essere interrogate, l’evento arriva nella sessione che hai già aperto: vedi come si confrontano i canali. Installi un canale come plugin e lo configuri con le tue credenziali. Telegram, Discord e iMessage sono inclusi nell’anteprima di ricerca. Quando Claude risponde attraverso un canale, vedi il messaggio in arrivo nel tuo terminale ma non il testo della risposta. Il terminale mostra la chiamata dello strumento e una conferma (come “inviato”), e la risposta effettiva appare sull’altra piattaforma. Questa pagina copre: Per creare il tuo canale, vedi il riferimento Canali.

​
Canali supportati

Ogni canale supportato è un plugin che richiede Bun. Per una demo pratica del flusso del plugin prima di connettere una piattaforma reale, prova la guida rapida fakechat.
Visualizza il codice sorgente del plugin Telegram completo.
1

Crea un bot Telegram

Apri BotFather in Telegram e invia /newbot. Dagli un nome visualizzato e un nome utente univoco che termina con bot. Copia il token che BotFather restituisce.
2

Installa il plugin

In Claude Code, esegui:
/plugin install telegram@claude-plugins-official
Se Claude Code segnala che il plugin non si trova in alcun marketplace, il tuo marketplace è mancante o obsoleto. Esegui /plugin marketplace update claude-plugins-official per aggiornarlo, oppure /plugin marketplace add anthropics/claude-plugins-official se non l’hai ancora aggiunto. Quindi riprova l’installazione.Dopo l’installazione, esegui /reload-plugins per attivare il comando di configurazione del plugin.
3

Configura il tuo token

Esegui il comando di configurazione con il token da BotFather:
/telegram:configure <token>
Questo lo salva in ~/.claude/channels/telegram/.env. Puoi anche impostare TELEGRAM_BOT_TOKEN nel tuo ambiente shell prima di avviare Claude Code.
4

Riavvia con i canali abilitati

Esci da Claude Code e riavvia con il flag del canale. Questo avvia il plugin Telegram, che inizia a eseguire il polling dei messaggi dal tuo bot:
claude --channels plugin:telegram@claude-plugins-official
5

Accoppia il tuo account

Apri Telegram e invia qualsiasi messaggio al tuo bot. Il bot risponde con un codice di accoppiamento.
Se il tuo bot non risponde, assicurati che Claude Code sia in esecuzione con --channels dal passaggio precedente. Il bot può rispondere solo mentre il canale è attivo.
Torna in Claude Code ed esegui:
/telegram:access pair <code>
Quindi blocca l’accesso in modo che solo il tuo account possa inviare messaggi:
/telegram:access policy allowlist
Puoi anche creare il tuo canale per sistemi che non hanno ancora un plugin.

​
Guida rapida

Fakechat è un canale demo ufficialmente supportato che esegue un’interfaccia di chat su localhost, senza nulla da autenticare e nessun servizio esterno da configurare. Una volta installato e abilitato fakechat, puoi digitare nel browser e il messaggio arriva nella tua sessione Claude Code. Claude risponde e la risposta appare di nuovo nel browser. Dopo aver testato l’interfaccia fakechat, prova Telegram, Discord o iMessage. Per provare la demo fakechat, avrai bisogno di:
  • Claude Code installato e autenticato con un account claude.ai
  • Bun installato. I plugin di canale pre-costruiti sono script Bun. Controlla con bun --version; se fallisce, installa Bun.
  • Utenti Team/Enterprise: l’amministratore della tua organizzazione deve abilitare i canali nelle impostazioni gestite
1

Installa il plugin del canale fakechat

Avvia una sessione Claude Code ed esegui il comando di installazione:
/plugin install fakechat@claude-plugins-official
Se Claude Code segnala che il plugin non si trova in alcun marketplace, il tuo marketplace è mancante o obsoleto. Esegui /plugin marketplace update claude-plugins-official per aggiornarlo, oppure /plugin marketplace add anthropics/claude-plugins-official se non l’hai ancora aggiunto. Quindi riprova l’installazione.
2

Riavvia con il canale abilitato

Esci da Claude Code, quindi riavvia con --channels e passa il plugin fakechat che hai installato:
claude --channels plugin:fakechat@claude-plugins-official
Il server fakechat si avvia automaticamente.
Puoi passare più plugin a --channels, separati da spazi.
3

Invia un messaggio

Apri l’interfaccia fakechat su http://localhost:8787 e digita un messaggio:
hey, what's in my working directory?
Il messaggio arriva nella tua sessione Claude Code come evento <channel source="fakechat">. Claude lo legge, fa il lavoro e chiama lo strumento reply di fakechat. La risposta appare nell’interfaccia di chat.
Se Claude incontra un prompt di permesso mentre sei lontano dal terminale, la sessione si mette in pausa fino a quando non rispondi. I server di canale che dichiarano la capacità di inoltro dei permessi possono inoltrarti questi prompt in modo che tu possa approvare o negare da remoto. Per l’uso incustodito, --dangerously-skip-permissions bypassa completamente i prompt, ma usalo solo in ambienti di cui ti fidi.

​
Sicurezza

Ogni plugin di canale approvato mantiene un allowlist dei mittenti: solo gli ID che hai aggiunto possono inviare messaggi e tutti gli altri vengono silenziosamente scartati. Telegram e Discord avviano l’elenco mediante accoppiamento:
  1. Trova il tuo bot in Telegram o Discord e invigli qualsiasi messaggio
  2. Il bot risponde con un codice di accoppiamento
  3. Nella tua sessione Claude Code, approva il codice quando richiesto
  4. Il tuo ID mittente viene aggiunto all’allowlist
iMessage funziona diversamente: inviarti messaggi bypassa automaticamente il gate, e aggiungi altri contatti per handle con /imessage:access allow. Oltre a ciò, controlli quali server sono abilitati ogni sessione con --channels, e su piani Team ed Enterprise la tua organizzazione controlla la disponibilità con channelsEnabled. Essere in .mcp.json non è sufficiente per inviare messaggi: un server deve anche essere nominato in --channels. L’allowlist controlla anche l’inoltro dei permessi se il canale lo dichiara. Chiunque possa rispondere attraverso il canale può approvare o negare l’uso dello strumento nella tua sessione, quindi allowlist solo i mittenti di cui ti fidi con questa autorità.

​
Controlli Enterprise

Su piani Team ed Enterprise, i canali sono disabilitati per impostazione predefinita. Gli amministratori controllano la disponibilità attraverso due impostazioni gestite che gli utenti non possono ignorare:
ImpostazioneScopoQuando non configurato
channelsEnabledInterruttore principale. Deve essere true affinché qualsiasi canale consegni messaggi. Impostato tramite l’interruttore della console Admin di claude.ai o direttamente nelle impostazioni gestite. Blocca tutti i canali incluso il flag di sviluppo quando disattivato.Canali bloccati
allowedChannelPluginsQuali plugin possono registrarsi una volta abilitati i canali. Sostituisce l’elenco mantenuto da Anthropic quando impostato. Si applica solo quando channelsEnabled è true.Si applica l’elenco predefinito di Anthropic
Gli utenti Pro e Max senza un’organizzazione saltano completamente questi controlli: i canali sono disponibili e gli utenti optano per sessione con --channels.

​
Abilita i canali per la tua organizzazione

Gli amministratori possono abilitare i canali da claude.ai → Admin settings → Claude Code → Channels, oppure impostando channelsEnabled su true nelle impostazioni gestite. Una volta abilitati, gli utenti della tua organizzazione possono usare --channels per optare i server di canale in sessioni individuali. Se l’impostazione è disabilitata o non impostata, il server MCP si connette comunque e i suoi strumenti funzionano, ma i messaggi del canale non arriveranno. Un avviso di avvio dice all’utente di far abilitare l’impostazione a un amministratore.

​
Limita quali plugin di canale possono essere eseguiti

Per impostazione predefinita, qualsiasi plugin nell’elenco di allowlist mantenuto da Anthropic può registrarsi come canale. Gli amministratori su piani Team ed Enterprise possono sostituire quell’allowlist con il loro impostando allowedChannelPlugins nelle impostazioni gestite. Usalo per limitare quali plugin ufficiali sono consentiti, approvare canali dal tuo marketplace interno, o entrambi. Ogni voce nomina un plugin e il marketplace da cui proviene: 
{
  "channelsEnabled": true,
  "allowedChannelPlugins": [
    { "marketplace": "claude-plugins-official", "plugin": "telegram" },
    { "marketplace": "claude-plugins-official", "plugin": "discord" },
    { "marketplace": "acme-corp-plugins", "plugin": "internal-alerts" }
  ]
}
Quando allowedChannelPlugins è impostato, sostituisce completamente l’allowlist di Anthropic: solo i plugin elencati possono registrarsi. Lascialo non impostato per tornare all’allowlist predefinito di Anthropic. Un array vuoto blocca tutti i plugin di canale dall’allowlist, ma --dangerously-load-development-channels può comunque bypassarlo per i test locali. Per bloccare completamente i canali incluso il flag di sviluppo, lascia invece channelsEnabled non impostato. Questa impostazione richiede channelsEnabled: true. Se un utente passa un plugin a --channels che non è nel tuo elenco, Claude Code si avvia normalmente ma il canale non si registra, e l’avviso di avvio spiega che il plugin non è nell’elenco approvato dell’organizzazione.

​
Anteprima di ricerca

I canali sono una funzione di anteprima di ricerca. La disponibilità viene implementata gradualmente e la sintassi del flag --channels e il contratto del protocollo possono cambiare in base al feedback. Durante l’anteprima, --channels accetta solo plugin da un allowlist mantenuto da Anthropic, o dall’allowlist della tua organizzazione se un amministratore ha impostato allowedChannelPlugins. I plugin di canale in claude-plugins-official sono l’insieme approvato predefinito. Se passi qualcosa che non è nell’allowlist effettivo, Claude Code si avvia normalmente ma il canale non si registra, e l’avviso di avvio ti dice perché. Per testare un canale che stai costruendo, usa --dangerously-load-development-channels. Vedi Test durante l’anteprima di ricerca per informazioni sul test di canali personalizzati che costruisci. Segnala problemi o feedback nel repository GitHub di Claude Code.

​
Come si confrontano i canali

Diverse funzioni di Claude Code si connettono a sistemi al di fuori del terminale, ognuna adatta a un diverso tipo di lavoro:
FunzioneCosa faBuono per
Claude Code sul webEsegue attività in una nuova sandbox cloud, clonata da GitHubDelegare lavoro asincrono autonomo su cui torni in seguito
Claude in SlackAvvia una sessione web da una menzione @Claude in un canale o threadAvviare attività direttamente dal contesto della conversazione del team
Server MCP standardClaude lo interroga durante un’attività; nulla viene inviato alla sessioneDare a Claude accesso on-demand per leggere o interrogare un sistema
Remote ControlGuidi la tua sessione locale da claude.ai o dall’app mobile ClaudeGuidare una sessione in corso mentre sei lontano dalla tua scrivania
I canali colmano il divario in quell’elenco inviando eventi da fonti non-Claude nella tua sessione locale già in esecuzione.
  • Ponte di chat: chiedi a Claude qualcosa dal tuo telefono tramite Telegram, Discord o iMessage, e la risposta torna nella stessa chat mentre il lavoro viene eseguito sulla tua macchina contro i tuoi file reali.
  • Ricevitore webhook: un webhook da CI, il tuo error tracker, una pipeline di deploy o altro servizio esterno arriva dove Claude ha già i tuoi file aperti e ricorda cosa stavi debuggando.

​
Passaggi successivi

Una volta che hai un canale in esecuzione, esplora queste funzioni correlate: