2026 年如何透過 Telegram 在手機上控制 Claude Code

更多工具設定資料請參閱 Ailoot 文件。

Claude Code Channels 是什麼？為什麼需要它？#

2026 年 3 月 20 日，Anthropic 發布了 Claude Code Channels，這是一款將 Claude 工作階段連接到訊息應用程式的官方外掛。支援 Telegram、Discord 和 iMessage。此功能目前處於研究預覽階段：文件位於 code.claude.com/docs/en/channels，外掛原始碼則在公開儲存庫 anthropics/claude-plugins-official。

簡單來說，它是手機與 Claude Code 工作階段之間的「聊天橋接」。我傳訊息給機器人：「繼續改寫定價表格；在 business/products/practicum/README.md 中，更新下一梯次的日期。」機器人會將訊息轉送到 VPS 上的工作階段。Claude 取得上下文、編輯檔案、提交變更，然後在 Telegram 回覆：「完成了，查看一下提交紀錄。」筆電就留在家裡闔著。

⚠️ 研究預覽的主要限制： Channels 是 MCP 橋接。工作階段必須在你的電腦或 VPS 上執行。工作階段關閉時，就沒有人會收到訊息。因此，必須另外設定 24/7 運作（請參閱下方的 VPS 章節）。

Channels 與其他遠端工作方式有何不同

Anthropic 在官方文件中提供了直接比較表。以下是改編版本：

Channels 和 Remote Control 的主要差異是：Remote Control 就像「把手機當成終端機的視窗」——你會直接看到游標並按下按鈕。Channels 則是以本機 Claude 工作階段為大腦的聊天機器人。使用 Remote Control 時，我會看著終端機；使用 Channels 時，我會傳訊息給一個能讀取我檔案的對象。

如果你需要透過畫面完整操控，請使用 Remote Control。如果你想「傳個問題，繼續過自己的日子，之後再收到回覆」，就使用 Channels。我兩者都用：需要核准重要變更時用 Remote Control；對工作有把握、想把晚上的時間留給自己時用 Channels。

開始前需要準備什麼#

開始輸入指令前，先確認以下清單：

1. Anthropic 帳戶。 你需要 Pro、Max、Team 或 Enterprise。免費方案無法使用 Channels。Anthropic Console API 金鑰也受支援；若 Console 組織部署受管理設定，請確認其中已啟用 channels。
2. Claude Code v2.1.80 或更新版本。 使用 claude --version 檢查。如果版本較舊，請用 claude update 或 npm install -g @anthropic-ai/claude-code@latest 更新。
3. Bun。 Channels 外掛是 Bun 指令碼，不是 Node 指令碼。使用 bun --version 檢查。如果尚未安裝，請執行 curl -fsSL https://bun.sh/install | bash，然後執行 source ~/.bashrc。
4. Telegram 帳戶。 任何帳戶都可以；最重要的是你已在手機登入。
5. 如果你使用 Team/Enterprise 方案， 請管理員在受管理設定中或透過 admin-settings/claude-code 啟用 channelsEnabled。組織預設會停用此功能。

如果你第一次聽到 Bun，不用擔心。Bun 是另一種 JavaScript 執行環境，類似 Node。Anthropic 為 Channels 外掛選用 Bun，因為它啟動速度較快，也更容易封裝成單一二進位檔。安裝一次就不用再操心。

⚠️ Channels 目前無法搭配企業版 Bedrock / Google Vertex / Azure Foundry 使用。 它只支援 claude.ai 驗證或 Anthropic Console。

步驟 1. 透過 BotFather 建立 Telegram 機器人#

BotFather 會幫你處理所有事情——你只需要按五個按鈕。步驟如下：

1. 在 Telegram 開啟 @BotFather（可以用手機操作；其餘設定也能在手機上完成）。
2. 如果是第一次使用，請按「Start」。
3. 傳送 /newbot 指令。
4. BotFather 會問：「好的，新機器人。要叫它什麼名字呢？」輸入顯示名稱，例如 我的助理 - Claude Code。
5. 接著它會詢問使用者名稱。名稱必須在整個 Telegram 中獨一無二，且以 bot 結尾。例如 my_claude_bot 或 my_dev_bot。
6. BotFather 會回覆類似以下訊息：

Done! Congratulations on your new bot. You will find it at
'<OFFICIAL_URL>'.

