跳轉到主要內容
Channels 處於研究預覽階段,需要 Claude Code v2.1.80 或更新版本。它們需要 claude.ai 登入。不支援 Console 和 API 金鑰驗證。Team 和 Enterprise 組織必須明確啟用它們
Channel 是一個 MCP 伺服器,可將事件推送到您執行中的 Claude Code 工作階段,讓 Claude 能對您不在終端時發生的事情做出反應。Channels 可以是雙向的:Claude 讀取事件並通過同一 channel 回覆,就像聊天橋接一樣。事件只在工作階段開啟時到達,因此對於始終開啟的設定,您可以在背景程序或持久終端中執行 Claude。 與產生新鮮雲端工作階段或等待輪詢的整合不同,事件到達您已開啟的工作階段:請參閱 channels 如何比較 您將 channel 安裝為外掛程式,並使用您自己的認證進行設定。Telegram、Discord 和 iMessage 包含在研究預覽中。 當 Claude 通過 channel 回覆時,您會在終端中看到入站訊息,但看不到回覆文字。終端顯示工具呼叫和確認(如「已傳送」),實際回覆會出現在另一個平台上。 本頁涵蓋: 若要建立您自己的 channel,請參閱 Channels 參考

支援的 channels

每個支援的 channel 都是需要 Bun 的外掛程式。如需在連接真實平台之前親身體驗外掛程式流程的演示,請嘗試 fakechat 快速入門
檢視完整的 Telegram 外掛程式原始碼
1

建立 Telegram 機器人

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

安裝外掛程式

在 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 以啟用外掛程式的設定命令。
3

設定您的權杖

使用來自 BotFather 的權杖執行設定命令:
/telegram:configure <token>
這會將其儲存到 ~/.claude/channels/telegram/.env。您也可以在啟動 Claude Code 之前在 shell 環境中設定 TELEGRAM_BOT_TOKEN
4

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

退出 Claude Code 並使用 channel 旗標重新啟動。這會啟動 Telegram 外掛程式,開始輪詢來自您機器人的訊息:
claude --channels plugin:telegram@claude-plugins-official
5

配對您的帳戶

開啟 Telegram 並向您的機器人傳送任何訊息。機器人會回覆配對代碼。
如果您的機器人沒有回應,請確保 Claude Code 使用上一步的 --channels 執行。機器人只能在 channel 處於活動狀態時回覆。
回到 Claude Code,執行:
/telegram:access pair <code>
然後鎖定存取權,使只有您的帳戶可以傳送訊息:
/telegram:access policy allowlist
您也可以建立您自己的 channel,用於尚未有外掛程式的系統。

快速入門

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

安裝 fakechat channel 外掛程式

啟動 Claude Code 工作階段並執行安裝命令:
/plugin install fakechat@claude-plugins-official
如果 Claude Code 報告在任何市場中找不到該外掛程式,您的市場可能遺失或已過期。執行 /plugin marketplace update claude-plugins-official 以重新整理它,或如果您之前未新增過,執行 /plugin marketplace add anthropics/claude-plugins-official。然後重試安裝。
2

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

退出 Claude Code,然後使用 --channels 重新啟動並傳遞您安裝的 fakechat 外掛程式:
claude --channels plugin:fakechat@claude-plugins-official
fakechat 伺服器會自動啟動。
您可以將多個外掛程式傳遞到 --channels,以空格分隔。
3

推送訊息進去

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 完全繞過提示,但僅在您信任的環境中使用。

安全性

每個已批准的 channel 外掛程式都維護寄件者允許清單:只有您新增的 ID 可以推送訊息,其他所有人都會被無聲地丟棄。 Telegram 和 Discord 通過配對啟動清單:
  1. 在 Telegram 或 Discord 中找到您的機器人並向其傳送任何訊息
  2. 機器人回覆配對代碼
  3. 在您的 Claude Code 工作階段中,在提示時批准代碼
  4. 您的寄件者 ID 會新增到允許清單
iMessage 的工作方式不同:向自己傳送訊息會自動繞過閘道,您可以使用 /imessage:access allow 按控制代碼新增其他聯絡人。 除此之外,您可以使用 --channels 控制每個工作階段啟用哪些伺服器,在 Team 和 Enterprise 計畫上,您的組織可以使用 channelsEnabled 控制可用性。 .mcp.json 中還不足以推送訊息:伺服器也必須在 --channels 中命名。 允許清單也會閘道權限中繼(如果 channel 宣告它)。任何可以通過 channel 回覆的人都可以批准或拒絕您工作階段中的工具使用,因此只允許清單您信任具有該權限的寄件者。

Enterprise 控制

在 Team 和 Enterprise 計畫上,channels 預設為關閉。管理員通過兩個受管設定控制可用性,使用者無法覆蓋:
設定目的未設定時
channelsEnabled主開關。必須為 true 才能讓任何 channel 傳遞訊息。通過 claude.ai 管理員主控台切換或直接在受管設定中設定。關閉時會阻止所有 channels,包括開發旗標。Channels 被阻止
allowedChannelPlugins啟用 channels 後可以註冊哪些外掛程式。設定時替換 Anthropic 維護的清單。僅在 channelsEnabledtrue 時適用。應用 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 執行,請探索這些相關功能: