Push events into a running session with channels
- 分组:一、官方文档
- 原始链接:https://code.claude.com/docs/en/channels
- 抓取来源:http://code.claude.com/docs/en/channels
- 原始文件:/Users/yuanruiqin/Desktop/知识库/ClaudeCode-系统化知识库/01-官方文档/15-push-events-into-a-running-session-with-channels.md
- 精读版生成时间:2026-04-05 13:50:44
中文精读版(去噪)
将事件推送到带有通道的正在运行的会话中 - Claude Code Docs
Claude Code Docs 主页!图片 1:光徽标!图2:黑暗标志
⌘K问AI
克劳德开发者平台 网络上的克劳德代码
自动化
将事件推送到带有通道的正在运行的会话中
入门与 Claude 一起构建代码部署管理配置参考什么新资源
代理
创建自定义子代理 运行代理团队
工具和插件
自动化
故障排除
疑难解答
自动化
将事件推送到带有通道的正在运行的会话中
使用通道将消息、警报和 Webhook 从 MCP 服务器推送到您的 Claude Code 会话中。转发 CI 结果、聊天消息和监控事件,以便 Claude 在您离开时做出反应。
通道是一个 MCP 服务器,它将事件推送到正在运行的 Claude Code 会话中,以便 Claude 可以对您不在终端时发生的事情做出反应。通道可以是双向的:Claude 读取事件并通过同一通道回复,就像聊天桥一样。事件仅在会话打开时到达,因此对于始终在线的设置,您可以在后台进程或持久终端中运行 Claude。与生成新云会话或等待轮询的集成不同,事件到达您已打开的会话中:请参阅通道如何比较。您将通道安装为插件并使用您自己的凭据进行配置。研究预览中包含 Telegram、Discord 和 iMessage。当 Claude 通过频道回复时,您会在终端中看到入站消息,但看不到回复文本。终端显示工具调用和确认(如“已发送”),实际回复出现在其他平台上。此页面涵盖: 支持的频道:Telegram、Discord 和 iMessage 设置 安装并运行通道:发件人白名单以及配对方式 在团队和企业上为您的组织启用渠道 通道如何比较 与网络会话、Slack、MCP 和远程控制
要构建您自己的频道,请参阅频道参考。
支持的频道
每个受支持的频道都是一个需要 Bun 的插件。如需在连接真实平台之前亲身体验插件流程的演示,请尝试 fakechat 快速入门。
电报 不和谐 短信
查看完整的 Telegram 插件源代码。
创建 Telegram 机器人
在 Telegram 中打开 BotFather 并发送 /newbot。为其指定一个显示名称和一个以“bot”结尾的唯一用户名。复制 BotFather 返回的令牌。
安装插件
在克劳德代码中,运行:
/插件安装 telegram@claude-plugins-official
如果 Claude Code 报告在任何市场中都找不到该插件,则您的市场可能已丢失或已过时。运行“/pluginmarketplaceupdateclaude-plugins-official”来刷新它,或者“/pluginmarketplaceaddanthropics/claude-plugins-official”(如果您之前没有添加过)。然后重试安装。安装后,运行“/reload-plugins”以激活插件的配置命令。
配置您的令牌
使用来自 BotFather 的令牌运行配置命令:
/telegram:配置<令牌>
这会将其保存到“~/.claude/channels/telegram/.env”。您还可以在启动 Claude Code 之前在 shell 环境中设置“TELEGRAM_BOT_TOKEN”。
重新启动并启用通道
退出 Claude Code 并使用通道标志重新启动。这将启动 Telegram 插件,该插件开始轮询来自您的机器人的消息:
克劳德--频道插件:telegram@claude-plugins-official
配对您的帐户
打开 Telegram 并向您的机器人发送任何消息。机器人会回复一个配对码。
如果您的机器人没有响应,请确保 Claude Code 正在使用上一步中的“--channels”运行。机器人只能在频道处于活动状态时回复。
回到克劳德代码,运行:
/telegram:访问对<代码>
然后锁定访问权限,以便只有您的帐户可以发送消息:
/telegram:访问策略白名单
查看完整的 Discord 插件源代码。
创建一个 Discord 机器人
转到 Discord 开发者门户,单击“新应用程序”,然后命名。在 Bot 部分中,创建用户名,然后单击 重置令牌 并复制令牌。
启用消息内容意图
在机器人的设置中,滚动到特权网关意图并启用消息内容意图。
邀请机器人到您的服务器
转至 OAuth2 > URL 生成器。选择“bot”范围并启用这些权限:
打开生成的 URL 将机器人添加到您的服务器。
安装插件
在克劳德代码中,运行:
/插件安装discord@claude-plugins-official
如果 Claude Code 报告在任何市场中都找不到该插件,则您的市场可能已丢失或已过时。运行“/pluginmarketplaceupdateclaude-plugins-official”来刷新它,或者“/pluginmarketplaceaddanthropics/claude-plugins-official”(如果您之前没有添加过)。然后重试安装。安装后,运行“/reload-plugins”以激活插件的配置命令。
配置您的令牌
使用您复制的机器人令牌运行配置命令:
/discord:配置<令牌>
这会将其保存到“~/.claude/channels/discord/.env”。您还可以在启动 Claude Code 之前在 shell 环境中设置“DISCORD_BOT_TOKEN”。
重新启动并启用通道
退出 Claude Code 并使用通道标志重新启动。这将连接 Discord 插件,以便您的机器人可以接收和响应消息:
克劳德--频道插件:discord@claude-plugins-official
配对您的帐户
在 Discord 上私信您的机器人。机器人会回复一个配对码。
如果您的机器人没有响应,请确保 Claude Code 正在使用上一步中的“--channels”运行。机器人只能在频道处于活动状态时回复。
回到克劳德代码,运行:
/discord:访问对<代码>
然后锁定访问权限,以便只有您的帐户可以发送消息:
/discord:访问策略白名单
查看完整的 iMessage 插件源代码。 iMessage 通道直接读取您的消息数据库并通过 AppleScript 发送回复。它需要 macOS,并且不需要机器人令牌或外部服务。
授予完整磁盘访问权限
~/Library/Messages/chat.db 处的消息数据库受 macOS 保护。服务器第一次读取时,macOS 会提示访问:单击“允许”。提示名称为启动 Bun 的应用程序,例如终端、iTerm 或您的 IDE。如果未出现提示或您单击了“不允许”,请在 系统设置 > 隐私和安全 > 全磁盘访问下手动授予访问权限并添加您的终端。如果没有这个,服务器会立即退出并显示“授权被拒绝”。
安装插件
在克劳德代码中,运行:
/插件安装imessage@claude-plugins-official
如果 Claude Code 报告在任何市场中都找不到该插件,则您的市场可能已丢失或已过时。运行“/pluginmarketplaceupdateclaude-plugins-official”来刷新它,或者“/pluginmarketplaceaddanthropics/claude-plugins-official”(如果您之前没有添加过)。然后重试安装。
重新启动并启用通道
退出 Claude Code 并使用通道标志重新启动:
克劳德--频道插件:imessage@claude-plugins-official
给自己发短信
第一个回复 Claude 发送 tr