Claude Code Telegram 教學：用官方 Channels 從手機操作本機專案（2026） | MO Stories

最後更新：2026-03-29

先說結論：現在真的可以用 Telegram 操作 Claude Code 嗎？

可以。現在也不用再把它當成社群 hack。

依 Claude Code 最新官方文件，Channels 已經支援 Telegram、Discord、iMessage 的 research preview。你可以把 Telegram 訊息直接推進正在本機執行的 Claude Code session，讓 Claude 在你離開 terminal 的時候，照樣接到訊息、回訊息，甚至在有設定權限轉發時，遠端批准或拒絕工具使用。

但這裡有一個很重要的前提：Telegram 不是把你的專案搬到雲端跑。

Claude Code 還是跑在你自己的電腦上。Telegram 在這條架構裡，比較像一個外部入口。你在手機上傳訊息，Telegram bot 收到後交給本機的 channel plugin，再把事件推進你已經開著的 Claude Code session。

所以如果你要一句最短答案，我會這樣說：

想用手機接續本機工作流，Telegram + Channels 現在可以做。
想 24 小時都收得到訊息，本機或背景 session 要一直活著。
想遠端批准敏感指令，先把 allowlist 和 permission relay 搞懂，再上線。

如果你還沒用過 Claude Code，建議先讀主文 Claude Code 教學與實戰指南：從安裝、指令到專案工作流（2026），再回來做 Telegram 這條線，會順很多。

如果你正在找的是手機直接接手本機 session，而不是聊天入口，請改看 Claude Code Remote Control 教學：怎麼從手機延續本機 session（2026）。
如果你卡的是 allowlist、auto mode 或權限提示，請直接接著讀 Claude Code 權限怎麼設？permission modes、allowlist 與安全設定完整整理（2026）。

Claude Code Telegram 的架構到底是什麼？

很多人一看到「用 Telegram 操作 Claude Code」，直覺會以為這是另一個聊天機器人。

其實不是。

比較準確的理解是：

Claude Code session 跑在你的本機
Telegram plugin 也跑在你的本機
Telegram bot 收到訊息後，plugin 會把事件推進目前那個 session
Claude 如果要回覆，會透過同一條 channel 回到 Telegram

這代表兩件事。

第一，你不用把 repo 丟到第三方服務。
第二，訊息只有在 session 活著的時候才會進來。

官方文件也有講得很清楚：Channels 是把外部事件推進「你已經開著的那個 session」，不是每次來一則訊息就幫你重新開一個雲端 Claude。

這種設計的好處是上下文很連續。你上午在電腦前讓 Claude 看 repo，下午去外面買咖啡時，可以直接用手機繼續問它「剛剛那個 PR 風險在哪」、「幫我再看一下那支 migration script」。它接到的不是陌生對話，而是你原本那個工作 session。

Claude Code Telegram 適合什麼情境？

這條線不是給每個人都一樣有用。

最適合的 4 種情境

你常在本機跑長任務，中間會離開座位
你想從手機看 Claude 現在做到哪裡
你想在外面先回一句指令，不想重開整個工作流
你需要遠端批准工具使用，但又不想直接把權限全開

不太適合的情境

你希望完全不用開電腦，手機就能獨立跑整個專案
你還沒先搞懂 Claude Code 的基本權限模型
你要把它接到公共群組或陌生使用者都能觸發的 bot
你想省掉所有人工驗收

Telegram 這條線最有價值的地方，不是拿來取代本機，而是把「本機 session 的可達性」拉出去。

前置條件：開始前你要先有什麼？

根據官方 Channels 文件，Telegram 這條線至少要滿足下面幾個條件：

Claude Code v2.1.80 以上
使用 claude.ai 帳號登入
不能只靠 Console / API key 驗證
預建 channel plugins 需要 Bun
Team / Enterprise 需要管理員先在組織層開啟 channels

這些限制不能跳過。尤其是 claude.ai login 這點很重要。你如果現在是拿 API key 跑腳本，很可能會以為自己已經「有 Claude 了」，但 Channels 這條線不是這樣算。

另外還有一個常被忽略的點：

訊息只會在 session 開著時進來。

如果你想做成像客服 bot 那樣 24 小時待命，就不是單純開一次 terminal 而已。你要讓 Claude Code 在背景程序或持久 terminal 裡持續執行，不然 bot 不會回。

Step 1：先用 BotFather 建 Telegram bot

Telegram 這一步很單純，但很多人會卡在最開始的 token 沒有收好。

官方流程是：

打開 Telegram 裡的 BotFather
傳 /newbot
幫你的 bot 取一個顯示名稱
設一個結尾是 bot 的唯一 username
複製 BotFather 回給你的 token

