Hogyan irányítsd a Claude Code-ot a telefonodról Telegramon keresztül 2026-ban
MarkdownLépésről lépésre: hozz létre egy Telegram-botot, telepítsd a Claude Code Channels plugint, védd hozzáférési listával, és futtasd 24/7 egy VPS-en. Kövesd ezt a kész útmutatót a parancsokkal együtt.
A teljes cikk elolvasása
Főbb pontok
A Claude Code Channels 2026. március 20. óta az Anthropic hivatalos pluginje. Hozz létre egy botot a BotFather segítségével, telepítsd a plugint egyetlen paranccsal, indítsd újra a Claude-ot a --channels kapcsolóval, majd küldj üzeneteket a botnak a telefonodról. A Claude közvetlenül a helyi munkamenetedben olvassa el őket, kódot ír a fájljaidba, és Telegramon válaszol. Ha azt szeretnéd, hogy 24/7 működjön, helyezd át a munkamenetet a saját VPS-edre, és futtasd systemd-vel.
Az eszközök konfigurálásáról további anyagokat találsz az Ailoot dokumentációjában.
Mi a Claude Code Channels, és miért van rá szükséged?
Főbb pontok
A Channels egy MCP-plugin, amely a Telegramról, Discordról vagy iMessage-ről érkező üzeneteket egy már futó Claude Code-munkamenethez továbbítja. A munkamenet az üzenetet szokásos felhasználói kérésként kezeli, dolgozik a helyi fájljaiddal, majd ugyanabban a csevegésben válaszol. A laptopod nyitva marad, miközben a telefonoddal intézed a dolgaidat.
- március 20-án az Anthropic kiadta a Claude Code Channelst, egy hivatalos plugint, amellyel egy Claude-munkamenetet üzenetküldő alkalmazásokhoz kapcsolhatsz. A Telegram, a Discord és az iMessage támogatott. A funkció kutatási előzetes verzióban van: a dokumentáció a code.claude.com/docs/en/channels oldalon, a plugin forráskódja pedig a nyílt anthropics/claude-plugins-official tárolóban található.
Röviden: ez egy „csevegési híd” a telefonod és a Claude Code-munkameneted között. Ezt írom a botnak: „Folytasd az ártáblázat átdolgozását; a business/products/practicum/README.md fájlban frissítsd a következő csoport dátumait”, a bot pedig továbbítja az üzenetet a VPS-emen futó munkamenetnek. A Claude lekéri a kontextust, szerkeszti a fájlt, véglegesíti a módosításokat, majd ezt írja Telegramon: „Kész, nézd meg a commitot.” A laptop otthon csukva marad.
⚠️ A kutatási előzetes verzió legfontosabb korlátja: a Channels egy MCP-híd. A munkamenetnek a gépeden vagy a VPS-eden kell futnia. Ha a munkamenet leáll, senki sem kapja meg az üzeneteket. Ezért a 24/7-es működést külön kell beállítani (lásd alább a VPS-ről szóló részt).
Miben különbözik a Channels a távoli munkavégzés más módjaitól?
A hivatalos dokumentációjában az Anthropic közvetlen összehasonlító táblázatot közöl. Íme ennek átdolgozott változata:
| Funkció | Mit csinál? | Mikor válaszd? |
|---|---|---|
| Claude Code a weben | Feladatot futtat egy friss felhős sandboxban, és klónoz egy repót a GitHubról | Bízz rá egy önálló háttérfeladatot, és később nézd meg az eredményt |
| Slack-integráció | Webes munkamenetet indít egy szálban, amikor valaki megemlíti a @Claude-ot | Indíts feladatokat közvetlenül a csapat beszélgetéseiből |
| MCP-szerver (hagyományos) | A Claude egy feladat során hívja meg; nem küld semmit a munkamenetnek | Adj a Claude-nak igény szerinti hozzáférést külső rendszerekhez |
| Remote Control | A helyi munkamenetedet a claude.ai-ról vagy a mobilalkalmazásból vezérled | Működtess egy meglévő munkamenetet a telefonod képernyőjéről |
| Channels ⭐ | Nem Claude-forrásokból származó eseményeket küld egy már futó helyi munkamenetbe | Tegyél fel kérdést a telefonodról, és kapj választ a csevegésben; fogadj webhookot a CI-tól |
A legfontosabb különbség a Channels és a Remote Control között: a Remote Control „ablak a telefonodról a terminálra”—szó szerint látod a kurzort, és gombokat nyomsz meg. A Channels olyan chatbot, amelynek az agya a helyi Claude-munkameneted. A Remote Controlnál a terminált nézem. A Channelsnél valakinek üzenek, aki elolvassa a fájljaimat.
Ha teljes képernyős vezérlésre van szükséged, használd a Remote Controlt. Ha azt szeretnéd, hogy „elküldj egy kérdést, folytasd a napodat, aztán kapj választ”, használd a Channelst. Én mindkettőt használom: a Remote Controlt, amikor jóvá kell hagynom a fontos módosításokat, a Channelst pedig akkor, ha biztos vagyok a feladatban, és szeretném visszakapni az estémet.
Mire van szükséged a kezdés előtt?
Főbb pontok
Claude Code v2.1.80 vagy újabb verzió, támogatott claude.ai-hitelesítés vagy Anthropic Console API-kulcs, telepített Bun és Telegram-hozzáférés. A 24/7-es működéshez Ubuntu vagy Debian rendszert futtató VPS kell. Minden ugyanúgy működik macOS-en, Linuxon és WSL-en.
A parancsok előtt ellenőrizd ezt a listát:
- Anthropic-fiók. A claude.ai-előfizetéses úthoz Pro, Max, Team vagy Enterprise csomag szükséges. A Channels nem érhető el az ingyenes csomagban. Anthropic Console API-kulcs is használható; ha a Console-szervezet felügyelt beállításokat alkalmaz, ellenőrizd ott a csatornák engedélyezését.
- Claude Code v2.1.80 vagy újabb verzió. Ellenőrizd a
claude --versionparanccsal. Ha régebbi, frissíts aclaude updatevagy aznpm install -g @anthropic-ai/claude-code@latestparanccsal. - Bun. A Channels-bővítmények Bun-szkriptek, nem Node-szkriptek. Ellenőrizd a
bun --versionparanccsal. Ha nincs telepítve, futtasd acurl -fsSL https://bun.sh/install | bashparancsot, majd asource ~/.bashrcparancsot. - Telegram-fiók. Bármilyen fiók megfelel; az a fontos, hogy be legyél jelentkezve a telefonodon.
- Ha Team/Enterprise csomagod van, kérd meg az adminisztrátort a
channelsEnabledengedélyezésére a felügyelt beállításokban vagy az admin-settings/claude-code oldalon. A szervezeteknél alapértelmezés szerint ki van kapcsolva.
Ne aggódj a Bun miatt, ha most hallasz róla először. A Bun egy alternatív JavaScript-futtatókörnyezet, akárcsak a Node. Az Anthropic azért választotta a Channels-bővítményekhez, mert gyorsabban indul, és könnyebb egyetlen binárisba csomagolni. Telepítsd egyszer, aztán felejtsd el.
⚠️ A Channels egyelőre nem működik vállalati Bedrock / Google Vertex / Azure Foundry használatával. Kizárólag claude.ai-hitelesítéssel vagy Anthropic Console-lal működik.
1. lépés: hozz létre Telegram-botot a BotFather segítségével
Főbb pontok
Nyisd meg a @BotFathert a Telegramon, küldd el a /newbot parancsot, válassz nevet és felhasználónevet (a felhasználónévnek bot végződésűnek kell lennie), majd megkapod az 12345678:AAH... formátumú tokent. Tartsd biztonságban a tokent: ez a botod jelszava. Aki látja, az a bot nevében írhat, és akár el is foghatja a Claude-nak küldött üzeneteidet.
A BotFather mindent elintéz helyetted—csak öt gombot kell megnyomnod. Íme a lépések:
- Nyisd meg a @BotFathert a Telegramon (használhatod a telefonodat; a beállítás többi részét is elvégezheted róla).
- Ha először használod, nyomd meg a „Start” gombot.
- Küldd el a
/newbotparancsot. - A BotFather ezt fogja kérdezni: „Rendben, egy új bot. Mi legyen a neve?” Add meg a megjelenített nevet, például:
Saját asszisztens - Claude Code. - Ezután felhasználónevet kér. Ennek egyedinek kell lennie az egész Telegramon, és
botvégződésűnek kell lennie. Például:my_claude_botvagymy_dev_bot. - A BotFather ehhez hasonló üzenettel válaszol:
Kész! Gratulálunk az új botodhoz. Itt találod:
'<OFFICIAL_URL>'.
Ezzel a tokennel érheted el a HTTP API-t:
1234567890:AAHzlAU...
Tartsd biztonságban a tokenedet, és tárold biztonságos helyen; bárki felhasználhatja a botod irányítására.
Másold ki a tokent. Két perc múlva szükséged lesz rá.
⚠️ A token biztonsága. A bot tokenje teljes irányítást biztosít felette. Ha kiszivárog, bárki írhat a botod nevében, és (esetleg) elfoghatja a Claude-nak küldött üzeneteidet. Ne tedd közzé repókban, ne illeszd kódba, és ne küldd el csevegésekben. A tokeneket a ~/.claude/channels/telegram/.env fájlban tárolom; a plugin a következő lépésben oda helyezi őket.
2. lépés: telepítsd a Telegram-plugint a Claude Code-ba
Főbb pontok
Indítsd el a Claude Code-ot a szokásos módon, majd írd be a munkamenetbe a /plugin install telegram@claude-plugins-official parancsot. Ha a plugin nem található, először add hozzá a hivatalos marketplace-et a /plugin marketplace add anthropics/claude-plugins-official paranccsal. A telepítés után futtasd a /reload-plugins parancsot, hogy a plugin parancsai elérhetővé váljanak az aktuális munkamenetben.
Nyiss terminált egy tetszőleges mappában, ahol általában a Claude-dal dolgozol, majd futtasd:
claude
Írd be a perjellel kezdődő parancsot a munkamenetbe:
/plugin install telegram@claude-plugins-official
Ha a Claude azt válaszolja, hogy „A plugin egyetlen marketplace-en sem található”, akkor a kliens nem ismeri a hivatalos marketplace-et. Add hozzá:
/plugin marketplace add anthropics/claude-plugins-official
Vagy frissítsd, ha korábban már hozzáadtad:
/plugin marketplace update claude-plugins-official
A sikeres telepítés után töltsd újra a plugineket, hogy a parancsaik elérhetők legyenek:
/reload-plugins
Most már olyan perjeles parancsoknak kell rendelkezésedre állniuk, mint a /telegram:configure és a /telegram:access. Ellenőrzésükhöz írd be a /help parancsot; a listának tartalmaznia kell egy telegram szakaszt.
3. lépés: kapcsold a tokent a pluginhoz
Főbb pontok
A Claude-munkamenetben írd be a /telegram:configure <token> parancsot az 1. lépésben kapott tokennel. A parancs elmenti a tokent a ~/.claude/channels/telegram/.env fájlba (amelyhez csak te férsz hozzá). Másik lehetőségként állítsd be a TELEGRAM_BOT_TOKEN környezeti változót a shellben a Claude indítása előtt. Éles környezetben a második lehetőséget használom: systemd-vel könnyebb kezelni, és nem kell bevonni a ~/.claude/ mappát a repóba.
A Claude-munkamenetben:
/telegram:configure 1234567890:AAHzlAU...
A parancs a ~/.claude/channels/telegram/.env fájlba teszi a tokent. A fájlhoz csak te férsz hozzá (chmod 600), így emiatt nem kell aggódnod.
Másik lehetőségként környezeti változón keresztül is beállíthatod a tokent. Ez akkor hasznos, ha a Claude-ot systemd-vel vagy Dockerrel telepíted, és nem szeretnél interaktív parancsokat használni:
export TELEGRAM_BOT_TOKEN="1234567890:AAHzlAU..."
claude --channels plugin:telegram@claude-plugins-official
⚠️ Éles környezetben mindig környezeti változókat használok a home mappában, a ~/ könyvtárban lévő .env fájl helyett. Így könnyebb a titkokat systemd-vel kezelni (Environment=TELEGRAM_BOT_TOKEN=...), és elkerülhető, hogy véletlenül bekerüljön a ~/.claude/ a repóba.
4. lépés: indítsd újra a Claude-ot a --channels kapcsolóval
Főbb pontok
Lépj ki a munkamenetből (exit vagy Ctrl+D), majd indítsd el újra a --channels plugin:telegram@claude-plugins-official kapcsolóval. Ez a kapcsoló engedélyezi a plugint, és megkéri a Claude-ot, hogy rendszeresen ellenőrizze a Telegram API-t új üzenetekért. A kapcsoló nélkül a bot létezik, de néma marad—a plugin inaktív, és az üzenetek rendszeres ellenőrzése nem indult el.
Ez a legfontosabb tudnivaló, és az, aminél első indításkor mindenki elakad. A plugin telepítése önmagában nem elég. Ahhoz, hogy a bot valóban elkezdjen üzeneteket fogadni, kifejezetten megadott kapcsolóval kell elindítanod a Claude-ot:
claude --channels plugin:telegram@claude-plugins-official
A kapcsoló nélkül a munkamenet a szokásos módon működik, de a Telegram-plugin inaktív. A kapcsolóval a Claude elindítja a plugin MCP-szerverét, elkezdi rendszeresen ellenőrizni a Telegram API-t, és válaszol a botnak küldött üzenetekre.
Az indítás után ehhez hasonlót kell látnod a terminálban:
✻ Üdvözöl a Claude Code 2.1.80
Channels: telegram@claude-plugins-official (aktív)
Üzenetek ellenőrzése...
Ha nincs channels-t említő sor, akkor a kapcsoló nem érvényesült. Ellenőrizd, hogy a Claude Code verziója 2.1.80+ legyen, és a plugin valóban telepítve legyen (/plugin list a munkameneten belül).
⚠️ Hasznos tipp. Alias-t vettem fel a ~/.zshrc fájlba:
alias claude-tg="claude --channels plugin:telegram@claude-plugins-official"
Ezután csak a claude-tg parancsot futtatom. Több plugint is megadhatsz szóközökkel elválasztva: --channels plugin:telegram@... plugin:discord@....
5. lépés: párosítsd a fiókot, és tilts le mindenki mást
Főbb pontok
Nyisd meg a botot a Telegramon, és küldj neki egy tetszőleges üzenetet. A bot egy hatjegyű párosítási kóddal válaszol. Térj vissza a terminálhoz, és írd be a /telegram:access pair <code> parancsot. Ezután mindenképp korlátozd a hozzáférést engedélyezési listával: /telegram:access policy allowlist. Csak a szándékosan engedélyezni kívánt személyek párosítási kódját hagyd jóvá; a küldőengedélylista szabályozza, ki érheti el a munkamenetet.
Ez a lépés a biztonságról szól. Egy jóváhagyott küldő kérheti Claude-ot a munkamenet számára elérhető fájlok és eszközök használatára. Csak a kívánt fiókot párosítsd, és a botra támaszkodás előtt zárd le a küldőszabályzatot.
Lépések:
- Nyisd meg a botot a Telegramon. Keresd meg az
@my_claude_botfelhasználónévvel vagy a BotFather válaszában szereplő hivatkozással. Nyomd meg a „Start” gombot. - Küldj a botnak egy tetszőleges üzenetet. Például:
hi. - A bot párosítási kóddal válaszol. Valahogy így fog kinézni:
Szia! A fiók párosításához futtasd ezt a Claude Code-munkamenetedben:
/telegram:access pair 847291
Ez a kód 5 percig érvényes.
- Térj vissza a terminálhoz. A Claude-munkamenetben írd be a válaszban kapott parancsot:
/telegram:access pair 847291
A Claude ezt válaszolja: „A fiók párosítva.” Most már a Telegram-fiókod is küldhet parancsokat.
- Kapcsold be az engedélyezési listát. Ez minden olyan fiókot letilt, amelyet még nem párosítottál:
/telegram:access policy allowlist
Ezt követően a más fiókokról érkező üzeneteket csendben figyelmen kívül hagyja a rendszer. Nem jelennek meg a terminálban, és a bot sem válaszol—mintha soha nem is léteztek volna.
⚠️ Nagyon fontos, hogy közvetlenül a párosítás után bekapcsold az engedélyezési listát. Ne hagyd későbbre. Beállítás közben ne hagyj jóvá ismeretlen párosításkérést, és ne feltételezd, hogy egy sikeres válasz igazolja a küldőszabályzatot. Amikor először futott a botom, tíz percig nem volt engedélyezési lista, és ezalatt két véletlenszerű Telegram-felhasználó is küldött egy „hi” üzenetet. Szerencsére akkor még nem engedtem, hogy a parancsok fájlokat írjanak.
Ha valaki mást is hozzá szeretnél adni (például egy projektpartnert):
/telegram:access pair <a fiókjukhoz tartozó kód>
Először nekik is üzenniük kell a botnak, hogy kódot kapjanak, majd át kell adniuk neked. Csak így tudod hozzáadni őket.
További útmutatókat találsz az Ailoot dokumentációjában.
Hogyan futtasd a Claude-ot 24/7 a saját VPS-eden?
Főbb pontok
A helyi munkamenet akkor fut, amikor a laptopod nyitva van; csukd le a fedelét, és a bot elnémul. Ha azt szeretnéd, hogy a Claude bármikor válaszoljon, helyezd át a munkamenetet a saját VPS-edre: telepítsd a Claude Code-ot és a Bunt, ugyanazon külön Unix-felhasználóként hitelesíts, telepítsd és párosítsd a plugint, majd futtasd systemd-vel, automatikus újraindítással. Egy Coolify-szerver gond nélkül kezeli.
Ha azt szeretnéd, hogy a bot „éjjel-nappal éljen”, ne csak „nyisd ki a laptopot egy órára, és piszkáld”, akkor a munkamenetnek folyamatosan futnia kell. Helyben ezt megteheted tmuxszal, de a VPS egyszerűbb és megbízhatóbb.
Az egyik példabeállítás egy Coolify VPS-t használ, amely egy weboldalnak is otthont ad (részletek a Coolify-on keresztüli közzétételről szóló útmutatóban). Ugyanezt a szervert használhatod—Claude kevés memóriát fogyaszt. Ha nincs VPS-ed, válaszd a legolcsóbbat, havi 4–5 euróért, például egy Hetzner CX11 / Yandex Cloud / Selectel szolgáltatást.
1. lépés: telepítsd a rendszert a VPS-re
Előbb adminisztrátorként hozd létre a külön Unix-fiókot és munkaterületet. Meglévő fiókot csak home könyvtárának és tulajdonosának ellenőrzése után használj újra:
sudo useradd --create-home --shell /bin/bash claude
sudo install -d -o claude -g claude /home/claude/workspace
sudo -iu claude
Ebben a claude bejelentkezési shellben folytasd, ne root home könyvtárában. A Bunt hivatalos telepítőjével, a Claude Code-ot a natív telepítési folyamattal telepítsd:
curl -fsSL https://bun.sh/install | bash
curl -fsSL https://claude.ai/install.sh | bash
Ugyanennek a felhasználónak nyiss friss bejelentkezési shellt a telepítők PATH-módosításaihoz. Ellenőrizd a fiókot és futtatható útvonalakat:
whoami
printf '%s\n' "$HOME"
command -v bun
command -v claude
bun --version
claude --version
cd /home/claude/workspace
claude
A whoami eredménye claude, a HOME pedig /home/claude legyen. Rögzítsd a command -v abszolút útvonalait; a valódi Claude-útvonalat használd az ExecStart sorban, a Bun könyvtárát pedig tedd a szolgáltatás PATH-jába. Hiányzó futtatható fájlnál állj meg.
2. lépés: hitelesítés, telepítés és párosítás szolgáltatásfelhasználóként
Ugyanebben az interaktív claude munkamenetben fejezd be a belépést, majd e Unix-felhasználó alatt ismételd meg a fenti 2–5. lépést: Telegram-plugin telepítése user hatókörben, tokenbeállítás, újraindítás --channels kapcsolóval, Telegram-fiók párosítása és policy allowlist. Szolgáltatásbeállítás előtt igazolj egy üzenetet és választ. Root Claude-konfigurációját vagy hitelesítő adatait ne másold ebbe a home-ba.
A claude.ai-előfizetéses hitelesítés és az Anthropic Console API-kulcsa is támogatott. Team/Enterprise szervezeti engedélyezést igényel; a felügyelt Console-szervezetek csatornabeállításai is érvényesek. A Console-hozzáférés API-számlázású, nem a claude.ai-előfizetés fedezi. Az interaktív shellről szolgáltatásra váltáskor tartsd meg a kiválasztott fiókot és hitelesítési módot.
3. lépés: futtasd a munkamenetet systemd-vel
Lépj ki a szolgáltatásfelhasználó shelljéből, és adminisztrátorként hozd létre a unitot. Az alábbi példa feltételezi, hogy az útvonalellenőrzés /home/claude/.local/bin/claude és /home/claude/.bun/bin/bun értéket adott; eltérésnél a tényleges kimenetre cseréld. Add meg ugyanazt a választott hitelesítési környezetet és bottokent, a unitot csak adminisztrátora olvashassa, és titkot ne commitolj. Hozz létre szolgáltatásfájlt az automatikus indításhoz és összeomlás utáni újraindításhoz:
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
A következő beállításokat engedélyeztem:
Type=simple— egyszerű mód; a systemd azonnal elindultnak tekinti a folyamatot, amint az elindul.User=claude— külön felhasználóként fut, nem rootként. Biztonságosabb.WorkingDirectory=/home/claude/workspace— az előkészített, szolgáltatásfelhasználó tulajdonában lévő munkaterület. Indítás előtt helyezd ide a kívánt tárolót; ne maradjon root tulajdonú klón, és ne root home-jából fusson.Environment=TELEGRAM_BOT_TOKEN=...— a token közvetlenül a folyamatnak adódik át. Nincs szükség.envfájlra.--dangerously-skip-permissions— felügyelet nélküli működéshez elengedhetetlen. Enélkül a Claude minden művelet előtt a terminálban várja az „igen/nem” válaszodat, ezért a munkamenet elakad. Az engedélylista a küldőt azonosítja; a kért parancsokat nem teszi biztonságossá. E megkerülést csak tudatosan korlátozott fájl-, hitelesítőadat- és hálózati hozzáférésű elkülönített környezetben használd.Restart=on-failure— ha a folyamat összeomlik (a Claude összeomlik vagy megszakad a hálózat), a systemd 10 másodperc múlva újraindítja.
A naplókat ezzel tekintheted meg:
journalctl -u claude-code -f
Ha valami gond van, a journalctl -u claude-code -n 100 megjeleníti az utolsó 100 sort.
4. lépés: ellenőrizd, hogy működik-e a bot
A szolgáltatást csak az interaktív beállítás valódi Telegram-válasza után indítsd. Ezután ugyanannak a botnak a párosított fiókból küldj ártalmatlan üzenetet, és igazold a választ és szolgáltatásnaplót is. Ha interaktívan működik, systemd alatt nem, előbb a Unix-felhasználót, HOME-ot, munkaterületet, futtatható útvonalat, PATH-ot és hitelesítési környezetet vesd össze.
Későbbi párosításmódosításhoz állítsd le a szolgáltatást, futtasd a sudo -iu claude parancsot, lépj a /home/claude/workspace könyvtárba, és ugyanazt a csatornát indítsd interaktívan. Ott párosíts, állítsd be az engedélylistát, lépj ki, és indítsd újra a szolgáltatást. Ugyanahhoz a bothoz ne futtass egyszerre második lekérdezőt. A journalctl naplót olvas; nem interaktív Claude-prompt.
5 buktató éles szerveren, és elkerülésük módja
Főbb pontok
Egyhetes éles beállítási futtatások során gyűjtöttem össze ezeket a buktatókat: a systemd nem látja a Bunt, a long polling hosszabb tétlenség után megszakad, a Max csomag korlátai a nap közepén elfogynak, a --dangerously-skip-permissions adatok szivárgásához vezethet, és az újratelepítés után megfeledkeznek az engedélyezési listáról. Mindegyik megoldható egy egysoros beállítással, de ha nem tudsz róluk, néhány napon belül te is belefutsz valamelyikbe.
1. A Bun nincs benne a systemd PATH-jában
A systemd minimális környezettel indít folyamatokat: nem látja a ~/.bashrc fájlban megadott változókat. Ha a Bunt csak root home-jába telepítetted, de a szolgáltatásfájlban User=claude szerepel, a szolgáltatás nem örökli ezt a telepítést vagy root shell-PATH-ját.
Megoldás. Telepítsd a Bunt az egész rendszer számára (/usr/local/bin/bun), vagy add meg kifejezetten a PATH-ot:
Environment="PATH=/home/claude/.bun/bin:/usr/local/bin:/usr/bin:/bin"
2. A munkamenet hosszabb tétlenség után elveszíti a TCP-kapcsolatot a Telegram API-val
6–12 óra tétlenség után a bot „elhallgathat”—az üzenetek megérkeznek a Telegramra, de a plugin nem kapja meg őket. Ez a long polling egyik sajátossága.
Megoldás. Állíts be rendszeres újraindítást a systemd-ben (24 óránként):
Restart=always
RuntimeMaxSec=86400
Vagy állíts be cron-feladatot: 0 5 * * * systemctl restart claude-code (újraindítás hajnali 5-kor).
3. A Claude Max korlátai a nap közepén elfogynak
Ha sokat használod a Claude-ot Telegramon keresztül, a Max 5x csomaggal (~$100/hónap) 4–6 óra alatt elérheted a korlátot. A Telegram-kérések nem különböznek a hagyományos terminálban küldött kérésektől; ugyanabból a keretből fogyasztanak.
Megoldás. Állíts be emlékeztetőt: „A bot nem válaszol—ellenőrizd a /stats parancsot.” Ha eléred a korlátot, várd meg a visszaállítást, vagy válts Max 20x csomagra ($200/hónap). A tokenmegtakarításról szóló útmutató és a Sonnet és Opus modellekről szóló útmutató segíthet.
4. A --dangerously-skip-permissions engedélyezési listával is veszélyes
Ez a kapcsoló letilt minden megerősítést. Bármilyen parancsot küldesz Telegramon, kérdés nélkül végrehajtja: fájlok törlését, külső kérések küldését, bármit. Egyszer azt kértem a Claude-tól, hogy „távolítsd el a szükségtelen console.log utasításokat”, és a rendrakás hevében a Claude kitörölte egy éles szkript hibakeresési naplóinak felét. Visszaállítottam őket a giten keresztül, de a kár már megtörtént.
Megoldás. Ne engedélyezd a --dangerously-skip-permissions kapcsolót, ha kritikus projekten dolgozol. Ehelyett munkamenetek futtatásához használd a Remote Controlt—az engedélykérések megjelennek a telefonodon, és manuálisan hagyod jóvá őket. A --dangerously-skip-permissions kapcsolóval használt Channels durva vázlatokhoz, refaktoráláshoz és teszteléshez való.
5. Az engedélyezési lista „elromlik” újratelepítés után
Az engedélyezési lista a ~/.claude/channels/telegram/ mappában található. Ha új VPS-re költözöl, újratelepíted a Claude-ot, vagy felhasználót váltasz, a régi párosítási adatok nem kerülnek elő. A régi küldőengedélylista hiányzik; ne feltételezd, hogy az új példány megőrizte a korábbi hozzáférési szabályzatot.
Megoldás. Költözés előtt készíts biztonsági másolatot a ~/.claude/channels/telegram/ mappáról. Utána másold vissza. Vagy végezd el újra a párosítást közvetlenül az újratelepítés után, és ne hagyj akár egyetlen percet sem a bot indítása és a policy allowlist beállítása között.
Channels vagy Remote Control—melyiket válaszd?
Főbb pontok
A Channels azt jelenti, hogy a Claude-munkameneted csevegésben válaszol, te pedig a telefonodról küldesz promptokat. A Remote Control azt jelenti, hogy a terminál képernyője a telefonodon van, és gombokkal irányítod a munkamenetet. A Channels kényelmesebb a „kérdezz, aztán folytasd a napod” helyzetekben, a Remote Control pedig azokhoz a kritikus lépésekhez való, amikor látni akarod, mit csinál a Claude, és jóvá kell hagynod minden kockázatos műveletet.
Az Anthropic szinte egy időben adta ki mindkét funkciót: a Remote Controlt 2026. február 25-én, a Channelst pedig 2026. március 20-án. Nem helyettesítik egymást; különböző problémákra kínálnak megoldást.
| Helyzet | Channels | Remote Control |
|---|---|---|
| Kint vagy, és azt kérdezed: „Mik voltak a tegnapi commitok?” | ✅ Ideális | Túlzás—az egész képernyőre szükséged van |
| Fájlmódosítás jóváhagyása | ⚠️ Vakon hagyod jóvá a --dangerously-skip-permissions használatával | ✅ Látod, mit akar csinálni a Claude |
| Claude futtatása 24/7 | ✅ VPS + systemd beállítás | ⚠️ Nyitva kell tartanod a laptopot |
| Csak néhány promptot küldenél a telefonodról | ⚠️ Túlzás—bot, token és plugin kell | ✅ Egyetlen QR-kód |
| Webhook fogadása a CI-tól / Sentrytől | ✅ Beépített felhasználási eset | ❌ Erre nem való |
| Többfős csapat | ✅ Több fiókra érvényes engedélyezési lista | ⚠️ Csak a munkamenet tulajdonosa használhatja |
| Fájlok távol tartása az Anthropic felhőjétől | ✅ Csak szöveg az MCP-n keresztül | ✅ Itt is csak szöveg |
Én így osztom fel a használatukat: Channels aszinkron munkához, amikor távol vagyok a laptopomtól, CI-értesítésekhez és integrációkhoz. Remote Control, amikor látnom kell, mit csinál a Claude, vagy jóvá kell hagynom egy kockázatos lépést.
Egyszerre is használhatod mindkettőt. A Telegram-bot gyors csatornát ad a „kérdezek és választ kapok” helyzetekhez; a Remote Control pedig a „fontos dolgok vezérléséhez” kínál felületet. Ugyanazt a Claude-keretet használják.
GYIK
Főbb pontok
Hét gyakori kérdés a Channelsről: több bot csatlakoztatása, mi történik a terminál bezárásakor, webhookok fogadása a CI-tól, Telegram vagy Discord, a Team csomag korlátozásai, mit láthat a Claude a telefonodról, és az ingyenes csomag. További anyagokat találsz az Ailoot dokumentációjában.
Egyszerre több botot is csatlakoztathatok?
Igen. A --channels kapcsoló szóközzel elválasztott listát fogad el: --channels plugin:telegram@claude-plugins-official plugin:discord@claude-plugins-official. Egy Claude-munkamenet mindkét csevegésben válaszol.
Mi történik, ha bezárom a terminált?
A munkamenet bezárul, a plugin leáll, a bot pedig elhallgat. VPS-en a munkamenet tovább fut a systemd-ben. Helyi gépen csukd le a laptopot, és a claude néhány másodpercen belül SIGHUP-pal megszakad.
Kaphatok értesítéseket a CI-tól vagy a Sentrytől?
Igen. A Channels kétirányú csatorna. Írhatsz saját plugint, amellyel webhookokat továbbíthatsz a munkamenetnek a Channels Referencia használatával. A Claude valós időben látja az eseményeket, és válaszol rájuk.
Korlátozottabb a Telegram a Discordnál valamiben?
Az alapvető képességeik azonosak. A Discord botbeállításaiban engedélyezni kell a Message Content Intentet. Az iMessage csak macOS-en működik, és közvetlenül olvassa a ~/Library/Messages/chat.db adatbázist. A Telegram mindenhol használható.
Mit kell tennem, ha Team csomagom van?
A szervezet adminisztrátorának engedélyeznie kell a channelsEnabled: true beállítást a felügyelt beállításokban vagy az admin-settings/claude-code oldalon. Enélkül a plugin csatlakozik, de az üzenetek nem jutnak át—indításkor figyelmeztetés jelenik meg a terminálban.
Mit láthat a Claude a telefonomról—magát a Telegram-csevegést is?
Nem. A Claude csak azt az üzenetet látja, amelyet a botnak küldtél. A Telegram-beszélgetéseid előzményei, a csevegéslistád és a névjegyeid nem érhetők el. Az MCP-plugin kizárólag a botnak küldött üzeneteket olvassa a Telegram Bot API-n keresztül.
Futtathatom a Claude-ot a Channelsszel Pro/Max-előfizetés nélkül?
Igen, Anthropic Console API-kulcs is támogatott; az API-használatot annak a Console-szervezetnek számlázzák. Az ingyenes claude.ai csomag nem az itt tárgyalt előfizetéses út. Team/Enterprise és felügyelt Console-szervezeteknél a csatornaengedélyezési beállításoknak is teljesülniük kell.
Mi következik?
Főbb pontok
A bot be van állítva, az engedélyezési lista aktív, a munkamenet pedig egy VPS-en fut. Ezután építsd be a Channelst a napi rutinodba: csatlakoztass webhookokat a GitHub Actionsből és a Sentryből, társítsd a Routines szolgáltatással a rendszeres feladatokhoz, és állíts be botállapot-figyelőt. Mindegyik lépés 15–30 percet vesz igénybe, és megszüntet egy megfigyelhetőségi rést.
Ha a bot már megbízhatóan működik, néhány további lépéssel a legtöbbet hozhatod ki a Channelsből:
- Csatlakoztass webhookokat a CI-ból. Ha GitHub Actionst / GitLab CI-t használsz, beállíthatod a Channels plugint, hogy közvetlenül a munkamenetnek továbbítsa a build eredményeit. A Claude rögtön a push után látja a „teszt sikertelen” üzenetet, és javítást javasol. Lásd a channels-reference dokumentációt.
- Társítsd a Routines szolgáltatással. Ugyanabban a munkamenetben rendszeres feladatokhoz a Routines is futtatható. Reggel a bot magától elküldi, hogy „jó reggelt, itt a projekt összefoglalója”, te pedig a telefonodról válaszolsz: „készíts bevételi jelentést”.
- Állíts be botfigyelőt. Ha a bot elhallgat, tudni szeretnék róla. Egy kis cron-szkript óránként egyszer ellenőrzi a Telegram-botot a VPS-en. Ha a bot nem válaszol, riasztást küld egy külön csatornára. Enélkül a bot hajnali 4-kor leállhat, és csak délben vennéd észre.
- Fontold meg a hooks használatát. A hookok a Claude eseményeire reagálnak (eszköz elindult, üzenet befejeződött). A hookok és a Channels együtt automatikus Telegram-értesítéseket tesznek lehetővé, például: „A Claude befejezte az N feladatot.”
Ne próbálj mindenhova Channelst illeszteni. Kényelmes módja annak, hogy útközben vagy egy kávézóban felzárkózz egy feladattal. Ha valóban gondolkodnod kell, nyisd ki a laptopodat, és ülj le elé. A Channels megszabadít attól a gondolattól, hogy „ó, ezt még meg kell kérdeznem tőle, ki kell nyitnom a laptopot”, amikor úton vagy.
Források
- Események küldése egy futó munkamenetbe a channels segítségével - Claude Code dokumentáció
- anthropics/claude-plugins-official a GitHubon - a Telegram-, Discord-, iMessage- és fakechat-bővítmények forráskódja
- Helyi munkamenetek folytatása bármely eszközről a Remote Control segítségével - Claude Code dokumentáció
Az eszközökkel való munkáról további anyagokat az Ailoot dokumentációjában találsz.
További részletek
Kérdések és válaszok: Hogyan irányítsd a Claude Code-ot a telefonodról Telegramon keresztül 2026-ban
Miért működik kézzel a Telegram-bot, szolgáltatásként pedig nem?
A szolgáltatás Unix-felhasználóját, HOME-ját, munkaterületét, Claude-futtatható útvonalát, Bun-PATH-ját és hitelesítési környezetét vesd össze a sikeres interaktív futással. Ugyanazon szolgáltatásfelhasználó alatt telepíts, állíts be és párosíts; root plugin- és párosítási állapota más konfiguráció.
Helyettesítheti Console API-kulcs a Pro- vagy Max-belépést Channelsnél?
Igen. Az Anthropic Console API-kulcsos hitelesítés támogatott, és Console API-számlázást használ. Szükség esetén ellenőrizd a szervezeti csatornabeállításokat, a tokenbeállítást, párosítást és küldőengedélylistát pedig a munkamenetet futtató fiók alatt fejezd be.