Claude Code Channels 与计划任务指南

核心概念

Channels 和计划任务解决两类不同问题:

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

关键原则:

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

什么是 Channels

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

核心价值:

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

当前状态:

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

Channels vs Remote Control vs MCP

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

判断标准:

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

开始前准备

基础条件:

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

当前官方支持的 channel plugin:

Telegram
Discord
iMessage
fakechat (官方 demo)

入门: fakechat

安装插件

/plugin install fakechat@claude-plugins-official

如果提示 marketplace 不存在:

/plugin marketplace update claude-plugins-official

# 或
/plugin marketplace add anthropics/claude-plugins-official

启动 channels

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

同时启动多个 channel:

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

打开本地界面

浏览器打开:

http://localhost:8787

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

Telegram 集成

配置流程

# 1. 安装插件
/plugin install telegram@claude-plugins-official

# 2. 重新加载插件
/reload-plugins

# 3. 配置 token
/telegram:configure <token>

启动

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

配对和权限

# 配对
/telegram:access pair <code>

# 设置权限策略
/telegram:access policy allowlist

Token 存储

Token 默认存储在 ~/.claude/channels/telegram/.env,包含 TELEGRAM_BOT_TOKEN。

Discord 集成

配置流程

# 1. 安装插件
/plugin install discord@claude-plugins-official

# 2. 重新加载插件
/reload-plugins

# 3. 配置 token
/discord:configure <token>

启动

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

配对和权限

# 配对
/discord:access pair <code>

# 设置权限策略
/discord:access policy allowlist

Discord Bot 必须开启的权限

Message Content Intent (在 Developer Portal 的 Bot 设置中开启)
View Channels
Send Messages
Send Messages in Threads
Read Message History
Attach Files
Add Reactions

Token 存储

Token 默认存储在 ~/.claude/channels/discord/.env,包含 DISCORD_BOT_TOKEN。

iMessage 集成

特点

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

配置流程

# 安装插件
/plugin install imessage@claude-plugins-official

启动

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

允许联系人

# 默认给自己发消息即可打通
# 允许其他联系人
/imessage:access allow +15551234567

Channels 安全边界

allowlist 是核心

所有 approved channel plugin 都有 sender allowlist:

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

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

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

必须当前会话显式用:

claude --channels plugin:xxx@marketplace

Team/Enterprise 控制

管理员可以通过:

channelsEnabled
allowedChannelPlugins

控制:

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

开发模式

开发自定义 channel plugin 时:

claude --channels plugin:my-channel --dangerously-load-development-channels

该参数绕过 marketplace 验证,仅用于本地开发调试。

Permission Relay: 远端审批权限请求

从 v2.1.81 起,Channels 支持权限中继:

当 Claude 需要执行需要审批的操作时 (如写文件、执行命令),权限确认请求会被转发到你的 Channel (如 Telegram/Discord),你可以直接在手机上批准或拒绝。

这意味着你不需要守在终端前也能让 Claude 继续有权限地工作。

事件只在会话打开时到达

Channel 消息只会在 Claude Code 会话运行时被接收。如果你关掉了终端,消息就丢了。

如果你需要 always-on 的 Channel 接收:

在后台进程中运行 Claude Code
或使用持久终端 (如 tmux/screen)

计划任务: /loop

/loop 是当前会话仍然开着时,用最低成本做"定时轮询"。

基础用法

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

默认行为

如果你只打 /loop 不带任何参数,Claude 会使用内置的维护提示词,按以下优先级自动工作:

继续未完成的工作
维护当前 PR (查看 review comments、CI 失败、merge conflicts)
运行清理 (bug 排查、代码简化)

自定义默认提示词

在项目目录创建 .claude/loop.md,或在用户目录创建 ~/.claude/loop.md。项目级优先于用户级。

支持的写法

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

如果你不写间隔且带了自定义 prompt,Claude 会动态选择间隔 (1 分钟到 1 小时之间)。

支持单位

s - 秒
m - 分钟
h - 小时
d - 天

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

循环执行另一个命令

