Блог

2026 жылы Claude Code-ты телефоннан Telegram арқылы басқару жолы

Markdown

Қадам-қадамымен: Telegram ботын жасаңыз, Claude Code Channels плагинін орнатыңыз, оны рұқсат тізімімен қорғаңыз және VPS серверінде тәулік бойы іске қосыңыз. Дайын нұсқаулықтағы қадамдарды орындаңыз; пәрмендер берілген.

Мақаланы толық оқу

Негізгі түйін

2026 жылғы 20 наурыздағы жағдай бойынша Claude Code Channels — Anthropic-тің ресми плагині. BotFather арқылы бот жасап, плагинді бір пәрменмен орнатыңыз, Claude-ты --channels жалауымен қайта іске қосып, телефоныңыздан ботқа хабарлама жіберіңіз. Claude оларды жергілікті сессияңызда тікелей оқып, файлдарыңызға код жазып, Telegram-да жауап береді. Тәулік бойы жұмыс істеуі үшін сессияны systemd көмегімен жеке VPS серверіңізге көшіріңіз.

Құралдарды баптау жөніндегі қосымша материалдар Ailoot құжаттамасында берілген.

Claude Code Channels деген не және ол не үшін қажет

Негізгі түйін

Channels — Telegram, Discord немесе iMessage-тен хабарламаларды бұрыннан іске қосылған Claude Code сессиясына жіберетін MCP плагині. Сессия хабарламаны кәдімгі пайдаланушы сұрауы ретінде қабылдап, жергілікті файлдарыңызбен жұмыс істейді және сол чатта жауап береді. Сіз телефоныңызбен шаруаларыңызды істеп жүргенде ноутбугыңыз қосулы тұрады.

2026 жылғы 20 наурызда Anthropic Claude сессиясын хабар алмасу қолданбаларына қосатын ресми плагин Claude Code Channels-ты шығарды. Telegram, Discord және iMessage қолдау табады. Бұл мүмкіндік зерттеу алдындағы шолу кезеңінде: құжаттама code.claude.com/docs/en/channels мекенжайында, ал плагиннің бастапқы коды anthropics/claude-plugins-official ашық репозиторийінде орналасқан.

Қысқасы, бұл — телефоныңыз бен Claude Code сессияңыз арасындағы «чат көпірі». Мен ботқа: «Баға кестесін қайта жазуды жалғастыр; business/products/practicum/README.md файлын ашып, келесі топтың күндерін жаңарт» деп хабарлама жіберемін, ал бот оны VPS серверімдегі сессияға жеткізеді. Claude контексті алады, файлды өңдейді, өзгерістерді коммиттейді де, Telegram-да «Дайын, коммитті тексер» деп жауап береді. Ноутбук үйде жабық тұрады.

⚠️ Зерттеу алдындағы шолудың негізгі шектеуі: Channels — MCP көпірі. Сессия компьютеріңізде немесе VPS серверіңізде жұмыс істеп тұруы керек. Сессия жабылғанда, хабарламаларды ешкім қабылдамайды. Сондықтан тәулік бойы жұмыс істеуді бөлек баптау керек (төмендегі VPS бөліміне қараңыз).

Channels қашықтан жұмыс істеудің басқа тәсілдерінен несімен ерекшеленеді

Өзінің ресми құжаттамасында Anthropic тікелей салыстыру кестесін ұсынады. Төменде оның бейімделген нұсқасы берілген:

МүмкіндікНе істейдіҚай кезде таңдаған жөн
Claude Code вебтеGitHub-тан репозиторийді клондап, жаңа бұлттық құмсалғышта тапсырманы орындайдыФондық режимде бөлек тапсырма беріп, кейін тексеру үшін
Slack интеграциясы@Claude деп белгілегенде, тредте веб-сессияны бастайдыТапсырмаларды тікелей топтық әңгімелерден бастау үшін
MCP сервері (кәдімгі)Claude оны тапсырманы орындау кезінде шақырады; ол сессияға ештеңе жібермейдіClaude-қа сыртқы жүйелерге сұраныс бойынша қол жеткізу үшін
Remote Controlclaude.ai немесе мобильді қолданбадан жергілікті сессияны басқарасызТелефон экранынан бұрыннан ашық сессияны басқару үшін
Channels ⭐Claude-қа қатысы жоқ көздерден оқиғаларды жергілікті іске қосылған сессияға жібередіТелефоннан сұрақ қойып, чатта жауап алу; CI жүйесінен вебхук қабылдау үшін

Channels пен Remote Control арасындағы негізгі айырмашылық: Remote Control — «телефоныңыз терминалға ашылған терезе»; меңзерді көріп, түймелерді басасыз. Channels — миы жергілікті Claude сессиясы болып табылатын чатбот. Remote Control арқылы мен терминалға қараймын. Channels арқылы файлдарымды оқитын біреуге хабарлама жазамын.

