Claude Code Channels与计划任务完整指南：把外部事件推入会话

课程信息

作者：老金

预计学时：2-3小时

难度等级：⭐⭐⭐ 进阶

更新日期：2026年4月

适用版本：Claude Code v2.1.92（验证于 2026-04-05）

信息来源：

Claude Code 官方文档 - Channels

Claude Code 官方文档 - Scheduled tasks

本课学习目标

完成本课后，你将能：

理解 Channels、Remote Control、MCP、Cloud Tasks 之间的区别
正确安装并启用官方 channel plugin
用 --channels 把 Telegram / Discord / iMessage / fakechat 推入当前会话
正确使用 /schedule、/loop、CronCreate / CronList / CronDelete
避开“用 polling 解决 push 问题”这种常见设计误区

1. 先说结论

Channels 和计划任务，解决的是两类不同问题：

Channels：外部事件主动推给 Claude
计划任务：Claude 按时间轮询或提醒

如果你只记一句话：

有事件就用 Channels，没有事件源才考虑 /loop 或 /schedule。

2. Channels 是什么

官方当前定义里，Channels 是：

通过 MCP server 把消息、提醒、Webhook 直接推入你已经打开的 Claude Code 会话。

它不是新开云端会话，也不是轮询。

它的核心价值是：

CI 失败了，直接把结果推进当前会话
Telegram / Discord / iMessage 上给 Claude 发消息
你不在终端前时，也能让外部事件进到当前 session

2.1 当前官方状态

research preview
需要 Claude Code v2.1.80+
需要 claude.ai 登录
不支持 API key / Console auth
Team / Enterprise 默认可能关闭，需要管理员启用

3. Channels、Remote Control、普通 MCP 的区别

功能	解决什么问题	最适合场景
Channels	外部事件主动推进来	CI、聊天桥、Webhook
Remote Control	你自己从别的设备继续控制会话	手机继续本地会话
普通 MCP	Claude 在任务中主动调用外部工具	按需查数据 / 操作系统
`/loop` / `Cron*`	按时间轮询或提醒	没有事件推送源时

一个特别重要的判断标准：

外部系统会主动发事件：优先 Channels
只能自己定时检查：才用 /loop

4. 开始前准备

4.1 基础条件

Claude Code 已安装并登录 claude.ai
能看到 /plugin
若要跑官方 channel plugin，需要 Bun

4.2 当前官方支持的典型 channel plugin

Telegram
Discord
iMessage
fakechat（官方 demo）

5. 最推荐的入门方式：fakechat

如果你第一次接触 Channels，别一上来就配 Telegram。

先用官方 demo fakechat 最稳。

5.1 安装插件

在 Claude Code 里：

/plugin install fakechat@claude-plugins-official

如果提示 marketplace 不存在或未更新，先执行：

/plugin marketplace update claude-plugins-official

或：

/plugin marketplace add anthropics/claude-plugins-official

5.2 启动 channels

退出当前会话后重新启动：

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

5.3 打开本地界面

浏览器打开：

http://localhost:8787

在页面输入消息，它会作为 <channel source="fakechat"> 事件进入你当前 Claude Code 会话。

这就是理解 Channels 最快的方法。

6. Telegram / Discord / iMessage 的核心模式

它们虽然接法不同，但逻辑一致：

装 plugin
配 token 或权限
用 --channels 启动
做 pairing / allowlist
之后该平台的消息会直接推入当前 session

6.1 Telegram

官方主路径大致是：

/plugin install telegram@claude-plugins-official
/reload-plugins
/telegram:configure <token>

然后重启：

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

再做配对：

/telegram:access pair <code>
/telegram:access policy allowlist

6.2 Discord

同理：

/plugin install discord@claude-plugins-official
/reload-plugins
/discord:configure <token>

然后：

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

最后：

/discord:access pair <code>
/discord:access policy allowlist

6.3 iMessage

iMessage 逻辑不同：

只支持 macOS
直接读本机 Messages 数据库
需要 Full Disk Access
回复靠 AppleScript

启动方式：

/plugin install imessage@claude-plugins-official

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