/loop 20m /sync-inbox

取消正在等待的 /loop

在 /loop 等待下一次迭代时,按 Esc 即可取消 (v2.1.111+)。

/proactive 别名

从 v2.1.105 起,/proactive 是 /loop 的别名,功能完全相同。

Cron 调度能力

当前官方工具

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

计划任务功能从 v2.1.72+ 开始可用。

Cron 表达式参考

| 表达式 | 含义 | |--------|------| | */5 * * * * | 每 5 分钟 | | 0 * * * * | 每小时整点 | | 0 9 * * * | 每天早上 9 点 | | 0 9 * * 1-5 | 工作日早上 9 点 | | 30 14 15 3 * | 3 月 15 日下午 2:30 |

所有时间均为本地时区,不是 UTC。

/schedule 命令

/schedule 用来创建、更新、列出和运行 Cloud scheduled tasks。

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

一次性提醒

自然语言也可以:

remind me at 3pm to push the release branch

in 45 minutes, check whether the integration tests passed

正常重启 → 任务丢失
claude --resume / claude --continue → 未过期任务自动恢复

Claude 忙的时候不会插队

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

recurring task 7 天自动过期

官方当前默认策略:

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

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

退出确认会提示剩余任务 (v2.1.113+)

从 v2.1.113 起,当你退出会话时,如果还有未完成的计划任务,Claude Code 会显示确认提示并展示倒计时:

一次性任务: 显示距离触发还有多久
循环任务: 显示下一次触发时间

每个会话最多 50 个计划任务

官方当前限制: 单个会话最多 50 个计划任务。超过后需要先删除旧的才能创建新的。

--resume 不会恢复所有任务

v2.1.110 的 --resume 恢复策略:

循环任务: 创建后 7 天内的会恢复
一次性任务: 计划时间未过的会恢复
后台 Bash 和监控任务: 永远不恢复

Jitter 策略

为了避免大规模部署时所有 Claude 实例在同一时刻触发:

循环任务: 最多延迟周期的 10% (上限 15 分钟)
一次性任务: 整点/半点前后最多提前 90 秒

这是确定性偏移,不是随机的。

Bedrock/Vertex/Foundry 限制

在 Bedrock、Vertex 或 Foundry 环境下,/loop <prompt> 固定为 10 分钟间隔,不支持动态调整。

禁用调度器

如果你完全不需要计划任务功能:

CLAUDE_CODE_DISABLE_CRON=1 claude

Cloud/Desktop scheduled tasks

如果你需要:

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

那就别靠 /loop。

官方建议:

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

常见误区

误区 1: Channels = Remote Control

不是。

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

# 安装 fakechat
/plugin install fakechat@claude-plugins-official
/reload-plugins

# 启动 channels
claude --channels plugin:fakechat@claude-plugins-official

# 同时启动多个 channel
claude --channels plugin:telegram@claude-plugins-official plugin:discord@claude-plugins-official

# 开发模式
claude --channels plugin:my-channel --dangerously-load-development-channels

计划任务操作

# 基础 /loop
/loop 5m check if the deployment finished

# 取消正在等待的 /loop
按 Esc

# 查询计划任务
what scheduled tasks do I have?

# 取消任务
cancel the deploy check job

# 自定义 /loop 默认提示词
创建 .claude/loop.md 或 ~/.claude/loop.md

# 恢复会话时自动恢复未过期任务
claude --resume

# 禁用调度器
CLAUDE_CODE_DISABLE_CRON=1 claude

Telegram 配置

/plugin install telegram@claude-plugins-official
/reload-plugins
/telegram:configure <token>
/telegram:access pair <code>
/telegram:access policy allowlist

Discord 配置

/plugin install discord@claude-plugins-official
/reload-plugins
/discord:configure <token>
/discord:access pair <code>
/discord:access policy allowlist

iMessage 配置

/plugin install imessage@claude-plugins-official
/imessage:access allow +15551234567

典型使用场景

场景 1: CI/CD 集成

# 启动 Telegram channel
claude --channels plugin:telegram@claude-plugins-official

