使用 channels 將事件推送到執行中的工作階段

Channels 處於研究預覽階段。它們需要透過 claude.ai 或 Console API 金鑰進行 Anthropic 驗證，且在 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 上不可用。Team 和 Enterprise 組織必須明確啟用它們。

Channel 是一個 MCP 伺服器，可將事件推送到您執行中的 Claude Code 工作階段，讓 Claude 能對您不在終端時發生的事情做出反應。Channels 可以是雙向的：Claude 讀取事件並通過同一 channel 回覆，就像聊天橋接一樣。事件只在工作階段開啟時到達，因此對於始終開啟的設定，您可以在背景程序或持久終端中執行 Claude。與產生新鮮雲端工作階段或等待輪詢的整合不同，事件到達您已開啟的工作階段：請參閱 channels 如何比較。您將 channel 安裝為外掛程式，並使用您自己的認證進行設定。Telegram、Discord 和 iMessage 包含在研究預覽中。當 Claude 通過 channel 回覆時，您會在終端中看到入站訊息，但看不到回覆文字。終端顯示工具呼叫和確認（如「已傳送」），實際回覆會出現在另一個平台上。如果您管理 Team、Enterprise 或 Console 組織，請參閱為您的組織啟用 channels。若要建立您自己的 channel，請參閱 Channels 參考。

支援的 channels

每個支援的 channel 都是需要 Bun 的外掛程式。如需在連接真實平台之前親身體驗外掛程式流程的演示，請嘗試 fakechat 快速入門。

Telegram
Discord
iMessage

檢視完整的 Telegram 外掛程式原始碼。

建立 Telegram 機器人

在 Telegram 中開啟 BotFather 並傳送 /newbot。給它一個顯示名稱和一個以 bot 結尾的唯一使用者名稱。複製 BotFather 返回的權杖。

安裝外掛程式

在 Claude Code 中，執行：

/plugin install telegram@claude-plugins-official

如果 Claude Code 報告在任何市場中找不到該外掛程式，您的市場可能遺失或已過期。執行 /plugin marketplace update claude-plugins-official 以重新整理它，或如果您之前未新增過，執行 /plugin marketplace add anthropics/claude-plugins-official。然後重試安裝。安裝後，執行 /reload-plugins 以啟用外掛程式的設定命令。

設定您的權杖

使用來自 BotFather 的權杖執行設定命令：

/telegram:configure <token>

這會將其儲存到 ~/.claude/channels/telegram/.env。您也可以在啟動 Claude Code 之前在 shell 環境中設定 TELEGRAM_BOT_TOKEN。

在啟用 channels 的情況下重新啟動

退出 Claude Code 並使用 channel 旗標重新啟動。這會啟動 Telegram 外掛程式，開始輪詢來自您機器人的訊息：

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

配對您的帳戶

開啟 Telegram 並向您的機器人傳送任何訊息。機器人會回覆配對代碼。

如果您的機器人沒有回應，請確保 Claude Code 使用上一步的 --channels 執行。機器人只能在 channel 處於活動狀態時回覆。

回到 Claude Code，執行：

/telegram:access pair <code>

然後鎖定存取權，使只有您的帳戶可以傳送訊息：

/telegram:access policy allowlist

檢視完整的 Discord 外掛程式原始碼。

建立 Discord 機器人

前往 Discord 開發者入口網站，按一下新應用程式，並為其命名。在機器人部分中，建立使用者名稱，然後按一下重設權杖並複製權杖。

啟用訊息內容意圖

在您的機器人設定中，向下捲動至特權閘道意圖並啟用訊息內容意圖。

邀請機器人加入您的伺服器

前往 OAuth2 > URL 產生器。選擇 bot 範圍並啟用這些權限：

檢視頻道
傳送訊息
在執行緒中傳送訊息
讀取訊息歷史記錄
附加檔案
新增反應

開啟產生的 URL 以將機器人新增到您的伺服器。

安裝外掛程式

在 Claude Code 中，執行：

/plugin install discord@claude-plugins-official

設定您的權杖

使用您複製的機器人權杖執行設定命令：

/discord:configure <token>

這會將其儲存到 ~/.claude/channels/discord/.env。您也可以在啟動 Claude Code 之前在 shell 環境中設定 DISCORD_BOT_TOKEN。

在啟用 channels 的情況下重新啟動

退出 Claude Code 並使用 channel 旗標重新啟動。這會連接 Discord 外掛程式，讓您的機器人可以接收和回應訊息：

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

配對您的帳戶

在 Discord 上直接訊息您的機器人。機器人會回覆配對代碼。

如果您的機器人沒有回應，請確保 Claude Code 使用上一步的 --channels 執行。機器人只能在 channel 處於活動狀態時回覆。

回到 Claude Code，執行：

/discord:access pair <code>

然後鎖定存取權，使只有您的帳戶可以傳送訊息：

/discord:access policy allowlist

檢視完整的 iMessage 外掛程式原始碼。iMessage channel 直接讀取您的訊息資料庫，並通過 AppleScript 傳送回覆。它需要 macOS，不需要機器人權杖或外部服務。

授予完整磁碟存取權

位於 ~/Library/Messages/chat.db 的訊息資料庫受 macOS 保護。伺服器第一次讀取它時，macOS 會提示存取：按一下允許。提示會命名啟動 Bun 的任何應用程式，例如終端、iTerm 或您的 IDE。如果提示未出現或您按一下「不允許」，請在系統設定 > 隱私與安全 > 完整磁碟存取下手動授予存取權，並新增您的終端。沒有這個，伺服器會立即退出，並顯示 authorization denied。

安裝外掛程式

在 Claude Code 中，執行：

/plugin install imessage@claude-plugins-official

在啟用 channels 的情況下重新啟動

退出 Claude Code 並使用 channel 旗標重新啟動：

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

傳送訊息給自己

在任何登入您 Apple ID 的裝置上開啟訊息，並向自己傳送訊息。它立即到達 Claude：自聊天繞過存取控制，無需設定。

Claude 傳送的第一個回覆會觸發 macOS 自動化提示，詢問您的終端是否可以控制訊息。按一下 OK。

允許其他寄件者

預設情況下，只有您自己的訊息通過。若要讓另一個聯絡人到達 Claude，請新增其控制代碼：

/imessage:access allow +15551234567

控制代碼是 +country 格式的電話號碼或 Apple ID 電子郵件，例如 user@example.com。

您也可以建立您自己的 channel，用於尚未有外掛程式的系統。

快速入門

Fakechat 是一個官方支援的演示 channel，在 localhost 上執行聊天 UI，無需驗證，也無需設定外部服務。安裝並啟用 fakechat 後，您可以在瀏覽器中輸入，訊息會到達您的 Claude Code 工作階段。Claude 回覆，回覆會顯示在瀏覽器中。測試 fakechat 介面後，嘗試 Telegram、Discord 或 iMessage。若要嘗試 fakechat 演示，您需要：

Claude Code 已安裝並使用 claude.ai 帳戶或 Claude Console API 金鑰進行驗證
Bun 已安裝。預先建立的 channel 外掛程式是 Bun 指令碼。使用 bun --version 檢查；如果失敗，安裝 Bun。
Team、Enterprise 或受管 Console 組織：您的管理員必須在受管設定中啟用 channels

安裝 fakechat channel 外掛程式

啟動 Claude Code 工作階段並執行安裝命令：

/plugin install fakechat@claude-plugins-official

在啟用 channel 的情況下重新啟動

退出 Claude Code，然後使用 --channels 重新啟動並傳遞您安裝的 fakechat 外掛程式：

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

fakechat 伺服器會自動啟動。

您可以將多個外掛程式傳遞到 --channels，以空格分隔。

推送訊息進去

在 http://localhost:8787 開啟 fakechat UI 並輸入訊息：

hey, what's in my working directory?

訊息作為 <channel source="fakechat"> 事件到達您的 Claude Code 工作階段。Claude 讀取它，完成工作，並呼叫 fakechat 的 reply 工具。答案會顯示在聊天 UI 中。

如果 Claude 在您不在終端時遇到權限提示，工作階段會暫停，直到您回應。宣告權限中繼功能的 channel 伺服器可以將這些提示轉發給您，以便您可以遠端批准或拒絕。對於無人值守使用，--dangerously-skip-permissions 完全繞過提示，但僅在您信任的環境中使用。明確的詢問規則、connector 工具您的組織設定為 ask 和標記為 requiresUserInteraction 的 MCP 工具仍會提示。當您以非互動模式使用 -p 執行 channels 時，需要終端輸入的工具（例如多選題和計畫模式批准）會被停用，因此工作階段永遠不會因等待輸入而停滯。

安全性

每個已批准的 channel 外掛程式都維護寄件者允許清單：只有您新增的 ID 可以推送訊息，其他所有人都會被無聲地丟棄。 Telegram 和 Discord 通過配對啟動清單：

在 Telegram 或 Discord 中找到您的機器人並向其傳送任何訊息
機器人回覆配對代碼
在您的 Claude Code 工作階段中，在提示時批准代碼
您的寄件者 ID 會新增到允許清單

iMessage 的工作方式不同：向自己傳送訊息會自動繞過閘道，您可以使用 /imessage:access allow 按控制代碼新增其他聯絡人。除此之外，您可以使用 --channels 控制每個工作階段啟用哪些伺服器，您的組織可以使用 channelsEnabled 在 claude.ai Team 和 Enterprise 計畫以及部署受管設定的 Console 組織上控制可用性。在 .mcp.json 中還不足以推送訊息：伺服器也必須在 --channels 中命名。允許清單也會閘道權限中繼（如果 channel 宣告它）。任何可以通過 channel 回覆的人都可以批准或拒絕您工作階段中的工具使用，因此只允許清單您信任具有該權限的寄件者。

Enterprise 控制

管理員通過兩個受管設定控制可用性，使用者無法覆蓋。預設值取決於您如何驗證：

claude.ai Team 和 Enterprise：channels 被阻止，直到管理員啟用它們。
Anthropic Console 與 API 金鑰驗證：channels 預設被允許。只有在您的組織部署受管設定時才需要此設定。

在所有情況下，在使用者使用 --channels 為工作階段選擇加入之前，沒有 channel 會執行。

設定	目的	未設定時
`channelsEnabled`	主開關。必須為 `true` 才能讓任何 channel 傳遞訊息。通過 claude.ai 管理員主控台切換或直接在受管設定中設定。關閉時會阻止所有 channels，包括開發旗標。	claude.ai Team 和 Enterprise：channels 被阻止。Console：channels 被允許，除非您的組織部署受管設定，在這種情況下 channels 被阻止，直到設定此金鑰
`allowedChannelPlugins`	啟用 channels 後可以註冊哪些外掛程式。設定時替換 Anthropic 維護的清單。僅在 `channelsEnabled` 為 `true` 時適用。	應用 Anthropic 預設清單

沒有組織的 Pro 和 Max 使用者完全跳過這些檢查：channels 可用，使用者按工作階段選擇加入 --channels。

為您的組織啟用 channels

管理員可以從 claude.ai → 管理員設定 → Claude Code → Channels 啟用 channels，或通過在受管設定中將 channelsEnabled 設定為 true。啟用後，您組織中的使用者可以使用 --channels 將 channel 伺服器選擇加入個別工作階段。如果設定已停用或未設定，MCP 伺服器仍會連接，其工具可以工作，但 channel 訊息不會到達。啟動警告會告訴使用者讓管理員啟用該設定。

限制可以執行哪些 channel 外掛程式

預設情況下，Anthropic 維護的允許清單上的任何外掛程式都可以註冊為 channel。Team 和 Enterprise 計畫上的管理員可以通過在受管設定中設定 allowedChannelPlugins 來用自己的清單替換該允許清單。使用此功能來限制允許哪些官方外掛程式、批准來自您自己的內部市場的 channels，或兩者。每個條目命名一個外掛程式及其來自的市場：

{
  "channelsEnabled": true,
  "allowedChannelPlugins": [
    { "marketplace": "claude-plugins-official", "plugin": "telegram" },
    { "marketplace": "claude-plugins-official", "plugin": "discord" },
    { "marketplace": "acme-corp-plugins", "plugin": "internal-alerts" }
  ]
}

設定 allowedChannelPlugins 時，它完全替換 Anthropic 允許清單：只有列出的外掛程式可以註冊。保持未設定以回退到預設 Anthropic 允許清單。空陣列會阻止允許清單中的所有 channel 外掛程式，但 --dangerously-load-development-channels 仍可以為本地測試繞過它。若要完全阻止 channels，包括開發旗標，請改為保持 channelsEnabled 未設定。此設定需要 channelsEnabled: true。如果使用者傳遞一個不在您清單上的外掛程式到 --channels，Claude Code 會正常啟動，但 channel 不會註冊，啟動通知會解釋該外掛程式不在組織的已批准清單上。

研究預覽

Channels 是研究預覽功能。可用性正在逐步推出，--channels 旗標語法和協議合約可能會根據回饋而改變。在預覽期間，--channels 只接受來自 Anthropic 維護的允許清單的外掛程式，或來自您組織的允許清單（如果管理員已設定 allowedChannelPlugins）。claude-plugins-official 中的 channel 外掛程式是預設已批准的集合。如果您傳遞不在有效允許清單上的東西，Claude Code 會正常啟動，但 channel 不會註冊，啟動通知會告訴您原因。若要測試您正在建立的 channel，請使用 --dangerously-load-development-channels。請參閱在研究預覽期間測試，以取得有關測試您建立的自訂 channels 的資訊。在 Claude Code GitHub 儲存庫上報告問題或回饋。

Channels 如何比較

Claude Code 的多個功能連接到終端外的系統，每個都適合不同類型的工作：

功能	它的作用	適合
網路上的 Claude Code	在新鮮雲端沙箱中執行任務，從 GitHub 複製	委派您稍後檢查的自包含非同步工作
Slack 中的 Claude	從頻道或執行緒中的 `@Claude` 提及產生網路工作階段	直接從團隊對話內容啟動任務
標準 MCP 伺服器	Claude 在任務期間查詢它；沒有任何東西被推送到工作階段	讓 Claude 按需存取讀取或查詢系統
遠端控制	您從 claude.ai 或 Claude 行動應用程式驅動您的本地工作階段	在遠離您的桌子時引導進行中的工作階段

Channels 通過將來自非 Claude 來源的事件推送到您已執行的本地工作階段，填補該清單中的空白。

聊天橋接：通過 Telegram、Discord 或 iMessage 從您的手機詢問 Claude 一些事情，答案會在同一聊天中返回，而工作在您的機器上針對您的真實檔案執行。
Webhook 接收器：來自 CI、您的錯誤追蹤器、部署管道或其他外部服務的 webhook 到達 Claude 已開啟您的檔案並記得您正在調試的地方。

後續步驟

一旦您有 channel 執行，請探索這些相關功能：

建立您自己的 channel，用於尚未有外掛程式的系統
遠端控制，從您的手機驅動本地工作階段，而不是將事件轉發到其中
排程任務，按計時器輪詢，而不是對推送事件做出反應

代理程式與平行工作

MCP

技能

外掛程式

成品

自動化

指南

疑難排解

使用 channels 將事件推送到執行中的工作階段

支援的 channels

快速入門

安全性

Enterprise 控制

為您的組織啟用 channels

限制可以執行哪些 channel 外掛程式

研究預覽

Channels 如何比較

後續步驟

​支援的 channels

​快速入門

​安全性

​Enterprise 控制

​為您的組織啟用 channels

​限制可以執行哪些 channel 外掛程式

​研究預覽

​Channels 如何比較

​後續步驟

支援的 channels

快速入門

安全性

Enterprise 控制

為您的組織啟用 channels

限制可以執行哪些 channel 外掛程式

研究預覽

Channels 如何比較

後續步驟