這個 token 就是後面 plugin 要吃的憑證。

這一步沒什麼技術難度，但要注意兩件事：

不要把 token 直接貼到公開 repo 或截圖裡
如果你懷疑 token 洩漏，直接回 BotFather 重置

Step 2：在 Claude Code 裡安裝 Telegram plugin

官方 research preview 的 Telegram plugin，不是你自己瞎猜插件名。文件已經寫死了安裝方式：

/plugin install telegram@claude-plugins-official

如果 Claude Code 跟你說找不到 plugin，通常不是 Telegram 壞了，而是你的 plugin marketplace 沒更新。

官方給的補救路徑是：

/plugin marketplace update claude-plugins-official

如果你以前沒加過這個 marketplace，還可以先補：

/plugin marketplace add anthropics/claude-plugins-official

然後重新安裝一次。
安裝完後，再跑：

/reload-plugins

這樣 configure command 才會被載進來。

Step 3：把 BotFather 的 token 配進 Claude Code

裝好 plugin 後，下一步是設定 token：

/telegram:configure <token>

官方文件提到，這個動作會把 token 存到：

~/.claude/channels/telegram/.env

你也可以改成先在 shell 環境變數裡設好 TELEGRAM_BOT_TOKEN，再啟動 Claude Code。

如果你是單人使用，讓 plugin 自己存進 ~/.claude/... 通常最直覺。
如果你是團隊或要管理多套環境，環境變數會比較乾淨。

Step 4：重啟 Claude Code，明確帶上 channels

這一步很多人會忘。
就算你裝好了 plugin，也不是馬上就會收 Telegram 訊息。

你要退出目前 session，重新用 --channels 啟動：

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

官方文件說得很明確：Telegram plugin 會在這時候開始 polling 你的 bot 訊息。

如果你 bot 明明建好了，token 也設了，卻完全沒反應，先不要懷疑 Telegram API。先回頭看你是不是根本沒有用 --channels 啟動。

Step 5：pair 你的 Telegram 帳號

這一步是安全關鍵，不是裝完就自動完成。

官方流程是：

在 Telegram 裡先隨便傳一則訊息給你的 bot
bot 會回你一組 pairing code
回到 Claude Code，執行：

/telegram:access pair <code>

這樣 Claude Code 才知道哪個 Telegram 帳號是你要授權進來的使用者。

如果你在 Telegram 裡傳了訊息，bot 完全沒回，官方文件也直接提醒了：先確認 Claude Code 是真的用 --channels 跑著。因為 channel 沒活著的時候，bot 不會自己回。

Step 6：立刻鎖 allowlist，不要讓任何人都能傳

配對完最重要的一步，就是把存取策略鎖起來：

/telegram:access policy allowlist

這一步不能省。

因為 Channels 的本質，是把外部文字直接推到你本機的 Claude Code session 前面。
如果你沒有 sender gating，這就會變成標準的 prompt injection 入口。

官方文件在 Channels reference 也講得很直白：一個沒有 gating 的 channel，本身就是 prompt injection vector。

換成白話就是：

你如果不限制 sender，任何能碰到這支 bot 的人，都有機會把文字塞進你現在的工作 session。

這不是「可能有點危險」，而是設計上就一定要防。

Permission relay 是什麼？為什麼 Telegram 這條線一定要懂它

這是 Telegram 文章裡最值得理解的一段。

很多人想做 Telegram 控制 Claude Code，不只是想收訊息，而是想做到這種感覺：

Claude 想跑某個指令
它在 Telegram 上問你要不要允許
你回 yes 或 no
本機 session 繼續跑

這件事在官方文件裡叫 permission relay。

它實際在做什麼？

官方 reference 的意思很清楚：

channel 可以宣告 claude/channel/permission
當 Claude Code 本地跳出工具權限提示時，這個提示可以被轉發到 channel
遠端的人可以回傳 allow / deny verdict

再講更白一點，就是把本來只能在 terminal 前面按的那個「准不准執行」，搬到遠端。

為什麼這很有用？

因為很多真實情境是這樣：

你人在外面
本機 session 還在跑
Claude 想執行某個 Bash / Write / MCP 工具
你不想把整個環境開成全自動
但你又不想每次都等回到電腦前才批准

Telegram 這時候就很像一個遙控批准器。

為什麼也很危險？

官方文件也警告得很直接：

任何能透過這條 channel 回應的人，都可能批准或拒絕你 session 裡的工具使用。

所以如果你要開 permission relay，前提一定是：

sender 已經被認證
allowlist 已經設好
你知道這支 bot 不會被外人碰到

