Claude Code Channels 完全指南：让 Telegram/Discord 消息直接推送到你的编码会话

想象一下：你的 Claude Code 正在运行一个长任务，你离开了终端去喝杯咖啡。这时 CI 构建失败了，或者同事在 Telegram 给你发了条紧急消息。以前你需要回到终端才能处理，现在有了 Channels，这些事件会直接推送到你正在运行的 Claude Code 会话中。

什么是 Channels？#

Channels 是 Claude Code v2.1.80+ 引入的新功能（目前处于 Research Preview 阶段），它允许通过 MCP Server 将外部事件推送到你正在运行的 Claude Code 会话中。

简单来说：

• 传统方式：你打开 Claude Code → 输入指令 → Claude 响应
• Channels 方式：外部事件主动推送 → Claude 在当前会话中自动响应

而且 Channels 是双向的——Claude 不仅能接收消息，还能通过同一个 Channel 回复。

目前支持的 Channel#

Telegram 配置步骤#

1. 创建 Telegram Bot#

打开 BotFather，发送 /newbot，按提示创建 Bot 并复制 Token。

2. 安装插件#

# 在 Claude Code 中
/plugin install telegram@claude-plugins-official
/reload-plugins

3. 配置 Token#

/telegram:configure <你的Bot Token>

Token 保存到 ~/.claude/channels/telegram/.env。

4. 启动 Channel#

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

5. 配对和安全#

在 Telegram 给 Bot 发消息，Bot 会回复配对码。在 Claude Code 中输入：

/telegram:access pair <配对码>
/telegram:access policy allowlist  # 锁定只允许你的账号

Discord 配置步骤#

1. 创建 Discord Bot#

前往 Discord Developer Portal：

• 创建 New Application → Bot → Reset Token → 复制
• 启用 Message Content Intent
• OAuth2 → URL Generator → 选择 bot → 启用权限

2. 安装和配置#

/plugin install discord@claude-plugins-official
/reload-plugins
/discord:configure <Bot Token>
claude --channels plugin:discord@claude-plugins-official

3. 配对#

DM 你的 Bot → 获取配对码 → 在 Claude Code 中完成配对。

iMessage 配置（macOS 专属）#

iMessage Channel 直接读取 macOS 的 Messages 数据库，无需外部服务：

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

首次使用需要授权 Full Disk Access。给自己发 iMessage 即可测试（self-chat 自动绕过访问控制）。

实际使用场景#

场景1：远程监控构建#

你启动了一个长时间的构建任务，通过 Telegram 接收构建状态更新。构建失败时，Claude 可以立即分析错误并尝试修复。

场景2：团队协作#

同事通过 Discord 给你的 Claude Bot 发消息描述 Bug，Claude 在你的代码库中直接定位和修复问题。

场景3：CI/CD 通知#

将 CI 结果转发到 Channel，Claude 自动分析失败的测试用例并建议修复方案。

安全机制#

• 发送者白名单：可以精确控制谁能向你的 Claude 会话发送消息
• 配对机制：需要物理访问 Claude Code 终端才能完成配对
• 企业控制：Team 和 Enterprise 组织需要管理员显式启用

与其他方案的对比#

Channels 的独特优势在于事件到达你已经打开的会话，保持完整的项目上下文和对话历史。

注意事项#

1. 需要 claude.ai 登录，不支持 Console 或 API Key 认证
2. 事件只在会话打开时到达——如果你关闭了 Claude Code，消息不会排队
3. 要实现始终在线，需要在后台进程或持久终端中运行 Claude
4. 当 Claude 回复时，终端只显示工具调用和确认，实际回复在对应平台上

原文来源：Claude Code Channels 文档 | 来源：Claude Code 官方文档