Jak ovládat Claude Code z telefonu přes Telegram v roce 2026

Další materiály o konfiguraci nástrojů najdete v dokumentaci Ailoot.

Co je Claude Code Channels a proč ho potřebujete?#

Dne 20. března 2026 vydala společnost Anthropic Claude Code Channels, oficiální plugin pro propojení relace Claude s aplikacemi pro zasílání zpráv. Podporovány jsou Telegram, Discord a iMessage. Funkce je v režimu výzkumného náhledu: dokumentace je na adrese code.claude.com/docs/en/channels a zdrojový kód pluginu je ve veřejném repozitáři anthropics/claude-plugins-official.

Stručně řečeno jde o „chatovací most“ mezi vaším telefonem a relací Claude Code. Napíšu botovi: „Pokračuj v přepisování cenové tabulky; v souboru business/products/practicum/README.md aktualizuj data příštího běhu,“ a bot zprávu předá relaci na mém VPS. Claude načte kontext, upraví soubor, potvrdí změny a odpoví v Telegramu: „Hotovo, zkontroluj commit.“ Notebook zůstane doma zavřený.

⚠️ Hlavní omezení výzkumného náhledu: Channels je most MCP. Relace musí běžet na vašem počítači nebo VPS. Když relaci zavřete, zprávy nikdo nepřijímá. Proto je nutné nepřetržitý provoz nakonfigurovat zvlášť (viz část o VPS níže).

Čím se Channels liší od jiných způsobů vzdálené práce

Ve své oficiální dokumentaci uvádí Anthropic přímou srovnávací tabulku. Zde je její adaptace:

Hlavní rozdíl mezi Channels a Remote Control: Remote Control je „telefon jako okno do terminálu“ — doslova vidíte kurzor a mačkáte tlačítka. Channels je chatbot, jehož mozkem je vaše místní relace Claude. S Remote Control se dívám na terminál. S Channels píšu někomu, kdo čte moje soubory.

Pokud potřebujete plnou kontrolu nad obrazovkou, použijte Remote Control. Pokud chcete „poslat dotaz, věnovat se svému dni a dostat odpověď“, použijte Channels. Používám obojí: Remote Control, když potřebuji schválit kritické změny, a Channels, když úloze důvěřuji a chci mít volný večer.

Co potřebujete pro propojení Claude Code s Telegramem?#

Než přejdete k příkazům, projděte si tento seznam:

1. Účet Anthropic. Použijte podporované přihlášení claude.ai nebo klíč Anthropic Console API; příslušné povolení organizace a účtování ověřte samostatně. Funguje i klíč Anthropic Console API; používá-li organizace Console spravovaná nastavení, ověřte povolení kanálů.
2. Claude Code v2.1.80 nebo novější. Zkontrolujte pomocí claude --version. Pokud máte starší verzi, aktualizujte ji příkazem claude update nebo npm install -g @anthropic-ai/claude-code@latest.
3. Bun. Pluginy Channels jsou skripty Bun, nikoli Node. Zkontrolujte pomocí bun --version. Pokud není nainstalován, spusťte curl -fsSL https://bun.sh/install | bash a pak source ~/.bashrc.
4. Účet Telegram. Může to být jakýkoli účet; hlavní je, abyste na telefonu byli přihlášeni.
5. Pokud máte tarif Team/Enterprise, požádejte správce, aby zapnul channelsEnabled ve spravovaných nastaveních nebo přes admin-settings/claude-code. Organizace ho mají ve výchozím nastavení vypnutý.

Pokud o Bunu slyšíte poprvé, nemusíte se ho bát. Bun je alternativní běhové prostředí pro JavaScript, podobně jako Node. Anthropic ho pro pluginy Channels zvolil proto, že se spouští rychleji a snáze se zabalí do jediného binárního souboru. Jednou ho nainstalujte a dál na něj nemusíte myslet.

⚠️ Channels zatím nefunguje s podnikovými Bedrock / Google Vertex / Azure Foundry. Funguje pouze s ověřením přes claude.ai nebo Anthropic Console.