Use this token to access the HTTP API:
1234567890:AAHzlAU...

Keep your token secure and store it safely, it can be used by anyone to control your bot.

複製權杖。兩分鐘後就會用到。

⚠️ 權杖安全。 機器人權杖能讓人完全控制機器人。若權杖外洩，任何人都能以機器人身分傳訊息，並（可能）攔截你傳給 Claude 的訊息。不要將它發布在儲存庫、貼進程式碼或傳到聊天中。我會把權杖存放在 ~/.claude/channels/telegram/.env；下一個步驟中，外掛會將它放在該處。

步驟 2. 在 Claude Code 安裝 Telegram 外掛#

在平常使用 Claude 的任意資料夾開啟終端機，並執行：

claude

在工作階段中輸入斜線指令：

/plugin install telegram@claude-plugins-official

如果 Claude 回覆「在任何市集中都找不到外掛」，代表你的用戶端不知道官方市集。請加入市集：

/plugin marketplace add anthropics/claude-plugins-official

如果之前已加入，則更新它：

/plugin marketplace update claude-plugins-official

安裝成功後，重新載入外掛以啟用其指令：

/reload-plugins

現在應該會看到 /telegram:configure 和 /telegram:access 等斜線指令。輸入 /help 即可檢查；清單中應該會有 telegram 區段。

步驟 3. 將權杖連結到外掛#

在 Claude 工作階段中輸入：

/telegram:configure 1234567890:AAHzlAU...

此指令會將權杖放到 ~/.claude/channels/telegram/.env。該檔案只有你的使用者能存取（chmod 600），所以不用擔心。

你也可以透過環境變數設定權杖。如果使用 systemd 或 Docker 部署 Claude，且不想使用互動式指令，這種方式很有用：

export TELEGRAM_BOT_TOKEN="1234567890:AAHzlAU..."
claude --channels plugin:telegram@claude-plugins-official

⚠️ 在正式環境中，我一律使用環境變數，而不是放在家目錄 ~/ 的 .env 檔案。這樣更容易透過 systemd（Environment=TELEGRAM_BOT_TOKEN=...）管理機密，也能避免不小心把 ~/.claude/ 拉進儲存庫。

步驟 4. 使用 --channels 旗標重新啟動 Claude#

這是最重要的一點，也是大家第一次執行時最容易卡住的地方。只安裝外掛還不夠。 若要讓機器人真正開始接收訊息，必須使用明確的旗標啟動 Claude：

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

沒有這個旗標，工作階段仍會照常運作，但 Telegram 外掛處於休眠狀態。加上旗標後，Claude 會啟動外掛的 MCP 伺服器，開始輪詢 Telegram API，並回覆傳給機器人的訊息。

啟動後，終端機應該會顯示類似以下內容：

✻ Welcome to Claude Code 2.1.80
  Channels: telegram@claude-plugins-official (active)
  Polling for messages...

如果沒有顯示 channels 相關行，代表旗標未生效。請檢查 Claude Code 是否為 2.1.80+，並確認外掛已安裝（在工作階段中執行 /plugin list）。

⚠️ 方便的小技巧。 我在 ~/.zshrc 中設定了別名：

alias claude-tg="claude --channels plugin:telegram@claude-plugins-official"

之後只要執行 claude-tg 即可。你可以用空格分隔並傳入多個外掛：--channels plugin:telegram@... plugin:discord@...。

步驟 5. 配對帳戶並封鎖其他所有人#

這個步驟關乎安全。獲准發送者能要求 Claude 操作工作階段可用的檔案與工具。 只配對預定帳戶，依賴機器人前先鎖定發送者政策。

步驟：

1. 在 Telegram 開啟你的機器人。 搜尋使用者名稱 @my_claude_bot，或使用 BotFather 回覆中的連結。按下「Start」。
2. 傳送任意訊息給機器人。 例如 hi。
3. 機器人會回覆配對碼。 格式大致如下：

Hi! To pair this account, run in your Claude Code session:
/telegram:access pair 847291

This code is valid for 5 minutes.

4. 回到終端機。 在 Claude 工作階段中輸入回覆裡的指令：

/telegram:access pair 847291

Claude 會回覆「帳戶已配對」。現在你的 Telegram 帳戶可以傳送指令。

