Anleitung

Claude Code mit Telegram verbinden

Claude Code per offiziellem Channels-Plugin mit Telegram verbinden: Bot-Pairing, Berechtigungsabfragen aus der Ferne, Session-Grenzen und sicherere Einrichtung.

Claude Code hat eine offizielle Telegram-Integration namens Channels. Sie passt gut, wenn du einer bereits laufenden Session eine Aufgabe schicken, die Antwort in Telegram empfangen und gewöhnliche Tool-Freigaben erledigen willst, ohne einen Laptop aufzuklappen.

Die wichtigste Einschränkung ist schnell erklärt: Telegram führt Claude Code nicht aus. Die Arbeit erledigt weiterhin ein Claude-Code-Prozess auf deinem Computer oder Server, und dieser Prozess muss online bleiben.

Kurze Antwort

Erstelle mit dem BotFather von Telegram einen privaten Bot, installiere das offizielle Telegram-Plugin in Claude Code, konfiguriere dessen Token, starte Claude mit aktiviertem Channel und kopple dein Telegram-Konto. Halte den Bot auf einer Allowlist, statt ihn öffentlich zu machen.

Die Integration ist derzeit eine Research Preview. Lies die Channels-Dokumentation von Anthropic, bevor du sie auf einem sensiblen Rechner automatisierst, denn Befehle und Funktionen können sich ändern.

Was du brauchst

  • Eine aktuelle Claude-Code-Installation, angemeldet mit einem unterstützten Anthropic-Konto.
  • Bun auf dem Host; das offizielle Channel-Plugin läuft auf Bun.
  • Ein Telegram-Konto und ein Bot-Token von @BotFather.
  • Ein Terminal, das offen bleiben kann, oder eine persistente Session wie tmux.

Behandle das Bot-Token wie ein Passwort. Füge es nicht in ein Repository oder in eine Shell-History ein, die andere Nutzer sehen, und zeig es nicht auf Screenshots.

1. Einen privaten Telegram-Bot erstellen

Öffne den BotFather in Telegram, sende /newbot und folge seinen Anweisungen. Der Benutzername des Bots muss auf bot enden. Kopiere das Token an eine vorübergehende, private Stelle.

Für eine persönliche Coding-Session gibt es keinen Grund, den Bot zu einer Gruppe hinzuzufügen. Direktnachrichten plus Allowlist sind leichter zu durchschauen.

2. Das offizielle Plugin installieren

Installiere das Telegram-Plugin in Claude Code:

/plugin install telegram@claude-plugins-official

Wenn der Marketplace noch nicht registriert ist, füge ihn hinzu und versuche es erneut:

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

Verwende den offiziellen Marketplace-Namen und kein ähnlich benanntes Paket eines Drittanbieters.

3. Das Bot-Token konfigurieren

Führe den Plugin-Befehl in Claude Code aus:

/telegram:configure <BOT_TOKEN>

Das Plugin speichert das Token in seiner lokalen Channel-Konfiguration. Falls das Token in Logs oder in einem Chat aufgetaucht ist, widerrufe es über den BotFather und konfiguriere ein neues.

4. Claude Code mit aktiviertem Telegram starten

Beende die aktuelle Session und starte sie dann mit dem Channel:

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

Führe das im Repository aus, an dem Claude arbeiten soll. Auf einem ständig laufenden Host startest du es in einer benannten tmux-Session, damit ein SSH-Verbindungsabbruch den Prozess nicht beendet:

tmux new -s claude-telegram
claude --channels plugin:telegram@claude-plugins-official

tmux erhält den Prozess; es hält keinen Laptop im Ruhezustand wach und stellt keine abgebrochene Netzwerkverbindung wieder her.

5. Dein Konto koppeln und auf die Allowlist setzen

Schicke dem Bot eine Nachricht. Er antwortet mit einem Pairing-Code. Bestätige diesen Code im Claude-Code-Terminal und halte den Zugriff eingeschränkt:

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

Teste mit einer rein lesenden Anfrage, etwa indem du Claude bittest, das aktuelle Verzeichnis zusammenzufassen. Prüfe, dass die Nachricht in der richtigen Session ankommt, bevor du weitergehenden Tool-Zugriff gewährst.

Wie Berechtigungsabfragen heute funktionieren

Ältere Beschreibungen von Channels behaupten oft, dass jede Berechtigungsabfrage den Weg zurück ins Terminal erfordert. Das stimmt nicht mehr. Das aktuelle offizielle Telegram-Plugin meldet die Permission-Relay-Fähigkeit von Claude Code an und kann unterstützte Tool-Anfragen mit den Buttons Allow und Deny an Telegram senden.