Krok 1. Vytvořte telegramového bota přes BotFather#

BotFather udělá vše za vás — stačí pětkrát klepnout. Postupujte takto:

1. Otevřete v Telegramu @BotFather (můžete použít telefon; i zbytek nastavení lze udělat na telefonu).
2. Pokud jste tu poprvé, stiskněte „Start“.
3. Pošlete příkaz /newbot.
4. BotFather se zeptá: „Dobře, nový bot. Jak mu budeme říkat?“ Zadejte zobrazované jméno, například Můj asistent - Claude Code.
5. Pak se zeptá na uživatelské jméno. Musí být jedinečné v celém Telegramu a končit na bot. Například my_claude_bot nebo my_dev_bot.
6. BotFather odpoví zprávou podobnou této:

Hotovo! Gratulujeme k novému botovi. Najdete ho na adrese
'<OFFICIAL_URL>'.

Tento token použijte pro přístup k HTTP API:
1234567890:AAHzlAU...

Token uchovávejte v bezpečí a uložte ho na bezpečné místo. Může ho použít kdokoli k ovládání vašeho bota.

Zkopírujte token. Za dvě minuty ho budete potřebovat.

⚠️ Zabezpečení tokenu. Token poskytuje plnou kontrolu nad botem. Pokud unikne, kdokoli může vystupovat jako váš bot a (potenciálně) zachytit zprávy, které posíláte Claudovi. Nezveřejňujte ho v repozitářích, nevkládejte ho do kódu ani neposílejte v chatech. Ukládám tokeny do ~/.claude/channels/telegram/.env; plugin ho tam uloží v dalším kroku.

Krok 2. Nainstalujte telegramový plugin do Claude Code#

Otevřete terminál v libovolné složce, kde s Claudem obvykle pracujete, a spusťte:

claude

V relaci zadejte příkaz se lomítkem:

/plugin install telegram@claude-plugins-official

Pokud Claude odpoví „Plugin not found in any marketplace“, klient nezná oficiální marketplace. Přidejte ho:

/plugin marketplace add anthropics/claude-plugins-official

Nebo ho aktualizujte, pokud jste ho přidali dříve:

/plugin marketplace update claude-plugins-official

Po úspěšné instalaci znovu načtěte pluginy, aby se aktivovaly jejich příkazy:

/reload-plugins

Nyní byste měli mít příkazy se lomítkem, například /telegram:configure a /telegram:access. Ověříte to příkazem /help; seznam by měl obsahovat sekci telegram.

Krok 3. Propojte token s pluginem#

V relaci Claude:

/telegram:configure 1234567890:AAHzlAU...

Příkaz uloží token do ~/.claude/channels/telegram/.env. K souboru máte přístup pouze vy (chmod 600), takže se o něj nemusíte obávat.

Případně nastavte token pomocí proměnné prostředí. To se hodí, pokud nasazujete Claude přes systemd nebo Docker a nechcete používat interaktivní příkazy:

export TELEGRAM_BOT_TOKEN="1234567890:AAHzlAU..."
claude --channels plugin:telegram@claude-plugins-official

⚠️ V produkci vždy používám proměnné prostředí místo souboru .env ve své domovské složce ~/. Usnadňuje to správu tajných údajů přes systemd (Environment=TELEGRAM_BOT_TOKEN=...) a předchází nechtěnému přidání ~/.claude/ do repozitáře.

Krok 4. Restartujte Claude s příznakem --channels#

Tohle je nejdůležitější bod a při prvním spuštění na něm ztroskotá skoro každý. Samotná instalace pluginu nestačí. Aby bot skutečně začal přijímat zprávy, musíte spustit Claude s výslovným příznakem:

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

Bez příznaku relace funguje jako obvykle, ale telegramový plugin je neaktivní. S příznakem Claude spustí MCP server pluginu, začne dotazovat Telegram API a odpovídat na zprávy poslané botovi.

Po spuštění byste měli v terminálu vidět něco podobného:

✻ Welcome to Claude Code 2.1.80
  Channels: telegram@claude-plugins-official (active)
  Polling for messages...

