指先でコードを書く - TelegramでClaudeを使ってプロジェクトを管理
想像してみてください：地下鉄に乗っているときやカフェの行列に並んでいるときに、仕事のチャットで突然バグが見つかり、即座に修正が必要な的情况。或者你有了一个很棒的重构想法，但手边没有笔记本电脑。こんな時、普通は諦めてデスクに戻るまで待ちますよね。でも、パワフルなAIアシスタント搭載のターミナルが обычная мессенджер приложение内で使えたらどうでしょうか？
claude-code-telegramプロジェクトは、この夢を現実のものにします。コードとClaude Code — Anthropic社の高度なCLIエージェント — の架け橋となる存在です。
これは何であり、なぜ開発者に必要なのか
本質的には、作業環境へのリモートアクセスを提供する高度なTelegramボットです。しかしこれは単なる「Telegram内のコマンドライン」ではありません。Claude Code統合により、ボットはプロジェクトのコンテキストを理解し、ファイルを読み取り、テストを実行し、さらには自律的に変更を加えることすらできます。
誰が便利に使えるでしょうか？
- チームリード — IDEを開かずにビルド状況やコードの一部を手早く確認する必要がある方。
- フルスタック開発者 — 外回りながら働く方。
- 自動化愛好家 — AIにプロジェクトの健全性レポートを自動送信させたい方。
主な機能：なぜ便利なのか
1. エージェントモード（Agentic Mode）
これが主な動作モードです。ボットとは、まるで先輩同僚とチャットするように会話できます。コマンド構文を覚える必要はありません — 単にこう書きます：「api.pyにエラーハンドリングを追加して、テストがまだ通るか確認して」。ボットはファイルを分析し、変更を提案し、pytestを自分で実行します。
ちなみに、ボットの「詳細度」レベルは/verboseコマンドで調整できます。最大に設定すると推論チェーンが表示され、AIがなぜ特定の決定を下したのかを理解するのに本当に役立ちます。
2. GitHub on Steroids
ボットはgh CLIとうまく連携します。チャット上から直接以下のことができます：
- リポジトリのクローン作成。
- オープンなIssueの一覧表示。
- 修正用のブランチを作成してリモートリポジトリにプッシュ。
これにより、TelegramはGitHubアカウントの完全なコントロールパネルに変身します。
3. ターミナルモード（Classic Mode）
伝統的な操作を好む場合は、クラシックモードに切り替え可能です。そこでおなじみのコマンドが見つかります：/ls、/cd、/pwd、クイックアクション用のインタラクティブボタン — 例えば、リント実行やワンクリックでのコードフォーマットなど。
4. 主动型自動化（Proactive Automation）
このプロジェクトの興味深い機能は、webhookとスケジューラー（Cron）サポートです。以下のようにボットを設定できます：
- 各GitHub Pull Requestの簡単なサマリーを送信。
- コードベースの毎日の「健康チェック」を実行し、潜在的な問題を通知。
- CI/CDイベントに反応。
セキュリティ：コードが「べきではない場所」に漏れないように
リモートでのコードアクセスにおいて、最初の質問はセキュリティです。開発者は複数の保護レベルを実装しています：
- ユーザーホワイトリスト：ボットは指定したあなたのみに応答します（ Telegram IDを指定する必要があります）。
- サンドボックス化：ディレクトリを厳密に制限し、ボットはそれより上位にアクセスできません。システムファイルへの
/etc/passwdアクセスはありません。 - トークン制限：ドル建ての予算を設定でき、Claudeが無限リファクタリングループで給与を「M」食べてしまうことを防げます。
始め方
プロジェクトはPythonで書かれており、依存関係管理にPoetryを使用しています。始めるには以下が必要です：
- @BotFatherからbotトークンを取得。
- Claude Code CLIがインストール済み（またはAnthropic APIキー）。
- Python 3.10以上。
クイックスタートは標準的なものです：
git clone https://github.com/RichardAtCT/claude-code-telegram.git
cd claude-code-telegram
make dev
cp .env.example .env # Настраиваем свои ID и токены
make run
実践的なユースケース：いつ助かるか
ケース#1：緊急ホットフィックス。本番環境のコンフィグのタイポやテキストに気づいたとします。Telegramを開き、ボットに：「config.yamlの42行目のタイポを修正してmainにプッシュして」。完了。
ケース#2：素早い監査。新しいライブラリをダウンロードし、その構造をすぐに理解したい場合は：「libs/new-libフォルダの構造を分析して、主要なエントリーポイントを説明して」とボットに尋ねます。
ケース#3：監視。毎日のレポートを設定：「毎朝9時にテストカバレッジをチェックし、80%を下回ったらメッセージして」。
claude-code-telegramは本格的なIDEの代替品ではなく、強力な追加ツールです。「PCの前にいる」と「対応可能」の境界を消します。すでにコーディング支援にClaudeを使用しているなら、このボットはワークフローへの素晴らしい追加になるでしょう。
プロジェクトは積極的に開発中で、作者の計画には機能を拡張するプラグインシステムが含まれています。ブックマークするか、個人利用のためにホームサーバー/VPSにデプロイする価値ありです。
関連プロジェクト