claude-code/docs/features/channels.md

Channels — 外部频道消息接入

启动参数：--channels / --dangerously-load-development-channels 状态：已解除 feature flag 和 OAuth 限制，可直接使用

概述

Channel 是一个 MCP 服务器，它将外部事件推送到你运行中的 Claude Code 会话中，以便 Claude 可以在你不在终端时做出反应。详细使用说明请参考以下文档：

• 官方文档：使用 channels 将事件推送到运行中的会话
• 飞书插件：claude-code-feishu-channel — 社区首个飞书 Channel 插件，支持双向消息、配对认证、群组聊天、文件附件

快速开始

# 启用频道监听（plugin 格式）
ccb --channels plugin:feishu@claude-code-feishu-channel

# 启用频道监听（server 格式）
ccb --channels server:my-slack-bridge

# 同时启用多个频道
ccb --channels plugin:feishu@claude-code-feishu-channel --channels server:discord-bot

# 开发模式（跳过 allowlist 检查，用于测试自定义 channel）
ccb --dangerously-load-development-channels server:my-custom-channel

支持的 Channel

Channel	说明	来源
Telegram	官方 Telegram Bot 集成	/plugin install telegram@claude-plugins-official
Discord	官方 Discord Bot 集成	/plugin install discord@claude-plugins-official
iMessage	macOS 原生消息	/plugin install imessage@claude-plugins-official
飞书 (Feishu/Lark)	双向消息、群组聊天、文件附件	/plugin install feishu@claude-code-feishu-channel

相关文件

文件	职责
src/services/mcp/channelNotification.ts	频道 gate 逻辑、消息包装
src/services/mcp/channelAllowlist.ts	频道开关（已默认开启）
src/services/mcp/useManageMCPConnections.ts	MCP 连接管理中的频道注册
src/components/LogoV2/ChannelsNotice.tsx	启动时频道状态提示
src/main.tsx	--channels 参数解析
src/interactiveHelpers.tsx	Dev channels 确认对话框

参考链接

• 官方 Channels 文档 — 完整使用说明、安全性、Enterprise 控制
• 飞书 Channel 插件 — 安装配置教程、MCP 工具、Skill 命令参考