5. 啟用允許清單政策。 這會封鎖所有尚未配對的帳戶：

/telegram:access policy allowlist

完成後，其他帳戶傳來的訊息會直接忽略，不會通知你。訊息不會出現在終端機中，機器人也不會回覆——就像從未收到訊息一樣。

⚠️ 配對後立刻啟用允許清單非常重要。 不要留到之後再做。 設定期間不要核准陌生配對請求，也別把收到回覆當成發送者政策正確的證明。第一次使用時，我讓機器人在未設定允許清單的情況下執行了十分鐘，期間有兩位陌生 Telegram 使用者傳了「hi」。幸好當時我沒有允許指令寫入檔案。

如果需要新增其他人（例如專案夥伴）：

/telegram:access pair <對方帳戶的代碼>

對方必須先傳訊息給機器人取得代碼，再交給你。只能透過這種方式新增。

更多指南請參閱 Ailoot 文件。

如何在自己的 VPS 上讓 Claude 24/7 運作#

如果你想讓機器人「全天候運作」，而不是「打開筆電一小時戳戳看」，工作階段就必須持續執行。在本機可以用 tmux 達成，但 VPS 更簡單也更可靠。

在一個設定範例中，所用的 Coolify VPS 同時也架設了網站（詳情請參閱透過 Coolify 發布的指南）。你也可以使用同一台伺服器——Claude 使用的記憶體很少。如果你沒有 VPS，可以租用最便宜的方案，每月 4–5 歐元，例如 Hetzner CX11 / Yandex Cloud / Selectel。

步驟 1：在 VPS 上安裝系統

先由管理員建立專用 Unix 帳戶與工作目錄。若重用既有帳戶，應先確認 home 與所有權：

sudo useradd --create-home --shell /bin/bash claude
sudo install -d -o claude -g claude /home/claude/workspace
sudo -iu claude

接下來在 claude 登入 shell 執行，不要使用 root 家目錄。透過官方安裝器安裝 Bun，並依原生安裝流程 安裝 Claude Code：

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

為同一使用者開新的登入 shell，讓 PATH 變更生效，並確認帳戶與執行路徑：

whoami
printf '%s\n' "$HOME"
command -v bun
command -v claude
bun --version
claude --version
cd /home/claude/workspace
claude

whoami 必須是 claude，HOME 必須為 /home/claude。記錄 command -v 回傳的絕對路徑，將實際 Claude 路徑用於 ExecStart，並把 Bun 目錄放入服務 PATH；任何執行檔缺少時先停止。

步驟 2：以服務使用者驗證、安裝與配對

在同一個互動式 claude 工作階段完成登入，再以此 Unix 使用者重做上方步驟 2–5：在 user scope 安裝 Telegram 外掛、設定 token、以 --channels 重啟、配對 Telegram 帳戶並設定 policy allowlist。設定服務前先確認訊息與回覆。不要把 root 的 Claude 設定或憑證複製到此 home。

claude.ai 訂閱與 Anthropic Console API 金鑰驗證都受支援。Team／Enterprise 需要組織啟用，受管理 Console 組織也要符合 channels 設定。Console 按 API 收費，不由 claude.ai 訂閱支付；從互動 shell 移到服務時，維持同一帳戶與驗證方法。

步驟 3：使用 systemd 執行工作階段

先退出服務使用者 shell，再由管理員建立 unit。下例假設查得路徑為 /home/claude/.local/bin/claude 及 /home/claude/.bun/bin/bun；不同時請換實際輸出。提供同一驗證環境與 bot token，unit 只讓管理員讀取，機密不可提交。接著建立自動啟動與當機重啟服務：

cat > /etc/systemd/system/claude-code.service <<'EOF'
[Unit]
Description=Claude Code with Telegram channel
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
User=claude
WorkingDirectory=/home/claude/workspace
Environment="HOME=/home/claude"
Environment="TELEGRAM_BOT_TOKEN=1234567890:AAH..."
Environment="PATH=/home/claude/.local/bin:/home/claude/.bun/bin:/usr/local/bin:/usr/bin:/bin"
ExecStart=/home/claude/.local/bin/claude --channels plugin:telegram@claude-plugins-official --dangerously-skip-permissions
Restart=on-failure
RestartSec=10

[Install]
WantedBy=multi-user.target
EOF

