Telegram plugin pro Claude Code

Telegram plugin pro Claude Code je plugin z repozitáře claude-plugins-official, který propojí Telegram bota s běžící session Claude Code přes MCP server. Umožňuje přijímat zprávy z Telegramu, odpovídat na ně, přidávat reakce a upravovat zprávy, které bot už odeslal.

Plugin se na straně serveru přihlásí do Telegramu jako bot a zpřístupní Claude Code nástroje pro práci se zprávami. Když uživatel pošle botovi zprávu, server ji přepošle do aktivní session Claude Code.

Podle README plugin umí hlavně:

odpovědět do chatu
přidat emoji reakci na konkrétní zprávu
upravit dříve odeslanou zprávu bota
automaticky zobrazovat stav psaní během generování odpovědi

README uvádí jako základní závislost Bun, protože MCP server běží právě na něm.

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

Nejprve je potřeba vytvořit bota přes @BotFather a získat bot token. BotFather vrátí token ve tvaru podobném tomuto:

123456789:AAHfiqksKZ8...

Je potřeba zkopírovat celý token včetně číselné části a dvojtečky.

README uvádí tyto příkazy. Spouští se v aktivní session Claude Code:

/plugin install telegram@claude-plugins-official
/reload-plugins

Token se nastaví tímto příkazem:

/telegram:configure 123456789:AAHfiqksKZ8...

Tím se zapíše proměnná TELEGRAM_BOT_TOKEN do souboru ~/.claude/channels/telegram/.env. README zároveň uvádí, že proměnnou lze nastavit i ručně nebo přes shell environment; hodnoty ze shellu mají přednost.

Pokud má na jednom stroji běžet více botů, je možné pro každou instanci použít jiný TELEGRAM_STATE_DIR.

Po konfiguraci nestačí jen reload. Session je potřeba ukončit a znovu spustit s parametrem –channels:

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

Bez tohoto parametru se server k Telegramu nepřipojí.

Výchozí flow v README je určené pro jednoho uživatele v DM konverzaci. Po spuštění Claude Code s –channels stačí poslat botovi zprávu na Telegramu. Bot odpoví šestimístným pairing kódem, který se zadá zpět do Claude Code:

/telegram:access pair <code>

Po úspěšném spárování už další DM zprávy chodí do asistenta.

README doporučuje po spárování přepnout policy z výchozího režimu pairing na allowlist, aby bot nevracel pairing kódy cizím uživatelům.

/telegram:access policy allowlist

reply

Nástroj reply odešle zprávu do chatu. Bere chat_id a text, volitelně také reply_to pro navázání na konkrétní zprávu a files pro přílohy.

README uvádí tyto vlastnosti:

obrázky typu .jpg, .png, .gif a .webp se posílají jako fotky s náhledem
ostatní soubory se posílají jako dokumenty
maximální velikost jednoho souboru je 50 MB
delší text se automaticky rozdělí na více částí
soubory se posílají jako samostatné zprávy po textu

Nástroj react přidá emoji reakci na konkrétní zprávu podle jejího ID. README výslovně uvádí, že Telegram přijímá jen pevně daný whitelist podporovaných emoji.

edit_message

Nástroj edit_message upraví zprávu, kterou bot už odeslal. Hodí se například pro průběžné statusy typu „working…“ a následné nahrazení finálním výsledkem.

Příchozí fotky plugin ukládá do adresáře ~/.claude/channels/telegram/inbox/. Lokální cesta se pak předá do notifikace <channel>, takže ji může Claude Code přečíst.

README zároveň upozorňuje, že Telegram fotky komprimuje. Pokud je potřeba originální soubor, má se poslat jako dokument, ne jako běžná fotka.

Telegram Bot API podle README neposkytuje historii zpráv ani vyhledávání. Bot tedy vidí jen zprávy v okamžiku, kdy přijdou. Neexistuje tu nástroj typu fetch_messages.

Praktický důsledek je jednoduchý: pokud bude Claude potřebovat starší kontext, musí ho uživatel vložit znovu nebo shrnout.

README také uvádí, že neexistuje nástroj pro stahování historických příloh. Fotky se proto stahují hned při přijetí, protože později už je přes Bot API nemusí být možné znovu získat stejným způsobem.

výchozí setup v README je pro single-user DM bota
pro skupiny a víceuživatelské scénáře README odkazuje na další dokumentaci v repozitáři
výchozí access policy je pairing