文档索引

在此获取完整文档索引：https://code.claude.com/docs/llms.txt 使用此文件发现所有可用页面，然后再进一步探索。

使用通道将事件推送到运行中的会话

使用通道从 MCP 服务器将消息、提醒和 webhook 推送到您的 Claude Code 会话。转发 CI 结果、聊天消息和监控事件，以便 Claude 可以在您离开时做出反应。

通道是一个 MCP 服务器，它将事件推送到您正在运行的 Claude Code 会话中，以便 Claude 可以在您不在终端时对发生的事件做出反应。通道可以是双向的：Claude 读取事件并通过同一通道回复，就像聊天桥接器。事件仅在会话打开时到达，因此对于始终在线的设置，您需要在后台进程或持久终端中运行 Claude。

与生成新的云会话或等待轮询的集成不同，事件到达您已经打开的会话中：请参阅通道比较。

您将通道作为插件安装并使用自己的凭据进行配置。Telegram、Discord 和 iMessage 包含在研究预览中。

当 Claude 通过通道回复时，您会在终端中看到入站消息，但看不到回复文本。终端显示工具调用和确认（如"sent"），实际回复出现在另一个平台上。

本页面涵盖：

• 支持的通道：Telegram、Discord 和 iMessage 设置
• 安装和运行通道：使用 fakechat（本地主机演示）
• 谁可以推送消息：发送者允许列表和配对方式
• 为您的组织启用通道：如果您管理 Team、Enterprise 或 Console 组织
• 通道比较：与 Web 会话、Slack、MCP 和 Remote Control 的对比

要构建自己的通道，请参阅通道参考。

支持的通道

每个支持的通道都是一个需要 Bun 的插件。在连接真实平台之前，要获得插件流程的实际操作演示，请尝试 fakechat 快速入门。

您也可以构建自己的通道，用于尚无插件的系统。

快速入门

Fakechat 是一个官方支持的演示通道，它在本地主机上运行聊天 UI，无需身份验证，也无需配置外部服务。

安装并启用 fakechat 后，您可以在浏览器中输入消息，消息会到达您的 Claude Code 会话。Claude 回复后，回复会显示回浏览器中。测试完 fakechat 界面后，尝试 Telegram、Discord 或 iMessage。

要尝试 fakechat 演示，您需要：

• Claude Code 已安装并已身份验证，使用 claude.ai 帐户或 Claude Console API 密钥
• 已安装 Bun。预构建的通道插件是 Bun 脚本。使用 bun --version 检查；如果失败，安装 Bun。
• Team、Enterprise 或托管 Console 组织：您的管理员必须在托管设置中启用通道

1. 安装 fakechat 通道插件

   启动 Claude Code 会话并运行安装命令：

   /plugin install fakechat@claude-plugins-official
   

   如果 Claude Code 报告在任何市场中都找不到该插件，则您的市场缺失或过时。运行 /plugin marketplace update claude-plugins-official 刷新它，或者如果您之前未添加过，运行 /plugin marketplace add anthropics/claude-plugins-official。然后重试安装。

2. 启用通道后重启

   退出 Claude Code，然后使用 --channels 重新启动并传递您安装的 fakechat 插件：

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

   fakechat 服务器自动启动。

   💡

   Tip

   您可以向 --channels 传递多个插件，用空格分隔。

3. 推送消息

   在 http://localhost:8787 打开 fakechat UI 并输入消息：

   hey, what's in my working directory?
   

   消息作为 <channel source="fakechat"> 事件到达您的 Claude Code 会话。Claude 读取它，执行工作，并调用 fakechat 的 reply 工具。答案显示在聊天 UI 中。

如果 Claude 在您离开终端时遇到权限提示，会话会暂停直到您响应。声明权限中继功能的通道服务器可以将这些提示转发给您，以便您可以远程批准或拒绝。对于无人值守使用，--dangerously-skip-permissions 完全绕过提示，但仅在您信任的环境中使用它。

当您使用 -p 在非交互模式下运行通道时，需要终端输入的工具（如多选题和计划模式审批）会被禁用，因此会话永远不会因等待输入而停滞。

安全

每个已批准的通道插件维护一个发送者允许列表：只有您添加的 ID 可以推送消息，其他人会被静默丢弃。

Telegram 和 Discord 通过配对来引导列表：

