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

使用 channels 從 MCP 伺服器將訊息、警報和 webhooks 推送到您的 Claude Code 工作階段。轉發 CI 結果、聊天訊息和監控事件，讓 Claude 在您不在時做出反應。

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 快速入門。

/plugin install telegram@claude-plugins-official

/telegram:configure <token>

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

/telegram:access pair <code>

/telegram:access policy allowlist

/plugin install discord@claude-plugins-official

/discord:configure <token>

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

/discord:access pair <code>

/discord:access policy allowlist

/plugin install imessage@claude-plugins-official

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

/imessage:access allow +15551234567

您也可以建立您自己的 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

/plugin install fakechat@claude-plugins-official

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

hey, what's in my working directory?

如果 Claude 在您不在終端時遇到權限提示，工作階段會暫停，直到您回應。宣告權限中繼功能的 Channel 伺服器可以將這些提示轉發給您，以便您可以遠端批准或拒絕。對於無人值守使用，--dangerously-skip-permissions 完全繞過提示，但僅在您信任的環境中使用。

當您以非互動模式使用 -p 執行 channels 時，需要終端輸入的工具（例如多選題和計畫模式批准）會被停用，因此工作階段永遠不會因等待輸入而停滯。

安全性

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

Telegram 和 Discord 通過配對啟動清單：

1. 在 Telegram 或 Discord 中找到您的機器人並向其傳送任何訊息
2. 機器人回覆配對代碼
3. 在您的 Claude Code 工作階段中，在提示時批准代碼
4. 您的寄件者 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 會執行。

沒有組織的 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 的多個功能連接到終端外的系統，每個都適合不同類型的工作：

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

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

後續步驟

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

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