Pokud se neobjeví řádek o channels, příznak nebyl rozpoznán. Zkontrolujte, že máte Claude Code ve verzi 2.1.80+ a že je plugin skutečně nainstalovaný (/plugin list v relaci).

⚠️ Praktický tip. Do ~/.zshrc jsem přidal alias:

alias claude-tg="claude --channels plugin:telegram@claude-plugins-official"

Pak stačí spustit claude-tg. Můžete zadat více pluginů oddělených mezerami: --channels plugin:telegram@... plugin:discord@....

Krok 5. Spárujte účet a zablokujte všechny ostatní#

Tento krok se týká zabezpečení. Schválený odesílatel může požádat Claude o akce se soubory a nástroji dostupnými relaci. Spárujte jen zamýšlený účet a před spoléháním na bota uzamkněte zásady odesílatelů.

Postup:

1. Otevřete svého bota v Telegramu. Najděte ho podle uživatelského jména @my_claude_bot nebo přes odkaz v odpovědi BotFather. Stiskněte „Start“.
2. Pošlete botovi libovolnou zprávu. Například hi.
3. Bot odpoví párovacím kódem. Bude vypadat přibližně takto:

Ahoj! Pokud chcete tento účet spárovat, spusťte ve své relaci Claude Code tento příkaz:
/telegram:access pair 847291

Tento kód platí 5 minut.

4. Vraťte se do terminálu. V relaci Claude zadejte příkaz z odpovědi:

/telegram:access pair 847291

Claude odpoví: „Účet spárován.“ Nyní může váš účet Telegram posílat příkazy.

5. Zapněte zásadu seznamu povolených účtů. Zablokuje všechny kromě již spárovaných účtů:

/telegram:access policy allowlist

Poté budou zprávy od ostatních účtů tiše ignorovány. Neobjeví se v terminálu a bot neodpoví — jako by nikdy nepřišly.

⚠️ Zapnutí seznamu povolených účtů hned po spárování je velmi důležité. Nenechávejte to na později. Během nastavení neschvalujte neznámé párování a nepředpokládejte správnost politiky odesílatelů jen z úspěšné odpovědi. Můj bot běžel poprvé bez seznamu povolených účtů deset minut a dva náhodní uživatelé Telegramu mu za tu dobu stihli poslat „hi“. Naštěstí jsem tehdy nenechával příkazy zapisovat do souborů.

Pokud potřebujete přidat někoho dalšího (například spolupracovníka na projektu):

/telegram:access pair <code from their account>

Nejprve musí botovi napsat, získat kód a předat vám ho. Přidat ho můžete pouze tímto způsobem.

Další průvodce najdete v dokumentaci Ailoot.

Jak provozovat Claude 24/7 na vlastním VPS#

Pokud chcete, aby bot „žil nepřetržitě“, a ne jen „zapněte na hodinu notebook a chvíli si s ním hrajte“, musí relace běžet pořád. Místně toho dosáhnete pomocí tmux, ale VPS je jednodušší a spolehlivější.

Jedno ukázkové nastavení používá VPS Coolify, na kterém zároveň běží web (podrobnosti v průvodci publikováním přes Coolify). Můžete použít stejný server — Claude spotřebuje málo paměti. Pokud VPS nemáte, pořiďte si nejlevnější za 4–5 eur měsíčně, například Hetzner CX11 / Yandex Cloud / Selectel.

Krok 1: Nainstalujte systém na VPS

Nejprve jako správce vytvořte vyhrazený unixový účet a pracovní prostor. Existující účet použijte až po ověření domova a vlastnictví:

sudo useradd --create-home --shell /bin/bash claude
sudo install -d -o claude -g claude /home/claude/workspace
sudo -iu claude

Pokračujte v přihlašovacím shellu claude, nikoli v domově root. Nainstalujte Bun oficiálním instalátorem a Claude Code nativním postupem:

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

Otevřete nový přihlašovací shell stejného uživatele, aby se uplatnily změny PATH. Ověřte účet a cesty programů:

