Claude Code 如何用 --channels 把 Discord 与 Telegram 消息接入会话claude-howto 的频道插件配置【免费下载链接】claude-howtoA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-howto如果你的 Claude Code 会话目前只能在终端里手动输入而团队的实际沟通发生在 Discord 或 Telegram--channels就是用来打通这两端的启动时加上该标志外部渠道的消息会以 MCP 频道插件的形式实时推入正在运行的会话Claude 可以在会话上下文中直接读取并回复这些消息。这个能力在 claude-howto 中被称为 Channels属于 Research Preview 功能支持的渠道包括 Discord、Telegram、iMessage 和任意 webhook。本文基于仓库中 09-advanced-features/README.md 的 Channels 章节与 10-cli/README.md 的 CLI 参考给出从启动订阅到企业端管控配置的完整操作路径。开始前需要满足的两个条件安装 Claude Code 并保持版本可用claude-howto 给出的安装方式是 npm 全局安装npm install -g anthropic-ai/claude-codeCLI 参考 说明自 v2.1.113 起npm 安装会在后台拉取与你平台匹配的 native 二进制如果企业代理需要显式放行名单需把downloads.claude.ai加入出口规则否则安装或claude update会失败。完成鉴权并注意认证方式与版本的对应关系Channels 的鉴权要求与 Claude Code 版本绑定这是 CHANGELOG.md 中 v2.1.128 条目明确写出的变化v2.1.128 及以后--channels同时支持 Pro/Max OAuth 登录和 API-keyconsole认证更早版本只支持 OAuthAPI-key 认证无法使用--channels。所以如果你的环境用 API-key 跑 Claude Code先确认版本不低于 v2.1.128。可用文档给出的命令检查登录状态claude auth status该命令登录成功时退出码为 0未登录时为 1见 CLI 参考 的命令表。API-key 用户按文档的排查章节设置export ANTHROPIC_API_KEYyour-key其中your-key需要替换为你自己的密钥。启动时订阅 Discord 与 Telegram 频道频道不是会话中途加载的而是在启动时通过--channels标志订阅。这是 Channels 章节 给出的两条命令# 只订阅 Discord 与 Telegram claude --channels discord,telegram # 同时订阅多个来源 claude --channels discord,telegram,imessage,webhooks参数值是渠道插件名逗号分隔、不加空格。只接一个渠道时同样适用CLI 参考 的 Advanced Features 表中就列了claude --channels discord这种单渠道写法。启动后发生什么文档的 How It Works 部分描述了完整链路理解这四点有助于判断接入是否生效MCP server 作为频道插件channel plugin连接外部服务外部服务的消息和事件被推送进当前活跃的 Claude Code 会话Claude 在会话上下文中读取并回复这些消息整个过程不需要轮询事件实时送达。各渠道的具体能力如下表摘自 Channels 章节渠道说明Discord在会话中接收并回复 Discord 消息Telegram在会话中接收并回复 Telegram 消息iMessage在会话中接收 iMessage 通知Webhooks接收来自任意 webhook 来源的事件验证方式文档没有给出固定的成功日志实际判断依据就是上述第 2、3 点启动会话后从 Discord 或 Telegram 向机器人发送消息事件被推入当前会话、Claude 在会话内对该消息做出响应说明链路已通。企业环境用 allowedChannelPlugins 管控允许的频道插件个人使用时只需--channels标志即可组织级部署则通过 managed setting 控制哪些频道插件被允许。文档给出的配置示例{ allowedChannelPlugins: [discord, telegram] }allowedChannelPlugins控制整个组织中允许使用的频道插件且 How It Works 的第 4 点明确写道频道插件必须经由该 managed setting 批准。也就是说企业环境下如果某个渠道消息推不进来应先检查该设置是否包含对应插件名。07-plugins/README.md 的插件设置表中同样列出了allowedChannelPlugins这一键但描述角度略有差异Control which plugins are permitted per release channel两处对适用条件的口径不完全一致涉及企业管控行为时建议以 09-advanced-features/README.md Channels 章节的表述为准。排查与边界结合 CLI 参考 的 Troubleshooting 章节只列与 Channels 直接相关的项claude: command not found重新执行npm install -g anthropic-ai/claude-code确认 PATH 包含 npm 全局 bin 目录或改用npx claude运行。认证失败检查ANTHROPIC_API_KEY是否已设置、密钥是否有效且额度充足、是否有权访问所请求的模型OAuth 用户重新claude auth login。API-key 用户启动--channels无反应优先核对版本是否达到 v2.1.128——这是文档唯一给出的、与该功能相关的版本门槛。边界与限制均来自源文档Channels 是Research PreviewCATALOG.md 也将其标注为 Research Preview条目为 Multi-channel communication … Configure channel plugins; March 2026意味着能力可能随版本变化仓库内各文档对渠道列表的口径有轻微出入CATALOG.md 的条目写作 Multi-channel communication (Telegram, Slack, etc.)而 09-advanced-features/README.md 的 Channels 章节列出的来源是 Telegram、Discord、iMessage 和 webhooks未把 Slack 列为渠道插件仓库中出现的 Slack 是 05-mcp/README.md 里 MCP server 示例的用法与--channels不是同一机制。本文以 Channels 章节的列表为准。下一步想确认当前版本还有哪些 CLI 标志与--channels组合例如--mcp-config、--strict-mcp-config查 10-cli/README.md 的 MCP Configuration 一节想把它放进功能选型聊天集成选 Channels这条决策路径见 QUICK_REFERENCE.md 的 Feature Matrix或直接阅读 09-advanced-features/README.md 的完整 Channels 章节核对最新表述。【免费下载链接】claude-howtoA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-howto创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考