用 Telegram 遠端操控 Claude Code：完整踩坑教學

從 MCP failed 到 connected，一步步解決 Windows 上的 Channels 整合問題

April 2026·Claude Code v2.1.109·適用平台：Windows

目錄

1. 前言：Claude Code Channels 是什麼
2. 前置需求 claude.ai 登入、Bot 設定
3. 安裝與啟動 plugin install、–channels 旗標
4. 常見錯誤與解法 Auth 衝突、MCP failed、Bun
5. 確認成功運作
6. 已知限制與現況

前言：Claude Code Channels 是什麼

Claude Code Channels 是 Anthropic 在 2026 年 3 月推出的實驗性功能，讓你可以透過 Telegram（或 Discord）把訊息推送進正在執行的 Claude Code session。

實際的應用場景：你在外出時用手機傳一句「跑一下測試，告訴我有沒有失敗」，你的電腦上的 Claude Code 就會收到、執行，然後把結果回傳到 Telegram。

注意Channels 目前仍是 Research Preview（實驗性功能），Windows 上有已知的穩定性問題。本文記錄的是截至 v2.1.109 的實際狀況。

前置需求

• Claude Code 已安裝且版本 ≥ v2.1.109
  用 npm update -g @anthropic-ai/claude-code 更新
• 使用 claude.ai 帳號登入（Pro 或 Max）
  Channels 不支援純 API Key 認證，必須用 claude.ai 帳號
• 在 Telegram 建立 Bot（透過 @BotFather）
  取得形如 123456789:AAHfiqks... 的 Bot Token
• 安裝 Bun 執行環境（Windows 必須）
  Telegram plugin 使用 Bun 執行，這是最常被忽略的步驟

安裝 Bun（Windows 必做）

這是 Windows 上最容易卡關的地方。Telegram plugin 的 MCP server 以 Bun 執行，沒有 Bun 就會直接顯示 MCP · ✗ failed。

在 PowerShell 中執行：

powershell -c "irm bun.sh/install.ps1 | iex"

安裝完後關閉並重新開啟 PowerShell（讓 PATH 生效），確認安裝成功：

bun --version
# 應該輸出版本號，例如：1.x.x

解決 Auth 衝突

若啟動時看到這個警告：

⚠ Auth conflict: Both a token (claude.ai) and an API key
  (/login managed key) are set.

這代表同時存在兩種認證方式。Channels 功能只支援 claude.ai 登入，需要清除衝突：

claude /logout

登出後重新用 claude.ai 帳號登入，確認登入後只有一種認證方式存在。

安裝與設定 Telegram Plugin

啟動 Claude Code，在對話中執行以下指令：

/plugin install telegram@claude-plugins-official

安裝完成後設定 Bot Token：

/telegram:configure <你的 Bot Token>

設定存取權限（建議啟動後先用 pairing 模式，再切換成 allowlist）：

/telegram:access

啟動 Channels

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

啟動後會看到：

Listening for channel messages from: plugin:telegram@claude-plugins-official
Experimental · inbound messages will be pushed into this session

驗證是否成功

在 Claude Code 裡執行 /plugin list，確認顯示：

telegram Plugin · claude-plugins-official · ✔ enabled
└ telegram MCP · ✔ connected       ← 這行是關鍵！

成功標誌看到 telegram MCP · ✔ connected 就代表設定完成，可以去 Telegram 傳訊息測試了。

常見錯誤排查

telegram MCP · ✗ failed

原因：Bun 未安裝或不在 PATH 中。
解法：安裝 Bun（irm bun.sh/install.ps1 | iex），重新開啟 PowerShell 後再試。

Auth conflict 警告

原因：同時存在 claude.ai token 和 API key。
解法：執行 claude /logout 清除衝突，選擇一種登入方式。Channels 需要 claude.ai 登入。

傳訊息沒有回應（MCP 顯示 connected）

原因：你的 Telegram 使用者 ID 不在 allowlist，或是 pairing 尚未完成。
解法：執行 /telegram:access 確認存取設定，或重新執行 pairing 流程。

已知限制（截至 v2.1.109）

這個功能仍在快速迭代，以下是目前的已知狀況：

• Channels 只在 session 開啟時運作，關掉 Claude Code 就收不到訊息
• 如需長時間監聽，建議搭配 tmux 或讓終端機持續開著
• Windows 上的穩定性比 macOS/Linux 差，偶爾需要重啟
• 目前是 Research Preview，API 隨時可能變更

參考資訊

https://code.claude.com/docs/zh-TW/channels

第三方 telegram