Invia eventi in una sessione in esecuzione con i canali

Utilizza i canali per inviare messaggi, avvisi e webhook nella tua sessione Claude Code da un server MCP. Inoltra i risultati CI, i messaggi di chat e gli eventi di monitoraggio in modo che Claude possa reagire mentre sei assente.

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:

• Canali supportati: configurazione di Telegram, Discord e iMessage
• Installa ed esegui un canale con fakechat, una demo localhost
• Chi può inviare messaggi: allowlist dei mittenti e come si accoppia
• Abilita i canali per la tua organizzazione se gestisci un'organizzazione Team, Enterprise o Console
• Come si confrontano i canali con sessioni web, Slack, MCP e Remote Control

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.

/plugin install telegram@claude-plugins-official

/telegram:configure <token>

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

/telegram:access pair <code>

/telegram:access policy allowlist

/plugin install discord@claude-plugins-official

/discord:configure <token>

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

/discord:access pair <code>

/discord:access policy allowlist

/plugin install imessage@claude-plugins-official

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

/imessage:access allow +15551234567

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 o una chiave API Console
• Bun installato. I plugin di canale pre-costruiti sono script Bun. Controlla con bun --version; se fallisce, installa Bun.
• Organizzazioni Team, Enterprise o Console gestite: l'amministratore della tua organizzazione deve abilitare i canali nelle impostazioni gestite

/plugin install fakechat@claude-plugins-official

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

hey, what's in my working directory?

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 i prompt diversi dalle regole di richiesta esplicita, ma usalo solo in ambienti di cui ti fidi.

Quando esegui i canali in modalità non interattiva con -p, gli strumenti che necessitano di input da terminale, come domande a scelta multipla e approvazione della modalità plan, sono disabilitati in modo che la sessione non si blocchi mai in attesa di input.

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 la tua organizzazione controlla la disponibilità con channelsEnabled su piani Team ed Enterprise di claude.ai e su organizzazioni Console che distribuiscono impostazioni gestite.

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

Gli amministratori controllano la disponibilità attraverso due impostazioni gestite che gli utenti non possono ignorare. L'impostazione predefinita dipende da come ti autentichi:

• claude.ai Team ed Enterprise: i canali sono bloccati fino a quando un amministratore non li abilita.
• Anthropic Console con autenticazione tramite chiave API: i canali sono consentiti per impostazione predefinita. Hai bisogno di questa impostazione solo se la tua organizzazione distribuisce impostazioni gestite.

In tutti i casi, nessun canale viene eseguito fino a quando un utente non lo abilita per la sessione con --channels.

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:

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:

• Crea il tuo canale per sistemi che non hanno ancora plugin
• Remote Control per guidare una sessione locale dal tuo telefono invece di inoltrarvi eventi
• Attività pianificate per eseguire il polling su un timer invece di reagire a eventi inviati