# CI 失败时,通过 Telegram bot 推送消息到 Claude
# Claude 自动分析失败原因并提供修复建议

场景 2: 定时检查部署状态

/loop 5m check if the production deployment is healthy and alert me if there are any issues

场景 3: 团队协作

# 启动 Discord channel
claude --channels plugin:discord@claude-plugins-official

# 团队成员可以通过 Discord 直接与 Claude 交互
# Claude 可以回答问题、执行任务、提供建议

场景 4: 一次性提醒

remind me in 2 hours to review the PR

at 5pm, check if all tests passed and prepare the release notes

场景 5: 维护任务

# 使用默认维护提示词
/loop

# Claude 会自动:
# 1. 继续未完成的工作
# 2. 维护当前 PR
# 3. 运行清理任务

最佳实践

1. 选择合适的工具

外部事件推送 → Channels
定时轮询 → /loop
跨重启持久化 → Cloud/Desktop scheduled tasks

2. 安全配置

始终使用 allowlist 控制访问
定期审查允许的 sender
使用环境变量存储 token
不要在代码中硬编码敏感信息

3. 性能优化

合理设置 /loop 间隔
避免过于频繁的轮询
使用 Channels 代替轮询
及时清理不需要的计划任务

4. 监控和维护

定期检查计划任务列表
监控 Channel 连接状态
及时处理过期任务
使用 --resume 恢复重要任务

故障排查

问题 1: Channel 无法连接

可能原因:

Token 配置错误
网络问题
Bot 权限不足

解决方案:

# 检查 token 配置
cat ~/.claude/channels/telegram/.env

# 重新配置
/telegram:configure <new_token>

# 检查 Bot 权限
# 确保 Discord Bot 开启了 Message Content Intent

问题 2: 计划任务未触发

可能原因:

会话已关闭
任务已过期
Claude 正在忙

解决方案:

# 检查任务列表
what scheduled tasks do I have?

# 重新创建任务
/loop 5m check deployment status

# 使用 --resume 恢复任务
claude --resume

问题 3: Permission Relay 不工作

可能原因:

Channel 未正确配置
版本过低 (需要 v2.1.81+)
权限请求被阻止

解决方案:

升级到最新版本
检查 Channel 配置
确保 allowlist 正确设置

问题 4: /loop 间隔不准确

可能原因:

Jitter 策略
底层 cron 只有分钟粒度
Claude 正在执行其他任务

解决方案:

理解 Jitter 策略是正常行为
使用分钟级别的间隔
避免在 Claude 忙时触发

常见问题

Q: Channels 会把我的代码上传到云端吗?

不会。Channels 只是把外部消息推入你的本地会话。

Q: /loop 可以跨重启持久化吗?

部分可以。使用 claude --resume 可以恢复未过期的任务。

Q: 如何查看所有计划任务?

what scheduled tasks do I have?

Q: 如何取消所有计划任务?

cancel all scheduled tasks

Q: Channels 支持哪些平台?

当前官方支持: Telegram、Discord、iMessage、fakechat。

Q: 如何开发自定义 Channel?

使用 --dangerously-load-development-channels 参数加载本地开发的 channel plugin。

Q: /loop 和 /schedule 有什么区别?

/loop: 本地 session-scoped 的轮询
/schedule: Cloud scheduled tasks,跨重启持久化

Q: 如何禁用计划任务功能?

CLAUDE_CODE_DISABLE_CRON=1 claude

总结

通过本指南,你已经掌握了:

Channels 概念 - 理解外部事件推送机制
Channel 集成 - Telegram、Discord、iMessage 配置
安全边界 - allowlist、Permission Relay
计划任务 - /loop、Cron 调度
限制和最佳实践 - 理解 session-scoped 和过期策略
故障排查 - 解决常见问题
典型场景 - 实际应用案例

下一步学习:

Remote Control 远程控制
Agent SDK 开发
企业级集成

参考资源

更新日期: 2026年4月29日
适用版本: Claude Code v2.1.119+

Claude Code Channels 与计划任务指南

分享这篇文章