Ereignisse mit Kanälen in eine laufende Sitzung übertragen

Verwenden Sie Kanäle, um Nachrichten, Benachrichtigungen und Webhooks von einem MCP-Server in Ihre Claude Code-Sitzung zu übertragen. Leiten Sie CI-Ergebnisse, Chat-Nachrichten und Überwachungsereignisse weiter, damit Claude reagieren kann, während Sie weg sind.

Ein Kanal ist ein MCP-Server, der Ereignisse in Ihre laufende Claude Code-Sitzung überträgt, damit Claude auf Dinge reagieren kann, die passieren, während Sie nicht am Terminal sind. Kanäle können bidirektional sein: Claude liest das Ereignis und antwortet über denselben Kanal zurück, wie eine Chat-Brücke. Ereignisse treffen nur ein, während die Sitzung offen ist. Für ein Always-On-Setup führen Sie Claude in einem Hintergrundprozess oder persistenten Terminal aus.

Im Gegensatz zu Integrationen, die eine neue Cloud-Sitzung starten oder auf Abruf warten, kommt das Ereignis in der Sitzung an, die Sie bereits offen haben: siehe wie Kanäle sich vergleichen.

Sie installieren einen Kanal als Plugin und konfigurieren ihn mit Ihren eigenen Anmeldedaten. Telegram, Discord und iMessage sind in der Forschungsvorschau enthalten.

