overwirehq/claude-code-telegram

解决的问题

该项目提供对 Claude Code 的远程访问，使用户可以通过 Telegram 机器人与代码库进行交互。无需终端即可分析、编辑或解释代码，开发者可从任何设备管理项目。

工作原理

该机器人充当 Telegram API 与 Claude Code CLI/SDK 之间的桥梁。支持两种主要交互模式：

• 代理模式：自然语言界面，用户可与 Claude 对话，执行编辑文件、运行测试、管理 GitHub 仓库等任务，使用 gh CLI 工具。
• 经典模式：使用特定命令（如 /cd、/ls、/pwd）和内联键盘的类终端界面，用于导航和文件管理。

此外，还包含一个事件驱动系统，可通过 Webhook（如 GitHub 事件）或基于 cron 的调度器触发 Claude，实现自动代码健康检查。

适用人群

希望使用移动端友好的界面远程管理代码库的开发者，或希望通过 Telegram 通知和 Webhook 实际自动化代码库维护任务的用户。

主要亮点

• 远程代码库交互：与 Claude Code 完全集成，支持远程编辑和分析代码。
• 多模式界面：可在对话式代理体验与命令式终端体验之间自由选择。
• 多模态输入：支持通过 Whisper 或 Voxtral 进行图像/截图分析和语音消息转录。
• 安全性：具备目录沙箱、用户白名单和速率限制功能，防止未授权访问或路径遍历攻击。
• 自动化：内置 Webhook API 服务器和任务调度器，支持主动通知和仅自动化任务执行。