dudumd

Posted on Mar 28

我把 Claude Code 接进了 Telegram，手机上终于能随时使唤它了

#ai #tutorial

🦞 这两天我折腾了一个很有意思的玩法：把 Claude Code 接进 Telegram。

接通之后，体验确实爽。人在外面，手机给 Bot 发一句话，Claude Code 就能接住，继续干活。

但这功能不是谁都能无脑冲。

一是它依赖 官方 Claude Code 会员能力，第三方中转一般不支持。
二是真正的风险不在 Telegram，而在 Claude 官方账号环境本身更敏感，更容易遇到风控、限额，甚至封号。

这篇文章我就讲三件事：

它到底是什么

怎么配

值不值得你折腾

我是冲冲，咱们继续用费曼风格讲人话。

一、先说结论：这功能很香，但不是所有人都适合直接冲

先说结论：

Claude Code 接 Telegram 值得试，但前提是你有稳定的官方 Claude Code 环境。

它的门槛主要有两个：

1）必须是官方 Claude Code 能力

这套 --channels + 官方 Telegram 插件，不是第三方中转、镜像站、共享壳都能跑。

2）真正的风险在账号，不在 Telegram

Telegram 接入本身是官方能力。
真正脆弱的是 Claude 官方账号环境：Anthropic 对网络、地区、登录行为更敏感，账号更容易碰到风控、限额，甚至封号。

3）体验上越来越像“随身助手”

一旦接上 Telegram，Claude Code 就不再只是电脑里的编程工具，而开始像一个能随时被叫起来的 AI 搭子。

所以这功能不是不能冲，
而是你得先知道：它能跑，但前提和代价都比表面大。

二、这玩意到底是什么？用人话解释清楚

Claude Code 官方提供了一个 Telegram 插件。

你可以理解为：

给 Claude Code 装上一条“Telegram 通信线”。

接通之后，流程是这样的：

你在 Telegram 里给自己的 Bot 发消息
Bot 把消息交给 Telegram 插件
插件把消息转给 Claude Code 当前会话
Claude Code 生成结果
插件再把结果发回 Telegram

所以它不是“Claude 突然有了 Telegram App”。

而是：

Claude Code + 官方 Telegram 插件 + 你自己的 Telegram Bot

一起组成了一个“手机里可用的 Claude Code 入口”。

这就是它的本质。

三、先别急着装，先确认一件事：你用的是不是官方 Claude Code？

先把边界讲清楚：

这套功能属于官方 Claude Code 生态，不是所有 Claude 服务都支持。

如果你用的是：

第三方中转
镜像站
共享壳
套壳网页

那大概率跑不起来。

所以这篇文章默认适合这三类人：

有官方 Claude Code 环境
能用官方插件
愿意自己折腾一下 Bot 和配置

如果这三条不满足，这篇教程你看完也很难落地。

四、效果到底值不值得配？先看它能干嘛

你只要记住一句话：

它的价值，就是把 Claude Code 从电脑前搬到手机里。

最常见的三个场景：

1）随手丢任务

出门时突然想到：

帮我总结 bug
帮我整理思路
帮我列提纲

以前要回电脑。现在手机发一句就行。

2）把 Claude Code 变成随叫随到的搭子

它不再只是坐在桌面上的编程工具，
而开始变成一个你在路上也能叫起来的助手。

3）从编程工具，往随身助手走

接上 Telegram 后，它能承担的不只是写代码，
还有整理、拆解、讨论、提醒。

这也是为什么我会觉得：

Claude Code 接上 Telegram 后，已经开始有点像 OpenClaw 了。

五、前置条件：不是 Node，是 Bun

要跑这个功能，你至少需要：

Claude Code CLI
Telegram 账号
你自己创建的 Telegram Bot
Bun 运行时

这里有个特别容易踩的坑：

这个 Telegram MCP 服务器跑在 Bun 上，不是 Node.js。

也就是说，你电脑上哪怕装了：

Node
npm
pnpm
yarn

这些都不能替代 Bun。

Mac / Linux 安装方式

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

Windows PowerShell 安装方式

irm bun.sh/install.ps1 | iex

装完后验证：

bun --version

这里最容易踩的坑

如果你是先开 Claude Code，后装 Bun，很容易出现“明明装好了，但 Telegram 不工作”。

原因通常是：

终端还没刷新 PATH，Claude Code 根本没读到 Bun。

解决也简单：

