Näin ohjaat Claude Codea puhelimellasi Telegramin kautta vuonna 2026
MarkdownVaihe vaiheelta: luo Telegram-botti, asenna Claude Code Channels -lisäosa, suojaa se sallittujen luettelolla ja aja sitä VPS:llä ympäri vuorokauden. Helposti seurattava opas komentoineen.
Lue koko artikkeli
Tärkeimmät kohdat
Claude Code Channels on Anthropicin virallinen lisäosa 20. maaliskuuta 2026 alkaen. Luo botti BotFatherin kautta, asenna lisäosa yhdellä komennolla, käynnistä Claude uudelleen --channels-lipulla ja lähetä botille viestejä puhelimestasi. Claude lukee ne suoraan paikallisessa istunnossasi, kirjoittaa koodia tiedostoihisi ja vastaa Telegramissa. Jos haluat sen toimivan ympäri vuorokauden, siirrä istunto omalle VPS:llesi ja ota se käyttöön systemd:llä.
Lisää oppaita työkalujen määrittämiseen löydät Ailoot-dokumentaatiosta.
Mikä Claude Code Channels on ja miksi tarvitset sitä
Tärkeimmät kohdat
Channels on MCP-lisäosa, joka välittää viestit Telegramista, Discordista tai iMessagesta jo käynnissä olevaan Claude Code -istuntoon. Istunto näkee viestin tavallisena käyttäjän pyyntönä, käsittelee paikallisia tiedostojasi ja vastaa samassa chatissa. Kannettava tietokoneesi pysyy käynnissä, kun hoidat asioita puhelimellasi.
Anthropic julkaisi Claude Code Channelsin 20. maaliskuuta 2026. Se on virallinen lisäosa Claude-istunnon yhdistämiseen viestisovelluksiin. Tuettuja ovat Telegram, Discord ja iMessage. Ominaisuus on tutkimusesikatselussa: dokumentaatio löytyy osoitteesta code.claude.com/docs/en/channels, ja lisäosan lähdekoodi on avoimessa repositoriossa anthropics/claude-plugins-official.
Lyhyesti sanottuna kyseessä on ”chat-silta” puhelimesi ja Claude Code -istuntosi välillä. Lähetän botille viestin: ”Jatka hinnoitteluruudukon uudelleenkirjoittamista; päivitä seuraavan ryhmän päivämäärät tiedostossa business/products/practicum/README.md”, ja botti välittää viestin VPS:lläni olevalle istunnolle. Claude hakee asiayhteyden, muokkaa tiedostoa, tekee muutoksista commitin ja vastaa Telegramissa: ”Valmis, tarkista commit.” Kannettava tietokone on kiinni kotona.
⚠️ Tutkimusesikatselun tärkein rajoitus: Channels on MCP-silta. Istunnon on oltava käynnissä koneellasi tai VPS:lläsi. Kun istunto on suljettu, kukaan ei vastaanota viestejä. Siksi ympärivuorokautinen käyttö on määritettävä erikseen (katso VPS-osio alta).
Miten Channels eroaa muista etätyötavoista
Anthropic vertailee vaihtoehtoja suoraan virallisessa dokumentaatiossaan. Tässä on muokattu versio vertailusta:
| Ominaisuus | Mitä se tekee | Milloin se kannattaa valita |
|---|---|---|
| Claude Code verkossa | Suorittaa tehtävän uudessa pilvihiekkalaatikossa ja kloonaa repositorion GitHubista | Anna itsenäinen taustatehtävä jonkun hoidettavaksi ja tarkista tilanne myöhemmin |
| Slack-integraatio | Käynnistää verkkoversion istunnon viestiketjussa, kun siinä mainitaan @Claude | Aloita tehtäviä suoraan tiimin keskusteluista |
| MCP-palvelin (tavallinen) | Claude kutsuu sitä tehtävän aikana; se ei työnnä mitään istuntoon | Anna Claudelle tarvittaessa pääsy ulkoisiin järjestelmiin |
| Remote Control | Ohjaat paikallista istuntoa claude.ai:n tai mobiilisovelluksen kautta | Käytä olemassa olevaa istuntoa puhelimen näytöltä käsin |
| Channels ⭐ | Työntää muiden kuin Claude-lähteiden tapahtumat jo käynnissä olevaan paikalliseen istuntoon | Kysy jotakin puhelimestasi ja saa vastaus chattiin; vastaanota webhook CI:stä |
Channelsin ja Remote Controlin suurin ero on tämä: Remote Control tekee ”puhelimestasi ikkunan päätteen näkymään” – näet kirjaimellisesti kohdistimen ja painat painikkeita. Channels on chatbot, jonka aivot ovat paikallinen Claude-istuntosi. Remote Controlilla katson päätettä. Channelsilla lähetän viestin jollekin, joka lukee tiedostojani.
Jos tarvitset täyden hallinnan näytöltä, käytä Remote Controlia. Jos haluat ”lähettää kysymyksen, jatkaa päivääsi ja saada vastauksen myöhemmin”, käytä Channelsia. Käytän molempia: Remote Controlia, kun minun täytyy hyväksyä kriittisiä muutoksia, ja Channelsia, kun luotan tehtävään ja haluan iltani takaisin.
Mitä tarvitset ennen aloittamista
Tärkeimmät kohdat
Claude Code v2.1.80 tai uudempi, tuettu claude.ai-todennus tai Anthropic Consolen API-avain, asennettu Bun ja pääsy Telegramiin. Ympärivuorokautiseen käyttöön tarvitset Ubuntua tai Debiania käyttävän VPS:n. Kaikki toimii samalla tavalla macOS:ssä, Linuxissa ja WSL:ssä.
Tarkista tämä luettelo ennen komentojen suorittamista:
- Anthropic-tili. Tarvitset tuetun claude.ai-tilauksen tai erikseen laskutettavan Anthropic Consolen API-pääsyn. Maksuton claude.ai-taso ei ole tässä kuvattu tilausreitti. Myös Anthropic Consolen API-avain toimii. Jos Console-organisaatio käyttää hallittuja asetuksia, tarkista kanavien käyttöönotto siellä.
- Claude Code v2.1.80 tai uudempi. Tarkista versio komennolla
claude --version. Jos se on vanhempi, päivitä komennollaclaude updatetainpm install -g @anthropic-ai/claude-code@latest. - Bun. Channels-lisäosat ovat Bun-skriptejä, eivät Node-skriptejä. Tarkista versio komennolla
bun --version. Jos Bunia ei ole asennettu, suoritacurl -fsSL https://bun.sh/install | bashja sittensource ~/.bashrc. - Telegram-tili. Mikä tahansa tili käy; tärkeintä on, että olet kirjautunut puhelimellasi.
- Jos käytössäsi on Team/Enterprise-paketti, pyydä järjestelmänvalvojaasi ottamaan
channelsEnabledkäyttöön hallituissa asetuksissa tai osoitteessa admin-settings/claude-code. Ominaisuus on organisaatioissa oletusarvoisesti poissa käytöstä.
Älä huoli Bunista, jos kuulet siitä ensimmäistä kertaa. Bun on vaihtoehtoinen JavaScript-ympäristö, kuten Node. Anthropic valitsi sen Channels-lisäosille, koska se käynnistyy nopeammin ja on helpompi paketoida yhdeksi binääritiedostoksi. Asenna se kerran ja unohda koko asia.
⚠️ Channels ei vielä toimi yrityskäyttöön tarkoitetuilla Bedrockin / Google Vertexin / Azure Foundryn versioilla. Se toimii vain claude.ai-todennuksella tai Anthropic Consolen kautta.
Vaihe 1. Luo Telegram-botti BotFatherin kautta
Tärkeimmät kohdat
Avaa Telegramissa @BotFather, lähetä komento /newbot, valitse nimi ja käyttäjänimi (käyttäjänimen on päätyttävä sanaan bot) ja saat tokenin muodossa 12345678:AAH.... Pidä token turvassa: se on bottisi salasana. Kuka tahansa, joka näkee sen, voi kirjoittaa bottinasi ja mahdollisesti siepata Claudeen lähettämäsi viestit.
BotFather hoitaa kaiken puolestasi – sinun tarvitsee vain painaa viittä painiketta. Toimi näin:
- Avaa Telegramissa @BotFather (voit käyttää puhelintasi; myös loput määrityksistä voi tehdä puhelimella).
- Paina ”Start”, jos tämä on ensimmäinen kertasi.
- Lähetä komento
/newbot. - BotFather kysyy: ”Alright, a new bot. How are we going to call it?” Anna botille näyttönimi, esimerkiksi
Oma avustaja - Claude Code. - Seuraavaksi se pyytää käyttäjänimeä. Sen on oltava ainutlaatuinen Telegramissa ja päätyttävä sanaan
bot. Esimerkiksimy_claude_bottaimy_dev_bot. - BotFather vastaa suunnilleen tällaisella viestillä:
Done! Congratulations on your new bot. You will find it at
'<OFFICIAL_URL>'.
Use this token to access the HTTP API:
1234567890:AAHzlAU...
Keep your token secure and store it safely, it can be used by anyone to control your bot.
Kopioi token. Tarvitset sitä kahden minuutin kuluttua.
⚠️ Tokenin turvallisuus. Bottitoken antaa täydet oikeudet bottiin. Jos se vuotaa, kuka tahansa voi kirjoittaa bottinasi ja mahdollisesti siepata Claudeen lähettämäsi viestit. Älä julkaise tokenia repositorioissa, liitä sitä koodiin tai lähetä sitä chateissa. Tallennan tokenit tiedostoon ~/.claude/channels/telegram/.env; lisäosa tallentaa sen sinne seuraavassa vaiheessa.
Vaihe 2. Asenna Telegram-lisäosa Claude Codeen
Tärkeimmät kohdat
Käynnistä Claude Code tavalliseen tapaan ja kirjoita sitten istunnossa /plugin install telegram@claude-plugins-official. Jos lisäosaa ei löydy, lisää ensin virallinen marketplace komennolla /plugin marketplace add anthropics/claude-plugins-official. Asennuksen jälkeen suorita /reload-plugins, jotta lisäosan komennot aktivoituvat nykyisessä istunnossa.
Avaa pääte missä tahansa kansiossa, jossa yleensä työskentelet Clauden kanssa, ja suorita:
claude
Kirjoita kauttaviivakomento istunnossa:
/plugin install telegram@claude-plugins-official
Jos Claude vastaa ”Plugin not found in any marketplace”, asiakasohjelmasi ei tunne virallista marketplacea. Lisää se:
/plugin marketplace add anthropics/claude-plugins-official
Tai päivitä se, jos olet lisännyt sen aiemmin:
/plugin marketplace update claude-plugins-official
Kun asennus on onnistunut, lataa lisäosat uudelleen niiden komentojen aktivoimiseksi:
/reload-plugins
Nyt käytettävissäsi pitäisi olla kauttaviivakomentoja, kuten /telegram:configure ja /telegram:access. Tarkista asia kirjoittamalla /help; luettelossa pitäisi olla telegram-osio.
Vaihe 3. Yhdistä token lisäosaan
Tärkeimmät kohdat
Kirjoita Claude-istunnossa /telegram:configure <token> ja käytä vaiheen 1 tokenia. Komento tallentaa sen tiedostoon ~/.claude/channels/telegram/.env (johon vain käyttäjälläsi on pääsy). Vaihtoehtoisesti voit määrittää TELEGRAM_BOT_TOKEN-ympäristömuuttujan komentotulkissa ennen Clauden käynnistämistä. Tuotannossa käytän toista vaihtoehtoa: sitä on helpompi hallita systemd:n kautta, eikä ~/.claude/ päädy vahingossa repositorioon.
Claude-istunnossa:
/telegram:configure 1234567890:AAHzlAU...
Komento tallentaa tokenin tiedostoon ~/.claude/channels/telegram/.env. Tiedosto on vain käyttäjäsi käytettävissä (chmod 600), joten siitä ei tarvitse huolehtia.
Voit myös määrittää tokenin ympäristömuuttujan avulla. Tämä on hyödyllistä, jos otat Clauden käyttöön systemd:llä tai Dockerilla etkä halua käyttää vuorovaikutteisia komentoja:
export TELEGRAM_BOT_TOKEN="1234567890:AAHzlAU..."
claude --channels plugin:telegram@claude-plugins-official
⚠️ Tuotannossa käytän aina ympäristömuuttujia kotihakemistoni ~/ .env-tiedoston sijaan. Näin salaisuuksia on helpompi hallita systemd:n kautta (Environment=TELEGRAM_BOT_TOKEN=...), eikä ~/.claude/ päädy vahingossa repositorioon.
Vaihe 4. Käynnistä Claude uudelleen --channels-lipulla
Tärkeimmät kohdat
Poistu istunnosta (exit tai Ctrl+D) ja käynnistä se sitten uudelleen lipulla --channels plugin:telegram@claude-plugins-official. Lippu ottaa lisäosan käyttöön ja käskee Clauden hakea uusia viestejä Telegram APIsta. Ilman lippua botti on olemassa mutta pysyy hiljaa – lisäosa ei ole aktiivinen eikä viestien haku ole käynnissä.
Tämä on tärkein asia ja ensimmäisellä kerralla kohta, johon kaikki kompastuvat. Pelkkä lisäosan asennus ei riitä. Jotta botti todella alkaa vastaanottaa viestejä, Claude on käynnistettävä nimenomaisella lipulla:
claude --channels plugin:telegram@claude-plugins-official
Ilman lippua istunto toimii tavalliseen tapaan, mutta Telegram-lisäosa ei ole aktiivinen. Lipun kanssa Claude käynnistää lisäosan MCP-palvelimen, alkaa hakea päivityksiä Telegram APIsta ja vastaa botille lähetettyihin viesteihin.
Käynnistämisen jälkeen päätteessä pitäisi näkyä jotakin tämänkaltaista:
✻ Welcome to Claude Code 2.1.80
Channels: telegram@claude-plugins-official (active)
Polling for messages...
Jos channels-rivi puuttuu, lippua ei ole luettu. Tarkista, että Claude Code on versiota 2.1.80+ ja että lisäosa on todella asennettu (/plugin list istunnon sisällä).
⚠️ Kätevä vinkki. Lisäsin aliaksen tiedostoon ~/.zshrc:
alias claude-tg="claude --channels plugin:telegram@claude-plugins-official"
Sen jälkeen suoritan vain komennon claude-tg. Voit antaa useita lisäosia välilyönneillä erotettuina: --channels plugin:telegram@... plugin:discord@....
Vaihe 5. Parita tili ja estä kaikki muut
Tärkeimmät kohdat
Avaa bottisi Telegramissa ja lähetä sille mikä tahansa viesti. Botti vastaa kuusinumeroisella parituskoodilla. Palaa päätteelle ja kirjoita /telegram:access pair <code>. Rajoita sitten käyttöä sallittujen luettelolla: /telegram:access policy allowlist. Hyväksy vain niiden henkilöiden parituskoodit, jotka haluat valtuuttaa. Lähettäjien sallittujen lista hallitsee pääsyä istuntoon.
Tässä vaiheessa on kyse turvallisuudesta. Hyväksytty lähettäjä voi pyytää Claudea toimimaan istunnon tiedostoilla ja työkaluilla. Parita vain tarkoitettu tili ja lukitse lähettäjäkäytäntö ennen bottiin tukeutumista.
Toimi näin:
- Avaa bottisi Telegramissa. Etsi se käyttäjänimellä
@my_claude_bottai BotFatherin vastauksessa olevasta linkistä. Paina ”Start”. - Lähetä botille mikä tahansa viesti. Esimerkiksi
hi. - Botti vastaa parituskoodilla. Se näyttää suunnilleen tältä:
Hi! To pair this account, run in your Claude Code session:
/telegram:access pair 847291
This code is valid for 5 minutes.
- Palaa päätteelle. Kirjoita vastauksessa annettu komento Claude-istunnossasi:
/telegram:access pair 847291
Claude vastaa: ”Tili paritettu.” Nyt Telegram-tilisi voi lähettää komentoja.
- Ota sallittujen luettelo käyttöön. Se estää kaikki tilit, joita ei ole jo paritettu:
/telegram:access policy allowlist
Tämän jälkeen muilta tileiltä tulevat viestit ohitetaan äänettömästi. Ne eivät näy päätteessä, eikä botti vastaa – aivan kuin niitä ei olisi koskaan ollutkaan.
⚠️ On erittäin tärkeää ottaa sallittujen luettelo käyttöön heti parituksen jälkeen. Älä jätä sitä myöhemmäksi. Älä hyväksy tuntemattomia parituspyyntöjä käyttöönotossa tai oleta onnistuneen vastauksen todistavan lähettäjäkäytännön oikeaksi. Ensimmäisellä kerralla bottini oli kymmenen minuuttia ilman sallittujen luetteloa, ja kaksi satunnaista Telegram-käyttäjää ehti lähettää sinä aikana ”hi”. Onneksi en silloin sallinut komentojen kirjoittaa tiedostoihin.
Jos sinun täytyy lisätä joku toinen (esimerkiksi projektikumppani):
/telegram:access pair <code from their account>
Hänen täytyy ensin viestittää botille, saada koodi ja lähettää se sinulle. Vain tällä tavalla voit lisätä hänet.
Lisää oppaita on Ailoot-dokumentaatiossa.
Clauden ympärivuorokautinen käyttö omalla VPS:llä
Tärkeimmät kohdat
Paikallinen istunto toimii, kun kannettava tietokoneesi on auki; sulje kansi, niin botti hiljenee. Jos haluat Clauden vastaavan milloin tahansa, siirrä istunto omalle VPS:llesi: asenna Claude Code ja Bun, todenna sekä asenna ja parita plugin samalla erillisellä Unix-käyttäjällä ja määritä istunto systemd-palveluksi, joka käynnistyy automaattisesti uudelleen. Coolify-palvelin selviytyy tehtävästä ongelmitta.
Jos haluat botin olevan ”elossa ympäri vuorokauden” sen sijaan, että ”avaat kannettavan tunniksi ja näprää töitä”, istunnon täytyy pysyä käynnissä. Paikallisesti voit käyttää tmuxia, mutta VPS on yksinkertaisempi ja luotettavampi.
Eräässä esimerkkikokoonpanossa käytetään Coolify-VPS:ää, joka isännöi myös verkkosivustoa (lisätietoja Coolify-julkaisuoppaassa). Voit käyttää samaa palvelinta – Claude käyttää vain vähän muistia. Jos sinulla ei ole VPS:ää, hanki halvin mahdollinen 4–5 eurolla kuussa, esimerkiksi Hetzner CX11 / Yandex Cloud / Selectel.
Vaihe 1: Asenna järjestelmä VPS:lle
Luo ensin erillinen Unix-tili ja työtila ylläpitäjänä. Käytä olemassa olevaa tiliä vain tarkistettuasi sen kotihakemiston ja omistajuuden:
sudo useradd --create-home --shell /bin/bash claude
sudo install -d -o claude -g claude /home/claude/workspace
sudo -iu claude
Jatka tässä claude-kirjautumiskomentotulkissa, älä rootin kotihakemistossa. Asenna Bun sen virallisella asentimella ja Claude Code natiivilla asennusmenettelyllä:
curl -fsSL https://bun.sh/install | bash
curl -fsSL https://claude.ai/install.sh | bash
Avaa samalle käyttäjälle uusi kirjautumiskomentotulkki, jotta asenninten PATH-muutokset tulevat käyttöön. Tarkista tili ja ohjelmapolut:
whoami
printf '%s\n' "$HOME"
command -v bun
command -v claude
bun --version
claude --version
cd /home/claude/workspace
claude
whoami-komennon pitää tulostaa claude ja HOME-arvon olla /home/claude. Kirjaa command -v -komentojen palauttamat täydet polut. Käytä todellista Claude-polkua ExecStart-rivillä ja sisällytä Bun-hakemisto palvelun PATHiin. Pysähdy, jos jompikumpi ohjelma puuttuu.
Vaihe 2: Todenna, asenna ja parita palvelukäyttäjänä
Viimeistele kirjautuminen tässä samassa interaktiivisessa claude-istunnossa. Toista sitten edellä olevat vaiheet 2–5 tällä Unix-käyttäjällä: asenna Telegram-plugin käyttäjärajaukseen, määritä token, käynnistä uudelleen valitsimella --channels, parita Telegram-tilisi ja aseta policy allowlist. Testaa viesti ja vastaus ennen palvelun määritystä. Älä kopioi rootin Claude-asetuksia tai tunnistetietoja tähän kotihakemistoon.
Sekä claude.ai-tilaustodennus että Anthropic Consolen API-avain ovat tuettuja. Team/Enterprise tarvitsevat organisaation käyttöönoton; hallittujen Console-organisaatioiden pitää myös täyttää kanava-asetukset. Console-pääsy laskutetaan API-käyttönä claude.ai-tilauksen sijaan. Säilytä valittu tili ja todennustapa samoina interaktiivisesta komentotulkista palveluun siirryttäessä.
Vaihe 3: Kytke istunto systemd-palveluun
Poistu palvelukäyttäjän komentotulkista ja luo yksikkö ylläpitäjänä. Alla oleva yksikkö olettaa polkutarkistusten palauttaneen /home/claude/.local/bin/claude ja /home/claude/.bun/bin/bun. Korvaa ne todellisilla tuloksilla, jos ne eroavat. Anna sama valittu todennusympäristö ja bottitoken, pidä yksikkö vain ylläpitäjän luettavana äläkä commitoi salaisuuksia. Luo palvelutiedosto automaattista käynnistystä ja kaatumisen jälkeistä uudelleenkäynnistystä varten:
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
Tässä ovat käyttöön ottamani asetukset:
Type=simple– yksinkertainen toimintatila; systemd katsoo prosessin käynnistyneen heti, kun se käynnistyy.User=claude– toimii erillisenä käyttäjänä, ei root-käyttäjänä. Turvallisempaa.WorkingDirectory=/home/claude/workspace– valmisteltu palvelukäyttäjän omistama työtila. Sijoita tarkoitettu repositorio sinne ennen käynnistystä. Älä jätä rootin omistamaa kloonia tai suorita rootin kotihakemistosta.Environment=TELEGRAM_BOT_TOKEN=...– token välitetään suoraan prosessille..env-tiedostoa ei tarvita.--dangerously-skip-permissions– välttämätön valvomattomassa käytössä. Ilman lippua Claude odottaa päätteen ääressä vastaustasi ”kyllä/ei” ennen jokaista toimintoa, ja istunto jumittuu. Sallittujen luettelo tunnistaa lähettäjät. Se ei tee heidän pyytämistään komennoista turvallisia. Käytä ohitusta vain eristetyssä ympäristössä tarkoituksella rajatuilla tiedostoilla, tunnistetiedoilla ja verkkopääsyllä.Restart=on-failure– jos prosessi kaatuu (Claude kaatuu tai verkkoyhteys katkeaa), systemd käynnistää sen uudelleen 10 sekunnin kuluttua.
Näytä lokit komennolla:
journalctl -u claude-code -f
Jos jokin menee pieleen, journalctl -u claude-code -n 100 näyttää viimeiset 100 riviä.
Vaihe 4: Tarkista, että botti toimii
Käynnistä palvelu vasta interaktiivisen määrityksen tuotettua oikea Telegram-vastaus. Lähetä sitten samaan bottiin vaaraton viesti paritetulta tililtä ja varmista sekä vastaus että palvelulokit. Jos se toimii interaktiivisesti mutta ei systemd:ssä, vertaa ensin Unix-käyttäjää, HOMEa, työtilaa, ohjelmapolkua, PATHia ja todennusympäristöä.
Pysäytä palvelu myöhempiä paritusmuutoksia varten, suorita sudo -iu claude, siirry hakemistoon /home/claude/workspace ja käynnistä sama kanava interaktiivisesti. Parita ja ota sallittujen luettelo käyttöön siellä, poistu ja käynnistä palvelu uudelleen. Älä aja samalle botille kahta polleria yhtä aikaa. journalctl lukee lokeja eikä tarjoa interaktiivista Claude-kehotetta.
Viisi sudenkuoppaa tuotantopalvelimella ja niiden välttäminen
Tärkeimmät kohdat
Kokosin sudenkuopat viikon tuotantokäyttöönottojen aikana: systemd ei löydä Bunia, long polling lakkaa toimimasta pitkän käyttämättömyyden jälkeen, Max-paketin rajat tulevat vastaan kesken päivän, --dangerously-skip-permissions voi johtaa tietovuotoon ja sallittujen luettelo unohtuu uudelleenasennuksessa. Jokaisen voi korjata yhden rivin asetuksella, mutta jos et tiedä näistä ongelmista, törmäät niihin parin päivän kuluessa.
1. Bun ei ole systemd:n PATH-muuttujassa
systemd käynnistää prosessit minimaalisessa ympäristössä: se ei näe tiedoston ~/.bashrc muuttujia. Jos asensit Bunin vain rootin kotihakemistoon mutta palvelutiedostossa on User=claude, palvelu ei peri tätä asennusta tai rootin komentotulkin PATHia.
Ratkaisu. Asenna Bun joko koko järjestelmälle (/usr/local/bin/bun) tai välitä PATH erikseen:
Environment="PATH=/home/claude/.bun/bin:/usr/local/bin:/usr/bin:/bin"
2. Istunto menettää TCP-yhteyden Telegram APIin pitkän käyttämättömyyden jälkeen
Kun botti on ollut käyttämättä 6–12 tuntia, se saattaa ”hiljentyä” – viestit lähtevät Telegramiin, mutta lisäosa ei vastaanota niitä. Tämä johtuu long pollingin omituisuudesta.
Ratkaisu. Lisää systemd:hen säännöllinen uudelleenkäynnistys (24 tunnin välein):
Restart=always
RuntimeMaxSec=86400
Tai määritä cron-työ: 0 5 * * * systemctl restart claude-code (uudelleenkäynnistys aamulla kello 5).
3. Claude Max -käyttörajat tulevat vastaan kesken päivän
Jos käytät Claudea paljon Telegramin kautta, Max 5x -paketin (~$100/kuukausi) raja voi tulla vastaan 4–6 tunnissa. Telegram-pyynnöt eivät eroa tavallisessa päätteessä tehdyistä pyynnöistä, vaan ne kuluttavat samaa käyttöbudjettia.
Ratkaisu. Aseta muistutus: ”Botti ei vastaa – tarkista /stats.” Jos raja tulee vastaan, odota sen nollautumista tai päivitä Max 20x -pakettiin ($200/kuukausi). Tokenien säästöoppaasta ja Sonnet- ja Opus-mallien vertailuoppaasta voi olla apua.
4. --dangerously-skip-permissions on vaarallinen myös sallittujen luettelon kanssa
Tämä lippu poistaa kaikki vahvistukset käytöstä. Kaikki Telegramissa antamasi komennot suoritetaan kysymättä: tiedostojen poistaminen, ulkoisten pyyntöjen lähettäminen, mitä tahansa. Kerran pyysin Claudea ”poistamaan tarpeettomat console.log-lauseet”, ja siivousintonsa vallassa Claude pyyhki pois puolet tuotantoskriptin virheenjäljityslokeista. Palautin ne gitillä, mutta vahinko oli jo tapahtunut.
Ratkaisu. Älä ota --dangerously-skip-permissions-lippua käyttöön, jos työskentelet kriittisen projektin parissa. Käytä sen sijaan Remote Controlia istuntojen suorittamiseen – käyttöoikeuskyselyt tulevat puhelimeesi, ja hyväksyt ne itse. Channels ja --dangerously-skip-permissions sopivat luonnoksiin, refaktorointiin ja testeihin.
5. Sallittujen luettelo ”lakkaa toimimasta” uudelleenasennuksen jälkeen
Sallittujen luettelo tallennetaan hakemistoon ~/.claude/channels/telegram/. Jos siirryt uudelle VPS:lle, asennat Clauden uudelleen tai vaihdat käyttäjää, vanhoja paritustietoja ei oteta käyttöön. Vanha lähettäjien sallittujen lista puuttuu. Älä oleta uuden instanssin käyttävän aiempaa pääsykäytäntöä.
Ratkaisu. Varmuuskopioi ~/.claude/channels/telegram/ ennen siirtymää. Palauta se siirtymän jälkeen. Tai parita uudelleen heti uudelleenasennuksen jälkeen, äläkä anna kulua edes minuuttia botin käynnistämisen ja policy allowlist -asetuksen käyttöönoton välillä.
Channels vai Remote Control – kumpi kannattaa valita?
Tärkeimmät kohdat
Channelsin kautta Claude-istuntosi vastaa chatissa, ja sinä lähetät kehotteita puhelimestasi. Remote Control näyttää päätteen puhelimessasi, ja ohjaat istuntoa painikkeilla. Channels on kätevämpi, kun haluat ”kysyä ja jatkaa matkaa”, kun taas Remote Control sopii kriittisiin vaiheisiin, joissa sinun täytyy nähdä mitä Claude tekee ja hyväksyä jokainen riskialtis toiminto.
Anthropic julkaisi molemmat ominaisuudet lähes samaan aikaan: Remote Controlin 25. helmikuuta 2026 ja Channelsin 20. maaliskuuta 2026. Ne eivät tee samaa asiaa vaan ratkaisevat eri ongelmia.
| Tilanne | Channels | Remote Control |
|---|---|---|
| Kysy ”mitkä commitit tehtiin eilen?”, kun olet poissa | ✅ Ihanteellinen | Liioiteltua – tarvitset koko näytön |
| Hyväksy tiedostomuutos | ⚠️ Sokea hyväksyntä --dangerously-skip-permissions-lipulla | ✅ Näet, mitä Claude aikoo tehdä |
| Käytä Claudea ympäri vuorokauden | ✅ VPS + systemd-määritys | ⚠️ Edellyttää, että kannettava tietokone pysyy auki |
| Lähetä vain pari kehotetta puhelimestasi | ⚠️ Liioiteltua – botti, token, lisäosa | ✅ Yksi QR-koodi |
| Vastaanota webhook CI:stä / Sentrystä | ✅ Luonteva käyttötapaus | ❌ Ei tähän tarkoitukseen |
| Usean henkilön tiimi | ✅ Usean tilin sallittujen luettelo | ⚠️ Vain istunnon omistaja |
| Pidä tiedostot poissa Anthropicin pilvestä | ✅ Vain tekstiä MCP:n kautta | ✅ Tässäkin vain tekstiä |
Jaan käyttötavat näin: Channels sopii asynkroniseen työhön, kun olen poissa koneelta, CI-ilmoituksiin ja integraatioihin. Remote Control sopii tilanteisiin, joissa minun täytyy nähdä, mitä Claude tekee, tai hyväksyä riskialtis vaihe.
Voit käyttää molempia samanaikaisesti. Telegram-botti tarjoaa nopean kanavan, jolla voit ”kysyä ja saada vastauksen”; Remote Control tarjoaa kanavan ”kriittisten asioiden ohjaamiseen”. Ne kuluttavat samaa Claude-käyttörajaa.
Usein kysyttyä
Tärkeimmät kohdat
Seitsemän yleistä Channels-kysymystä: useiden bottien yhdistäminen, mitä tapahtuu, kun suljet päätteen, webhookit CI:stä, Telegramin ja Discordin erot, Team-paketin rajoitukset, mitä Claude näkee puhelimestasi ja ilmainen paketti. Lisää oppaita löydät Ailoot-dokumentaatiosta.
Voinko yhdistää useita botteja samanaikaisesti?
Kyllä. --channels-lippu hyväksyy välilyönneillä erotetun luettelon: --channels plugin:telegram@claude-plugins-official plugin:discord@claude-plugins-official. Yksi Claude-istunto vastaa molemmissa chateissa.
Mitä tapahtuu, jos suljen päätteen?
Istunto sulkeutuu, lisäosa pysähtyy ja botti hiljenee. VPS:llä istunto jatkaa toimintaansa systemd:ssä. Paikallisella koneella kannettavan tietokoneen sulkeminen katkaisee claude-yhteyden SIGHUP-signaalilla muutamassa sekunnissa.
Voinko saada ilmoituksia CI:stä tai Sentrystä?
Kyllä. Channels on kaksisuuntainen kanava. Voit kirjoittaa oman lisäosan, joka välittää webhookit istuntoon Channels Referencen avulla. Claude näkee tapahtumat reaaliajassa ja vastaa niihin.
Onko Telegram joiltakin osin rajoitetumpi kuin Discord?
Perustoiminnot ovat samat. Discord edellyttää Message Content Intent -asetusta botin määrityksissä. iMessage toimii vain macOS:ssä ja lukee suoraan tietokantaa ~/Library/Messages/chat.db. Telegram toimii kaikkialla.
Mitä minun täytyy tehdä, jos minulla on Team-paketti?
Organisaation järjestelmänvalvojan on otettava channelsEnabled: true käyttöön hallituissa asetuksissa tai osoitteessa admin-settings/claude-code. Muuten lisäosa muodostaa yhteyden, mutta viestit eivät kulje – päätteessä näytetään käynnistysvaroitus.
Mitä Claude näkee puhelimestani – itse Telegram-chatin?
Ei. Claude näkee vain botille lähettämäsi viestin. Telegram-keskusteluhistoriasi, chat-luettelosi ja yhteystietosi eivät ole sen käytettävissä. MCP-lisäosa lukee vain botille lähetetyt viestit Telegram Bot API:n kautta.
Voinko käyttää Claudea Channelsin kautta ilman Pro/Max-tilausta?
Kyllä, myös Anthropic Consolen API-avain on tuettu. API-käyttö laskutetaan kyseiseltä Console-organisaatiolta. Maksuton claude.ai-taso ei ole tässä kuvattu tilausreitti. Teamin, Enterprisen ja hallittujen Console-organisaatioiden pitää täyttää kanavien käyttöönottoasetukset.
Seuraavaksi
Tärkeimmät kohdat
Botti on määritetty, sallittujen luettelo on käytössä ja istunto toimii VPS:llä. Seuraavaksi ota Channels osaksi päivittäistä rutiiniasi: yhdistä webhookit GitHub Actionsista ja Sentrystä, käytä sitä Routinesin kanssa säännöllisiin tehtäviin ja määritä botin kunnonvalvonta. Kukin vaihe kestää 15–30 minuuttia ja sulkee yhden valvonnan puutteen.
Kun botti toimii luotettavasti, voit tehdä muutaman lisätoimenpiteen saadaksesi Channelsista enemmän irti:
- Yhdistä webhookit CI:stä. Jos käytät GitHub Actionsia / GitLab CI:tä, voit määrittää Channels-lisäosan välittämään rakennustulokset suoraan istuntoon. Claude näkee ”testi epäonnistui” heti pushin jälkeen ja ehdottaa korjausta. Katso channels-reference-dokumentaatio.
- Yhdistä Routinesiin. Voit suorittaa Routinesia samassa istunnossa säännöllisiä tehtäviä varten. Aamulla botti lähettää automaattisesti ”hyvää huomenta, tässä projektin yhteenveto”, ja vastaat puhelimestasi: ”tee liikevaihtoraportti”.
- Määritä botin valvonta. Jos botti hiljenee, haluan tietää siitä. Pieni VPS:llä oleva cron-skripti pingaa Telegram-botin kerran tunnissa. Jos botti ei vastaa, skripti lähettää hälytyksen erilliseen kanavaan. Ilman tätä botti voi lakata toimimasta aamuyöllä kello 4, etkä huomaa sitä ennen puoltapäivää.
- Harkitse hookeja. Hookit reagoivat Claude-tapahtumiin (työkalu käynnistyi, viesti valmistui). Hookit ja Channels mahdollistavat automaattiset Telegram-ilmoitukset, kuten ”Claude sai tehtävän N valmiiksi”.
Älä kytke Channelsia kaikkeen. Se on kätevä tapa ottaa selvää tehtävän tilanteesta, kun olet liikkeellä tai kahvilassa. Kun sinun täytyy todella ajatella, avaa kannettava tietokone ja istu alas. Channels vapauttaa ajatuksestasi ”ai niin, minun pitää vielä pyytää sitä tekemään tämä, täytyy avata kannettava tietokone” silloin, kun olet ulkona tai matkalla.
Lähteet
- Tapahtumien työntäminen käynnissä olevaan istuntoon channelsin avulla - Claude Code Docs
- anthropics/claude-plugins-official GitHubissa - Telegram-, Discord-, iMessage- ja fakechat-lisäosien lähdekoodi
- Jatka paikallisia istuntoja millä tahansa laitteella Remote Controlin avulla - Claude Code Docs
Lisää oppaita työkalujen käyttöön löytyy Ailoot-dokumentaatiosta.
Lisätietoja
Kysymyksiä tästä oppaasta: Näin ohjaat Claude Codea puhelimellasi Telegramin kautta vuonna 2026
Miksi Telegram-botti toimii käsin mutta epäonnistuu palveluna?
Vertaa palvelun Unix-käyttäjää, HOMEa, työtilaa, Claude-ohjelman polkua, Bunin PATHia ja todennusympäristöä onnistuneeseen interaktiiviseen ajoon. Asenna, määritä ja parita samalla palvelukäyttäjällä. Rootin plugin ja paritustila ovat eri kokoonpano.
Voiko Console API -avain korvata Pron tai Maxin kirjautumisen Channelsissa?
Kyllä. Anthropic Consolen API-avaintodennusta tuetaan ja se käyttää Console API -laskutusta. Tarkista tarvittavat organisaation kanava-asetukset ja viimeistele token, paritus sekä lähettäjien sallittujen lista istuntoa suorittavalla tilillä.