Экранды толық бақылау керек болса, Remote Control қолданыңыз. «Сұрақ жіберіп, күнімді жалғастырып, жауабын алу» керек болса, Channels қолданыңыз. Мен екеуін де пайдаланамын: маңызды өзгерістерді мақұлдау керек кезде Remote Control, ал тапсырмаға сенімді болып, кешімді өзіме қайтарғым келгенде Channels.

Бастамас бұрын не қажет

Негізгі түйін

Сізге Claude Code v2.1.80 не жаңасы, қолдау көрсетілетін claude.ai авторизациясы не Anthropic Console API кілті, орнатылған Bun және Telegram қолжетімділігі қажет. Тәулік бойы жұмыс істеу үшін Ubuntu немесе Debian жүйесі бар VPS керек. macOS, Linux және WSL жүйелерінде бәрі бірдей жұмыс істейді.

Пәрмендерге кіріспес бұрын, мына тізімді тексеріңіз:

  1. Anthropic аккаунты. Сізге Pro, Max, Team немесе Enterprise қажет. Channels тегін жоспарда қолжетімді емес. Anthropic Console API кілті де жарайды; Console ұйымы басқарылатын баптауларды қолданса, сол жерде channel қосылғанын тексеріңіз.
  2. Claude Code v2.1.80 немесе одан жаңа нұсқасы. claude --version пәрменімен тексеріңіз. Ескі болса, claude update немесе npm install -g @anthropic-ai/claude-code@latest пәрменімен жаңартыңыз.
  3. Bun. Channels плагиндері Node скрипттері емес, Bun скрипттері. bun --version пәрменімен тексеріңіз. Орнатылмаған болса, curl -fsSL https://bun.sh/install | bash пәрменін орындап, кейін source ~/.bashrc іске қосыңыз.
  4. Telegram аккаунты. Кез келген аккаунт жарайды; бастысы, телефоныңызда оған кірген болуыңыз керек.
  5. Team/Enterprise жоспарын пайдалансаңыз, әкімшіден басқарылатын баптауларда немесе admin-settings/claude-code арқылы channelsEnabled параметрін қосуды сұраңыз. Ұйымдарда ол әдепкі бойынша өшірулі болады.

Bun туралы алғаш рет естіп тұрсаңыз, алаңдамаңыз. Bun — Node сияқты балама JavaScript орындау ортасы. Anthropic оны Channels плагиндеріне жылдам іске қосылатын және бір бинарлық файлға жинау оңай болғандықтан таңдады. Бір рет орнатып, ұмытыңыз.

⚠️ Channels әзірге корпоративтік Bedrock / Google Vertex / Azure Foundry жүйелерімен жұмыс істемейді. Ол тек claude.ai аутентификациясымен немесе Anthropic Console арқылы жұмыс істейді.

1-қадам. BotFather арқылы Telegram ботын жасау

Негізгі түйін

Telegram-да @BotFather ашып, /newbot пәрменін жіберіңіз, атау мен пайдаланушы атын таңдаңыз (пайдаланушы аты bot деп аяқталуы керек) және 12345678:AAH... пішіміндегі токенді алыңыз. Токенді қауіпсіз сақтаңыз: ол — ботыңыздың құпиясөзі. Оны көрген кез келген адам бот атынан жаза алады және Claude-қа жіберген хабарламаларыңызды ұстап қалуы мүмкін.

BotFather жұмыстың бәрін өзі атқарады — сізге бес түймені басу ғана керек. Қадамдар мынадай:

  1. Telegram-да @BotFather ашыңыз (телефонды пайдалануға болады; қалған баптауларды да телефоннан жасауға болады).
  2. Алғаш рет кірсеңіз, «Start» түймесін басыңыз.
  3. /newbot пәрменін жіберіңіз.
  4. BotFather: «Жарайды, жаңа бот. Оны қалай атаймыз?» деп сұрайды. Көрсетілетін атауды енгізіңіз, мысалы, Менің көмекшім - Claude Code.
  5. Содан кейін пайдаланушы атын сұрайды. Ол Telegram желісінде бірегей болып, bot деп аяқталуы керек. Мысалы, my_claude_bot немесе my_dev_bot.
  6. BotFather мынаған ұқсас хабарлама жібереді:
Дайын! Жаңа ботыңыз құтты болсын. Оны мына жерден таба аласыз:
'<OFFICIAL_URL>'.

Ботты басқаруға арналған HTTP API токені:
1234567890:AAHzlAU...

Токеніңізді қауіпсіз жерде сақтаңыз. Оны кез келген адам ботты басқару үшін пайдалана алады.

