用 Telegram 遠端操控 Claude Code：完整踩坑教學
從 MCP failed 到 connected，一步步解決 Windows 上的 Channels 整合問題
April 2026·Claude Code v2.1.109·適用平台：Windows
目錄
- 前言：Claude Code Channels 是什麼
- 前置需求 claude.ai 登入、Bot 設定
- 安裝與啟動 plugin install、–channels 旗標
- 常見錯誤與解法 Auth 衝突、MCP failed、Bun
- 確認成功運作
- 已知限制與現況
前言：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
近期留言