systemctl daemon-reload
systemctl enable claude-code
systemctl start claude-code

以下是我設定的內容：

• Type=simple — 簡易模式；程序一啟動，systemd 就會視為已啟動。
• User=claude — 使用獨立使用者執行，而非 root，安全性較高。
• WorkingDirectory=/home/claude/workspace — 已準備好、歸服務使用者所有的工作目錄。啟動前放入正確儲存庫，不要留下 root 擁有的 clone 或從 root home 執行。
• Environment=TELEGRAM_BOT_TOKEN=... — 直接將權杖傳給程序。無須 .env 檔案。
• --dangerously-skip-permissions — 無人值守操作的關鍵。若沒有此旗標，Claude 每次操作前都會在終端機等待你回答「是／否」，工作階段便會卡住。允許清單辨識發送者，不代表其指令安全；只在檔案、憑證及網路權限刻意受限的隔離環境使用 bypass。
• Restart=on-failure — 如果程序當機（Claude 當機或網路中斷），systemd 會在 10 秒後重新啟動。

使用以下指令查看記錄：

journalctl -u claude-code -f

如果發生問題，journalctl -u claude-code -n 100 會顯示最近 100 行。

步驟 4：確認機器人正常運作

互動設定收到真實 Telegram 回覆後，才啟動服務。再從已配對帳戶傳同一機器人一則無害訊息，確認回覆與服務日誌。若互動正常、systemd 失敗，先核對 Unix 使用者、HOME、workspace、執行路徑、PATH 與驗證環境。

日後變更配對時，先停止服務，執行 sudo -iu claude，進入 /home/claude/workspace，以相同 channel 互動啟動；配對並啟用允許清單後退出，再啟動服務。同一 bot 不要同時執行第二個 poller。journalctl 只讀日誌，不提供互動 Claude 提示。

生產伺服器上的 5 個陷阱與避免方式#

1. systemd 的 PATH 中沒有 Bun

systemd 以精簡環境啟動程序，不會讀取 ~/.bashrc 中的變數。若只在 root home 安裝 Bun，但服務設為 User=claude，服務不會繼承該安裝或 root shell PATH。

解決方法。 將 Bun 安裝到系統層級（/usr/local/bin/bun），或明確傳入 PATH：

Environment="PATH=/home/claude/.bun/bin:/usr/local/bin:/usr/bin:/bin"

2. 閒置一段時間後，與 Telegram API 的 TCP 連線中斷

閒置 6–12 小時後，機器人可能會「安靜下來」——訊息已傳到 Telegram，但外掛沒有收到。這是長輪詢的特性問題。

解決方法。 在 systemd 中加入定期重新啟動（每 24 小時一次）：

Restart=always
RuntimeMaxSec=86400

或設定 cron 工作：0 5 * * * systemctl restart claude-code（凌晨 5 點重新啟動）。

3. Claude Max 額度在白天用完

如果你經常透過 Telegram 使用 Claude，Max 5x 方案（每月約 $100）可能在 4–6 小時內用完額度。Telegram 請求與一般終端機請求並無不同，會使用相同額度。

解決方法。 設定提醒：「機器人沒有回應——檢查 /stats。」如果額度用完，可以等額度重設，或升級到 Max 20x（$200/月）。節省 token 指南和Sonnet 與 Opus 模型指南可能有所幫助。

4. 即使有允許清單，--dangerously-skip-permissions 仍然很危險

這個旗標會停用所有確認。你在 Telegram 傳送的任何指令都會直接執行，不會詢問：刪除檔案、傳送外部請求，任何事情都可以。有一次，我要求 Claude「移除不必要的 console.log 陳述式」，它清理得太起勁，把生產指令碼的一半偵錯記錄都刪掉了。我透過 git 還原，但損害已經造成。

解決方法。 如果你正在處理重要專案，就不要啟用 --dangerously-skip-permissions。改用 Remote Control 執行工作階段——權限請求會傳到手機，由你手動核准。搭配 --dangerously-skip-permissions 使用 Channels，適合粗略草稿、重構和測試。

5. 重新安裝後，允許清單會「失效」

允許清單儲存在 ~/.claude/channels/telegram/。如果你換到新的 VPS、重新安裝 Claude 或更換使用者，就不會載入舊的配對資料。舊發送者允許清單已不存在，不能假設新執行個體沿用先前政策。

