打开网易新闻 查看精彩图片

Claude Code的官方Telegram插件上线时,只干了一件事:文字进,文字出。用超过24小时的人,基本都撞上了同一堵墙——没法语音,群聊里上下文乱窜,重启后对话历史清零。

GitHub用户k1p1l0没等官方更新,直接写了个drop-in替换版。15项新功能,零配置迁移,你的bot token不用换,对话历史不用导。

语音输入是这次魔改最狠的一刀。

按住Telegram的麦克风按钮,说"把auth中间件改成JWT方案",Claude通过Whisper转文字接收指令,还能用ElevenLabs语音合成回话。开发者k1p1l0在README里打了个比方:这相当于给Claude Code装了Wispr Flow——遛狗时嘴对着手机,代码就改完了。

转写链路做了四层兜底:OpenAI Whisper API → Groq → Deepgram → 本地whisper-cli。填一个API key,后面自动 failover。

群聊不乱的秘密:线程追踪

群聊不乱的秘密:线程追踪

官方插件在多人场景下是个睁眼瞎。A回复B,B回复C,Claude根本分不清谁在跟谁说话。

魔改版做了回复链追踪,最深穿透3层嵌套。Telegram的Forum话题组也完全隔离,每个topic独立上下文,不会串台。

更细的一个设计:批量转发。一次性甩20条消息过去,插件会攒够5秒(debounce),自动摘要后统一回复。适合那种"帮我总结一下这群人吵了啥"的场景。

打开网易新闻 查看精彩图片

记忆 persistence:/clear 不是真的 clear

记忆 persistence:/clear 不是真的 clear

Claude Code官方的重启即失忆,在这个版本里被绕过了。

执行/clear时,插件先把对话摘要存到本地磁盘。下次启动自动加载,上下文 survives 崩溃、重启、甚至主动清屏。你的助理"假装"忘了,其实笔记都在。

supervisor脚本把Claude当子进程管:内存超限自动重启,崩溃后自动拉起。群里喊一声"clear everything",它先存记忆,再热重启,零 downtime。

安装路径:覆盖,不是并行

安装路径:覆盖,不是并行

这个项目的安装方式很"野"——直接覆盖官方插件的缓存文件。

步骤拆解:

1. 先装官方版:/plugin install telegram@claude-plugins-official

2. git clone 魔改仓库,把server.ts拷进Claude的插件缓存目录

打开网易新闻 查看精彩图片

3. 把supervisor.ts丢到~/.claude/scripts/

4. /telegram:configure 填token

5. 启动方式二选一:标准模式带Telegram通道,或daemon模式用bun跑supervisor

配对流程和官方一致:Telegram私聊bot拿6位码,Claude里/telegram:access pair 完成绑定。

安全建议最后一步切白名单:/telegram:access policy,防止陌生人刷你的API额度。

k1p1l0在issue区回复过一个用户的提问:为什么不做成独立插件,非要覆盖官方文件?

「Claude的插件系统暂时不支持并行同名插件,这是最快的hook方式。」

换句话说,这是利用缓存机制做的"合法劫持"——Anthropic的代码签名不校验文件内容,只校验下载来源。

项目仓库目前星标数未公开,但commit历史显示首版发布于2025年3月中旬,最近一周更新了语音TTS的流式输出优化。ElevenLabs的免费 tier 每月1万字符,重度用户需要绑卡。

一个值得玩味的细节:k1p1l0在README里埋了一句警告,"This is not officially supported by Anthropic"。但代码里用了大量Claude Code的内部类型定义,显然深度研究过官方实现。

语音对话、群聊线程、记忆 persistence——这三项正是Claude Code Telegram插件在官方路线图里标记为"planned"的功能。社区版本提前数月落地,Anthropic的产品经理现在是什么心情?