不然你等於把 terminal 上的「允許執行」按鈕丟到外面去。

Telegram 和 Remote Control 差在哪？

這兩條線很容易被混在一起，但其實用途不同。

Telegram / Channels

比較像：

把外部訊息推進正在跑的 session
用聊天入口控制或補充上下文
適合離開座位時快速回一句、收事件、收批准提示

Remote Control

比較像：

直接從手機、平板或瀏覽器接手本機 session
進入的是完整的 Claude Code 控制介面
適合你想延續工作，而不只是回一條聊天訊息

如果你要的是這種完整接手，而不是 Telegram 訊息橋接，直接看 Claude Code Remote Control 教學：怎麼從手機延續本機 session（2026）。

如果你是：

想要「我在 Telegram 回一句，它就繼續」：選 Channels
想要「我在手機上完整接手剛剛那個 session」：選 Remote Control

這兩條線不是互斥，而是不同層級的遠端操作。

Claude Code Telegram 最常見的 6 個卡點

1. plugin 裝不起來

先檢查 marketplace 有沒有更新，必要時重跑：

/plugin marketplace update claude-plugins-official

2. bot 建好了，但完全沒回

多半不是 BotFather 問題，而是你沒有用 --channels 啟動 Claude Code。
官方文件有直接寫：channel 沒活著，bot 不會自己回。

3. token 配好了，但換機器就不能用

因為它預設存到 ~/.claude/channels/telegram/.env。
這是使用者層設定，不是跟 repo 一起走。

4. Team / Enterprise 明明有帳號，還是不能開

官方文件寫得很明確：組織層要先開 channelsEnabled。
如果管理員沒開，你本機就算裝好了 plugin，也不會真的註冊成功。

5. 想做 24 小時 bot，結果電腦睡眠後全斷

因為 Claude Code 還是跑在你的本機。
你的 session 掛了、terminal 關了、電腦睡了，這條橋也就沒了。

6. 開了 permission relay 後反而更緊張

這很正常。
因為你終於意識到，Telegram 這條線不是只是收聊天訊息，而是開始碰到真實工具權限。這時候不要急著把所有東西開掉，先從可驗收的小場景開始。

這一段如果你想更完整搞懂，可以接著讀 Claude Code 權限怎麼設？permission modes、allowlist 與安全設定完整整理（2026）。

我會怎麼建議你開始？

如果你今天是第一次做這條線，我會建議你照這個順序：

先把 Claude Code 本機基本工作流走順
再裝 Telegram plugin
先測試單純收訊息和回訊息
配對完立刻鎖 allowlist
最後才碰 permission relay

不要一開始就把目標設成：

「我要在手機上遠端全自動控制整個專案。」

這種很容易失敗。

比較穩的做法，是先把它當成一條延伸本機 session 的聊天入口。先讓你收得到、回得動、控得住，再慢慢加權限與自動化。

Claude Code Telegram 常見問題 FAQ

Claude Code Telegram 需要 API key 嗎？

這條官方 Channels 流程不是只靠 API key。依目前文件，它要求 claude.ai 登入，Console 和 API key authentication 不支援。

Claude Code Telegram 一定要用 Bun 嗎？

如果你用官方 research preview 的預建 channel plugins，要。官方文件直接寫這批 plugin 是 Bun scripts。

Claude Code Telegram 可以 24 小時在線嗎？

可以，但前提不是 Telegram 本身，而是你的 Claude Code session 要一直活著。你需要背景程序、持久 terminal，或其他穩定的本機運行方式。

Claude Code Telegram 跟 Remote Control 哪個比較適合手機？

如果你只是想從手機丟訊息、收事件、做權限批准，Telegram 比較適合。
如果你想完整接手 session，Remote Control 會比較直接。

Claude Code Telegram 安全嗎？

安全與否，重點不在 Telegram 三個字，而在你有沒有做好 sender gating、allowlist 和權限控管。沒有這些，channel 本身就是 prompt injection 入口。

結語：這條線最有價值的，不是酷，是可達性

很多人看到 Claude Code + Telegram，第一反應會是「這很酷」。

但我覺得真正有價值的地方不是酷，而是可達性。

你原本只能坐在電腦前面操作的 session，現在可以被手機碰到；你原本只能在 terminal 上按的批准，現在有機會被遠端接住；你原本離開座位就中斷的工作流，現在多了一條延續的路。

這條線很值得做，但不要把它當玩具。它碰到的是你真實的 repo、真實的權限、真實的工作流。

先把基本盤收好，再把 Telegram 接上去，這樣你用起來才會穩。

參考來源

資料最後查核日期：2026-03-29