Токенді көшіріңіз. Ол сізге екі минуттан кейін керек болады.

⚠️ Токеннің қауіпсіздігі. Бот токені оны толық басқаруға мүмкіндік береді. Ол жария болып кетсе, кез келген адам бот атынан жаза алады және (мүмкін) Claude-қа жіберген хабарламаларыңызды ұстап қалуы мүмкін. Оны репозиторийлерде жарияламаңыз, кодқа қоймаңыз немесе чаттарда жібермеңіз. Мен токендерді ~/.claude/channels/telegram/.env ішінде сақтаймын; келесі қадамда плагин оны сол жерге жазады.

2-қадам. Telegram плагинін Claude Code-қа орнату

Негізгі түйін

Claude Code-ты әдеттегідей іске қосып, сессияға /plugin install telegram@claude-plugins-official пәрменін енгізіңіз. Плагин табылмаса, алдымен /plugin marketplace add anthropics/claude-plugins-official пәрменімен ресми маркетплейсті қосыңыз. Орнатқан соң, ағымдағы сессияда плагин пәрмендерін іске қосу үшін /reload-plugins орындаңыз.

Әдетте Claude-пен жұмыс істейтін кез келген қалтада терминалды ашып, мынаны орындаңыз:

claude

Сессияға қиғаш сызықпен басталатын пәрменді енгізіңіз:

/plugin install telegram@claude-plugins-official

Claude «Plugin not found in any marketplace» деп жауап берсе, клиент ресми маркетплейсті білмейді. Оны қосыңыз:

/plugin marketplace add anthropics/claude-plugins-official

Немесе бұрын қосқан болсаңыз, жаңартыңыз:

/plugin marketplace update claude-plugins-official

Орнату сәтті аяқталғаннан кейін пәрмендерін іске қосу үшін плагиндерді қайта жүктеңіз:

/reload-plugins

Енді /telegram:configure және /telegram:access сияқты қиғаш сызық пәрмендері болуы керек. Тексеру үшін /help енгізіңіз; тізімде telegram бөлімі болуы тиіс.

3-қадам. Токенді плагинге байланыстыру

Негізгі түйін

Claude сессиясында 1-қадамдағы токенмен /telegram:configure <token> пәрменін енгізіңіз. Ол токенді тек сіздің пайдаланушы аккаунтыңыз қол жеткізе алатын ~/.claude/channels/telegram/.env файлына сақтайды. Балама ретінде, Claude-ты іске қоспас бұрын, shell ортасында TELEGRAM_BOT_TOKEN айнымалысын орнатуға болады. Өндірістік ортада мен екінші тәсілді пайдаланамын: оны systemd арқылы басқару оңай және репозиторийге ~/.claude/ қалтасын қосудың қажеті жоқ.

Claude сессиясында:

/telegram:configure 1234567890:AAHzlAU...

Пәрмен токенді ~/.claude/channels/telegram/.env файлына жазады. Файлға тек сіздің пайдаланушы аккаунтыңыздың қолы жетеді (chmod 600), сондықтан алаңдаудың қажеті жоқ.

Балама ретінде, токенді орта айнымалысы арқылы орнатыңыз. Бұл Claude-ты systemd немесе Docker арқылы орналастырып, интерактивті пәрмендерді қолданғыңыз келмесе пайдалы:

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

⚠️ Өндірістік ортада ~/ үй каталогымдағы .env файлының орнына әрдайым орта айнымалыларын пайдаланамын. Бұл құпияларды systemd (Environment=TELEGRAM_BOT_TOKEN=...) арқылы басқаруды жеңілдетіп, ~/.claude/ қалтасын репозиторийге байқамай қосып жіберуден сақтайды.

4-қадам. Claude-ты --channels жалауымен қайта іске қосу

Негізгі түйін

Сессиядан шығыңыз (exit немесе Ctrl+D), содан кейін --channels plugin:telegram@claude-plugins-official жалауымен қайта іске қосыңыз. Бұл жалау плагинді қосып, Claude-қа жаңа хабарламаларды алу үшін Telegram API-ін сұрастыруды бастауға пәрмен береді. Жалау болмаса, бот бар болады, бірақ үндемей қалады: плагин әрекетсіз, ал сұрастыру басталмаған.

Бұл — ең маңызды тұс әрі алғаш іске қосқанда көпшілікті шатастырады. Плагинді орнату ғана жеткіліксіз. Бот хабарламаларды шынымен қабылдай бастауы үшін Claude-ты нақты жалаумен іске қосу керек:

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

