overwirehq/claude-code-telegram

何を解決するか

このプロジェクトは、Claude Codeへのリモートアクセスを提供し、ユーザーがTelegramボットを通じてコードベースとやり取りできるようにします。ターミナルがなくても、コードの分析、編集、説明が可能になり、あらゆるデバイスからプロジェクトを管理できます。

動作方法

ボットはTelegram APIとClaude Code CLI/SDKの間のブリッジとして機能します。主に2つの相互作用モードをサポートしています：

• エージェントモード：自然言語インターフェースで、ユーザーはClaudeとチャットして、ファイルの編集、テストの実行、GitHubリポジトリの管理（gh CLIを使用）などのタスクを実行できます。
• クラシックモード：特定のコマンド（例：/cd、/ls、/pwd）とインラインキーボードを使用した、ターミナルに似たインターフェースでナビゲーションやファイル管理が可能です。

さらに、Webhook（例：GitHubイベント）やcronベースのスケジューラーを介して、イベント駆動型のシステムによりClaudeをトリガーできます。これにより、コードの健全性チェックを自動化できます。

対象ユーザー

モバイルに最適化されたインターフェースでコードベースをリモート管理したい開発者、またはTelegramの通知やWebhookを通じてコードベースのメンテナンスを実際に自動化したいユーザー。

特徴

• リモートコードベース操作：Claude Codeとの完全統合により、リモートでコードの編集や分析が可能。
• マルチモードインターフェース：会話型のエージェント体験とコマンドベースのターミナル体験のどちらかを選択可能。
• マルチモーダル入力：WhisperやVoxtralを介して画像／スクリーンショットの分析や音声メッセージの転写をサポート。
• セキュリティ：ディレクトリのサンドボックス化、ユーザーのホワイトリスト化、レート制限により、不正アクセスやパストラバーサルを防止。
• 自動化：組み込みのWebhook APIサーバーとジョブスケジューラーにより、プロアクティブな通知と自動タスクのみを実行可能。