教程

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 GitHub Actions 完全接入指南(v1.0 GA 版):自动 PR 与 CI/CD 集成Claude Code GitHub Actions 正式升级为 v1.0 GA 版本,支持自动模式检测和简化配置。本文提供快速搭建(/install-github-app)与手动搭建两种方式,以及从 Beta 版本迁移到 v1.0 的完整字段对照表和实战 YAML 示例。2026/7/6教程Claude Code 连接 MCP 服务器完全指南:HTTP、SSE、Stdio、WebSocket 四种方式完整梳理 Claude Code 连接 MCP 服务器的四种方式:HTTP(推荐)、SSE、本地 Stdio、WebSocket,附 claude mcp add 命令语法、认证配置、CLAUDE_PROJECT_DIR 环境变量用法,以及团队场景下的服务器审批机制。2026/7/6教程Claude Code Week 26 功能详解:MCP 命令行登录、Shell 命令自动响应与后台子代理权限提示Claude Code Week 26 三大核心新特性:claude mcp login/logout 支持命令行直接 OAuth 认证 MCP 服务器;Shell 命令自动响应让 ! npm test 直接得到分析;后台子代理权限提示从自动拒绝改为主会话弹出。2026/7/3教程Claude Code Routines 指南:定时、API 和 GitHub 事件触发的云端自动化Claude Code Routines 让 Claude Code 在 Anthropic 管理的云端基础设施上自动运行:可按计划执行、由 HTTP API 触发,或响应 GitHub PR/release 等事件。2026/6/8