1. 在 Telegram 或 Discord 中找到您的机器人并发送任何消息
2. 机器人回复一个配对代码
3. 在您的 Claude Code 会话中，收到提示时批准该代码
4. 您的发送者 ID 被添加到允许列表

iMessage 的工作方式不同：给自己发短信会自动绕过门控，您可以使用 /imessage:access allow 按句柄添加其他联系人。

除此之外，您使用 --channels 控制每个会话启用哪些服务器，您的组织在 claude.ai Team 和 Enterprise 计划以及部署托管设置的 Console 组织上使用 channelsEnabled 控制可用性。

仅在 .mcp.json 中不足以推送消息：服务器还必须在 --channels 中被命名。

允许列表还控制权限中继（如果通道声明了它）。任何可以通过通道回复的人都可以批准或拒绝您会话中的工具使用，因此只允许您信任的发送者拥有该权限。

企业控制

管理员通过两个用户无法覆盖的托管设置控制可用性。默认值取决于您的身份验证方式：

• claude.ai Team 和 Enterprise：通道被阻止，直到管理员启用它们。
• 使用 API 密钥身份验证的 Anthropic Console：通道默认被允许。仅当您的组织部署托管设置时才需要此设置。

在所有情况下，在用户使用 --channels 选择加入之前，没有通道会运行。

没有组织的 Pro 和 Max 用户完全跳过这些检查：通道可用，用户使用 --channels 按会话选择加入。

为您的组织启用通道

管理员可以从 claude.ai → Admin settings → Claude Code → Channels 启用通道，或在托管设置中将 channelsEnabled 设置为 true。

启用后，您组织中的用户可以使用 --channels 将通道服务器选择加入到各个会话。如果设置被禁用或未设置，MCP 服务器仍然连接并且其工具可以工作，但通道消息不会到达。启动警告会告诉用户让管理员启用该设置。

限制哪些通道插件可以运行

默认情况下，Anthropic 维护的允许列表上的任何插件都可以注册为通道。Team 和 Enterprise 计划上的管理员可以通过在托管设置中设置 allowedChannelPlugins 来用他们自己的允许列表替换该列表。使用此功能限制允许哪些官方插件、批准您自己内部市场中的通道，或两者兼而有之。每个条目指定一个插件及其来源市场：

{
  "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 允许列表。空数组阻止来自允许列表的所有通道插件，但 --dangerously-load-development-channels 仍然可以为本地测试绕过它。要完全阻止通道（包括开发标志），请改为保持 channelsEnabled 未设置。

此设置需要 channelsEnabled: true。如果用户传递给 --channels 的插件不在您的列表中，Claude Code 正常启动但通道不会注册，启动通知会解释该插件不在组织的批准列表中。

研究预览

通道是研究预览功能。可用性正在逐步推出，--channels 标志语法和协议约定可能会根据反馈而更改。

在预览期间，--channels 仅接受来自 Anthropic 维护的允许列表的插件，或（如果管理员设置了 allowedChannelPlugins）来自您的组织允许列表的插件。claude-plugins-official 中的通道插件是默认批准的集合。如果您传递不在有效允许列表上的内容，Claude Code 正常启动但通道不会注册，启动通知会告诉您原因。

要测试您正在构建的通道，请使用 --dangerously-load-development-channels。有关测试您构建的自定义通道的信息，请参阅在研究预览期间测试。

在 Claude Code GitHub 仓库上报告问题或反馈。

通道比较

几个 Claude Code 功能连接到终端外部的系统，每个功能适合不同类型的工作：

通道通过将来自非 Claude 源的事件推送到您已运行的本地会话来填补该列表中的空白。

• 聊天桥接器：通过 Telegram、Discord 或 iMessage 从手机向 Claude 提问，答案会在同一聊天中返回，同时工作在您的机器上针对您的真实文件运行。
• Webhook 接收器：来自 CI、错误跟踪器、部署管道或其他外部服务的 webhook 到达 Claude 已经打开文件并记住您正在调试的内容的位置。

后续步骤

一旦您有一个通道在运行，请探索以下相关功能：

• 构建自己的通道：用于尚无插件的系统
• Remote Control：从手机驱动本地会话，而不是将事件转发到其中
• 定时任务：按计时器轮询而不是对推送事件做出反应