Zero Limits Circle · Guide

Dein eigener KI-Assistent in Telegram

Zero Limits Circle · Guide · Stand 06.10.2026

Was du am Ende hast

Du schreibst vom Handy in Telegram an deinen eigenen Bot. Hinter dem Bot sitzt Claude Code auf deinem eigenen Rechner, mit deinen Ordnern, deinen Skills und deiner Kommandozentrale. Er antwortet dir direkt in Telegram.

So sieht das im Alltag aus:

„Schreib mir ein Reel-Skript zu: 3 Fehler beim Auswandern“
„Mach mir mein Briefing für heute“
Du schickst ein Foto oder eine Datei, und Claude arbeitet damit.
Claude schickt dir fertige Dateien zurück in den Chat, zum Beispiel eine PDF oder ein Bild.

Das ist der offizielle Weg von Anthropic, die Funktion heißt „Channels“. Du brauchst keinen API-Key und kein Extra-Abo, nur dein Claude-Abo.

Wichtig vorab: Dein Assistent läuft auf deinem Rechner. Ist der Rechner aus oder Claude Code zu, antwortet der Bot nicht. Wie du ihn wach hältst, steht in Schritt 9.

Quelle: Claude Code Docs: Channels

Bevor du startest: Checkliste

Claude-Abo: Pro oder Max (Team und Enterprise gehen auch, siehe unten)
Claude Code ist installiert, und du bist mit deinem Claude-Konto eingeloggt
Telegram ist auf deinem Handy
Mac oder Windows-PC, der laufen darf, wenn du unterwegs bist
20 Minuten Zeit

Noch kein Claude Code? Im Terminal installieren:

Mac: curl -fsSL https://claude.ai/install.sh | bash
Windows (PowerShell): irm https://claude.ai/install.ps1 | iex

Danach claude eingeben und einloggen.

Team- oder Enterprise-Abo: Dort ist die Funktion gesperrt, bis ein Admin sie freischaltet. Pro und Max sind nicht betroffen.

Quellen: Quickstart · Channels: Enterprise controls

1Deinen Bot bei Telegram anlegen

Öffne in Telegram den Chat mit @BotFather: https://t.me/BotFather
Schick ihm: /newbot
Er fragt nach einem Namen. Das ist der Anzeigename und darf Leerzeichen haben, zum Beispiel Mein Assistent.
Dann fragt er nach einem Benutzernamen. Der muss eindeutig sein und auf bot enden, zum Beispiel max_assistent_2026_bot.
BotFather schickt dir einen Token, der so aussieht: 123456789:AAHfiqksKZ8...

👉 Kopier den kompletten Token, also auch die Zahl und den Doppelpunkt am Anfang. Gib ihn niemandem. Wer den Token hat, kann deinen Bot steuern.

Quelle: Telegram-Plugin README

2Bun installieren

Das Telegram-Plugin braucht ein kleines Programm namens Bun.

Mac (Terminal):

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

Windows (PowerShell):

powershell -c "irm bun.sh/install.ps1|iex"

Danach das Terminal schließen und neu öffnen und prüfen:

bun --version

Wenn eine Versionsnummer erscheint (zum Beispiel 1.3.14), passt alles.

Quellen: Bun Installation · Channels: Voraussetzungen

3Claude Code aktualisieren

Channels sind neu, deshalb brauchst du eine aktuelle Version:

claude update

Quelle: Channels: Research preview

4Das Telegram-Plugin installieren

Starte Claude Code:

claude

Gib dann in Claude Code ein:

/plugin install telegram@claude-plugins-official

Fragt Claude Code nach dem Speicherort (Scope), wählst du User. Dann ist das Plugin in allen Ordnern verfügbar.

Kommt die Meldung Marketplace "claude-plugins-official" not found, gib das ein und danach den Install-Befehl nochmal:

/plugin marketplace add anthropics/claude-plugins-official

Quelle: Channels: Telegram

5Den Token eintragen

Immer noch in Claude Code, mit deinem Token aus Schritt 1:

/telegram:configure 123456789:AAHfiqksKZ8...

Der Token wird lokal auf deinem Rechner gespeichert, in ~/.claude/channels/telegram/.env.

Kennt Claude Code den Befehl noch nicht, gib /reload-plugins ein oder starte Claude Code neu.

Danach Claude Code beenden:

/exit

Quelle: Telegram-Plugin README

6Mit Telegram starten

Wechsle im Terminal in den Ordner, mit dem dein Assistent arbeiten soll, zum Beispiel deine Kommandozentrale. Dann starte Claude Code so:

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

Das ist ab jetzt dein Startbefehl. Ohne --channels antwortet der Bot nicht.

Keine Sorge: --channels taucht in claude --help nicht auf. Das ist normal, solange die Funktion in der Testphase ist.

Quelle: Channels: Telegram + Research preview

7Dein Handy koppeln

Öffne in Telegram deinen Bot (Link: t.me/DEIN_BOTNAME) und schick ihm irgendeine Nachricht, zum Beispiel „Hi“.
Der Bot antwortet mit einem Code aus 6 Zeichen (zum Beispiel a4f91c).
Gib in Claude Code auf deinem Rechner ein:

/telegram:access pair DEINCODE

Ab jetzt kommen deine Nachrichten bei Claude an.

Quelle: Telegram-Plugin: Access

8Abschließen, damit nur du reinkommst

Dein Bot ist öffentlich auffindbar. Damit Fremde nicht mal einen Code bekommen:

/telegram:access policy allowlist

Jetzt kommen nur noch Nachrichten von dir durch, alle anderen werden still verworfen. Den aktuellen Stand siehst du mit:

/telegram:access

Erster Test: Schreib deinem Bot „Was kannst du für mich tun?“.

Quelle: Telegram-Plugin: Access

9Damit er läuft, wenn du unterwegs bist

Dein Assistent antwortet nur, solange Claude Code offen ist und der Rechner wach bleibt.

Mac: Starte so, dann schläft der Mac nicht ein, solange Claude läuft:

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

MacBook ans Netzteil hängen und das Terminal-Fenster offen lassen.
Erfahrungswert, nicht aus der Doku: Ein zugeklapptes MacBook geht meistens trotzdem schlafen. Lass es aufgeklappt.

Windows: Einstellungen → System → Netzbetrieb & Akku → Bildschirm und Energiesparmodus → „Energiesparmodus nach“ auf Nie stellen, solange der PC am Strom hängt. Das PowerShell-Fenster offen lassen.

Berechtigungen: Will Claude etwas Wichtiges tun, zum Beispiel einen Befehl ausführen, und braucht dein Okay, kommt die Frage direkt in Telegram, mit den Knöpfen ✅ Allow und ❌ Deny. Du musst also nicht am Rechner sitzen.

Später, optional: Für 24/7 ohne eigenen Rechner kann das Ganze auf einem Server laufen. Das ist ein eigener Guide.

Quellen: Channels („Events only arrive while the session is open“) · Plugin-Quellcode, Permission-Relay

Sicherheit: 5 Regeln

Der Token ist wie ein Passwort. Nie in Gruppen, Screenshots oder Chats teilen. Ist er raus: In @BotFather /mybots öffnen, deinen Bot wählen, dann „API Token“ und „Revoke“. Den neuen Token setzt du mit /telegram:configure. (Der Revoke-Weg kommt aus BotFather, nicht aus der Anthropic-Doku.)
Nur du auf der Allowlist. Wer drin ist, kann Claude Aufträge geben und Berechtigungen freigeben. Also keine Freunde und keine Kunden in deinen Bot.
Policy auf allowlist, wie in Schritt 8.
Nicht --dangerously-skip-permissions nutzen. Laut Doku ist das nur für Umgebungen gedacht, denen du voll vertraust. Die Telegram-Knöpfe sind der sichere Weg.
Keine Passwörter in den Chat. Telegram-Bots sind nicht Ende-zu-Ende-verschlüsselt.

Quellen: Channels: Security · Permission modes

Ehrlich: Das kann er (noch) nicht

Testphase: Channels sind laut Anthropic eine „Research Preview“. Befehle können sich noch ändern.
Nur bei offenem Rechner: Rechner aus heißt keine Antwort. Was du in der Zeit schickst, kommt nach dem Neustart meist noch an, weil Telegram es eine Weile aufhebt. (Einschätzung, nicht in der Anthropic-Doku)
Kein Gedächtnis aus dem Chat-Verlauf: Telegram gibt Bots keinen Verlauf. Claude sieht nur die neuen Nachrichten, solange die Sitzung läuft.
Sprachnachrichten: Sie kommen als Datei an, Claude kann sie aber nicht einfach anhören. Tipp: Nutz das Mikrofon auf der Handy-Tastatur (Diktieren), dann kommt Text an. (Einschätzung aus dem Plugin-Quellcode.)
Fotos komprimiert Telegram. Für Originalqualität schickst du sie „als Datei“.
Dateigrößen: Rein gehen bis 20 MB, raus bis 50 MB pro Datei.
Dein Abo-Limit: Alles läuft über dein Claude-Abo und zählt gegen dein normales Nutzungslimit. (Einschätzung)

