教程

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

Claude Code Channels 功能详解:通过 Telegram、Discord、iMessage 将外部消息直接推送到编码会话,实现双向通信和自动化响应。含完整配置步骤和实际使用场景。

2026/4/74分钟 阅读ClaudeEagle

想象一下:你的 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

Channel说明
Telegram通过 BotFather 创建 Bot
Discord通过 Discord Developer Portal 创建 Bot
iMessagemacOS 原生,无需外部服务
fakechat本地演示,localhost 聊天界面

Telegram 配置步骤

1. 创建 Telegram Bot

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

2. 安装插件

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

3. 配置 Token

bash
/telegram:configure <你的Bot Token>

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

4. 启动 Channel

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

5. 配对和安全

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

bash
/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. 安装和配置

bash
/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 数据库,无需外部服务:

bash
/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事件推送到当前会话,保持完整上下文
Web Sessions生成新的云端会话
Slack 集成等待被轮询
MCP通用协议,Channels 基于 MCP 构建

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

注意事项

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

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

相关文章推荐

教程Claude Code MCP 完整接入指南:HTTP、SSE、stdio、OAuth 和 ChannelsClaude Code MCP 官方文档中文整理:MCP 能做什么、何时该接入、HTTP/SSE/stdio 三种安装方式、claude mcp add 命令、.mcp.json 配置、/mcp 面板、OAuth 认证、动态工具更新、自动重连、Channels 推送消息、插件内置 MCP 服务器,以及安全风险与最佳实践。2026/5/15教程Claude Code Dispatch 和 Channels 完整指南:作为后台服务运行 Claude CodeClaude Code Dispatch 和 Channels 完整指南:Dispatch 将 Claude Code 变成可程序化调用的后台 Worker;Channels 提供运行中 Session 的结构化实时事件流;两者与 Routines 的定位差异;Dispatch vs 'claude -p 脚本' 的架构比较;Channels 事件类型(file_read/file_modified/tool_called/completion/error);完整 Python 监控代码示例;PR 自动审查/告警驱动自动修复/CI 后部署验证三个完整工作流;Auto Mode 与 Dispatch 的配合;以及 Remote Control 的集成模式。2026/5/12教程Claude Code Hooks 官方完整指南:28 个事件、JSON 输出和安全拦截实战Claude Code Hooks 官方文档完整中文整理:Hook 生命周期、28 个事件表、matcher 与 if 条件、PreToolUse 安全拦截、PostToolUse 自动化、JSON 输出格式、exit code 行为、HTTP hooks、异步 hooks、MCP tool hooks,以及一套可直接复用的团队安全配置。2026/5/15教程Claude Code Routines 官方完整指南:定时任务、API 触发、GitHub 事件自动化Claude Code Routines 官方文档完整中文整理:Routines 是什么(Prompt + Repository + Connectors);三种触发方式(Schedule 定时/API HTTP 触发/GitHub 事件);7 步创建流程(Web 界面);CLI 的 /schedule 命令;GitHub 触发器 PR 过滤器(8 个字段、正则注意事项);API 触发请求格式和响应;一次性运行;运行管理(绿色状态不等于任务成功);分支权限控制;网络访问配置;用量和限制说明;以及 Routines vs Desktop Tasks vs /loop vs GitHub Actions 的对比。2026/5/12教程Claude Code 定时任务完整指南:/schedule、Routines 三种触发方式和 /loop 监控/schedule 命令和 Routines 完整指南:/schedule 创建/查看/运行/编辑/删除定时任务;Routines 三种触发方式(Cron 定时/GitHub 事件/Webhook API /fire 端点);4 个实战 Routine 配置(每日健康检查/PR 自动质量门/每周技术债扫描/CI 失败分析);/loop 会话内定期重复(vs /schedule 的区别对比);Routines 访问权限配置(GitHub/Slack/数据库);以及 Routines + ultrareview/Hooks/Subagents 的组合用法。2026/5/8教程Claude Code 自定义 Agents 完整指南:创建专用 AI 编程助手Claude Code 自定义 Agents 完整指南:Agent 定义文件格式(Frontmatter 字段:name/description/tools/permissionMode/model/effort/context);4 种调用方式(/agents 界面/--agent CLI/对话提及/Print 模式自动化);4 个实战 Agent 配置(安全审查员/数据库优化顾问/无障碍合规检查/TypeScript 类型安全/CI 失败分析师);skillOverrides 控制可见性;context: fork 独立上下文;以及在 GitHub Actions 里使用 Agent 的 CI 配置示例。2026/5/7