Claude Code 支持借助通道将事件推送至正在运行的会话中

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

频道处于研究预览阶段，需要 Claude Code v2.1.80 或更高版本。它们需要 claude.ai 登录。不支持控制台和 API 密钥身份验证。团队和企业组织必须明确启用。

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

您将频道作为插件安装，并使用您自己的凭证配置。Telegram 和 Discord 包含在研究预览中。

当 Claude 通过频道回复时，您在终端中看到传入的消息，但看不到回复文本。终端显示工具调用和确认（例如“已发送”），而实际回复出现在其他平台上。

本页面涵盖：

• 支持的频道：Telegram 和 Discord 设置

• 安装和运行 频道，使用 fakechat（一个本地演示）

• 谁可以推送消息：发送者允许列表以及如何配对

• 为您的组织启用频道（适用于团队和企业）

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

支持的频道

每个支持的频道都是一个插件，需要 Bun。在连接真实平台之前，先试用插件流程，可以尝试 fakechat 快速入门。

• Telegram
• Discord

查看完整的 Telegram 插件源代码。

1. 创建 Telegram 机器人

打开 BotFather 在 Telegram 中，发送 /newbot。给予它一个显示名称和一个以 bot 结尾的唯一用户名。复制 BotFather 返回的令牌。

1. 安装插件

在 Claude Code 中运行：

   /plugin install telegram@claude-plugins-official

1. 配置您的令牌

使用来自 BotFather 的令牌运行配置命令：

   /telegram:configure <token>

这将令牌保存到项目中的 .claude/channels/telegram/.env。您也可以在启动 Claude Code 之前在 shell 环境中设置 TELEGRAM_BOT_TOKEN。

1. 重新启动并启用频道

退出 Claude Code 并使用频道标志重新启动。这启动了 Telegram 插件，该插件开始轮询来自您的机器人的消息：

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

1. 配对您的帐户

打开 Telegram 并向您的机器人发送任意消息。机器人用配对代码回复。

如果您的机器人没有响应，请确保 Claude Code 使用前一步骤中的 --channels 运行。机器人只能在频道激活时回复。

在 Claude Code 中运行：

   /telegram:access pair `
   `

   然后锁定访问权限，以便只有您的帐户可以发送消息：

/telegram:access policy allowlist

查看完整的 [Discord 插件源代码](https: //github.com/anthropics/claude-plugins-official/tree/main/external_plugins/discord)。

  1. 创建 Discord 机器人 前往 [Discord 开发者门户](https: //discord.com/developers/applications)，点击 **新建应用程序**，并为其命名。在 **机器人** 部分，创建用户名，然后点击 **重置令牌** 并复制令牌。

    2. 启用消息内容意图 在您的机器人的设置中，滚动到 **特权网关意图** 并启用 **消息内容意图**。 3. 将机器人邀请到您的服务器 前往 **OAuth2 > URL 生成器**。选择机器人范围并启用这些权限： - 查看频道 - 发送消息 - 在线程中发送消息 - 读取消息历史记录 - 附加文件 - 添加反应 打开生成的 URL 以将机器人添加到您的服务器。 4. 安装插件 在 Claude Code 中运行：

/plugin install discord@claude-plugins-official

5. 配置您的令牌

使用您复制的机器人令牌运行配置命令：

/discord:configure

这将令牌保存到项目中的 `.claude/channels/discord/.env`。
您也可以在启动 Claude Code 之前在 shell 环境中设置 `DISCORD_BOT_TOKEN`。

6. 重新启动并启用频道

退出 Claude Code 并使用频道标志重新启动。 这连接了 Discord 插件， 以便您的机器人可以接收和响应消息：

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

7. 配对您的帐户 在 Discord 上给您的机器人发送直接消息。机器人用配对代码回复。 如果您的机器人没有响应，请确保 Claude Code 使用前一步骤中的 `--channels` 运行。机器人只能在频道激活时回复。 在 Claude Code 中运行：

/discord:access pair

然后锁定访问权限，以便只有您的帐户可以发送消息：

/discord:access policy allowlist

您还可以为尚无插件的系统构建您自己的频道。

快速入门

Fakechat 是一个官方支持的演示频道，它在本地主机上运行聊天界面，无需身份验证，也无需配置外部服务。 安装并启用 fakechat 后，您可以在浏览器中输入消息，消息就会到达您的 Claude Code 会话中。Claude 会回复，回复就会在浏览器中显示。在您测试了 fakechat 界面后，可以试用 Telegram 或 Discord。

要试用 fakechat 演示，您需要：

• 使用 claude.ai 帐户安装并验证 Claude Code

• 安装 Bun。预建的频道插件是 Bun 脚本。检查 bun --version；如果失败，安装 Bun。

• 团队/企业用户：您的组织管理员必须在托管设置中启用频道

1. 安装 fakechat 频道插件

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

   /plugin install fakechat@claude-plugins-official

Fakechat 位于 claude-plugins-official 市场，该市场会自动为大多数设置添加。如果您没有它，请先运行 /plugin marketplace add anthropics/claude-plugins-official。

1. 启用频道后重启

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

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

fakechat 服务器会自动启动。

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

1. 推送消息

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

   hey, what's in my working directory?

消息作为 tool_use 事件到达您的 Claude Code 会话中。Claude 读取它，完成工作，然后调用 fakechat 的 reply 工具。答案在聊天界面中显示。

如果 Claude 在您离开终端时遇到权限提示，会话将暂停，直到您本地批准。对于无人值守的使用，--dangerously-skip-permissions 会跳过提示，但请仅在您信任的环境中使用它。

安全

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

• 在 Telegram 或 Discord 上找到您的机器人并发送任意消息

• 机器人用配对代码回复

• 在您的 Claude Code 会话中，批准提示的代码

• 您的发送者 ID 被添加到允许列表中

在此基础上，您通过 --channels 控制每个会话中启用的服务器，对于团队和企业计划，您的组织通过 channelsEnabled 控制可用性。

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

企业控制

频道由 托管设置 中的 channelsEnabled 设置控制。

计划类型	默认行为
Pro / Max，无组织	频道可用；用户通过 --channels 按需启用
团队/企业	频道在管理员明确启用之前被禁用

为您的组织启用频道

管理员可以从 claude.ai → 管理设置 → Claude Code → 频道 或在托管设置中将 channelsEnabled 设置为 true 来启用频道。 启用后，您组织中的用户可以使用 --channels 将频道服务器加入各个会话。如果设置被禁用或未设置，MCP 服务器仍然连接并且其工具有效，但频道消息不会到达。启动警告会告知用户管理员需要启用该设置。

研究预览

注意：此部分内容与原文一致，翻译保持原文的“研究预览”标记。

研究预览

频道（Channels）是一项正在研究预览的功能。该功能将逐步开放， --channels 标志的语法和协议合约可能会根据反馈而改变。

在预览期间， --channels 仅接受来自Anthropic维护的允许列表中的插件。 claude-plugins-official 中的频道插件是已批准的插件集合。如果您传递的插件不在列表中，Claude Code 将正常启动，但频道不会注册，启动通知将告知您原因。

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

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

下一步

一旦您运行了一个频道，请探索这些相关功能：

• 构建您自己的频道，适用于尚未有插件的系统

• 远程控制，通过手机驱动本地会话，而不是将事件转发到本地会话

• 定时任务，按定时器轮询，而不是响应推送事件