dailytutorfor.you
Web Development

Claude Code Telegram Plugin: Panduan Setup Lengkap 2026 (Production-Ready)

Panduan lengkap setup Claude Code Telegram Plugin dari nol sampai production-ready: mulai dari BotFather, instalasi plugin, pairing, hardening allowlist, hingga best practices operasional agar aman dan stabil dipakai harian.

7 menit baca

Claude Code Telegram Plugin: Panduan Setup Lengkap 2026 (Production-Ready)

Kamu pernah kepikiran nggak, “gimana kalau Claude Code bisa aku chat langsung dari Telegram, jadi bisa kontrol dari HP kapan aja?”
Kabar baiknya: itu bukan eksperimen lagi — sekarang sudah jadi workflow yang sangat realistis untuk developer solo maupun tim kecil.

Di tutorial ini, kita akan bahas end-to-end setup Claude Code Telegram plugin sampai siap dipakai harian, plus hardening keamanan supaya bot kamu nggak jadi pintu masuk orang asing.

Kita juga akan lengkapi konteks dari beberapa referensi resmi: dokumentasi plugin Telegram, praktik dasar BotFather/Bot API Telegram, dan insight operasional dari implementasi gateway/chat-agent modern.

Prerequisites

Sebelum mulai, pastikan kamu sudah punya:

  1. Telegram account aktif
  2. Akses ke Claude Code session (di mesin lokal/VPS)
  3. Runtime yang didukung plugin (umumnya Bun untuk server plugin tertentu)
  4. Akses terminal
  5. Koneksi internet stabil

Opsional tapi sangat disarankan:

  • Tailscale / private network kalau mau akses aman lintas device
  • Session manager (tmux/screen/systemd) supaya proses tetap hidup
  • Monitoring log dasar

Core Concepts (Biar Nggak Salah Mental Model)

Sebelum masuk setup, pahami dulu arsitekturnya:

  • Telegram Bot = endpoint chat publik milikmu (dibuat via BotFather)
  • Plugin / MCP server = jembatan antara Telegram dan Claude Code
  • Claude Code session = “otak” yang memproses prompt

Alur sederhananya:

[Telegram User]
     |
     v
[Telegram Bot API]
     |
     v
[Telegram Plugin / MCP Bridge]
     |
     v
[Claude Code Session]
     |
     v
[Reply back to Telegram]

Kenapa ini powerful?

Karena kamu bisa:

  • kirim instruksi dari HP,
  • cek progres,
  • update/reaksi/edit message,
  • dan tetap menjaga environment coding utama di server/laptop.

Step-by-Step Setup

1) Buat Bot di BotFather

Chat ke @BotFather, lalu jalankan:

/newbot

Isi:

  • Bot name (bebas)
  • Bot username (harus berakhiran bot)

Kamu akan dapat token seperti:

123456789:AAxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Simpan token ini seperti password. Jangan taruh di repo publik.

2) Install Plugin Telegram di Claude Code

Masuk Claude Code session, lalu install plugin Telegram resmi.

Contoh command (sesuaikan environment kamu):

/plugin install telegram@claude-plugins-official
/reload-plugins

Kalau command plugin belum muncul, restart session Claude Code.

3) Konfigurasi Bot Token

Set token ke plugin:

/telegram:configure <BOT_TOKEN>

Biasanya token disimpan di path semacam:

~/.claude/channels/telegram/.env

Isi minimal:

TELEGRAM_BOT_TOKEN=123456789:AAxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

4) Relaunch Claude Code dengan Channel Flag

Agar channel Telegram aktif, jalankan Claude Code dengan channel plugin Telegram.

Contoh:

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

Kalau kamu pakai service manager, flag ini harus masuk ke startup command service kamu.

5) Pairing Telegram User

Secara default, banyak setup pakai mode pairing dulu.

Flow umum:

  1. DM bot kamu dari Telegram
  2. Dapat pairing code
  3. Submit pairing code dari sisi Claude/plugin command

Contoh:

/telegram:access pair ABC123

Setelah sukses, pesan dari akun Telegram kamu akan diteruskan ke assistant.

6) Hardening: Ganti ke Allowlist

Setelah pairing berhasil, jangan biarkan policy pairing/open terus.

Set policy ke allowlist:

/telegram:access policy allowlist

Lalu pastikan hanya user ID yang kamu izinkan yang boleh akses.

Konsep access policy:

  • pairing → aman untuk onboarding awal
  • allowlist → aman untuk production
  • open → jangan dipakai kecuali environment eksperimen tertutup

Arsitektur Production yang Direkomendasikan

                    Internet
                       |
                [Telegram Cloud]
                       |
                [Bot API Traffic]
                       |
             +---------------------+
             |  VPS / Home Server  |
             |---------------------|
             | Claude Code Session |
             | Telegram Plugin     |
             | Logs + Monitoring   |
             +---------------------+
                       |
             (Optional Private Access)
                       |
                   [Tailscale]