whoami
printf '%s\n' "$HOME"
command -v bun
command -v claude
bun --version
claude --version
cd /home/claude/workspace
claude

whoami musí vypsat claude a HOME má být /home/claude. Zaznamenejte absolutní cesty command -v; skutečnou cestu Claude použijte v ExecStart a adresář Bun zahrňte do PATH služby. Při chybějícím programu zastavte.

Krok 2: Přihlášení, instalace a párování pod uživatelem služby

Ve stejné interaktivní relaci claude dokončete přihlášení a pod tímto unixovým uživatelem zopakujte výše uvedené kroky 2–5: nainstalujte plugin Telegram v uživatelském rozsahu, nastavte token, restartujte s --channels, spárujte Telegram a nastavte policy allowlist. Před službou otestujte zprávu i odpověď. Nekopírujte sem konfiguraci ani přihlašovací údaje root.

Podporováno je předplatné claude.ai i klíč Anthropic Console API. Team/Enterprise potřebují povolení organizace; spravované organizace Console musejí také splnit nastavení kanálů. Console se účtuje přes API, nikoli předplatné claude.ai. Při přechodu z interaktivního shellu do služby zachovejte účet i způsob přihlášení.

Krok 3: Spusťte relaci pod systemd

Opusťte shell uživatele služby a jednotku vytvořte jako správce. Následující předpokládá skutečně ověřené /home/claude/.local/bin/claude a /home/claude/.bun/bin/bun; pokud se výstupy liší, nahraďte je. Dodejte stejné zvolené prostředí přihlášení a token bota, jednotku zpřístupněte jen správci a tajné údaje nikdy necommitujte. Vytvořte službu pro automatický start a restart po pádu:

cat > /etc/systemd/system/claude-code.service <<'EOF'
[Unit]
Description=Claude Code with Telegram channel
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
User=claude
WorkingDirectory=/home/claude/workspace
Environment="HOME=/home/claude"
Environment="TELEGRAM_BOT_TOKEN=1234567890:AAH..."
Environment="PATH=/home/claude/.local/bin:/home/claude/.bun/bin:/usr/local/bin:/usr/bin:/bin"
ExecStart=/home/claude/.local/bin/claude --channels plugin:telegram@claude-plugins-official --dangerously-skip-permissions
Restart=on-failure
RestartSec=10

[Install]
WantedBy=multi-user.target
EOF

systemctl daemon-reload
systemctl enable claude-code
systemctl start claude-code

Nastavil jsem toto:

• Type=simple — jednoduchý režim; systemd považuje proces za spuštěný, jakmile se rozběhne.
• User=claude — běží pod samostatným uživatelem, nikoli pod rootem. Je to bezpečnější.
• WorkingDirectory=/home/claude/workspace — připravený prostor vlastněný uživatelem služby. Zamýšlený repozitář sem umístěte před spuštěním; neponechávejte klon vlastněný root ani nespouštějte z jeho domova.
• Environment=TELEGRAM_BOT_TOKEN=... — token se předává přímo procesu. Soubor .env není potřeba.
• --dangerously-skip-permissions — pro provoz bez obsluhy je to zásadní. Bez tohoto příznaku Claude před každou akcí čeká na vaše „ano/ne“ v terminálu a relace se zasekne. Seznam povolených účtů identifikuje odesílatele; nečiní jejich příkazy bezpečnými. Bypass používejte jen v izolovaném prostředí se záměrně omezenými soubory, přihlašovacími údaji a sítí.
• Restart=on-failure — pokud proces spadne (Claude spadne nebo vypadne síť), systemd ho za 10 sekund znovu spustí.

Prohlížejte protokoly pomocí:

journalctl -u claude-code -f

Pokud se něco pokazí, journalctl -u claude-code -n 100 zobrazí posledních 100 řádků.

Krok 4: Ověřte, že bot běží

Službu spusťte až po skutečné odpovědi Telegramu v interaktivním nastavení. Stejnému botovi pošlete ze spárovaného účtu neškodnou zprávu a ověřte odpověď i log služby. Funguje-li ručně a ne pod systemd, nejprve porovnejte unixového uživatele, HOME, pracovní prostor, cestu programu, PATH a prostředí přihlášení.

