Claude Code pe Telegram: plugin oficial si setup sigur

Claude Code poate fi conectat la Telegram prin pluginul prezent in repository-ul oficial Anthropic. Botul transmite mesajele catre o sesiune Claude Code activa si poate trimite inapoi raspunsuri, reactii sau fisiere. Nu este un serviciu cloud autonom: computerul sau serverul trebuie sa ramana pornit.

Nu exista un bot public Claude pe care sa il cauti si sa il folosesti direct. Trebuie sa creezi propriul bot prin @BotFather, sa instalezi pluginul Telegram si sa asociezi doar conturile autorizate.

Acest setup ofera control de la distanta, dar deschide si o cale catre fisierele si terminalul sistemului. De aceea, pairing-ul temporar, allowlist-ul, izolarea si permisiunile minime sunt mai importante decat comoditatea.

Claude Code pe Telegram este oficial?

Anthropic nu ofera un bot Telegram public gata de folosire. Exista insa un plugin Telegram in repository-ul claude-plugins-official. Pluginul porneste un server MCP care se conecteaza la Telegram ca bot si transmite mesajele catre sesiunea locala Claude Code.

Aceasta diferenta evita o confuzie periculoasa. Nu trimite credentiale unui bot care foloseste numele Claude. Creeaza botul tau cu BotFather si verifica pluginul in repository-ul Anthropic.

Functia Channels este in research preview. In organizatiile Team si Enterprise, administratorul poate fi nevoit sa o activeze explicit.

Cum functioneaza integrarea Telegram

1. Creezi un bot personal prin @BotFather.
2. Instalezi pluginul Telegram in Claude Code.
3. Salvezi tokenul botului in configuratia locala.
4. Repornesti Claude Code cu flag-ul Channels.
5. Trimiti un mesaj botului si primesti un cod de pairing.
6. Asociezi contul si treci imediat la allowlist.

Serverul MCP ruleaza pe aceeasi masina cu Claude Code. Evenimentele ajung doar cat timp sesiunea este deschisa. Pentru un sistem permanent ai nevoie de un proces de fundal sau un terminal persistent.

De ce ai nevoie

• Claude Code instalat si autentificat;
• Bun, folosit de serverul MCP al pluginului;
• un cont Telegram si botul oficial @BotFather;
• un computer sau server care ramane pornit;
• o versiune recenta Claude Code cu suport Channels;
• un director de lucru izolat, fara secrete inutile.

Documentatia pluginului foloseste Bun pentru executarea serverului. Instaleaza-l numai din sursa oficiala si verifica versiunea inainte de configurare.

Pasul 1: creeaza botul cu BotFather

Deschide Telegram si cauta @BotFather. Verifica username-ul exact si badge-ul oficial. Trimite:

/newbot

Alege un nume si un username unic care se termina in bot. BotFather va returna un token cu forma:

123456789:AA...

Tokenul controleaza botul. Nu il trimite in chat, nu il include in screenshot-uri, nu il salva in Git si nu il pune intr-un fisier public. Daca este expus, revoca-l imediat din BotFather si genereaza unul nou.

Pasul 2: instaleaza pluginul Telegram

Porneste Claude Code cu:

claude

Apoi instaleaza pluginul din marketplace-ul oficial:

/plugin install telegram@claude-plugins-official

Configureaza tokenul primit de la BotFather:

/telegram:configure TOKENUL_BOTULUI

Comanda scrie variabila TELEGRAM_BOT_TOKEN in ~/.claude/channels/telegram/.env. O poti seta si in mediul shell, care are prioritate. Restrictioneaza permisiunile fisierului pentru ca alti utilizatori ai sistemului sa nu il poata citi.

Pasii actuali sunt documentati in README-ul oficial al pluginului Telegram.

Pasul 3: porneste canalul Telegram

Inchide sesiunea Claude Code si reporneste-o cu:

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

Pluginul nu se conecteaza fara flag-ul --channels. Mesajele ajung numai cat timp sesiunea ruleaza. Daca inchizi terminalul sau opresti serverul, botul nu mai transmite conversatia.

Pasul 4: pairing si allowlist

Trimite un mesaj privat botului. Acesta va raspunde cu un cod de sase caractere. In sesiunea Claude Code ruleaza:

/telegram:access pair COD

Dupa ce verifici ca mesajele tale ajung la agent, inchide pairing-ul si activeaza allowlist:

/telegram:access policy allowlist

Nu lasa politica in modul pairing. Pairing-ul exista doar pentru capturarea ID-ului utilizatorului. Daca ramane deschis, persoane necunoscute pot cere coduri de asociere.

Pentru grupuri si configuratii multiuser exista reguli separate. Nu presupune ca pairing-ul unui cont personal protejeaza automat un grup.

Ce poate face pluginul Telegram?

• trimite raspunsuri text si atasamente;
• adauga reactii la mesaje;
• editeaza mesajele trimise de bot;
• primeste fotografii si le salveaza in inbox-ul canalului;
• afiseaza progres prin typing si actualizari de mesaj;
• transmite evenimente catre sesiunea Claude Code activa.

Telegram Bot API nu ofera automat istoricul complet si cautarea tuturor mesajelor. Pluginul lucreaza cu evenimentele primite cat timp ruleaza. Daca Claude are nevoie de context mai vechi, rezuma-l sau trimite-l din nou.

Pluginul Anthropic vs boturile community

Optiune	Avantaj	Risc
Plugin Anthropic	Setup integrat cu Claude Code Channels	Research preview si acces remote la sesiune
Bot community	Mai multe functii, scheduler, Git, webhook-uri	Mai multe dependinte si configuratii de auditat
Hook doar pentru notificari	Suprafata de atac redusa	Nu permite control interactiv