默认给自己发消息即可打通；允许其他联系人则用：

/imessage:access allow +15551234567

7. Channels 的安全边界

官方当前强调的几个点很关键：

7.1 allowlist 是核心

所有 approved channel plugin 都有 sender allowlist。

也就是说：

不是“谁知道 bot 就能发”
而是“只有被允许的 sender 才能推消息进来”

7.2 `--channels` 只是本会话启用

即便 .mcp.json 里有 server，也不代表它能推送消息。

必须当前会话显式用：

claude --channels plugin:xxx@marketplace

7.3 Team / Enterprise 还能再控一层

管理员可以通过：

channelsEnabled
allowedChannelPlugins

控制：

组织是否允许 Channels
哪些 plugin 可以注册成 channel

8. 什么时候该用 `/loop`

/loop 不是 Channels 的替代品，它是：

当前会话仍然开着时，用最低成本做“定时轮询”。

官方当前把 /loop 归为 bundled skill，不是固定逻辑 built-in command。

8.1 最基础用法

/loop 5m check if the deployment finished and tell me what happened

8.2 它支持几种写法

/loop 30m check the build
/loop check the build every 2 hours
/loop check the build

如果你不写间隔，默认是 每 10 分钟。

8.3 支持单位

但底层 cron 只有分钟粒度，所以秒会向上取整到分钟。

8.4 还能循环执行另一个命令

/loop 20m /sync-inbox

9. `/schedule`、`CronCreate`、`CronList`、`CronDelete`

除了 /loop，Claude Code 现在还有更底层的 cron 调度能力。

9.1 当前官方工具

工具	作用
`CronCreate`	创建任务
`CronList`	列出任务
`CronDelete`	删除任务

9.2 `/schedule` 是什么

/schedule 是当前用户入口，用来创建、更新、列出和运行 Cloud scheduled tasks。

但在本地 session 里，Claude 也会借助 CronCreate / CronList / CronDelete 做 session-scoped 的计划任务和提醒。

9.3 一次性提醒

你甚至不一定非得手打 /schedule。

自然语言也可以：

remind me at 3pm to push the release branch

in 45 minutes, check whether the integration tests passed

10. 当前本地计划任务的关键限制

官方当前明确写了几个限制，必须知道：

10.1 任务是 session-scoped

只要当前 Claude Code 会话结束，任务就没了。

10.2 不跨重启持久化

重启 Claude Code 后，本地 cron 任务不会继续。

10.3 Claude 忙的时候不会插队

定时任务会在 turn 之间触发，不会在 Claude 正在回答时硬插进去。

10.4 recurring task 7 天自动过期

官方当前默认策略是：

循环任务 7 天后自动过期
最后再触发一次，然后删除

这是为了防止遗忘的轮询长期跑下去。

11. 什么时候该用 Cloud / Desktop scheduled tasks

如果你需要：

关掉终端后也继续
重启后依然在
不依赖当前 session 持续存活

那就别靠 /loop。

官方建议：

要可靠、无需你机器在线：用 Cloud scheduled tasks
要跑在你本机且跨重启：用 Desktop scheduled tasks
只是在当前 session 临时盯一件事：用 /loop

12. 常见误区

误区 1：Channels = Remote Control

不是。

Remote Control 是你自己远程接管
Channels 是外部系统把消息推过来

误区 2：有 `/loop` 就不用 Channels

不对。

如果外部系统本来就能发事件，轮询只是更慢、更贵、更脆。

误区 3：计划任务会一直留着

不会。当前本地计划任务是 session-scoped，循环任务还有 7 天自动过期。

13. 实用速查

/plugin install fakechat@claude-plugins-official
/reload-plugins

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

/loop 5m check if the deployment finished

what scheduled tasks do I have?
cancel the deploy check job

14. 下一步建议

想跨设备继续本地会话：继续看 Remote Control完整指南
想控制模型、1M 上下文和 opusplan：继续看安装指南中的模型配置章节

最后更新：2026年4月5日 | 适用版本：Claude Code v2.1.92

FilesExpand file tree

13-Channels与计划任务完整指南.md

Latest commit

History