Claude Code 连接 Telegram 方法
2026-03-21 2026年03月 Claude-Code连接Telegram教程.md

Claude Code 连接 Telegram 方法

我已经用上了 Claude Code 的 Telegram 插件，巨 TM 丝滑。⚠️ 龙虾危

前提准备

  • Bun — MCP server 需要用到它

步骤一：创建 Telegram Bot

  1. 在 Telegram 上 DM @BotFather
  2. 发送 /newbot
  3. 输入 bot 的名称（显示名称，可以有空格）
  4. 输入 bot 的用户名（必须以 bot 结尾，且不能和别人的重复）
  5. BotFather 会返回一个 token，类似：123456789:AAHfiqksKZ8...

把这个 token 记下来！

步骤二：安装 Telegram Plugin

官方方法：

/plugin install telegram@claude-plugins-official

如果上述方法失败（和我一样），试试：

/plugin

然后在插件市场找到 telegram，点击安装。

步骤三：配置 Token

在 Claude Code 中输入：

/telegram:configure 123456789:AAHfiqksKZ8...

（替换成你的实际 token）

或者直接跟 Claude Code 对话让它帮你配置。

步骤四：重启 Claude Code

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

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

重启后就可以使用 /telegram 命令了。

步骤五：配对

  1. 在 Telegram 上搜索你创建的 bot（就是你刚才填的用户名）
  2. 给它发一条消息
  3. 它会回复你一个 6 位数的 pairing code
  4. 在 Claude Code 中输入：
    /telegram:access pair <code>
    （把 <code> 换成你收到的验证码）

配对成功后，CC 会给你发一条确认消息。

步骤六：加锁（安全加固）

让 bot 只响应你：

/telegram:access policy allowlist

这样其他陌生人就不能跟你的 CC 对话了。

步骤七：开始使用！

现在可以在 Telegram 上直接和 Claude Code 对话了！

Plugin 暴露给 CC 的工具

工具 功能
reply 发送消息到聊天，支持 chat_id + text，可以回复指定消息（threading），支持发送文件（图片自动预览，最大50MB）
react 添加表情反应（只支持 Telegram 白名单内的表情：👍 👎 ❤ 🔥 👀 等）
edit_message 编辑 bot 之前发送的消息，适合”工作中…”→ 结果的渐进更新

收到的消息会触发打字指示器 — Telegram 会显示”botname 正在输入…”直到助手完成响应。

照片处理

收到的照片会下载到 ~/.claude/channels/telegram/inbox/，本地路径会包含在通知中供 CC 读取。

注意：Telegram 会压缩照片，如果需要原图，请发送时选择”作为文件发送”（长按 → 发送为文件）。

⚠️ 重要限制：没有历史记录和搜索

Telegram Bot API 不提供消息历史记录和搜索功能。

Bot 只能看到实时收到的消息 — 没有 fetch_messages 工具。

如果 CC 需要查看之前的上下文，它会让你手动粘贴或总结。

这也意味着没有 download_attachment 工具用于历史消息 — 照片会在收到时立即下载，因为之后无法找回。

官方链接

  • 插件源码：https://github.com/anthropics/claude-plugins-official