Жалаусыз сессия әдеттегідей жұмыс істейді, бірақ Telegram плагині әрекетсіз болады. Жалаумен іске қосқанда Claude плагиннің MCP серверін іске қосып, Telegram API-ін сұрастыруды бастайды және ботқа жіберілген хабарламаларға жауап береді.

Іске қосқаннан кейін терминалда мынаған ұқсас мәтін көрінуі керек:

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

Channels туралы жол болмаса, жалау іске қосылмаған. Claude Code нұсқасы 2.1.80 немесе одан жаңа екенін және плагиннің шынымен орнатылғанын (/plugin list сессия ішінде) тексеріңіз.

⚠️ Пайдалы кеңес. Мен ~/.zshrc файлына бүркеншік пәрмен қостым:

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

Содан кейін жай ғана claude-tg деп іске қосамын. Бос орынмен бөліп, бірнеше плагинді беруге болады: --channels plugin:telegram@... plugin:discord@....

5-қадам. Аккаунтты жұптап, басқалардың бәрін бұғаттау

Негізгі түйін

Telegram-да ботыңызды ашып, кез келген хабарлама жіберіңіз. Бот алты таңбалы жұптастыру кодымен жауап береді. Терминалға оралып, /telegram:access pair <code> пәрменін енгізіңіз. Содан кейін рұқсат тізімі саясатын міндетті түрде қосыңыз: /telegram:access policy allowlist. Тек рұқсат бермек болған адамдардың жұптастыру кодтарын мақұлдаңыз; сеансқа кім жететінін sender allowlist басқарады.

Бұл қадам қауіпсіздікке қатысты. Мақұлданған жіберуші сеансқа қолжетімді файлдар мен құралдарға әрекет сұрай алады. Қажетті аккаунтты ғана жұптастырып, ботқа сенбес бұрын sender саясатын шектеңіз.

Қадамдар:

  1. Telegram-да ботыңызды ашыңыз. Оны @my_claude_bot пайдаланушы атымен немесе BotFather жауабындағы сілтеме арқылы табыңыз. «Start» түймесін басыңыз.
  2. Ботқа кез келген хабарлама жіберіңіз. Мысалы, hi.
  3. Бот жұптастыру кодымен жауап береді. Ол мынаған ұқсас болады:
Сәлем! Бұл аккаунтты жұптастыру үшін Claude Code сессиясында мына пәрменді орындаңыз:
/telegram:access pair 847291

Бұл код 5 минут жарамды.
  1. Терминалға оралыңыз. Claude сессиясында жауаптағы пәрменді енгізіңіз:
/telegram:access pair 847291

Claude «Account paired» деп жауап береді. Енді Telegram аккаунтыңыз пәрмен жібере алады.

  1. Рұқсат тізімі саясатын қосыңыз. Бұл бұрыннан жұптастырылған аккаунттардан басқасының бәрін бұғаттайды:
/telegram:access policy allowlist

Осыдан кейін басқа аккаунттардан келген хабарламалар үнсіз еленбейді. Олар терминалда көрінбейді, бот жауап бермейді — хабарламалар мүлде болмағандай.

⚠️ Мұны дереу қосу өте маңызды. Жұптастырғаннан кейінге қалдырмаңыз. Баптау кезінде бейтаныс pairing сұрауларын мақұлдамаңыз және сәтті жауап sender саясаты дұрыс екенін дәлелдейді деп санамаңыз. Алғаш рет ботымды рұқсат тізімінсіз он минуттай жұмыс істеттім, сол аралықта Telegram-ның екі кездейсоқ пайдаланушысы «hi» деп жібере алды. Бақытымызға орай, ол кезде пәрмендер файлдарға жаза алмайтын еді.

Басқа біреуді қосу керек болса (мысалы, жоба серіктесін):

/telegram:access pair <code from their account>

Ол алдымен ботқа хабарлама жіберіп, код алып, оны сізге беруі керек. Басқаларды тек осылай қоса аласыз.

Қосымша нұсқаулықтар Ailoot құжаттамасында бар.

Claude-ты жеке VPS серверіңізде тәулік бойы қалай іске қосуға болады

Негізгі түйін

Жергілікті сессия ноутбук ашық тұрғанда жұмыс істейді; қақпағын жапсаңыз, бот үнсіз қалады. Claude кез келген уақытта жауап беруі үшін сессияны жеке VPS серверіңізге көшіріңіз: Claude Code пен Bun орнатып, сол бөлек Unix пайдаланушысы ретінде кіріп, плагинді орнатып/жұптастырыңыз да, автоматты қайта бастайтын systemd қызметіне қосыңыз. Coolify сервері оны қиындықсыз іске қосады.