Quellen: Channels · Plugin README · server.ts

Wenn's hakt

Problem	Lösung
Bot antwortet gar nicht	Läuft Claude Code mit `--channels plugin:telegram@claude-plugins-official`? Schläft der Rechner?
`Marketplace "claude-plugins-official" not found`	`/plugin marketplace add anthropics/claude-plugins-official`, dann nochmal installieren
`bun: command not found`	Bun installieren (Schritt 2), Terminal neu öffnen
`/telegram:configure` unbekannt	`/reload-plugins` eingeben oder Claude Code neu starten
Startmeldung: Channel nicht registriert / Admin muss freischalten	Bei Team/Enterprise muss ein Admin „Channels“ aktivieren. Sonst Claude Code aktualisieren (`claude update`) und mit dem claude.ai-Konto einloggen
Bot schickt dir immer wieder einen Code	Du bist (noch) nicht gekoppelt: Code mit `/telegram:access pair CODE` bestätigen. Falsches Telegram-Konto? `/telegram:access` zeigt, wer drin ist
Claude „hängt“, während du unterwegs bist	Er wartet auf eine Freigabe: In Telegram auf ✅ Allow tippen. Oder der Rechner ist eingeschlafen (Schritt 9)
Token falsch / Bot reagiert nicht nach Token-Wechsel	Token komplett kopieren (mit Zahl und Doppelpunkt), neu setzen, Claude Code mit `--channels` neu starten
`--channels` steht nicht in `claude --help`	Das ist normal in der Testphase, der Befehl funktioniert trotzdem

Quellen: Channels · Channels reference: Troubleshooting

FAQ

Kostet das extra? Nein. Du brauchst nur dein Claude-Abo (Pro oder Max) und einen kostenlosen Telegram-Bot.

Kann ich das auch mit Discord oder iMessage machen? Ja, das sind die anderen offiziellen Channels. Die Schritte sind fast gleich.

Kann ich mehrere Bots haben? Ja, laut Plugin-Doku über einen eigenen Ordner pro Bot (TELEGRAM_STATE_DIR). Für den Anfang reicht einer.

Sieht Claude alles auf meinem Rechner? Claude arbeitet in dem Ordner, in dem du ihn startest, und fragt bei wichtigen Aktionen nach. Starte ihn deshalb in deinem Arbeitsordner, nicht im ganzen Benutzerordner.

Mein Rechner ist zu. Gehen die Nachrichten verloren? Meist nicht: Telegram hebt neue Nachrichten eine Weile auf und stellt sie zu, sobald dein Bot wieder läuft. Verlass dich aber nicht darauf (Einschätzung). Wichtige Aufträge schickst du lieber nochmal.

Wie sehe ich, ob ich gekoppelt bin? Schick deinem Bot /status. Oder gib in Claude Code /telegram:access ein.

Alle Befehle auf einen Blick

Wann	Wo eingeben	Befehl
Einmalig	Terminal (Mac)	`curl -fsSL https://bun.com/install \| bash`
Einmalig	Terminal	`claude update`
Einmalig	Terminal	`claude`
Einmalig	in Claude Code	`/plugin install telegram@claude-plugins-official`
Einmalig	in Claude Code	`/telegram:configure DEIN_TOKEN`
Einmalig	in Claude Code	`/exit`
Jedes Mal	Terminal (Mac, bleibt wach)	`caffeinate -i claude --channels plugin:telegram@claude-plugins-official`
Jedes Mal	Terminal (Windows)	`claude --channels plugin:telegram@claude-plugins-official`
Einmalig	in Claude Code	`/telegram:access pair DEINCODE`
Einmalig	in Claude Code	`/telegram:access policy allowlist`

Zum Kopieren nimmst du die Befehle oben in den einzelnen Schritten. Dort hat jeder einen eigenen Kopieren-Knopf.

Quellen

Claude Code Docs, Channels: https://code.claude.com/docs/en/channels
Claude Code Docs, Channels reference: https://code.claude.com/docs/en/channels-reference
Claude Code Docs, Quickstart: https://code.claude.com/docs/en/quickstart
Claude Code Docs, Permission modes: https://code.claude.com/docs/en/permission-modes
Telegram-Plugin (README, ACCESS.md, server.ts): https://github.com/anthropics/claude-plugins-official/tree/main/external_plugins/telegram
Bun Installation: https://bun.com/docs/installation

Alles abgerufen am 06.10.2026.

Fragen? Schreib in die Community. · Zero Limits Circle