Claude Code Channels - Interagiere mit Claude über Telegram! Schritt-für-Schritt-Einrichtungsanleitung

Wäre es nicht praktisch, Claude Code Nachrichten vom Smartphone aus senden zu können, auch wenn man nicht vor dem Terminal sitzt? Ich habe selbst versucht, eine solche Umgebung mit Discord-Integration aufzubauen, war aber mit dem Ergebnis nicht wirklich zufrieden. Mit Claude Code Channels, das kürzlich (am 21. März 2026) als Research Preview veröffentlicht wurde, lässt sich das jedoch ganz einfach umsetzen!

In diesem Artikel erkläre ich Schritt für Schritt, wie man Claude Code Channels mit der Chat-App Telegram einrichtet - von Grund auf und leicht verständlich.

Was ist Claude Code Channels?

Claude Code Channels ist ein System, das externe Benachrichtigungen und Nachrichten in Echtzeit an eine laufende Claude Code-Sitzung übermittelt. Technisch gesehen läuft es als MCP-Server (Model Context Protocol) und wird als Unterprozess von Claude Code gestartet.

Zum Beispiel sind folgende Anwendungsfälle möglich:

• Chat-Integration: Wenn man eine Nachricht über Telegram oder Discord sendet, empfängt das lokal laufende Claude Code diese und führt die entsprechende Aufgabe aus
• Webhook-Integration: CI/CD-Ergebnisse oder Monitoring-Alerts werden direkt an Claude Code weitergeleitet, das dann automatisch reagiert

Es unterstützt sowohl Einwegkommunikation (nur Benachrichtigungen senden) als auch bidirektionale Kommunikation (Claude antwortet ebenfalls). Bei der Integration mit Chat-Apps ist ein bidirektionaler Austausch möglich: Man sendet eine Nachricht vom Smartphone, und Claude schickt das Ergebnis seiner Arbeit zurück in denselben Chat.

Warum Telegram?

In der Research-Preview-Phase werden Telegram und Discord offiziell als Chat-Apps unterstützt. Ich habe mich für Telegram entschieden. Hier sind einige Gründe dafür.

1. Bot-Erstellung ist denkbar einfach

Bei Telegram reicht es, dem offiziellen Bot „BotFather" eine Nachricht zu schicken, um in wenigen Minuten einen neuen Bot zu erstellen. Da man sich nicht in ein Entwicklerportal einloggen und eine Anwendung erstellen muss, ist es sehr unkompliziert zum Ausprobieren.

2. Hervorragende Kompatibilität mit der Smartphone-Bedienung

Die Telegram-Mobile-App läuft flüssig, und man kann von überall schnell Nachrichten senden. Wenn man unterwegs plötzlich denkt „Ich möchte den Inhalt dieser Datei prüfen" oder „Ich möchte die Tests laufen lassen", ist es ein großer Vorteil, Claude Code direkt vom Smartphone in der Tasche aus Anweisungen geben zu können.

3. Einfaches Setup

Bei Discord muss man im Developer Portal eine Anwendung erstellen, den Message Content Intent aktivieren, Berechtigungen detailliert konfigurieren, den Bot auf einen Server einladen usw. - das sind viele Schritte. Bei Telegram reicht es, bei BotFather einen Token zu holen, und schon ist alles bereit. So kann man Channels schnell ausprobieren.

4. Kann als dedizierter Kanal für Claude Code genutzt werden

Da ich Telegram bis dahin nicht einmal installiert hatte, war das für mich sogar ein Vorteil. Es kommen keine Benachrichtigungen für andere Zwecke, und wenn man Telegram öffnet, sieht man ausschließlich Claude Code-Benachrichtigungen - ein vollständig dedizierter Kanal.

Dann legen wir mal los mit dem Setup!

Voraussetzungen

Bevor Sie mit dem Setup beginnen, stellen Sie sicher, dass Folgendes vorbereitet ist:

• Claude Code v2.1.80 oder höher ist installiert
• Sie sind mit einem claude.ai-Konto eingeloggt (Console- oder API-Key-Authentifizierung wird nicht unterstützt)
• Bun ist installiert (wird zur Ausführung von Plugins benötigt)
• Sie haben ein Telegram-Konto
• Bei Team/Enterprise-Plänen: Der Administrator der Organisation hat Channels aktiviert

Falls Sie Bun noch nicht installiert haben, können Sie es mit folgendem Befehl einfach installieren:

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

Nach Abschluss der Installation kann es vorkommen, dass bun --version direkt danach command not found zurückgibt. Das liegt daran, dass das Installationsprogramm zwar den Pfad zur ~/.zshrc hinzufügt, dieser aber noch nicht in der aktuellen Shell verfügbar ist. Führen Sie eine der folgenden Optionen aus, um das Problem zu beheben:

# Methode 1: Aktuelle Shell neu starten (wird auch vom Installationsprogramm angezeigt)
exec /bin/zsh

# Methode 2: .zshrc manuell neu laden
source ~/.zshrc

Sobald der Pfad gesetzt ist, überprüfen Sie die Version:

bun --version

Schritt 1: Telegram Bot erstellen

Zunächst richten wir auf der Telegram-Seite einen Bot ein.