Боттың «ноутбукты бір сағатқа ашып, шұқылағанша» емес, «тәулік бойы жұмыс істегенін» қаласаңыз, сессия тоқтамай жүруі керек. Жергілікті компьютерде мұны tmux арқылы жасауға болады, бірақ VPS оңайырақ әрі сенімдірек.

Бір мысалдағы баптауда сайт та орналастырылған Coolify VPS сервері пайдаланылады (Coolify арқылы жариялау нұсқаулығындағы мәліметтер). Сол серверді пайдалануға болады — Claude жадыны аз қолданады. VPS жоқ болса, Hetzner CX11 / Yandex Cloud / Selectel сияқты айына 4–5 еуро тұратын ең арзанын алыңыз.

1-қадам: VPS серверіне жүйені орнату

Алдымен әкімші ретінде бөлек Unix аккаунтын және workspace жасаңыз. Бар аккаунтты тек home мен иелігін тексеріп қайта қолданыңыз:

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

Root үйінде емес, сол claude login shell ішінде жалғастырыңыз. Bun-ды ресми орнатқышпен, Claude Code-ты жергілікті орнату жолымен орнатыңыз:

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

Орнатқыш PATH өзгерісін қолдану үшін сол пайдаланушыға жаңа login shell ашыңыз. Аккаунт пен орындалатын файл жолдарын тексеріңіз:

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

whoami — claude, HOME — /home/claude болуы керек. command -v берген абсолютті жолдарды тіркеңіз; нақты Claude жолын ExecStart-қа, Bun қалтасын қызмет PATH-ына енгізіңіз. Біреуі табылмаса, тоқтаңыз.

2-қадам: қызмет пайдаланушысы ретінде кіріп, орнатып, жұптастыру

Осы интерактивті claude сеансында кіруді аяқтап, жоғарыдағы 2–5-қадамдарды сол Unix пайдаланушыда қайталаңыз: Telegram плагинін user scope ішінде орнатыңыз, токенді баптаңыз, --channels арқылы қайта бастап, Telegram аккаунтыңызды жұптастырыңыз және policy allowlist орнатыңыз. Қызметті баптаудан бұрын хабарлама мен жауапты сынаңыз. Root конфигурациясын не credentials-ін бұл home-ға көшірмеңіз.

claude.ai жазылым авторизациясы да, Anthropic Console API кілті де қолдау табады. Team/Enterprise ұйымның қосуын қажет етеді; басқарылатын Console ұйымы да channel баптауларына сай болуы керек. Console қолжетімділігі claude.ai жазылымымен емес, API бойынша төленеді. Интерактивті shell-ден қызметке өткенде таңдалған аккаунт пен авторизацияны сақтаңыз.

3-қадам: сессияны systemd қызметіне қосу

Қызмет пайдаланушысы shell-інен шығып, unit-ті әкімші ретінде жасаңыз. Төмендегі unit жол тексерулері /home/claude/.local/bin/claude және /home/claude/.bun/bin/bun бергенін болжайды; өзгеше болса нақты шығыстармен ауыстырыңыз. Сол авторизация ортасы мен бот токенін беріп, unit-ті тек әкімші оқитындай ұстаңыз; құпияларды коммиттемеңіз. Автоматты бастау және істен шыққан соң қайта қосылу файлын жасаңыз:

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

Мен қосқан баптаулар:

  • Type=simple — қарапайым режим; systemd процесс іске қосылған сәтте оны басталды деп есептейді.
  • User=claude — root емес, бөлек пайдаланушы атынан жұмыс істейді. Қауіпсіздеу.
  • WorkingDirectory=/home/claude/workspace — дайындалған, қызмет пайдаланушысы иелік ететін workspace. Қажетті репозиторийді іске қосудан бұрын сонда орналастырыңыз; root иелігіндегі клонды қалдырмаңыз және root үйінен бастамаңыз.
  • Environment=TELEGRAM_BOT_TOKEN=... — токен процеске тікелей беріледі. .env файлы қажет емес.
  • --dangerously-skip-permissions — қараусыз жұмыс үшін маңызды. Бұл жалау болмаса, Claude әр әрекет алдында терминалда «иә/жоқ» жауабын күтіп тұрады да, сессия қатып қалады. Allowlist жіберушіні анықтайды, сұраған пәрменін қауіпсіз етпейді. Бұл bypass-ты тек файлдары, credentials және желісі әдейі шектелген оқшау ортада қолданыңыз.
  • Restart=on-failure — процесс істен шықса (Claude тоқтаса немесе желі үзілсе), systemd оны 10 секундтан кейін қайта қосады.

Журналдарды мына пәрменмен көріңіз:

journalctl -u claude-code -f

Бірдеңе дұрыс болмаса, journalctl -u claude-code -n 100 соңғы 100 жолды көрсетеді.

4-қадам: боттың жұмыс істеп тұрғанын тексеру