Daca ai nevoie doar de alerte pentru build sau teste, un canal unidirectional este mai sigur decat un bot care accepta comenzi. Alege cea mai mica putere necesara.

Este sigur Claude Code pe Telegram?

Nu trebuie considerat sigur implicit. Creezi o punte intre o aplicatie de mesagerie si un agent care poate citi fisiere, executa comenzi si folosi instrumente.

Allowlist-ul reduce accesul neautorizat, dar nu elimina:

• furtul tokenului botului;
• compromiterea contului Telegram;
• prompt injection prin mesaje sau fisiere;
• permisiuni prea largi in filesystem;
• comenzi distructive aprobate de la distanta;
• expunerea codului sau datelor prin conversatie;
• costuri neasteptate din taskuri lungi.

Checklist de securitate

• foloseste un bot si un cont dedicate;
• activeaza verificarea in doi pasi pe Telegram;
• treci imediat la allowlist;
• ruleaza Claude cu un utilizator fara privilegii administrative;
• nu porni sesiunea din radacina filesystemului;
• monteaza doar repository-ul necesar;
• blocheaza cheile SSH, fisierele .env si backup-urile;
• nu permite deploy sau migrari de productie;
• pastreaza loguri fara secrete si verifica actiunile.

Pentru bucle autonome, riscul creste deoarece o decizie poate fi repetata. Citeste si ghidul despre Ralph Loop si limitele obligatorii.

Mesajele botului au criptare end-to-end?

Nu, conversatiile cu botii nu sunt Secret Chats cu criptare end-to-end. Telegram foloseste criptare server-client pentru Cloud Chats, iar E2E este rezervata Secret Chats intre participanti compatibili.

Nu trimite prin bot parole, chei API, date personale sensibile sau fragmente de cod care nu trebuie sa tranziteze infrastructura Telegram. Fisierele si fotografiile descarcate local necesita si ele reguli de retentie si stergere.

Configuratie recomandata pentru un server

• container sau masina virtuala dedicata;
• utilizator fara privilegii;
• volum montat doar pentru proiectul necesar;
• branch separat si fara push direct pe main;
• acces de retea limitat;
• token Telegram furnizat ca secret;
• timeout si buget pentru fiecare task;
• backup si checkpoint inainte de modificari.

Daca ai nevoie de un workflow agentic mai larg, consulta comparatia Claude Code vs OpenCode vs Codex si pagina despre agenti AI pentru afaceri.

Cazuri de utilizare recomandate

• notificare cand testele sau build-ul s-au terminat;
• verificarea starii unei sesiuni deja pornite;
• rezumarea unor loguri fara date sensibile;
• pregatirea unei schite de issue sau pull request;
• consultarea unei documentatii read-only;
• aprobarea unui pas cu risc redus si usor reversibil.

Un hotfix direct in productie de pe telefon este un caz slab. Ecranul mic, lipsa unui diff complet si graba cresc sansa unei aprobari gresite.

Cat costa integrarea?

Pluginul Telegram nu are un abonament separat. Activitatea consuma planul sau facturarea configurata pentru Claude Code. Un bot community poate folosi direct API-ul Anthropic si poate avea propriile costuri.

Limiteaza durata, instrumentele si dimensiunea contextului. Pentru reducerea consumului, foloseste recomandarile din ghidul despre optimizarea Claude Code si tokenilor.

Probleme frecvente

Botul nu raspunde

Verifica tokenul, procesul Bun si faptul ca Claude Code a fost pornit cu --channels. Daca serverul MCP s-a deconectat, actualizeaza pluginul si reincarca sesiunea.

Pairing-ul nu functioneaza

Trimite un mesaj privat nou botului pentru un cod actual si verifica politica de acces. Nu transmite codul altei persoane.

Mesajele ajung, dar Claude nu executa actiunea

Controleaza directorul curent, permisiunile si instrumentele disponibile. Nu extinde toate permisiunile doar pentru a elimina o eroare.

Pluginul nu porneste pe Windows

Verifica Bun, PATH-ul si versiunea Claude Code. Au existat raportari de conectare MCP pe Windows, iar o repornire completa a rezolvat unele configuratii. Foloseste instructiunile curente din repository.

Intrebari frecvente

Claude are un bot Telegram oficial?

Nu exista un bot public Claude gata de folosire. Anthropic publica insa un plugin Telegram in repository-ul oficial de pluginuri.

Computerul trebuie sa ramana pornit?

Da. Botul transmite mesajele catre o sesiune Claude Code activa pe computer sau server.

Pot folosi Claude Telegram intr-un grup?

Da, dar trebuie configurate politici dedicate pentru utilizatori, mentiuni si livrarea mesajelor. Pairing-ul personal nu este suficient.

Pot rula mai multi boti?

Da. Poti folosi directoare de stare separate prin TELEGRAM_STATE_DIR, cu tokenuri si allowlist-uri diferite.

Este sigur sa modific productia din Telegram?

Nu este recomandat. Lucreaza intr-un mediu izolat si revizuieste modificarile inainte de deploy.

Chatul cu botul este criptat end-to-end?

Nu. Chat-urile cu boti sunt Cloud Chats, nu Secret Chats cu criptare end-to-end.

Concluzie

Claude Code pe Telegram este util pentru notificari si control remote limitat, dar transforma chatul intr-o intrare catre agent. Pluginul oficial simplifica instalarea; securitatea depinde de configuratia ta.

Pentru utilizare serioasa ai nevoie de allowlist, izolare, privilegii minime si review uman. Daca vrei o integrare remote controlata, vezi serviciile pentru aplicatii web si automatizari sau contacteaza-ma.