MemoryLake
返回全部文章
Tutorial2026 年 11 月 18 日·11 分钟阅读

什么是 Claude Code 频道?为什么消息仅在会话开启时送达,Claude 在接收消息时已知晓什么,以及为什么它的回复不显示在终端中 (2026)

你为 Claude Code 设置了 Telegram 频道,以便在手机上查看漫长的调试会话。午餐时它运行良好:你询问了测试运行的结果,Claude 在聊天中详细回答了它整个上午打开的文件内容。那天晚上你合上笔记本电脑,在火车上又发了一个问题。结果没有任何回应。

这两次体验都源于 Anthropic 文档中的一句话:“事件仅在会话开启时送达,因此对于常驻设置,你需要在后台进程或持久终端中运行 Claude。”

本指南涵盖了什么是频道、它们与远程访问 Claude Code 的其他方式有何不同、为什么消息会进入一个已有上下文的会话、当会话未运行时会发生什么、为什么回复出现在手机上而不是终端中、发送者白名单如何工作,以及组织需要开启哪些设置。

什么是频道

Anthropic 的文档在开头就描述了这一功能:“使用频道通过 MCP 服务器将消息、警报和 Webhook 推送到你的 Claude Code 会话中。”

其机制是一种特定类型的 MCP 服务器。“频道是一个 MCP 服务器,它将事件推送到你正在运行的 Claude Code 会话中,以便 Claude 能够对你不在终端时发生的事情做出反应。”

频道可以是双向的。文档指出:“频道可以是双向的:Claude 读取事件并通过同一频道回复,就像一个聊天桥梁。”

你可以将频道作为插件安装,并使用你自己的凭据进行配置。文档称:“Telegram、Discord 和 iMessage 已包含在研究预览版中。”每个受支持的频道都是一个需要 Bun 的插件,还有一个名为 fakechat 的演示频道,它在你自己的机器上运行一个聊天页面,这样你就可以在不连接真实平台的情况下尝试流程。

该功能被标记为研究预览版。可用性正在逐步推出,文档警告说,flag 语法和协议可能会根据反馈发生变化。

频道与访问 Claude Code 的其他方式有何不同

Claude Code 有多项功能可将其与终端之外的世界连接。文档对它们进行了比较:

  • Cloud sessions 在从 GitHub 克隆的新云端沙箱中运行任务。它们适合你稍后查看的独立工作。
  • Claude in Slack 通过频道或线程中的提及启动云端会话。
  • 标准 MCP 服务器 是 Claude 在任务期间查询的对象。没有任何内容被推送到会话中。
  • Remote Control 让你从 claude.ai 或 Claude 移动应用驱动本地会话。

然后:“频道填补了该列表中的空白,通过将来自非 Claude 源的事件推送到你已经在运行的本地会话中。”

关键区别在于消息落在哪里。文档指出,与生成新云端会话或等待轮询的集成不同,“事件会进入你已经开启的会话中”。

当消息送达时 Claude 已经知道了什么

因为频道消息加入的是一个正在运行的会话,Claude 会结合该会话已持有的所有信息进行回答。

文档描述了依赖于此的两种用途:

  • 聊天桥梁。 你“通过 Telegram、Discord 或 iMessage 从手机询问 Claude 某些事情,答案会通过同一个聊天返回,而工作则在你的机器上针对你的真实文件运行”。
  • Webhook 接收器。 来自 CI、错误追踪器或部署流水线的事件“送达时,Claude 已经打开了你的文件并记得你正在调试的内容”。

第二句话至关重要。通过频道发送的消息不是一段新对话。它变成了已经拥有你的文件、运行过的命令以及你正在调查的内容的会话中的下一个输入。这就是为什么开头例子中吃午饭时的提问能得到有用的回答。

这也意味着回答的质量取决于会话。向一个五分钟前启动的会话发送频道消息,得到的回答将基于五分钟的上下文。

为什么消息仅在会话开启时送达

同样的设计解释了晚上的沉默。频道将事件推送到运行中的会话。当会话未运行时,事件就没有地方可以送达。

文档中的句子很直接:“事件仅在会话开启时送达,因此对于常驻设置,你需要在后台进程或持久终端中运行 Claude。”

文档没有描述频道消息会为已关闭的会话进行排队,因此请按如下计划:如果消息在会话关闭时发送,它将无法送达。如果你想在离开座位时使用频道,请让会话在保持开启的地方运行。

我们在关于 Claude Code 后台任务 的指南中介绍了当你退出时 Claude Code 在后台运行的工作会发生什么,以及如何保持其运行。

对于应该按计划检查某些内容而不是对事件做出反应的任务,文档指向了会话范围的计划任务,这些任务会按定时器进行轮询。

