Claude Code 官方支持 Telegram 了！Channels 功能配置指南

Claude Code v2.1.80 新增 Channels 功能，绑定 Telegram Bot 后可以直接在手机上给 Claude Code 发消息、发图片、发文件，Claude 处理完自动回复。

版本要求

• Claude Code >= v2.1.80
• 检查当前版本：claude --version
• 升级：npm update -g @anthropic-ai/claude-code

功能亮点

• 支持发送图片、文件附件（Telegram 单文件 50MB，Discord 25MB x 10 个）
• Claude 自动显示”正在输入…”状态，处理完再发结果
• 能编辑之前发送的消息做进度更新
• Discord 额外支持拉取最近 100 条历史消息和按需下载附件
• 完整权限控制：配对模式 / 白名单 / 群组多人，防止陌生人乱发

Telegram 配置步骤

1. 创建 Telegram Bot

打开 Telegram，找到 @BotFather，发送 /newbot：

• Name：显示名称（随意，可含空格）
• Username：唯一标识，必须以 bot 结尾（如 my_claude_bot）

BotFather 会返回一个 token，格式如 123456789:AAHfiqksKZ8...，完整复制（包括开头数字和冒号）。

2. 安装插件

先启动 Claude Code，然后运行：

/plugin install telegram@claude-plugins-official

3. 配置 Bot Token

/telegram:configure 123456789:AAHfiqksKZ8...

这会将 TELEGRAM_BOT_TOKEN=... 写入 ~/.claude/channels/telegram/.env。也可以手动编辑这个文件，或者在 shell 环境变量中设置（环境变量优先级更高）。

4. 带 Channels 标志重启

退出当前 Claude Code 会话，用以下命令重新启动：

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

5. 配对

在 Telegram 中给你的 Bot 发一条消息，Bot 会回复一个 6 位配对码。

在 Claude Code 中输入：

/telegram:access pair <配对码>

配对成功后，下一条 DM 就会直达 Claude。

6. 锁定权限（推荐）

配对完成后，切换到白名单模式，防止陌生人触发配对：

/telegram:access policy allowlist

前置依赖

• Bun — MCP 服务器运行环境

  curl -fsSL https://bun.sh/install | bash

Claude 暴露给 Telegram 的工具

工具	用途
reply	发送消息到聊天，支持 reply_to 原生线程回复，支持 files 发送附件（图片内联预览，其他类型作为文档）。单文件最大 50MB
react	给消息添加 emoji 反应（仅限 Telegram 固定白名单表情）
edit_message	编辑 Bot 之前发送的消息，适合”处理中…” → 结果的进度更新

图片处理

• 收到的图片会自动下载到 ~/.claude/channels/telegram/inbox/
• 本地路径会包含在 <channel> 通知中，Claude 可以通过 Read 工具查看
• Telegram 会压缩图片，如需原图请以文件形式发送（长按 → 以文件发送）

已知限制

• Telegram Bot API 不支持历史消息查询和搜索，Bot 只能看到实时到达的消息
• 没有 fetch_messages 或 download_attachment 工具用于历史消息
• v2.1.80 已知 Bug：inbound 消息能收到但可能不触发 Claude 回复（官方正在修复）

Discord 配置（简要）

Discord 的配置流程类似，额外支持：

• 拉取最近 100 条历史消息
• 按需下载附件
• 服务器 + 频道级别的权限控制

与之前远程方案的对比

方案	优势	劣势
Channels（官方）	原生集成、权限控制完善、支持附件	需要 v2.1.80+，当前有 inbound bug
claude —remote（SSH）	稳定、双向实时	需要 SSH 隧道配置
第三方 Telegram Bot	功能丰富、可自定义	需要自己维护、安全性自负

参考来源

• 官方插件仓库：anthropics/claude-plugins-official
• 推文来源：@xiaohu