---
title: "Claude Code mit Telegram verbinden"
seoTitle: "Claude Code mit Telegram verbinden: native Einrichtung"
navTitle: "Claude Code + Telegram"
description: "Claude Code per offiziellem Channels-Plugin mit Telegram verbinden: Bot-Pairing, Berechtigungsabfragen aus der Ferne, Session-Grenzen und sicherere Einrichtung."
slug: how-to-connect-claude-code-to-telegram
lang: de
date: 2026-06-08
updated: 2026-07-30
author: "Chatcode"
category: guide
faq:
  - q: "Hat Claude Code eine offizielle Telegram-Integration?"
    a: "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."
  - q: "Kann ich Berechtigungsabfragen von Claude Code aus Telegram heraus freigeben?"
    a: "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."
  - q: "Was ist der Unterschied zwischen Channels und Remote Control?"
    a: "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."
  - q: "Funktioniert der Telegram-Bot, wenn Claude Code geschlossen ist?"
    a: "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."
---

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](https://code.claude.com/docs/en/channels) 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](https://bun.sh/) auf dem Host; das offizielle Channel-Plugin läuft
  auf Bun.
- Ein Telegram-Konto und ein Bot-Token von
  [@BotFather](https://t.me/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:

```text
/plugin install telegram@claude-plugins-official
```

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

```text
/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:

```text
/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:

```bash
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:

```bash
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:

```text
/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](https://github.com/anthropics/claude-plugins-official/blob/main/external_plugins/telegram/server.ts)
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](https://code.claude.com/docs/en/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](/articles/claude-code-telegram-with-chatcode).