解決方法。 搬遷前備份 ~/.claude/channels/telegram/，之後再將它移回。或者重新安裝後立刻重新配對，並且不要讓機器人啟動與設定 policy allowlist 之間相隔哪怕一分鐘。

Channels 或 Remote Control——該選哪一個？#

Anthropic 幾乎同時推出這兩項功能：Remote Control 於 2026 年 2 月 25 日推出，Channels 則於 2026 年 3 月 20 日推出。兩者功能並不重複，而是解決不同問題。

我自己的使用方式如下：離開筆電時的非同步工作、CI 通知和整合使用 Channels；需要查看 Claude 正在做什麼或核准高風險步驟時使用 Remote Control。

兩者可以同時使用。Telegram 機器人提供快速「提問並取得答案」的管道；Remote Control 則提供「控制重要事項」的管道。兩者使用同一份 Claude 額度。

常見問題#

可以同時連接多個機器人嗎？

可以。--channels 旗標接受以空格分隔的清單：--channels plugin:telegram@claude-plugins-official plugin:discord@claude-plugins-official。同一個 Claude 工作階段會在兩個聊天室中回覆。

關閉終端機會怎樣？

工作階段會關閉，外掛停止，機器人也會安靜下來。在 VPS 上，systemd 會讓工作階段繼續執行。在本機電腦上，闔上筆電後，claude 會在幾秒內因 SIGHUP 中斷連線。

可以接收 CI 或 Sentry 通知嗎？

可以。Channels 是雙向管道。你可以參考 Channels Reference，自行編寫外掛，將 webhook 轉送至工作階段。Claude 會即時看到事件並回應。

Telegram 有哪些地方比 Discord 受限嗎？

基本功能相同。Discord 必須在機器人設定中啟用 Message Content Intent。iMessage 只能在 macOS 上使用，並會直接讀取 ~/Library/Messages/chat.db 資料庫。Telegram 則普遍適用。

如果我使用 Team 方案，需要做什麼？

組織管理員必須在受管理設定中或透過 admin-settings/claude-code 啟用 channelsEnabled: true。若未啟用，外掛仍會連線，但訊息不會傳送——終端機會在啟動時顯示警告。

Claude 能從我的手機看到什麼？它看得到 Telegram 聊天內容嗎？

不會。Claude 只能看到你傳給機器人的訊息。它無法存取你的 Telegram 對話歷史、聊天室清單或聯絡人。MCP 外掛只會透過 Telegram Bot API 讀取傳給機器人的訊息。

沒有 Pro/Max 訂閱，也能透過 Channels 使用 Claude 嗎？

可以，Anthropic Console API 金鑰也受支援，API 用量計入該 Console 組織。免費 claude.ai 不是本文訂閱路徑；Team／Enterprise 及受管理 Console 組織仍須符合 channels 啟用設定。

接下來可以做什麼#

機器人穩定執行後，可以進一步利用 Channels 完成以下工作：

1. 連接 CI webhook。 如果你使用 GitHub Actions / GitLab CI，可以設定 Channels 外掛，將建置結果直接轉送到工作階段。push 後若「測試失敗」，Claude 會立即看到並提出修正建議。請參閱 channels-reference 文件。
2. 搭配 Routines。 你可以在同一個工作階段執行 Routines 來處理定期工作。早上，機器人會自行傳送「早安，以下是專案摘要」，你再用手機回覆：「製作營收報告。」
3. 設定機器人監控。 如果機器人安靜下來，我希望能知道。可以在 VPS 上設定簡單的 cron 指令碼，每小時 ping Telegram 機器人一次。若機器人沒有回覆，就向另一個頻道傳送警示。若未設定，機器人可能凌晨 4 點停止，直到中午你才發現。
4. 考慮使用 hooks。 Hooks 會回應 Claude 事件（工具啟動、訊息完成）。Hooks 搭配 Channels，就能自動傳送 Telegram 通知，例如「Claude 已完成工作 N。」

不用把 Channels 加到每件事上。當你外出或在咖啡店時，它是查看工作進度的便利方式。需要認真思考時，就打開筆電坐下來。人在外面或路上時，Channels 能讓你不用一直惦記「我還要問它這件事，得打開筆電才行」。

如需更多工具使用資料，請參閱 Ailoot 文件。