1. Öffnen Sie die Telegram-App. Wenn Sie sie zum ersten Mal verwenden, schließen Sie zunächst die Ersteinrichtung ab, einschließlich der Telefonnummernverifizierung.
2. Tippen Sie auf die Suchleiste (Lupensymbol) am unteren Bildschirmrand, geben Sie „BotFather" ein. In den Suchergebnissen erscheint „BotFather" mit einem blauen Häkchen - tippen Sie darauf, um den Chat zu öffnen. Falls Sie ihn in der Suche nicht finden, können Sie im Browser https://t.me/BotFather aufrufen, um den BotFather-Chat direkt zu öffnen.
3. Wenn Sie den Chat mit BotFather geöffnet haben, klicken Sie auf die Start-Schaltfläche und senden Sie /newbot.
4. Sie werden nach dem „Anzeigenamen" des Bots gefragt - geben Sie einen beliebigen Namen ein (z. B. My Claude Bot).
5. Anschließend werden Sie nach dem „Benutzernamen" gefragt. Dieser muss auf bot enden (z. B. my_claude_code_bot).
6. Nach erfolgreicher Erstellung wird der Bot-Token angezeigt. Es handelt sich um eine lange Zeichenkette wie 110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw. Notieren Sie sich diesen.

Hinweis: Der Bot-Token ist eine vertrauliche Information. Teilen Sie ihn nicht mit anderen und committen Sie ihn nicht in öffentliche Repositories.

Schritt 2: Telegram-Plugin installieren

Als Nächstes installieren wir das Telegram-Channel-Plugin innerhalb einer Claude Code-Sitzung.

Starten Sie Claude Code und führen Sie folgenden Befehl aus:

/plugin install telegram@claude-plugins-official

Falls ein Fehler auftritt, dass das Plugin nicht gefunden wurde, müssen Sie zunächst den Marketplace registrieren:

/plugin marketplace add anthropics/claude-plugins-official

Nachdem Sie den Marketplace hinzugefügt haben, führen Sie den Installationsbefehl erneut aus.

Nach Abschluss der Installation beenden Sie die Sitzung mit /exit und starten Sie sie neu. Mit /reload-plugins wurde der /telegram-Befehl bei mir nicht verfügbar.

Schritt 3: Bot-Token konfigurieren

Registrieren Sie den in Schritt 1 erhaltenen Bot-Token in Claude Code. Verwenden Sie dazu folgenden Befehl und ersetzen Sie <token> durch Ihren tatsächlichen Token:

/telegram:configure <token>

Der Token wird in ~/.claude/channels/telegram/.env gespeichert. Es soll auch funktionieren, ihn als Shell-Umgebungsvariable TELEGRAM_BOT_TOKEN zu setzen.

Um den Token zu übernehmen, beenden Sie die Sitzung erneut mit /exit.

Schritt 4: Channels aktivieren und Claude Code neu starten

Nachdem der Token konfiguriert ist, beenden Sie Claude Code und starten Sie es mit dem Flag --channels neu. Dieses Flag ist der Schalter, der das Telegram-Plugin aktiviert. Ich verwende außerdem --dangerously-skip-permissions, aber das liegt in Ihrem eigenen Ermessen.

claude --dangerously-skip-permissions --channels plugin:telegram@claude-plugins-official

Beim Start wird das Telegram-Plugin automatisch als Unterprozess gestartet und beginnt, Nachrichten an den Bot zu pollen (regelmäßig zu prüfen).

Schritt 5: Konto koppeln (Pairing)

Aus Sicherheitsgründen müssen Sie zunächst Ihr Telegram-Konto mit der Claude Code-Sitzung verknüpfen (Pairing).

1. Öffnen Sie in der Telegram-App den in Schritt 1 erstellten Bot über den Link in der letzten Nachricht und tippen Sie auf OK.
2. Senden Sie dem Bot eine beliebige Nachricht (z. B. „hello")
3. Der Bot antwortet mit einem Pairing-Code

Falls der Bot nicht reagiert, überprüfen Sie, ob Claude Code mit dem Flag --channels gestartet wurde. Ohne eine aktive Sitzung mit aktiviertem Channel kann der Bot nicht antworten.

4. Kehren Sie zum Claude Code-Terminal zurück und schließen Sie das Pairing mit folgendem Befehl ab. Ersetzen Sie <code> durch den vom Bot erhaltenen Code:

/telegram:access pair <code>

5. Legen Sie abschließend eine Zugriffsrichtlinie fest, um Nachrichten von anderen Benutzern zu blockieren:

/telegram:access policy allowlist

Damit können nur noch Nachrichten von Ihrem eigenen Telegram-Konto an Claude Code gesendet werden.

Ausprobieren!

Das Setup ist abgeschlossen - probieren wir es gleich aus! Öffnen Sie die Telegram-App und senden Sie dem Bot eine Nachricht:

Welche Dateien befinden sich im aktuellen Arbeitsverzeichnis?

Claude Code sollte daraufhin den Pfad des Arbeitsverzeichnisses der aktuellen Sitzung über Telegram zurücksenden.

Wenn eine Nachricht bei der Claude Code-Sitzung eingeht, liest Claude basierend darauf Dateien, führt Befehle aus usw. Das Ergebnis wird als Antwort im Telegram-Chat zurückgesendet.

Auf der Terminal-Seite werden die empfangene Nachricht und der Tool-Aufruf für die Antwort (mit der Bestätigung „sent") angezeigt. Der eigentliche Antworttext erscheint auf der Telegram-Seite.

Wichtiges zur Sicherheit

Bei der Verwendung von Channels gibt es einige wichtige Sicherheitsaspekte zu beachten.

Absender-Allowlist

Das Telegram-Channel-Plugin akzeptiert nur Nachrichten von gekoppelten Konten. Nachrichten von Absendern, die nicht auf der Allowlist stehen, werden ignoriert. Dadurch wird verhindert, dass Dritte über den Bot unberechtigte Anweisungen an Claude Code senden (Prompt Injection).

Sitzungsbasierte Aktivierung

Allein die Registrierung des Servers in .mcp.json reicht nicht aus, damit Nachrichten ankommen. Claude Code Channels