Panduan

Menyiapkan Claude Code channels dengan Telegram

Claude Code channels membuat Anda bisa mengirim pesan ke sesi Claude Code yang sedang berjalan dari Telegram, Discord, atau iMessage. Claude mengerjakannya di mesin Anda dan membalas di chat. Setup-nya lima langkah: bot, plugin, token, restart dengan flag channel, dan pairing. Jebakannya, pesan hanya masuk selama sesi terbuka, jadi Mac harus tetap menyala.

Apa itu channels

Channel adalah MCP server. Channel mengirim event ke sesi Claude Code yang sudah berjalan. Komunikasinya bisa dua arah. Claude membaca pesan, bekerja, lalu menjawab lewat chat yang sama. Dokumentasi Anthropic mencantumkan Telegram, Discord, dan iMessage di research preview (code.claude.com/docs/en/channels, Oktober 2026).

Ini berbeda dari Remote Control. Remote Control membuat Anda bisa mengendalikan sesi dari aplikasi Claude. Channels membawa masuk pesan dari platform lain, dan juga webhook, misalnya CI yang gagal.

Kebutuhan

  • Claude Code yang sudah login dengan akun claude.ai atau API key Console. Channels tidak berfungsi di Amazon Bedrock, Google Cloud, atau Microsoft Foundry.
  • Di paket Team dan Enterprise, admin harus mengaktifkan channels lebih dulu. Pengguna Pro dan Max tanpa organisasi bisa langsung memakainya. Dokumentasinya juga menyebut ketersediaannya diluncurkan secara bertahap.
  • Bun. Plugin channel adalah script Bun.
  • Token bot Telegram dari BotFather, untuk channel Telegram.

Pasang komponennya

Pasang Claude Code dan Bun dengan script resmi masing-masing.

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

Di Telegram, buka BotFather dan kirim perintah newbot. Pilih nama dan username yang berakhiran bot. Salin token yang diberikan. Lalu pasang plugin-nya. Di dalam Claude Code, ini berupa slash command.

/plugin install telegram@claude-plugins-official

Dari shell biasa, CLI plugin melakukan hal yang sama. Jika marketplace-nya belum ada, tambahkan dulu.

claude plugin marketplace add anthropics/claude-plugins-official
claude plugin install telegram@claude-plugins-official

Kami menjalankan ini di mesin macOS 26 hosted GitHub pada 2 Oktober 2026, tanpa login. Instalasinya berhasil. Ini output-nya.

$ claude --version
2.1.287 (Claude Code)
$ bun --version
1.4.2
$ claude plugin install telegram@claude-plugins-official
Successfully installed plugin: telegram@claude-plugins-official (scope: user)
$ claude plugin list
  telegram@claude-plugins-official
    Version: 0.0.7
    Scope: user
    Status: enabled

Hubungkan bot dan lakukan pairing

Di dalam Claude Code, simpan token Anda. Token disimpan di folder telegram, di bawah channels, di folder config Claude Anda.

/telegram:configure <token>

Lalu keluar dan jalankan Claude Code lagi dari shell, dengan flag channel.

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

Kirim pesan apa pun ke bot Anda. Bot menjawab dengan kode pairing. Setujui kode itu di Claude Code, lalu kunci bot hanya untuk akun Anda.

/telegram:access pair <code>
/telegram:access policy allowlist

Ada dua hal yang sering membingungkan di sini. Flag channel tidak muncul di output bantuan selama masa preview, tetapi tetap berfungsi. Dan terminal menampilkan pesan masuk serta catatan terkirim, bukan teks balasannya. Balasannya muncul di Telegram.

Discord sebagai pengganti Telegram

Langkah untuk Discord polanya sama. Buat aplikasi di Discord Developer Portal dan salin token bot-nya. Aktifkan Message Content Intent. Undang bot ke server Anda dengan izin untuk melihat channel, mengirim pesan, dan membaca riwayat. Lalu pasang, konfigurasi, dan lakukan pairing dengan cara yang sama. Baris restart dijalankan di shell. Baris lainnya dijalankan di dalam Claude Code.

/plugin install discord@claude-plugins-official
/discord:configure <token>
claude --channels plugin:discord@claude-plugins-official
/discord:access pair <code>
/discord:access policy allowlist

Anda bisa memberikan beberapa plugin ke flag channels, dipisahkan spasi. Satu sesi lalu bisa mendengarkan kedua aplikasi.

Jaga sesi tetap terbuka sepanjang waktu

Event hanya sampai ke sesi yang terbuka. Tutup terminal, biarkan Mac tidur, atau reboot, dan bot jadi diam. Tiga hal mengatasinya. Matikan mode tidur. Jalankan Claude Code di dalam tmux. Mulai sesi tmux itu saat login.

