====== Telegram plugin pro Claude Code ======

[[https://github.com/anthropics/claude-plugins-official/blob/main/external_plugins/telegram/README.md|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.

===== Co plugin dělá =====

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

===== Požadavky =====

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

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

===== Rychlé zprovoznění =====

==== 1. Vytvoření Telegram bota ====

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

<code>
123456789:AAHfiqksKZ8...
</code>

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

==== 2. Instalace pluginu v Claude Code ====

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

<code>
/plugin install telegram@claude-plugins-official
/reload-plugins
</code>

==== 3. Konfigurace tokenu ====

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

<code>
/telegram:configure 123456789:AAHfiqksKZ8...
</code>

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''.

==== 4. Spuštění Claude Code s Telegram channel ====

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

<code bash>
claude --channels plugin:telegram@claude-plugins-official
</code>

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

==== 5. Spárování účtu ====

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:

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

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

==== 6. Uzamčení přístupu ====

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.

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

===== Nástroje, které plugin zpřístupní Claude Code =====

==== 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

==== react ====

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.

===== Práce s fotkami =====

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.

===== Omezení =====

==== Bez historie a vyhledávání ====

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.

==== Bez dodatečného stahování starých příloh ====

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.

===== Poznámky k použití =====

  * 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''

===== Zdroje =====

  * [[https://github.com/anthropics/claude-plugins-official/blob/main/external_plugins/telegram/README.md|Claude plugins official – Telegram README]]