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 伺服器與任務排程器，支援主動通知與僅自動化任務執行。