sudo pmset -a sleep 0
sudo pmset -a disksleep 0
sudo pmset -a displaysleep 10

LaunchAgent ini memulai sesi tmux bernama channels dengan Claude Code dan channel Telegram. LaunchAgent mengecek setiap menit dan tidak melakukan apa pun jika sesinya sudah ada. Simpan sebagai dev.local.claude-channels.plist di folder LaunchAgents Anda.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
  "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
  <key>Label</key><string>dev.local.claude-channels</string>
  <key>ProgramArguments</key>
  <array>
    <string>/bin/zsh</string>
    <string>-lc</string>
    <string>export PATH="$HOME/.local/bin:$HOME/.bun/bin:/opt/homebrew/bin:$PATH"; tmux has-session -t channels 2>/dev/null || tmux new -d -s channels -c "$HOME" "claude --channels plugin:telegram@claude-plugins-official"</string>
  </array>
  <key>RunAtLoad</key><true/>
  <key>StartInterval</key><integer>60</integer>
</dict>
</plist>

Pasang tmux dulu jika belum ada. Lalu muat agennya dan sambungkan ke sesi untuk mengecek Claude.

brew install tmux
launchctl load ~/Library/LaunchAgents/dev.local.claude-channels.plist
tmux attach -t channels

Kami menguji file persis ini di mesin macOS 26 hosted GitHub pada 2 Oktober 2026. Dua puluh detik setelah dimuat, launchd sudah membuat sesi di folder home, dengan Claude Code menunggu di dalamnya.

$ tmux ls
channels: 1 windows (created Fri Oct  2 04:21:09 2026)
$ tmux capture-pane -pt channels
Welcome to Claude Code v2.1.287

Sesi dimulai di folder home Anda. Ganti variabel home dengan path proyek Anda jika ingin Claude mulai di sana. Pertama kali, sambungkan ke sesi, jawab pertanyaan first-run, lalu login.

Ada satu lagi penyebab macet yang perlu diantisipasi. Jika Claude bertemu prompt izin saat Anda pergi, sesi menunggu Anda. Dokumentasinya menyebut flag skip permissions untuk mesin tepercaya. Baca menjalankan Claude Code tanpa pengawasan dengan aman sebelum memakainya.

Catatan keamanan

  • Setiap channel menyimpan allowlist pengirim. Pesan dari orang lain dibuang tanpa pemberitahuan.
  • Siapa pun di allowlist bisa mengarahkan sesi Anda. Jika plugin meneruskan prompt izin, mereka juga bisa menyetujui pemakaian tool. Tambahkan hanya orang yang Anda percaya memegang mesin Anda.
  • Token bot Anda adalah password. Jika bocor, cabut di BotFather dan konfigurasikan token yang baru.
  • iMessage membaca database Messages dan butuh Full Disk Access. Di Mac sewaan, itu berarti login Apple ID Anda ke Messages di hardware yang bukan milik Anda. Telegram atau Discord menghindari hal itu.

Menjalankannya di Mac MacRun

Paket agen kami sudah memasang Claude Code. Anda login dengan paket Claude milik Anda sendiri. Mac tidak pernah tidur, dan sesinya bertahan setelah reboot. Anda menambahkan Bun dan plugin-nya, yang butuh beberapa menit. Setelah itu laptop Anda boleh ditutup, dan bot tetap menjawab.

Siapa yang tidak butuh ini. Jika Anda hanya ingin mengendalikan sesi dari ponsel, Remote Control di aplikasi Claude melakukannya tanpa bot. Dan jika admin paket Team Anda belum mengaktifkan channels, Mac baru tidak akan mengubah itu.

Untuk gambaran yang lebih luas, baca menjalankan Claude Code 24/7 di Mac.

Pertanyaan yang sering diajukan

Apakah Claude Code channels butuh API key?

+

Tidak harus. Dokumentasi Anthropic menyebut channels berfungsi dengan login claude.ai atau API key Console. Login Pro atau Max bisa dipakai, sedangkan Team atau Enterprise butuh admin untuk mengaktifkan channels.

Mengapa bot Telegram saya tidak membalas?

+

Bot hanya bisa membalas selama Claude Code berjalan dengan flag channels. Pastikan sesinya terbuka dan Mac dalam keadaan bangun.

Channel apa saja yang didukung Claude Code?

+

Research preview mencakup Telegram, Discord, dan iMessage, ditambah demo lokal bernama fakechat. Anda juga bisa membuat channel sendiri sebagai MCP server.

Mengapa --channels tidak ada di claude --help?

+

Dokumentasi Anthropic menyebut flag channel disembunyikan dari output bantuan selama research preview. Flag itu tetap berfungsi.

Panduan terkait