Wenn Claude über einen Kanal antwortet, sehen Sie die eingehende Nachricht in Ihrem Terminal, aber nicht den Antworttext. Das Terminal zeigt den Tool-Aufruf und eine Bestätigung (wie „gesendet"), und die eigentliche Antwort erscheint auf der anderen Plattform.

Diese Seite behandelt:

• Unterstützte Kanäle: Telegram-, Discord- und iMessage-Setup
• Installieren und Ausführen eines Kanals mit fakechat, einer Localhost-Demo
• Wer Nachrichten übertragen kann: Sender-Allowlists und wie Sie koppeln
• Kanäle für Ihre Organisation aktivieren, wenn Sie ein Team, Enterprise oder Console-Org verwalten
• Wie Kanäle sich vergleichen mit Web-Sitzungen, Slack, MCP und Remote Control

Um Ihren eigenen Kanal zu erstellen, siehe die Kanäle-Referenz.

Unterstützte Kanäle

Jeder unterstützte Kanal ist ein Plugin, das Bun erfordert. Für eine praktische Demo des Plugin-Flows, bevor Sie eine echte Plattform verbinden, versuchen Sie die fakechat-Schnellstart.

/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

Sie können auch Ihren eigenen Kanal erstellen für Systeme, die noch kein Plugin haben.

Schnellstart

Fakechat ist ein offiziell unterstützter Demo-Kanal, der eine Chat-Benutzeroberfläche auf localhost ausführt, ohne dass etwas authentifiziert werden muss und kein externer Service konfiguriert werden muss.

Sobald Sie fakechat installieren und aktivieren, können Sie im Browser eingeben und die Nachricht kommt in Ihrer Claude Code-Sitzung an. Claude antwortet, und die Antwort erscheint zurück im Browser. Nachdem Sie die fakechat-Benutzeroberfläche getestet haben, versuchen Sie Telegram, Discord oder iMessage.

Um die fakechat-Demo zu versuchen, benötigen Sie:

• Claude Code installiert und authentifiziert mit einem claude.ai-Konto oder einem Claude Console-API-Schlüssel
• Bun installiert. Die vorgefertigten Kanal-Plugins sind Bun-Skripte. Überprüfen Sie mit bun --version; wenn das fehlschlägt, installieren Sie Bun.
• Team, Enterprise oder verwaltete Console-Org: Ihr Administrator muss Kanäle aktivieren in verwalteten Einstellungen

/plugin install fakechat@claude-plugins-official

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

hey, what's in my working directory?

Wenn Claude auf eine Berechtigungsaufforderung trifft, während Sie weg vom Terminal sind, pausiert die Sitzung, bis Sie antworten. Kanal-Server, die die Berechtigungsweiterleitungsfähigkeit deklarieren, können diese Aufforderungen an Sie weiterleiten, damit Sie remote genehmigen oder ablehnen können. Für unbeaufsichtigte Nutzung umgeht --dangerously-skip-permissions Aufforderungen vollständig, aber verwenden Sie es nur in Umgebungen, denen Sie vertrauen.

Wenn Sie Kanäle im nicht-interaktiven Modus mit -p ausführen, sind Tools, die Terminaleingaben benötigen, wie Multiple-Choice-Fragen und Plan Mode-Genehmigung, deaktiviert, damit die Sitzung nie auf Eingaben wartet.

Sicherheit

Jedes genehmigte Kanal-Plugin verwaltet eine Sender-Allowlist: Nur IDs, die Sie hinzugefügt haben, können Nachrichten übertragen, und alle anderen werden stillschweigend gelöscht.

Telegram und Discord starten die Liste durch Kopplung:

1. Finden Sie Ihren Bot in Telegram oder Discord und senden Sie ihm eine beliebige Nachricht
2. Der Bot antwortet mit einem Kopplungscode
3. In Ihrer Claude Code-Sitzung genehmigen Sie den Code, wenn Sie dazu aufgefordert werden
4. Ihre Sender-ID wird zur Allowlist hinzugefügt

iMessage funktioniert anders: Sich selbst zu schreiben umgeht das Gate automatisch, und Sie fügen andere Kontakte mit /imessage:access allow nach Handle hinzu.

Darüber hinaus kontrollieren Sie, welche Server in jeder Sitzung mit --channels aktiviert sind, und Ihre Organisation kontrolliert die Verfügbarkeit mit channelsEnabled auf claude.ai Team- und Enterprise-Plänen und auf Console-Organisationen, die verwaltete Einstellungen bereitstellen.

In .mcp.json zu sein reicht nicht aus, um Nachrichten zu übertragen: Ein Server muss auch in --channels benannt werden.

Die Allowlist kontrolliert auch Berechtigungsweiterleitungen, wenn der Kanal sie deklariert. Jeder, der über den Kanal antworten kann, kann die Tool-Nutzung in Ihrer Sitzung genehmigen oder ablehnen, daher sollten Sie nur Sender zur Allowlist hinzufügen, denen Sie diese Autorität vertrauen.

Enterprise-Steuerelemente

Administratoren kontrollieren die Verfügbarkeit durch zwei verwaltete Einstellungen, die Benutzer nicht überschreiben können. Der Standard hängt davon ab, wie Sie sich authentifizieren:

• claude.ai Team und Enterprise: Kanäle sind blockiert, bis ein Administrator sie aktiviert.
• Anthropic Console mit API-Schlüssel-Authentifizierung: Kanäle sind standardmäßig zulässig. Sie benötigen diese Einstellung nur, wenn Ihre Organisation verwaltete Einstellungen bereitstellt.

In allen Fällen wird kein Kanal ausgeführt, bis ein Benutzer ihn für die Sitzung mit --channels aktiviert.

Pro- und Max-Benutzer ohne Organisation überspringen diese Überprüfungen vollständig: Kanäle sind verfügbar und Benutzer aktivieren sie pro Sitzung mit --channels.

Aktivieren Sie Kanäle für Ihre Organisation

Administratoren können Kanäle von claude.ai → Admin settings → Claude Code → Channels aktivieren oder indem sie channelsEnabled in verwalteten Einstellungen auf true setzen.

Nach der Aktivierung können Benutzer in Ihrer Organisation --channels verwenden, um Kanal-Server in einzelne Sitzungen zu aktivieren. Wenn die Einstellung deaktiviert oder nicht gesetzt ist, verbindet sich der MCP-Server immer noch und seine Tools funktionieren, aber Kanal-Nachrichten kommen nicht an. Eine Startwarnmeldung teilt dem Benutzer mit, dass ein Administrator die Einstellung aktivieren muss.

Beschränken Sie, welche Kanal-Plugins ausgeführt werden können

Standardmäßig kann jedes Plugin auf der von Anthropic verwalteten Allowlist sich als Kanal registrieren. Administratoren auf Team- und Enterprise-Plänen können diese Allowlist durch Setzen von allowedChannelPlugins in verwalteten Einstellungen durch ihre eigene ersetzen. Verwenden Sie dies, um zu beschränken, welche offiziellen Plugins zulässig sind, Kanäle aus Ihrem eigenen internen Marketplace zu genehmigen oder beides. Jeder Eintrag benennt ein Plugin und den Marketplace, aus dem es stammt:

{
  "channelsEnabled": true,
  "allowedChannelPlugins": [
    { "marketplace": "claude-plugins-official", "plugin": "telegram" },
    { "marketplace": "claude-plugins-official", "plugin": "discord" },
    { "marketplace": "acme-corp-plugins", "plugin": "internal-alerts" }
  ]
}

Wenn allowedChannelPlugins gesetzt ist, ersetzt es die Anthropic-Allowlist vollständig: Nur die aufgelisteten Plugins können sich registrieren. Lassen Sie es ungesetzt, um auf die Standard-Anthropic-Allowlist zurückzufallen. Ein leeres Array blockiert alle Kanal-Plugins aus der Allowlist, aber --dangerously-load-development-channels kann es immer noch für lokale Tests umgehen. Um Kanäle vollständig einschließlich des Entwicklungs-Flags zu blockieren, lassen Sie stattdessen channelsEnabled ungesetzt.

Diese Einstellung erfordert channelsEnabled: true. Wenn ein Benutzer ein Plugin an --channels übergibt, das nicht auf Ihrer Liste steht, startet Claude Code normal, aber der Kanal registriert sich nicht, und die Startnachricht erklärt, dass das Plugin nicht auf der genehmigten Liste Ihrer Organisation steht.

Forschungsvorschau

Kanäle sind eine Forschungsvorschau-Funktion. Die Verfügbarkeit wird schrittweise ausgerollt, und die --channels-Flag-Syntax und der Protokollvertrag können sich basierend auf Feedback ändern.

Während der Vorschau akzeptiert --channels nur Plugins von einer von Anthropic verwalteten Allowlist oder von der Allowlist Ihrer Organisation, wenn ein Administrator allowedChannelPlugins gesetzt hat. Die Kanal-Plugins in claude-plugins-official sind die Standard-genehmigte Menge. Wenn Sie etwas anderes übergeben, das nicht auf der geltenden Allowlist steht, startet Claude Code normal, aber der Kanal registriert sich nicht, und die Startnachricht teilt Ihnen mit, warum.

Um einen Kanal zu testen, den Sie erstellen, verwenden Sie --dangerously-load-development-channels. Siehe Test während der Forschungsvorschau für Informationen zum Testen benutzerdefinierter Kanäle, die Sie erstellen.

Melden Sie Probleme oder Feedback im Claude Code GitHub-Repository.

Wie Kanäle sich vergleichen

Mehrere Claude Code-Funktionen verbinden sich mit Systemen außerhalb des Terminals, jede für eine andere Art von Arbeit geeignet:

Kanäle füllen die Lücke in dieser Liste, indem sie Ereignisse von Nicht-Claude-Quellen in Ihre bereits laufende lokale Sitzung übertragen.

• Chat-Brücke: Fragen Sie Claude etwas von Ihrem Telefon über Telegram, Discord oder iMessage, und die Antwort kommt im selben Chat zurück, während die Arbeit auf Ihrem Computer gegen Ihre echten Dateien läuft.
• Webhook-Empfänger: Ein Webhook von CI, Ihrem Error Tracker, einer Deploy-Pipeline oder einem anderen externen Service kommt dort an, wo Claude bereits Ihre Dateien offen hat und sich erinnert, was Sie debuggt haben.

Nächste Schritte

Sobald Sie einen Kanal ausgeführt haben, erkunden Sie diese verwandten Funktionen:

• Erstellen Sie Ihren eigenen Kanal für Systeme, die noch keine Plugins haben
• Remote Control, um eine lokale Sitzung von Ihrem Telefon aus zu steuern, anstatt Ereignisse darin zu übertragen
• Geplante Aufgaben, um auf einem Timer abzurufen, anstatt auf übertragene Ereignisse zu reagieren