Kalau dipakai harian:

  • jalankan session via systemd/tmux,
  • simpan logs,
  • batasi siapa yang boleh DM bot,
  • dan rotasi token jika ada indikasi kebocoran.

Contoh Workflow Nyata

Misalnya kamu lagi di luar rumah, cuma pegang HP:

A) Trigger task coding

“Refactor service auth supaya token refresh pakai rotation, lalu kasih ringkasan perubahan.”

B) Minta status

“Progress sampai mana? test result?”

C) Finalize

“Kirim summary final + daftar file yang diubah.”

Ini sangat berguna buat workflow async, terutama kalau kamu develop sambil mobile.

Best Practices (Supaya Stabil)

  1. Always start private, then open selectively
    Mulai dari pairing + allowlist, bukan open.

  2. Pisahkan bot production vs bot eksperimen
    Jangan campur channel penting dengan playground.

  3. Gunakan user ID, bukan username, untuk policy
    Username bisa berubah, user ID lebih stabil.

  4. Aktifkan observability sederhana
    Log incoming/outgoing event + error untuk debug cepat.

  5. Batasi command yang sensitif
    Kalau ada tool/action berisiko tinggi, pakai checkpoint approval.

  6. Rotasi bot token secara periodik
    Minimal saat ada gejala akses mencurigakan.

Common Mistakes (Sering Banget Terjadi)

❌ 1) Lupa relaunch dengan channel flag

Gejala: bot hidup, tapi Claude tidak merespons.

Fix: pastikan launch command memang include channel plugin Telegram.

❌ 2) Tetap di mode pairing/open terlalu lama

Gejala: user random bisa trigger pairing flow.

Fix: setelah pairing sukses, langsung pindah ke allowlist.

❌ 3) Token disimpan di tempat yang salah

Gejala: token tercapture di shell history / repo.

Fix: simpan di env file aman, jangan commit ke git.

❌ 4) Mengira bot bisa baca history lama

Telegram Bot API pada praktik umum cenderung event-driven (push saat message masuk), bukan historical search penuh.

Fix: untuk konteks lama, kirim summary manual ke bot.

❌ 5) Tidak ada process supervisor

Gejala: session mati saat SSH putus / reboot.

Fix: gunakan tmux atau systemd service.

Advanced Tips

1) Jalankan dengan systemd (Linux)

Contoh unit service:

[Unit]
Description=Claude Code Telegram Channel
After=network.target

[Service]
User=dev
WorkingDirectory=/home/dev
Environment=TELEGRAM_BOT_TOKEN=123456789:AAxxxxxxxxxxxxxxxx
ExecStart=/usr/local/bin/claude --channels plugin:telegram@claude-plugins-official
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

Enable:

sudo systemctl daemon-reload
sudo systemctl enable claude-telegram.service
sudo systemctl start claude-telegram.service
sudo systemctl status claude-telegram.service

2) Segmentasi akses per environment

  • Bot A: production
  • Bot B: staging/testing

Dengan ini, kalau bot test kacau, production tidak ikut terdampak.

3) Incident playbook (wajib punya)

Kalau curiga bot diakses pihak asing:

  1. revoke token via BotFather
  2. update token di config
  3. restart service
  4. audit log 24 jam terakhir
  5. reset allowlist jika perlu

Checklist Deployment Cepat

  • Bot dibuat via BotFather
  • Plugin Telegram terinstall
  • Token tersimpan aman
  • Session relaunched dengan channel flag
  • Pairing berhasil
  • Policy diganti ke allowlist
  • User ID valid diverifikasi
  • Service persistent (tmux/systemd)
  • Logging basic aktif

Kalau semua checklist ini hijau, setup kamu sudah layak dipakai harian.

Summary & Next Steps

Di tutorial ini kamu sudah belajar:

  • cara setup Claude Code Telegram plugin dari nol,
  • cara pairing akun Telegram ke assistant,
  • cara hardening keamanan dengan allowlist,
  • dan praktik production agar stabil.

Next steps yang saya sarankan:

  1. Tambah observability (alert saat service down)
  2. Terapkan approval checkpoint untuk action high-risk
  3. Pisahkan bot prod dan staging
  4. Integrasikan dengan workflow coding kamu (daily command templates)

Kalau kamu mau, tahap berikutnya kita bisa bikin template SOP operasional (onboarding user baru, token rotation, incident response) supaya setup ini siap dipakai tim, bukan cuma personal.

References

  1. Dev.to – Claude Code Telegram Official Plugin: Complete Setup Guide 2026
    https://dev.to/czmilo/claude-code-telegram-plugin-complete-setup-guide-2026-3j0p

  2. Anthropic official plugin repository (Telegram plugin docs & access policy)
    https://github.com/anthropics/claude-plugins-official

  3. Telegram Bot API tutorial (BotFather/token fundamentals)
    https://core.telegram.org/bots/tutorial

  4. OpenClaw docs (operational context for chat-agent gateway patterns)
    https://docs.openclaw.ai