Pro pozdější změny párování službu zastavte, spusťte sudo -iu claude, přejděte do /home/claude/workspace a stejný kanál spusťte interaktivně. Tam proveďte párování a allowlist, relaci ukončete a službu znovu spusťte. Pro stejného bota nespouštějte dva pollery současně. journalctl čte logy; neposkytuje interaktivní zadávání Claude.

5 nástrah produkčního serveru a jak se jim vyhnout#

1. Bun není v PATH služby systemd

Systemd spouští procesy s minimálním prostředím: nevidí proměnné z ~/.bashrc. Pokud je Bun instalován jen v domově root a služba má User=claude, tato instalace ani PATH root se do ní automaticky nepřenáší.

Řešení. Buď nainstalujte Bun pro celý systém (/usr/local/bin/bun), nebo nastavte PATH výslovně:

Environment="PATH=/home/claude/.bun/bin:/usr/local/bin:/usr/bin:/bin"

2. Po dlouhé nečinnosti relace ztratí TCP spojení s Telegram API

Po 6–12 hodinách nečinnosti může bot „ztichnout“ — zprávy se do Telegramu posílají, ale plugin je nepřijímá. Jde o zvláštnost long pollingu.

Řešení. Nastavte v systemd pravidelný restart (každých 24 hodin):

Restart=always
RuntimeMaxSec=86400

Nebo nastavte úlohu cron: 0 5 * * * systemctl restart claude-code (restart v 5 ráno).

3. Limity Claude Max se vyčerpají uprostřed dne

Pokud Claude přes Telegram používáte intenzivně, v tarifu Max 5x (přibližně $100 měsíčně) můžete limitu dosáhnout za 4–6 hodin. Požadavky z Telegramu se neliší od požadavků z běžného terminálu; čerpají ze stejného rozpočtu.

Řešení. Nastavte si připomenutí: „Bot neodpovídá — zkontroluj /stats.“ Pokud limitu dosáhnete, buď počkejte na její obnovení, nebo přejděte na Max 20x ($200 měsíčně). Pomoci může průvodce úsporou tokenů a průvodce modely Sonnet a Opus.

4. --dangerously-skip-permissions je nebezpečný i se seznamem povolených účtů

Tento příznak vypne všechna potvrzení. Jakýkoli váš příkaz v Telegramu se provede bez dotazů: mazání souborů, odesílání externích požadavků, cokoli. Jednou jsem požádal Claude, aby „odstranil zbytečné příkazy console.log“, a ve své horlivosti uklidit Claude smazal polovinu ladicích výpisů v produkčním skriptu. Obnovil jsem je přes git, ale škoda už byla napáchána.

Řešení. Pokud pracujete na kritickém projektu, --dangerously-skip-permissions nezapínejte. Místo toho použijte Remote Control — oprávnění se zobrazí na telefonu a budete je ručně schvalovat. Channels s --dangerously-skip-permissions používejte pro hrubé návrhy, refaktoring a testy.

5. Seznam povolených účtů se po nové instalaci „rozbije“

Seznam povolených účtů je uložen v ~/.claude/channels/telegram/. Pokud přejdete na nový VPS, znovu nainstalujete Claude nebo změníte uživatele, stará data o spárování se nenačtou. Starý seznam povolených odesílatelů chybí; nepředpokládejte zachování předchozí politiky nové instance.

Řešení. Před přesunem zálohujte ~/.claude/channels/telegram/. Potom ho vraťte zpět. Nebo účty znovu spárujte hned po nové instalaci a nenechávejte mezi spuštěním bota a nastavením policy allowlist ani minutovou prodlevu.

Channels, nebo Remote Control — co si vybrat?#

Anthropic vydal obě funkce téměř současně: Remote Control 25. února 2026 a Channels 20. března 2026. Nenahrazují se; řeší různé problémy.