Интерактивті баптау нақты Telegram жауабын бергеннен кейін ғана қызметті бастаңыз. Сол жұптасқан аккаунттан сол ботқа зиянсыз хабарлама жіберіп, жауапты да, қызмет журналын да тексеріңіз. Интерактивті істеп, systemd-де істемесе, алдымен Unix пайдаланушысын, HOME, workspace, орындалатын файл жолын, PATH пен авторизация ортасын салыстырыңыз.

Кейін жұптастыруды өзгертуге қызметті тоқтатып, sudo -iu claude орындаңыз, /home/claude/workspace ішіне кіріп, сол channel-ды интерактивті бастаңыз. Сонда жұптастырып, allowlist қосыңыз, шығып, қызметті қайта бастаңыз. Бір ботқа бір уақытта екінші poller қоспаңыз. journalctl журналды оқиды; ол интерактивті Claude промптын бермейді.

Өндірістік серверде кездесетін 5 қате және олардан сақтану жолы

Негізгі түйін

Өндірістік ортада бір апта бойы баптау кезінде кездестірген мәселелер: systemd Bun-ды таппайды, ұзақ сұрастыру әрекетсіз отырғаннан кейін тоқтайды, Max жоспарының лимиттері күн ортасында таусылады, --dangerously-skip-permissions деректерді жария етуі мүмкін, ал қайта орнатқанда рұқсат тізімі ұмыт қалады. Әрқайсысын бір жолдық баптаумен түзетуге болады, бірақ білмесеңіз, бірнеше күн ішінде осы мәселелерге тап боласыз.

1. Bun systemd PATH айнымалысында жоқ

systemd процестерді ең аз орталар жиынтығымен іске қосады: ~/.bashrc ішіндегі айнымалыларды көрмейді. Bun тек root үйіне орнатылып, unit-те User=claude болса, қызмет сол орнатылымды не root shell PATH-ын мұраламайды.

Шешім. Bun-ды бүкіл жүйеге орнатыңыз (/usr/local/bin/bun) немесе PATH-ты нақты беріңіз:

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

2. Ұзақ әрекетсіздіктен кейін сессияның Telegram API-мен TCP байланысы үзіледі

6–12 сағат әрекетсіз тұрғаннан кейін бот «үнсіз қалып», хабарламалар Telegram-ға жіберілуі мүмкін, бірақ плагин оларды қабылдамайды. Бұл — ұзақ сұрастырудың бір ерекшелігі.

Шешім. systemd-ге тұрақты қайта іске қосуды қосыңыз (әр 24 сағат сайын):

Restart=always
RuntimeMaxSec=86400

Немесе cron тапсырмасын баптаңыз: 0 5 * * * systemctl restart claude-code (таңғы 5-те қайта іске қосу).

3. Claude Max лимиттері күн ортасында таусылады

Telegram арқылы Claude-ды белсенді пайдалансаңыз, Max 5x жоспарында (айына шамамен ~$100) лимитке 4–6 сағатта жетуіңіз мүмкін. Telegram сұраулары кәдімгі терминалдағы сұраулардан еш айырмашылығы жоқ: екеуі де бір бюджетті пайдаланады.

Шешім. «Бот жауап бермей тұр — /stats пәрменін тексер» деген еске салғыш орнатыңыз. Лимитке жетсеңіз, жаңартылғанша күтіңіз немесе Max 20x жоспарына ($200/month) өтіңіз. Токен үнемдеу жөніндегі нұсқаулық пен Sonnet және Opus модельдерін салыстыру нұсқаулығы көмектесуі мүмкін.

4. --dangerously-skip-permissions рұқсат тізімі қосылса да қауіпті

Бұл жалау барлық растауларды өшіреді. Telegram-да жіберген кез келген пәрмен сұрақсыз орындалады: файлдарды жою, сыртқы сұраулар жіберу және тағы басқалары. Бірде мен Claude-тан «қажет емес console.log операторларын алып тастауды» сұрадым. Тазалау кезінде Claude өндірістік скрипттегі жөндеу журналдарының жартысын өшіріп тастады. Оларды git арқылы қалпына келтірдім, бірақ зиян келіп үлгерді.

Шешім. Маңызды жобада жұмыс істесеңіз, --dangerously-skip-permissions жалауын қоспаңыз. Оның орнына сессияларды іске қосу үшін Remote Control қолданыңыз — рұқсат сұраулары телефоныңызға келеді, оларды қолмен мақұлдайсыз. --dangerously-skip-permissions жалауы қосылған Channels нобайларға, рефакторингке және сынақтарға арналған.

5. Қайта орнатқаннан кейін рұқсат тізімі «бұзылады»