为什么回复不显示在你的终端中

如果你在手机回复后瞥一眼终端,很容易忽略这一点。文档解释道:“当 Claude 通过频道回复时,你在终端中会看到入站消息,但看不到回复文本。”

在终端中,你会看到传入的消息作为一条入站频道行,然后是 Claude 为回复而进行的工具调用,以及一条简短的发送确认。回复本身出现在另一个平台上。

因此,频道对话的记录是分开的。你的问题在终端中可见。Claude 的回答在 Telegram、Discord 或 iMessage 上。如果在该交流中决定了重要事项,全文将保存在你的手机上。

权限提示时会发生什么

你从手机引导的会话仍可能因权限请求而停止。文档称:“如果 Claude 在你离开终端时遇到权限提示,会话将暂停,直到你做出响应。”

某些频道可以提供帮助。文档提到,声明了权限转发(permission relay)能力的频道服务器可以转发这些提示,以便你可以远程批准或拒绝。对于无人值守的使用,它指向了一种完全跳过权限检查的模式,但这会移除该安全保障。

当你使用 -p 在非交互模式下运行频道时,需要终端输入的工具将被关闭。文档中的例子包括多项选择题和计划模式批准,这些都被禁用,“以便会话永远不会因等待输入而停滞”。

如何启动带有频道的会话

安装频道插件后,你使用 --channels 标志并命名插件来重启 Claude Code。启动屏幕随后会显示一条通知,说明来自该插件的消息将直接进入会话。

有两个细节很重要:

  • 频道是按会话选择加入的。 文档指出,在所有情况下,除非用户使用 --channels 为会话选择加入,否则不会运行任何频道。
  • 仅靠配置是不够的。 “仅出现在 .mcp.json 中不足以推送消息:服务器还必须在 --channels 中命名。”

在预览期间,--channels 和开发标志都不会出现在 claude --help 中。文档称,即使这些标志未列出,它们也是有效的。

谁可以向你的会话发送消息

频道开启了一条通往会话的路径,该会话可以读取和更改你机器上的文件,因此文档对于谁可以使用它非常谨慎。

“每个经过批准的频道插件都维护一个发送者白名单:只有你添加的 ID 才能推送消息,其他所有人的消息都会被静默丢弃。”

Telegram 和 Discord 通过配对构建列表。你给你的机器人发消息,它回复一个配对码,你在 Claude Code 会话中批准该代码,你的发送者 ID 就会被添加。iMessage 的工作方式不同:允许自动给自己发短信,你通过账号(handle)添加其他联系人。

白名单还控制权限转发,文档阐明了这意味着什么:“任何可以通过频道回复的人都可以批准或拒绝你会话中的工具使用,因此只允许你信任并授予该权限的白名单发送者。”

在研究预览期间,--channels 仅接受来自 Anthropic 维护的白名单中的插件,或者如果管理员设置了白名单,则接受来自你组织白名单的插件。

组织需要开启哪些设置

可用性取决于你的登录方式。

  • 不属于组织的 Pro、Max 和 Ultra 用户。 “不属于组织的 Pro、Max 和 Ultra 用户完全跳过这些检查”。频道可用,你可以按会话选择加入。
  • Claude Team 和 Enterprise。 频道会被阻止,直到所有者(Owner)在 Claude Code 下的组织设置中启用它们,或者在托管设置中将 channelsEnabled 设置为 true。
  • 使用 API 密钥身份验证的控制台(Console)。 除非你的组织部署了托管设置,否则频道默认是允许的。

如果频道未启用,文档称服务器仍会连接:“如果设置被禁用或未设置,MCP 服务器仍会连接且其工具可以工作,但频道消息将无法送达。”启动警告会告知用户询问管理员。

管理员还可以使用 allowedChannelPlugins 将默认的批准频道插件列表替换为他们自己的列表。

频道需要通过 claude.ai 或控制台 API 密钥进行 Anthropic 身份验证。它们在 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 上不可用。

人们首先会尝试的操作

向未运行的会话发消息。 事件仅在会话开启时送达。

在终端中寻找 Claude 的回复。 终端显示你的消息和确认。回复在另一个平台上。

将服务器添加到 .mcp.json 后就停止操作。 它还必须在 --channels 中命名。

将群聊加入白名单。 白名单上的任何人都可以通过权限转发批准工具使用。

等待永远不会到来的团队推广。 在 Team 和 Enterprise 版上,所有者必须启用频道。

解决方案:保持会话、记录和上下文同步

第 1 步:在保持开启的地方运行会话

如果你在离开时会发消息,请使用持久终端或后台进程。

第 2 步:仅将你自己或你信任的人加入白名单

