Claude Code Channels mit Telegram einrichten

Was Channels sind

Ein Channel ist ein MCP-Server. Er schickt Ereignisse in eine Sitzung von Claude Code, die schon läuft. Das kann in beide Richtungen gehen. Claude liest die Nachricht, arbeitet und antwortet im selben Chat. Die Doku von Anthropic nennt Telegram, Discord und iMessage in der Research Preview (code.claude.com/docs/en/channels, Oktober 2026).

Das unterscheidet sich von Remote Control. Mit Remote Control steuern Sie Ihre Sitzung aus der Claude-App. Channels bringen Nachrichten von anderen Plattformen herein, und auch Webhooks, etwa einen fehlgeschlagenen CI-Lauf.

Voraussetzungen

• Claude Code, angemeldet mit einem Konto auf claude.ai oder einem API-Key aus der Console. Unter Amazon Bedrock, Google Cloud oder Microsoft Foundry funktionieren Channels nicht.
• In den Tarifen Team und Enterprise muss zuerst ein Admin Channels aktivieren. Nutzer von Pro und Max ohne Organisation können sie direkt verwenden. Laut Doku wird die Verfügbarkeit außerdem schrittweise ausgerollt.
• Bun. Die Channel-Plugins sind Bun-Skripte.
• Ein Bot-Token für Telegram von BotFather, für den Telegram-Channel.

Die Teile installieren

Installieren Sie Claude Code und Bun mit ihren offiziellen Skripten.

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

Öffnen Sie in Telegram BotFather und senden Sie den Befehl newbot. Wählen Sie einen Namen und einen Benutzernamen, der auf bot endet. Kopieren Sie den Token, den Sie zurückbekommen. Dann installieren Sie das Plugin. In Claude Code ist das ein Slash-Befehl.

/plugin install telegram@claude-plugins-official

In einer normalen Shell erledigt die Plugin-CLI dasselbe. Fehlt der Marketplace, fügen Sie ihn zuerst hinzu.

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

Wir haben das am 2. Oktober 2026 auf einer von GitHub gehosteten Maschine mit macOS 26 ausgeführt, ohne Anmeldung. Die Installation hat funktioniert. Das wurde ausgegeben.

$ claude --version
2.1.287 (Claude Code)
$ bun --version
1.4.2
$ claude plugin install telegram@claude-plugins-official
Successfully installed plugin: telegram@claude-plugins-official (scope: user)
$ claude plugin list
  telegram@claude-plugins-official
    Version: 0.0.7
    Scope: user
    Status: enabled

Den Bot verbinden und pairen

Speichern Sie in Claude Code Ihren Token. Er liegt dann im Ordner telegram unter channels in Ihrem Konfigurationsordner von Claude.

/telegram:configure <token>

Beenden Sie Claude Code dann und starten Sie es aus der Shell neu, mit dem Channel-Flag.

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

Schicken Sie Ihrem Bot eine beliebige Nachricht. Er antwortet mit einem Pairing-Code. Bestätigen Sie den Code in Claude Code und beschränken Sie den Bot dann auf Ihr eigenes Konto.

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

Zwei Dinge verwirren hier oft. Das Channel-Flag taucht während der Preview nicht in der Hilfeausgabe auf, funktioniert aber. Und das Terminal zeigt die eingehende Nachricht und einen Vermerk, dass gesendet wurde, nicht den Antworttext. Die Antwort erscheint in Telegram.

Discord statt Telegram

Die Schritte für Discord folgen demselben Muster. Legen Sie im Discord Developer Portal eine Anwendung an und kopieren Sie den Bot-Token. Aktivieren Sie Message Content Intent. Laden Sie den Bot auf Ihren Server ein, mit der Berechtigung, Kanäle zu sehen, Nachrichten zu senden und den Verlauf zu lesen. Dann installieren, konfigurieren und pairen Sie genauso. Die Zeile für den Neustart läuft in der Shell. Die anderen Zeilen laufen in Claude Code.

/plugin install discord@claude-plugins-official
/discord:configure <token>
claude --channels plugin:discord@claude-plugins-official
/discord:access pair <code>
/discord:access policy allowlist

Sie können dem Channel-Flag mehrere Plugins übergeben, getrennt durch Leerzeichen. Dann hört eine Sitzung auf beide Apps.

Die Sitzung rund um die Uhr offen halten