Рұқсат тізімі ~/.claude/channels/telegram/ ішінде сақталады. Жаңа VPS серверіне көшсеңіз, Claude-ты қайта орнатсаңыз немесе пайдаланушыны өзгертсеңіз, бұрынғы жұптау деректері табылмайды. Ескі sender allowlist жоқ; жаңа данада бұрынғы қолжетімділік саясаты бар деп санамаңыз.

Шешім. Көшпес бұрын ~/.claude/channels/telegram/ қалтасының сақтық көшірмесін жасаңыз. Кейін оны қайта қойыңыз. Немесе қайта орнатқан соң бірден қайта жұптап, ботты іске қосу мен policy allowlist орнату арасында бір минут та қалдырмаңыз.

Channels әлде Remote Control — қайсысын таңдаған жөн?

Негізгі түйін

Channels дегеніміз — Claude сессиясы чатта жауап береді, ал сіз телефоннан сұраулар жібересіз. Remote Control дегеніміз — терминал экраны телефонда көрсетіліп, сессияны түймелермен басқарасыз. Channels «сұрап, әрі қарай жүре беру» үшін ыңғайлы, ал Remote Control Claude не істеп жатқанын көріп, қауіпті әрекеттерді мақұлдау қажет болғанда қолданылады.

Anthropic екі мүмкіндікті де бір мезгілде шығарды: Remote Control — 2026 жылғы 25 ақпанда, Channels — 2026 жылғы 20 наурызда. Олар бірін-бірі қайталамайды, әртүрлі мәселені шешеді.

ЖағдайChannelsRemote Control
Сыртта жүргенде «кешегі коммиттер қандай болды?» деп сұрау✅ Өте қолайлыАртық — толық экран керек
Файл өзгерісін мақұлдау⚠️ --dangerously-skip-permissions арқылы көрмей мақұлдау✅ Claude-тың не істегісі келетінін көресіз
Claude-ты тәулік бойы іске қосу✅ VPS + systemd баптауы⚠️ Ноутбук ашық болуы керек
Телефоннан бірнеше сұрау ғана жіберу⚠️ Артық — бот, токен, плагин✅ Бір QR код
CI / Sentry жүйесінен вебхук қабылдау✅ Негізгі қолдану жағдайы❌ Бұл үшін арналмаған
Бірнеше адамнан тұратын топ✅ Бірнеше аккаунтқа арналған рұқсат тізімі⚠️ Тек сессия иесіне
Файлдарды Anthropic бұлтынан тыс ұстау✅ MCP арқылы тек мәтін✅ Мұнда да тек мәтін

Мен оларды өзім былай бөлемін: Channels — ноутбуктан алыстағы асинхронды жұмысқа, CI хабарландырулары мен интеграцияларға. Remote Control — Claude-тың не істеп жатқанын көру немесе қауіпті қадамды мақұлдау қажет болғанда.

Екеуін де бір уақытта қолдануға болады. Telegram ботында «сұрап, жауап алу» арнасы болса, Remote Control «маңызды нәрселерді басқару» арнасы болады. Екеуі де Claude-тың бірдей лимитін пайдаланады.

Жиі қойылатын сұрақтар

Негізгі түйін

Channels туралы ең жиі қойылатын жеті сұрақ: бірнеше ботты қосу, терминалды жапқанда не болатыны, CI вебхуктары, Telegram мен Discord айырмасы, Team жоспарының шектеулері, телефоннан Claude не көре алатыны және тегін жоспар. Қосымша материалдар Ailoot құжаттамасында бар.

Бір уақытта бірнеше ботты қоса аламын ба?

Иә. --channels жалауы бос орынмен бөлінген тізімді қабылдайды: --channels plugin:telegram@claude-plugins-official plugin:discord@claude-plugins-official. Бір Claude сессиясы екі чатта да жауап береді.

Терминалды жапсам не болады?

Сессия жабылып, плагин тоқтайды, ал бот үнсіз қалады. VPS серверінде сессия systemd арқылы жұмысын жалғастырады. Жергілікті компьютерде ноутбукты жапсаңыз, claude бірнеше секундтан кейін SIGHUP сигналымен ажырайды.

CI немесе Sentry жүйесінен хабарландыру ала аламын ба?

Иә. Channels — екі бағытты арна. Channels Reference арқылы вебхуктарды сессияға жіберетін жеке плагин жаза аласыз. Claude оқиғаларды нақты уақытта көріп, жауап береді.

Telegram қандай да бір жағынан Discord-қа қарағанда шектеулі ме?

Негізгі мүмкіндіктері бірдей. Discord үшін бот баптауларында Message Content Intent қажет. iMessage тек macOS жүйесінде жұмыс істейді және ~/Library/Messages/chat.db дерекқорын тікелей оқиды. Telegram-ды бәрі пайдалана алады.