Damit werden Freigaben aus der Ferne aber nicht risikofrei. Eine kleine Chat-Karte kann Kontext verbergen, der in einem Terminal-Diff offensichtlich wäre. Lies den Befehl und den betroffenen Pfad, vermeide pauschale „Always allow“-Regeln und nutze für eine ständig laufende Session ein Konto mit wenigen Rechten. Das anfängliche Vertrauen ins Projekt, die Zustimmung zu MCP und die Einrichtung von Plugins können weiterhin eine Eingabe im lokalen Terminal erfordern.

Grenzen, die in der Praxis zählen

  • Der Host-Prozess muss am Leben bleiben. Wenn du Claude Code schließt, stoppt der Channel.
  • Telegram ist ein Ereignisstrom, kein Session-Speicher. Die Bot API liefert neue Updates; sie gibt dem Plugin keinen vollständigen, durchsuchbaren Verlauf.
  • Die Antwort landet in Telegram. Das Terminal zeigt eventuell nur das eingehende Ereignis und den Zustellstatus statt eines Transkripts, das dem Chat entspricht.
  • Es ist auf Claude beschränkt. Das Plugin bindet weder Codex noch andere Agenten an.
  • Es ist Preview-Software. Prüfe nach Upgrades erneut die offizielle Doku und verlass dich nicht auf undokumentiertes Verhalten.

Channels vs. Remote Control

Remote Control von Anthropic ist eine separate Option. Damit steuert Claude im Web oder in der iOS- bzw. Android-App eine Session auf dem Host. Dateien und Tools bleiben auf dem Host, und das Smartphone dient als Remote-Oberfläche.

Wähle Channels, wenn Telegram die Oberfläche ist, die du willst, oder wenn externe Ereignisse eine Session erreichen sollen. Wähle Remote Control, wenn du die First-Party-Oberfläche von Claude und einen genaueren Blick auf die aktive Session willst. Beide hängen weiterhin vom Prozess auf dem Host ab.

Wann eine andere Remote-Ebene sinnvoll ist

Für eine einzelne Claude-Session ist das native Plugin meist die einfachste Lösung. Ein anderes Setup wird relevant, wenn sich die Anforderungen ändern – zum Beispiel ein vollwertiges Browser-Terminal, mehrere Coding-Agenten oder ein ständig laufender VPS, der getrennt von einem Laptop verwaltet wird.

Chatcode ist eine solche Option: Es verbindet einen Server mit einem Browser-Terminal und mit Telegram und kann Claude Code neben Codex, Gemini und OpenCode betreiben. Damit kommen ein Relay eines Drittanbieters und die Verantwortung für die Serververwaltung hinzu, es ist also kein automatisches Upgrade. Die praktische Einrichtung und die Kompromisse behandelt Claude Code in Telegram mit Chatcode.

Häufige Fragen

Hat Claude Code eine offizielle Telegram-Integration?

Ja. Claude Code Channels enthält ein offizielles Telegram-Plugin. Es verbindet einen Telegram-Bot, der auf einer Allowlist steht, mit einer Claude-Code-Session, die weiterhin auf deinem Computer oder Server läuft.

Kann ich Berechtigungsabfragen von Claude Code aus Telegram heraus freigeben?

Ja. Das aktuelle offizielle Telegram-Plugin leitet unterstützte Berechtigungsanfragen für Tools als Buttons Allow und Deny weiter. Das anfängliche Vertrauen ins Projekt, die Zustimmung zu Plugins und einige lokale Einrichtungsschritte brauchen weiterhin das Terminal.

Was ist der Unterschied zwischen Channels und Remote Control?

Mit Channels kann Telegram oder ein anderer Dienst Ereignisse an eine laufende Claude-Code-Session senden. Remote Control macht die Session über Claude im Web oder auf dem Smartphone zugänglich. Beide nutzen einen Claude-Prozess auf dem Host, unterscheiden sich aber in Oberfläche und Auslösemodell.

Funktioniert der Telegram-Bot, wenn Claude Code geschlossen ist?

Nein. Der Channel-Server läuft zusammen mit der Claude-Code-Session. Halte den Prozess in einem persistenten Terminal oder auf einem ständig laufenden Host am Leben, wenn er erreichbar bleiben soll.

Diese Anleitung teilen