Skip to main content
  1. Docs/

解放双手👐:用 Telegram 远程指挥 Claude Code 干活

·1287 words·3 mins· loading · ·
技巧 Claude Code 效率工具
Hyoung Yan
Author
Hyoung Yan
秋风即使带凉,亦漂亮.
Table of Contents

解放双手👐:用 Telegram 远程指挥 Claude Code 干活
#


大家一定有过这样的经历:训练一个模型,提交任务后就只能守在终端前,生怕错过任何进展。要么就是放下手机去干别的,结果错过了重要的更新。

Claude Code 最近推出了 remote-control 功能,但是并不利好国区用中转服务的用户。最近在 linux.do 发现了某大佬写的绕过插件,直接把 Claude Code 接上 Telegram。

相关脚本可前往github repolinux.do下载:
#

准备工作
#

  • Claude Code 已安装
  • 一个 Telegram Bot Token(找 @BotFather/newbot 几步搞定)
  • 服务器上装好 tmux,保持 Claude 常驻

01:建 Bot,拿 Token
#

去 Telegram 找 @BotFather,发 /newbot,起个名字,拿到一串 token。


02:安装 Bun
#

插件是 Bun 脚本,先装运行环境:

curl -fsSL https://bun.sh/install | bash
source ~/.bashrc  # 或 ~/.zshrc

03:应用绕过补丁
#

下载 linux.do 帖子或github仓库的 zip,解压后执行补丁脚本。因为 Claude Code 的 cli.js 装在 /usr/local/lib/,需要 sudo:

sudo bash apply-claude-code-channels-bypass-fix.sh

04:配置 Token
#

在tmux里启动 Claude Code:

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

在 Claude Code 里运行:

/telegram:configure <你的token>

Token 会保存到 ~/.claude/channels/telegram/.env


05:启动并完成配对
#

退出 Claude Code,带上 channels 参数重新启动:

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

然后打开 Telegram,给你的 Bot 发任意一条消息。Bot 会回复一个配对码

回到 Claude Code 终端,运行:

/telegram:access pair <配对码>

最后锁定白名单,防止其他人给 Bot 发消息控制你的机器:

/telegram:access policy allowlist

配对完成后,~/.claude/channels/telegram/access.json 里会记录你的 chat ID:

{
  "dmPolicy": "allowlist",
  "allowFrom": ["YOUR_CHAT_ID"],
  "groups": {},
  "ackReaction": "👀"
}

06:写 CLAUDE.md 定规矩
#

接上 Telegram 只是第一步,还得告诉 Claude 什么时候发消息、遇到什么情况要等人。在项目目录下建一个 CLAUDE.md,Claude 每次启动都会自动读它:

## 基本信息
- Telegram chat_id:YOUR_CHAT_ID

## Telegram 进度汇报

执行耗时任务时,使用 reply 工具向 Telegram 汇报进度:

1. 任务开始:确认收到指令,简述执行计划
2. 关键节点:每个阶段完成时发一条进度
3. 遇到错误:立刻通知,暂停等待指令,不要自行决定修复方向
4. 任务完成:发结果摘要,包括关键指标或输出路径

遇到需要决策的分叉点,告知情况并等待回复,不要擅自推进。

“不要自行决定修复方向"这条很关键。 没加这条之前,Claude 遇到报错会自己尝试修,越改越偏,等我回来看日志的时候根本搞不清楚发生了什么。


07:tmux 保持常驻
#

# 新建会话
tmux new -s claude

# 带 Telegram 频道启动
claude --channels plugin:telegram@claude-plugins-official

# Ctrl+B D 挂起,SSH 断开后 Claude 继续监听

之后重新连接:

tmux attach -t claude

实际体验
#

现在的工作流是:手机发一条消息,放下手机去干别的,等通知。

Me:    跑 exp03,训练完告我结果

Claude: 收到,开始训练 exp03,共 50 epoch,使用配置 configs/exp03.yaml

Claude: Epoch 10/50 ✓  loss: 0.421  val_acc: 84.1%
Claude: Epoch 20/50 ✓  loss: 0.318  val_acc: 87.6%
...
Claude: 训练完成 🎉  最终 val_acc: 91.8%
        模型已保存至 checkpoints/exp03_best.pt

遇到 OOM 或者需要决策的情况,它停下来问你,而不是瞎猜:

Claude: 遇到 CUDA OOM(batch_size=64)
        可以降 batch_size 或开梯度检查点,你来定

小结
#

不需要额外的服务、不需要写脚本,Claude Code 本身就是那个在后台跑的 agent。配好之后,真的可以离开工位了。

致谢: https://linux.do/t/topic/1787422