Pro sebe si je rozděluji takto: Channels používám pro asynchronní práci mimo notebook, oznámení z CI a integrace. Remote Control používám, když potřebuji vidět, co Claude dělá, nebo schválit rizikový krok.

Obě funkce můžete používat současně. Telegramový bot vám poskytne rychlý kanál „zeptat se a dostat odpověď“; Remote Control zase kanál pro „ovládání kritických věcí“. Čerpají ze stejného limitu Claude.

Časté dotazy#

Mohu připojit více botů současně?

Ano. Příznak --channels přijímá seznam oddělený mezerami: --channels plugin:telegram@claude-plugins-official plugin:discord@claude-plugins-official. Jedna relace Claude odpovídá v obou chatech.

Co se stane, když zavřu terminál?

Relace se zavře, plugin se zastaví a bot ztichne. Na VPS relace běží dál pod systemd. Na místním počítači zavřete notebook a claude se za několik sekund odpojí signálem SIGHUP.

Mohu přijímat oznámení z CI nebo Sentry?

Ano. Channels je obousměrný kanál. Můžete si napsat vlastní plugin, který bude předávat webhooky do relace pomocí referenční příručky Channels. Claude uvidí události v reálném čase a odpoví.

Je Telegram v něčem omezenější než Discord?

Základní možnosti jsou stejné. Discord vyžaduje v nastavení bota Message Content Intent. iMessage funguje pouze v macOS a čte přímo databázi ~/Library/Messages/chat.db. Telegram je univerzální.

Co musím udělat, když mám tarif Team?

Správce organizace musí zapnout channelsEnabled: true ve spravovaných nastaveních nebo přes admin-settings/claude-code. Bez toho se plugin připojí, ale zprávy neprojdou — v terminálu se zobrazí varování při spuštění.

Co může Claude vidět z mého telefonu — samotný chat v Telegramu?

Ne. Claude vidí pouze zprávu, kterou jste poslali botovi. Historie vašich konverzací v Telegramu, seznam chatů i kontakty jsou nepřístupné. MCP plugin čte pouze zprávy botovi přes Telegram Bot API.

Mohu používat Claude přes Channels bez předplatného Pro/Max?

Ano, podporován je i klíč Anthropic Console API; spotřeba se účtuje dané organizaci Console. Bezplatný claude.ai není zde popsanou cestou předplatného. Team/Enterprise a spravované organizace Console musejí splnit nastavení povolení kanálů.

Co dál#

Jakmile bot spolehlivě běží, můžete Channels využít naplno několika dalšími kroky:

1. Propojte webhooky z CI. Pokud používáte GitHub Actions / GitLab CI, můžete nakonfigurovat plugin Channels tak, aby předával výsledky sestavení přímo do relace. Claude hned po pushi uvidí „test selhal“ a navrhne opravu. Viz dokumentaci channels-reference.
2. Spojte ho s Routines. Ve stejné relaci můžete spouštět Routines pro pravidelné úlohy. Ráno bot sám pošle „dobré ráno, tady je souhrn projektu“ a vy z telefonu odpovíte „vytvoř přehled tržeb“.
3. Nastavte monitor bota. Chci vědět, když bot ztichne. Malý skript cron na VPS každou hodinu pošle telegramovému botovi ping. Pokud bot neodpoví, skript odešle upozornění do samostatného kanálu. Bez toho může bot přestat fungovat ve čtyři ráno a vy se to dozvíte až v poledne.
4. Zvažte hooks. Hooks reagují na události Claude (spuštění nástroje, dokončení zprávy). Hooks společně s Channels umožňují automatická oznámení v Telegramu, například „Claude dokončil úkol N“.

Nesnažte se Channels připojit úplně ke všemu. Je to pohodlný způsob, jak se věnovat úloze na cestách nebo v kavárně. Když potřebujete opravdu přemýšlet, otevřete notebook a posaďte se k němu. Channels vás na cestách zbaví myšlenky „ještě se ho na to musím zeptat, musím otevřít notebook“.

Další materiály o práci s nástroji najdete v dokumentaci Ailoot.