Ereignisse erreichen nur eine offene Sitzung. Schließen Sie das Terminal, lassen Sie den Mac schlafen oder starten Sie neu, und der Bot verstummt. Drei Dinge beheben das. Schalten Sie den Ruhezustand ab. Lassen Sie Claude Code in tmux laufen. Starten Sie diese tmux-Sitzung bei der Anmeldung.

sudo pmset -a sleep 0
sudo pmset -a disksleep 0
sudo pmset -a displaysleep 10

Dieser LaunchAgent startet eine tmux-Sitzung namens channels mit Claude Code und dem Telegram-Channel. Er prüft jede Minute und tut nichts, wenn die Sitzung schon existiert. Speichern Sie ihn als dev.local.claude-channels.plist in Ihrem Ordner LaunchAgents.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
  "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
  <key>Label</key><string>dev.local.claude-channels</string>
  <key>ProgramArguments</key>
  <array>
    <string>/bin/zsh</string>
    <string>-lc</string>
    <string>export PATH="$HOME/.local/bin:$HOME/.bun/bin:/opt/homebrew/bin:$PATH"; tmux has-session -t channels 2>/dev/null || tmux new -d -s channels -c "$HOME" "claude --channels plugin:telegram@claude-plugins-official"</string>
  </array>
  <key>RunAtLoad</key><true/>
  <key>StartInterval</key><integer>60</integer>
</dict>
</plist>

Installieren Sie zuerst tmux, falls es fehlt. Dann laden Sie den Agent und verbinden sich, um nach Claude zu sehen.

brew install tmux
launchctl load ~/Library/LaunchAgents/dev.local.claude-channels.plist
tmux attach -t channels

Wir haben genau diese Datei am 2. Oktober 2026 auf einer von GitHub gehosteten Maschine mit macOS 26 getestet. Zwanzig Sekunden nach dem Laden hatte launchd die Sitzung im Home-Ordner angelegt, mit Claude Code wartend darin.

$ tmux ls
channels: 1 windows (created Fri Oct  2 04:21:09 2026)
$ tmux capture-pane -pt channels
Welcome to Claude Code v2.1.287

Die Sitzung startet in Ihrem Home-Ordner. Setzen Sie den Pfad Ihres Projekts anstelle der Home-Variable ein, wenn Claude dort starten soll. Beim ersten Mal verbinden Sie sich, beantworten die Fragen zum ersten Start und melden sich an.

Planen Sie noch einen Stillstand ein. Trifft Claude auf eine Abfrage zu Berechtigungen, während Sie weg sind, wartet die Sitzung auf Sie. Die Doku nennt ein Flag zum Überspringen der Berechtigungen für vertrauenswürdige Maschinen. Lesen Sie Claude Code sicher unbeaufsichtigt betreiben, bevor Sie es nutzen.

Hinweise zur Sicherheit

• Jeder Channel führt eine Allowlist der Absender. Nachrichten von allen anderen werden stillschweigend verworfen.
• Jeder auf der Allowlist kann Ihre Sitzung steuern. Wenn das Plugin Berechtigungsabfragen weiterleitet, kann er auch Tool-Nutzung freigeben. Tragen Sie nur Personen ein, denen Sie Ihre Maschine anvertrauen.
• Ihr Bot-Token ist ein Passwort. Gelangt er nach außen, widerrufen Sie ihn in BotFather und konfigurieren den neuen.
• iMessage liest die Datenbank von Nachrichten und braucht vollen Festplattenzugriff. Auf einem gemieteten Mac heißt das, Ihre Apple ID in Nachrichten auf Hardware anzumelden, die Ihnen nicht gehört. Telegram oder Discord vermeiden das.

Auf einem Mac von MacRun betreiben

In unserem Agent-Tarif ist Claude Code schon installiert. Sie melden es mit Ihrem eigenen Claude-Tarif an. Der Mac schläft nie, und seine Sitzung übersteht Neustarts. Bun und das Plugin fügen Sie hinzu, das dauert ein paar Minuten. Danach können Sie Ihren Laptop zuklappen, und der Bot antwortet trotzdem.

Wer das nicht braucht. Wenn Sie eine Sitzung nur vom Handy aus steuern wollen, erledigt Remote Control in der Claude-App das ohne Bot. Und wenn der Admin Ihres Team-Tarifs Channels nicht aktiviert hat, ändert ein neuer Mac daran nichts.

Für das größere Bild lesen Sie Claude Code rund um die Uhr auf einem Mac betreiben.