重启终端
重启 Claude Code

六、第一步：去 BotFather 创建你的 Telegram Bot

打开 Telegram
搜索 @botfather
输入：/newbot
按提示填写：
- Name：显示名称，可随便写
- Username：唯一用户名，必须以 bot 结尾

创建成功后，BotFather 会给你一串 Token，比如：

123456789:AAHfiqksKZ8xxxxxxxxxxxx

这里记住一句话

这个 Token 就是你 Bot 的密码。

不要公开，不要乱发，不要贴仓库。

谁拿到它，谁就能控制你的机器人。

七、第二步：安装官方 Telegram 插件

先启动 Claude Code：

claude

然后执行：

/plugin install telegram@claude-plugins-official

插件装完后，最稳的做法就是：

直接重启 Claude Code。

原因很简单：有时插件其实装好了，但命令还没加载出来。
这时候别折腾，重开最快。

八、第三步：配置 Bot Token

在 Claude Code 里执行：

/telegram:configure 你的BotToken

比如：

/telegram:configure 123456789:AAHfiqksKZ8xxxxxxxxxxxx

执行后，它会把 Token 写到：

~/.claude/channels/telegram/.env

里面本质上就是：

TELEGRAM_BOT_TOKEN=你的Token

这一步没什么花活，照着配就行。

九、第四步：真正关键的是 `--channels`

很多人最容易在这里翻车。

插件装了、Token 配了，不代表 Telegram 已经通了。

你必须退出 Claude Code，然后这样启动：

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

这一步为什么这么重要？

你可以把 --channels 理解成：

启动 Claude Code 时，顺手把 Telegram 这条消息通道也一起拉起来。

如果不加这个参数，会怎么样？

Bot 可能根本不回你
或者只表现得像死了一样
你以为 Token 错了、网络炸了、插件坏了

结果其实只是：

通道根本没启动。

所以这一步不是“可选项”，而是核心项。

十、第五步：配对，让 Bot 认出你

现在 Claude Code 已经带着 Telegram channel 跑起来了。

接着你去 Telegram 私聊你的 Bot，随便发一句话。

正常情况下，Bot 会回你一个 6 位配对码。

然后回到 Claude Code，执行：

/telegram:access pair <6位配对码>

配对完成后，你再发消息，Claude Code 就能真正接住。

这个配对机制本质上在干嘛？

一句话：

把 Telegram 里的这个人，绑定到 Claude Code 当前允许访问的用户列表里。

它的好处是你不用手动折腾 Telegram 数字 ID。

对单人场景来说，这个体验还是挺舒服的。

十一、第六步：配对成功后，立刻锁权限

这一步很重要。

默认情况下，插件通常会处于一种适合“首次配对”的模式。

但你一旦已经配好了自己的账号，就别继续放着不管了。

直接执行：

/telegram:access policy allowlist

为什么要这么做？

因为配对模式本质上是在等待新用户来尝试接入。

这在第一次配置时很方便，但如果你的 Bot 链接被人看到了、用户名被别人搜到了，就有可能引来不必要的尝试。

所以最稳的操作是：

自己配完，立刻切 allowlist，只允许白名单用户访问。

这一步是安全底线。

十二、风险提醒：官方会员也不是绝对安全

这一段我觉得必须单独写，而且要写在明显位置。

因为如果我只告诉你“怎么配”，不告诉你“可能会出什么事”，那就不厚道了。

风险提醒：风险不在 Telegram，而在 Claude 官方账号环境

这句话一定要讲准确：

Telegram 接入是官方能力，真正有风险的是 Claude 官方账号环境。

你想用这套功能，通常要依赖官方 Claude Code 会员体系。
而 Anthropic 对账号环境更敏感，比较容易碰到：

风控
限额
封号

所以这功能不是不能用，
而是你得先接受一个前提：

真正脆弱的不是接入链路，而是账号本身。

如果你本来就有稳定的官方环境，这功能会很好用。
如果你的账号环境本来就不稳，那它再香也很难长期放心用。

十三、日常怎么用？

以后每次你要让 Claude Code 连 Telegram，都要这样启动：

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

如果已经配过，一般不需要重复配对。

建议你顺手配个别名

比如在 Mac / Linux 下：

alias claudetg='claude --channels plugin:telegram@claude-plugins-official'

以后只要敲：

claudetg

就能直接启动。