先配对你自己的账号,只有在其他人应该能够批准工具使用时才添加他们。

第 3 步:将重要答案复制回来

当频道交流决定了某些事情时,将其记录在团队其他成员可以看到的地方。

第 4 步:将项目上下文保存在会话之外

写下新会话需要的决策,以便重启的会话能像旧会话一样进行回答。

在 MemoryLake 中设置

频道消息能得到很好的回答,是因为会话已经知道你正在处理的工作。当该会话结束时,其上下文也随之结束,而通过聊天桥梁做出的决策则留在你的消息应用中。决策本身——例如你批准了哪个修复方案、为什么暂停部署或忽略哪个错误——是值得统一保存的项目上下文。

MemoryLake 是此类项目上下文(如决策、当前优先级及其背后的原因)的记忆层,统一保存在你维护的一个地方,并可供你连接的助手(如 ChatGPT、Claude Code 和 Codex)使用。

你用自己的语言亲自编写条目。不会从你的 Claude Code 会话、频道插件、Telegram、Discord 或 iMessage 对话、设置文件或任何供应商的存储中读取、写入或删除任何内容。频道的工作方式正如 Anthropic 所描述的那样。

第 1 步:创建 API 密钥

登录并从仪表板生成密钥。像对待任何其他凭据一样,将其存储在代码仓库之外。

MemoryLake 控制台显示 API 密钥屏幕,在此创建并复制新密钥以供代理使用
MemoryLake 控制台显示 API 密钥屏幕,在此创建并复制新密钥以供代理使用

第 2 步:上传你的第一批记忆

从你在解决方案第 4 步中写下的内容开始:新会话应该知道的决策。每个条目一个决策,并附上日期。

MemoryLake 工作区显示上传的第一批文档,列出每个文件成为可搜索记忆的过程
MemoryLake 工作区显示上传的第一批文档,列出每个文件成为可搜索记忆的过程

第 3 步:连接你的 AI 和代理

连接 Claude Code、Codex 和你使用的其他助手。重启的会话可以利用与被替换会话相同的决策。

MemoryLake 集成屏幕列出了可以连接到记忆层的 AI 客户端和代理框架
MemoryLake 集成屏幕列出了可以连接到记忆层的 AI 客户端和代理框架

这在实践中改变了什么

第一个区别是减少了对单一会话的依赖。如果会话重启,决策仍然可用。

第二个区别是记录更完整。手机上给出的答案不必只留在手机上。

第三个区别是工具之间的一致性。Claude Code 和其他助手中都有相同的决策。

Claude Code 频道的最佳实践

从 fakechat 开始。 在连接真实平台之前,先在你自己的机器上测试流程。

保持会话运行。 消息仅在会话开启时送达。

按会话选择加入。 使用 --channels 命名每个频道。

保持白名单精简。 白名单发送者可以批准工具使用。

为权限提示做好计划。 使用具有权限转发功能的频道,或者预料到会话会暂停。

记录通过聊天做出的决策。 回复保存在另一个平台上。

预见变化。 频道是研究预览版。

结论

频道允许 MCP 服务器将消息、警报和 Webhook 推送到已经在运行的 Claude Code 会话中。因为消息加入了该会话,Claude 会结合已有的文件、命令和调查进行回答,这使得从手机发出的快速提问变得非常有用。同样的设计意味着事件仅在会话开启时送达。

通过频道的回复出现在另一个平台上,而不是你的终端中。发送者白名单控制谁可以推送消息,并通过权限转发控制谁可以批准工具使用。在 Team 和 Enterprise 计划中,所有者必须先启用频道。在需要时保持会话运行,严格控制白名单,并将你通过聊天桥梁做出的决策记录在比会话更持久的地方。

常见问题

什么是 Claude Code 频道?

将事件(如聊天消息或 Webhook)推送到正在运行的 Claude Code 会话中的 MCP 服务器。

哪些频道可用?

Telegram、Discord 和 iMessage 已包含在研究预览版中,此外还有一个 fakechat 演示。

为什么我的消息没有送达 Claude?

事件仅在会话开启时送达。同时请检查频道是否已在 --channels 中命名,以及你的发送者 ID 是否在白名单上。

为什么我在终端中看不到 Claude 的回复?

终端显示你的入站消息和确认。回复出现在另一个平台上。

别人可以向我的会话发送消息吗?

只有插件白名单上的发送者 ID 可以。其他人的消息会被静默丢弃。

频道在 Team 和 Enterprise 计划中有效吗?

有效,只要所有者在组织设置或托管设置中启用它们即可。

频道是正式发布的吗?

不是。它们是研究预览版,标志和协议可能会发生变化。