Channels¶

本文你会学到：

• 🎯 Channel 是什么，它和普通 MCP 服务器有什么本质区别
• 🔧 如何安装和配置 Telegram、Discord、iMessage 三种官方 Channel
• 🚀 使用 fakechat 在本地快速体验 Channel 的工作流程
• 🔒 安全机制：发送者允许列表、配对流程和企业级管控
• 📊 Channel 与 Web 会话、Slack 集成、远程控制的功能对比

⚙️ 为什么需要 Channel¶

当你让 Claude Code 跑一个耗时任务（比如跑测试、重构代码）然后离开终端去处理其他事情时，你会发现一个问题：

CI 构建失败了，但 Claude 不知道——因为它只在**你主动发消息时**才工作。

又或者：

同事在 Telegram 里问了一个关于代码的问题，你想让 Claude 帮你回答，但不想一直守在电脑前。

Channel 就是解决这类问题的机制。它本质上是一个**特殊类型的 MCP 服务器**，可以把外部事件（消息、webhook、告警）推送到你正在运行的 Claude Code 会话中——不需要你主动发指令，Claude 就能「听到」外面发生了什么。

🗂️ Channel 的核心概念¶

Channel 和普通 MCP 的区别¶

你可能已经在用 MCP 服务器给 Claude 接入了数据库、Slack 等外部服务。那 Channel 和普通 MCP 有什么不同？

💡 简单类比：普通 MCP 是你让实习生「去查一下数据库」——你发起，他执行。Channel 是实习员的手机响了——外部事件主动到达，他需要回应。

双向通信¶

Channel 可以是**双向**的：

1. 入站：外部消息（Telegram、Discord 等）到达 Claude Code 会话
2. 出站：Claude 通过同一个 Channel 回复消息

当你通过 Telegram 给 Claude 发消息时，Claude 处理完后会通过 Telegram 回复你——这就是一个完整的聊天桥接。

事件的生命周期¶

Channel 的事件**只在会话打开时才会到达**。如果你的 Claude Code 会话已经关闭，发送的消息不会排队等待。

对于需要「始终在线」的场景，可以在后台进程或持久终端（如 tmux、screen）中运行 Claude Code。

📱 支持的 Channel¶

目前官方支持三种 Channel，每种都以插件形式安装，需要 Bun 运行时。

1
2
3

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

1

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

1
2

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

1
2
3

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

1

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

1
2

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

1

/plugin install imessage@claude-plugins-official

1

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

1

/imessage:access allow +15551234567

🚀 快速体验：fakechat¶

在连接真实平台之前，可以用 fakechat 在本地体验 Channel 的完整工作流程。fakechat 在 localhost 上运行一个简单的聊天 UI，无需任何外部服务配置。

前提条件¶

• Claude Code 已安装并使用 claude.ai 账户认证
• Bun 已安装（用 bun --version 检查）
• Team/Enterprise 用户需要管理员在企业设置中启用 Channel

操作步骤¶

安装插件：安装 fakechat 插件：

1

/plugin install fakechat@claude-plugins-official

启动 Claude Code：使用 --channels 标志启动 Claude Code：

1

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

多个 Channel 用空格分隔：claude --channels plugin:telegram@... plugin:discord@...

发送消息：打开 http://localhost:8787，输入消息：

1

hey, what's in my working directory?

消息以 <channel source="fakechat"> 事件到达 Claude Code 会话，Claude 处理后通过 reply 工具回复，答案显示在聊天 UI 中。

🔒 安全机制¶

发送者允许列表¶

每个 Channel 插件维护一个**发送者允许列表**——只有你添加的 ID 才能推送消息，其他人全部静默丢弃。

Telegram 和 Discord 通过**配对流程**引导：

1. 在平台中向机器人发送任意消息
2. 机器人回复一个**配对代码**
3. 在 Claude Code 中批准配对代码
4. 你的发送者 ID 被添加到允许列表

iMessage 的方式不同：给自己发短信自动绕过门禁，通过 /imessage:access allow 添加其他联系人。

权限中继¶

支持权限中继的 Channel 可以将 Claude Code 的权限提示转发到外部平台（如 Telegram），让你远程批准或拒绝工具使用。这意味着**允许列表中的发送者实际上拥有了批准或拒绝你会话中工具使用的权限**，因此只添加你信任的发送者。

多层防护¶

Channel 的安全由三个层面控制：

🏢 企业管理¶

Team 和 Enterprise 计划上，Channel 默认关闭。管理员通过两个托管设置控制：

Pro 和 Max 用户不受这些限制，直接使用 --channels 即可。

启用 Channel¶

管理员通过 claude.ai 管理员设置 启用，或在托管设置中设置：

1
2
3

{
  "channelsEnabled": true
}

限制允许的 Channel 插件¶

默认情况下，Anthropic 维护的允许列表上的插件都可以注册。管理员可以通过 allowedChannelPlugins 替换为自定义列表：

1
2
3
4
5
6
7
8

{
  "channelsEnabled": true,
  "allowedChannelPlugins": [
    { "marketplace": "claude-plugins-official", "plugin": "telegram" },
    { "marketplace": "claude-plugins-official", "plugin": "discord" },
    { "marketplace": "acme-corp-plugins", "plugin": "internal-alerts" }
  ]
}

设置 allowedChannelPlugins 后，只有列出的插件可以注册。空数组会阻止所有 Channel 插件。要完全阻止（包括开发标志），保持 channelsEnabled 未设置即可。

📊 Channel 与其他集成方式的对比¶

Claude Code 提供了多种连接外部系统的能力，每种适合不同的场景：

Channel 填补了这些方式中的空白——它把来自非 Claude 源的事件推送到你**已经运行**的本地会话中，而不是创建新会话。

两个典型用法¶

聊天桥接：通过 Telegram、Discord 或 iMessage 从手机向 Claude 提问，答案在同一聊天中返回，而工作在你的机器上针对真实文件运行。

1
2
3
4
5

# 在 Telegram 中发送
刚才跑的测试有 3 个失败了，帮我看看是什么原因

# Claude Code 在你的机器上检查测试日志、定位失败原因
# 回复通过 Telegram 返回到你的手机

Webhook 接收器：CI、错误跟踪器、部署管道的 webhook 到达 Claude 时，Claude 已经打开着你的文件并记得你正在调试的内容——比新开一个会话高效得多。

1
2
3
4
5

# GitHub Actions 构建失败后触发 webhook
# Claude Code 收到事件，自动分析构建日志并定位失败步骤

# Sentry 捕获到新的生产错误后触发 webhook
# Claude Code 收到事件，结合当前打开的代码上下文分析根因