Team жоспарын пайдаланатын болсам, не істеуім керек?

Ұйым әкімшісі басқарылатын баптауларда немесе admin-settings/claude-code арқылы channelsEnabled: true параметрін қосуы керек. Онсыз плагин қосылғанымен, хабарламалар өтпейді — терминалда іске қосу туралы ескерту шығады.

Claude телефонымдағы Telegram чатын көре ала ма?

Жоқ. Claude тек ботқа жіберген хабарламаңызды көреді. Ол Telegram әңгімелерінің тарихына, чаттар тізіміне және контактілерге қол жеткізе алмайды. MCP плагині Telegram Bot API арқылы тек ботқа арналған хабарламаларды оқиды.

Pro/Max жазылымынсыз Channels арқылы Claude-ты іске қоса аламын ба?

Иә, Anthropic Console API кілті де қолдау табады; API қолданысы сол Console ұйымына есептеледі. Тегін claude.ai тарифі мұнда сипатталған жазылым жолы емес. Team/Enterprise және басқарылатын Console ұйымдары channel қосу баптауларына сай болуы керек.

Әрі қарай не істеу керек

Негізгі түйін

Бот бапталды, рұқсат тізімі қосылды, сессия VPS серверінде жұмыс істеп тұр. Енді Channels-ты күнделікті жұмысқа қосыңыз: GitHub Actions пен Sentry жүйелерінен вебхуктарды қосып, тұрақты тапсырмалар үшін Routines-пен жұптастырыңыз және боттың жұмысын бақылайтын монитор орнатыңыз. Әр қадамға 15–30 минут кетеді және бақылаудағы бір олқылықты жояды.

Бот тұрақты жұмыс істей бастаған соң, Channels-тан барынша пайда алу үшін бірнеше қадам жасауға болады:

  1. CI жүйесінен вебхуктарды қосыңыз. GitHub Actions / GitLab CI пайдалансаңыз, құрастыру нәтижелерін сессияға тікелей жіберетіндей Channels плагинін баптай аласыз. Claude push жасалғаннан кейін бірден «сынақ сәтсіз аяқталды» деген хабарды көріп, түзету ұсынады. channels-reference құжаттамасын қараңыз.
  2. Routines-пен жұптастырыңыз. Сол сессияда тұрақты тапсырмаларды орындау үшін Routines іске қосуға болады. Таңертең бот өздігінен «Қайырлы таң, міне, жоба қорытындысы» деп жібереді, ал сіз телефоннан «кіріс есебін жаса» деп жауап бересіз.
  3. Бот мониторын орнатыңыз. Бот үнсіз қалса, мен бұл туралы білгім келеді. VPS серверіндегі шағын cron скрипті Telegram ботына сағатына бір рет хабар жібереді. Бот жауап бермесе, бөлек арнаға ескерту жібереді. Онсыз бот таңғы 4-те тоқтап, сіз оны түске дейін білмеуіңіз мүмкін.
  4. Хуктарды қарастырыңыз. Хуктар Claude оқиғаларына жауап береді (құрал іске қосылды, хабарлама аяқталды). Хуктар мен Channels бірге «Claude N тапсырмасын аяқтады» сияқты Telegram хабарландыруларын автоматты жібере алады.

Channels-ты барлық нәрсеге қоса бермеңіз. Бұл жолда немесе кофеханада жүргенде тапсырманы тексерудің ыңғайлы тәсілі. Терең ойлану керек кезде ноутбугыңызды ашып, отырып жұмыс істеңіз. Channels жолда жүргенде «мынаны да сұрауым керек, ноутбукты ашайын» деген ойдан арылтады.

Құралдармен жұмыс жөніндегі қосымша материалдарды Ailoot құжаттамасынан қараңыз.

Толығырақ

Жиі қойылатын сұрақтар

Telegram боты қолмен жұмыс істеп, қызмет ретінде неге істемейді?

Қызметтің Unix пайдаланушысын, HOME, workspace, Claude файлының жолын, Bun PATH және авторизация ортасын сәтті интерактивті іске қосумен салыстырыңыз. Сол қызмет пайдаланушысында орнатып, баптап, жұптастырыңыз; root плагині мен pairing күйі — бөлек конфигурация.

Channels үшін Console API кілті Pro не Max кіруін алмастыра ала ма?

Иә. Anthropic Console API кілтімен авторизация қолдау табады және Console API төлемін қолданады. Қажет жерде ұйымның channel баптауларын тексеріп, токен конфигурациясын, жұптастыруды және sender allowlist-ін сеансты жүргізетін аккаунтта аяқтаңыз.

Барлық мақалалар