开源：把真正的 Claude Code / Codex CLI 搬到 Telegram，手机上也能写代码

[cloveric]

分享一个我做的开源项目：cc-telegram-bridge

简单来说就是把 Claude Code 和 OpenAI Codex 的 CLI 工具桥接到 Telegram 。不是 API 套壳，跑的是真实的 CLI 进程，所以你能获得完整的会话管理、记忆、文件处理能力。

几个亮点：

1. **双引擎** — 每个 bot 实例可以选 Claude Code 或 Codex 作为后端，一行命令切换
2. **多机器人** — 同时跑 10 个 bot ，每个有独立的引擎、人格、工作区和状态
3. **Agent Bus** — 机器人之间可以协作：并行分发任务、互相验证结果、跑 pipeline
4. **YOLO 模式** — 手机上用的时候自动批准命令，不用每次确认
5. **语音输入** — 发语音消息直接转文字给 AI
6. **预算控制** — 每个实例设花费上限，不怕账单爆炸
7. **备份恢复** — 完整导出/导入实例状态

技术栈：TypeScript ，Node.js >= 20 ，支持 Windows / macOS / Linux

我自己每天在手机上用，坐地铁的时候让 Claude Code 帮我改代码已经成了日常。

GitHub: https://github.com/cloveric/cc-telegram-bridge

欢迎试用，有问题随时问。如果觉得有用，给个 star 支持一下。

[cloveric]

0414 更新：

会话续接
在电脑上用 Claude Code 开了个头？发 /resume 就能在 Telegram 上接着干 — 不用重复解释上下文。

/resume ← Bot 扫描本地最近 1 小时的 session
Bot 列出最近的 session：

最近的本地 session：

[cc-telegram-bridge] 64c2081c… (5m ago)
[my-app] a3f8b21e… (32m ago)
回复 /resume <编号> 继续该 session 。
选一个：

/resume 1 ← Bot 自动建软链、切工作区、绑 session
之后发的每条消息都走原始 session — 相同的上下文、相同的项目目录、相同的对话历史。完成后：

/detach ← 清理软链、解绑 session 、恢复默认工作区
底层原理：

扫描 ~/.claude/projects/ 中最近 1 小时内修改过的 .jsonl 文件
在 bot 的 engine-home/projects/ 下创建软链指向本地 session 目录
将工作区切换到你的真实项目路径
绑定 session ID ，Claude CLI 通过 -r <sessionId> 恢复会话
/detach 反向操作 — 本地 session 不受任何影响
零污染： --append-system-prompt 是每次调用时传入的，不会写进 session 文件。bridge 指令不会泄漏到你的本地会话中。

[cloveric]

0416 更新，
因为 opus4.7 多了 xhigh 的逻辑，所以/effort 匹配了下

[cloveric]

0418 更新，
Changelog

这次更新主要是一次底层整理和稳定性增强，不是新增很多表面功能。

- 重构了 Telegram 主流程，把原本过大的 delivery.ts 拆成多个职责明确的模块，包括命令分发、普通消息处理、错误恢复、响应发送、配置读写等。
- 收口了共享逻辑，统一了 Telegram 和 bus 路径里的 usage 、budget 、audit 、timeline 、错误处理和部分 bookkeeping 行为。
- bus 现在有正式协议层了，补上了结构化 request/response 、错误码、retryable 语义，以及更稳的响应校验。
- 给主要状态文件补了 runtime schema 校验，包括 config.json 、access.json 、session.json 、usage.json 、runtime-state.json 、workflow 状态、bus registry 、audit log 、timeline
log 、instance lock 。
- 新增了 timeline event model ，并把它接到了 dashboard 、service status 、service doctor 和 CLI 查询路径。
- 修复了一批运维和边界问题，包括 stale PID 误报 running 、dashboard 忽略自定义 state dir 、非 JSON bus 响应缺少结构化错误、旧 schemaVersion 写回不升级等。
- 整理了错误分类，把 bus 和运行时错误语义进一步收口，减少子系统各说各话的情况。
- 补了大量 focused tests ，并新增 dashboard / bus handler / runtime state / telegram modules 等测试覆盖。
- 新增和补充了一组项目文档，包括架构说明、状态模型、安全边界、入口地图、bus 协议、event model 、变更规则和发布清单。

[cloveric]

**4 月 28 日更新：**
从 v4.5.0 或更早版本升级： 更新代码后请刷新已生成的实例指令，让旧 bot 拿到新的短 Telegram Transport block：

telegram instructions upgrade --all --dry-run
telegram instructions upgrade --all
telegram service restart --all

[cloveric]

又增加许多小功能。

比如群里聊新的 thread 就是新 session

一个群聊的 thread 还可以组成 multibots