这个小优化，看起来不起眼，实际会大幅减少你后面使用的摩擦。

十四、这个插件到底给了 Claude 哪些能力？

官方 Telegram 插件主要给 Claude 暴露了三个能力：

1）reply

发消息回 Telegram 聊天。

支持：

回复指定消息
发图片
发文件
长文本自动分段

2）react

给消息加 emoji 反应。

3）edit_message

编辑 Bot 自己发过的消息。

这个功能特别适合做“处理中 → 最终结果”的进度体验。

比如先发：

正在整理，稍等一下……

等处理完了，再把原消息改成正式答案。

体验会比一次性生硬吐一大段好很多。

十五、你一定要知道的限制：它没你想得那么万能

1）没有历史消息搜索

这一点非常关键。

官方文档写得很明确：

Telegram Bot API 不提供消息历史和搜索能力。

也就是说：

Bot 只能看到“新到达的消息”
看不到过去的聊天记录
不能回头翻历史

所以如果你希望 Claude Code 理解上文，只能：

你自己粘贴给它
或者你自己总结后发给它

2）图片会压缩

如果你发普通图片给 Bot，Telegram 很可能会压缩。

如果你希望 Claude 读取更完整的原图，建议：

作为文件发送，不要直接当普通图片发送。

3）离线时消息可能就错过了

这套方案不是“永远在线云端助手”，而更像“你当前打开着的消息通道”。

如果 Claude Code 没开，或者没带 --channels，那你发过去的消息不一定会被补拉。

这一点非常像“实时转发”，而不是“历史回放”。

十六、它和 OpenClaw，是不是越来越像了？

写到这里，我有个感受越来越强烈：

Claude Code 一旦接上 Telegram，它真的开始有点像 OpenClaw 了。

为什么会有这种感觉？

因为它已经开始具备这些特征：

可以在聊天里被唤起
可以远程接收任务
可以通过 Bot 跟你持续互动
可以从“工具”变成“助手”

从体验层看，这确实已经很接近 OpenClaw 了。

但如果要说得更准确一点，我会这么讲：

Claude Code + Telegram 更像什么？

更像：

把一个强大的 AI 编程助手，搬进聊天框。

它的核心强项依然是：

写代码
改项目
处理工程任务
当你的编程搭子

OpenClaw 更像什么？

更像：

原生为聊天、渠道、自动化、工具编排而生的 AI 助手平台。

它更偏：

多渠道接入
工具系统
skill 体系
自动化编排
长期运行

所以我的判断是：

Claude Code 接上 Telegram 后，在“体验层面”开始接近 OpenClaw；

但在“架构层面”，两者仍然不是一回事。

一句话总结：

Claude Code 接上 Telegram 后，开始从“编程工具”往“随身助手”进化；

而 OpenClaw，本来就是按“随身助手”这个方向长出来的。

这个差别，我觉得很值得玩味。

十七、值不值得折腾？我的真实答案

值，但不是无脑值。

更准确地说：

如果你有稳定的官方 Claude Code 环境，并且愿意自己折腾，这功能很值得试。

因为它真正带来的变化是：

Claude Code 不再被锁在电脑前。

但如果你账号本来就不稳，或者特别在意账号安全，
那就别把它当成必须立刻上的功能。先观望，也完全合理。

十八、最短记忆版：整套流程就 6 步

如果你只想记住最核心的流程，记这 6 步就行：

装 Bun
用 BotFather 创建 Telegram Bot
在 Claude Code 里安装官方 Telegram 插件
用 /telegram:configure 写入 Bot Token
用 claude --channels plugin:telegram@claude-plugins-official 启动
私聊 Bot 拿配对码，配完立刻切 allowlist

就这么多。

真正麻烦的从来不是步骤，而是：

你知不知道这个功能的边界在哪
你能不能接受它背后的风险

冲冲的最后总结

我写完这篇最大的感受是：

AI 编程工具，正在慢慢长成 AI 助手。

Claude Code 本来是桌面上的编程工具。
接上 Telegram 之后，它开始变成一个你随时都能叫起来的搭子。

这也是我会联想到 OpenClaw 的原因。
体验上，它们越来越像；
但定位上，一个更偏编程助手，一个更偏原生 AI 助手平台。

这也是这个玩法最有意思的地方。

参考资料

Anthropic 官方 Telegram 插件说明：
https://github.com/anthropics/claude-plugins-official/blob/main/external_plugins/telegram/README.md