概要
Claude-Code-Remote は、メール・Discord・Telegram を通じて Claude Code を遠隔からコントロールできるツールです。ローカル環境で開始したタスクを、移動中や別の作業中に指示を追加・変更でき、完了時に通知を受け取ることができます。開発者の Jessy Tsui が「オフィスのデスクトップ PC でコード生成タスクを走らせたまま、カフェで打ち合わせをしたい」という課題から開発しました。それまでは SSH でリモート接続するか、タスク完了まで PC の前で待つしかありませんでしたが、このツールにより、メールで簡単に指示を追加でき、完了通知を受け取れるようになりました。
主な機能
- メール連携：メール返信でタスク指示を送信し、Claude に新しいコマンドを追加実行できる
- Discord 統合：Discord チャンネルでタスク状況をリアルタイム監視し、スラッシュコマンドで指示を送信可能
- Telegram サポート：Telegram ボットを通じて、どこからでもタスクを操作・確認できる
- 自動通知機能：Claude がタスクを完了すると、メール・Discord・Telegram で自動的に結果を通知
- ローカル実行：セキュリティを損なわず、ローカル環境でコード生成・実行を続行
- コマンドチェーン：複数のコマンドを連続実行でき、長時間かかる処理も制御可能
- ログ記録：全ての指示と実行結果が記録され、後から確認・再実行できる
技術スタック
- 言語：Python
- AI モデル：Anthropic Claude API
- メール処理：IMAP・SMTP ライブラリ（Python の email モジュール）
- Discord 連携：discord.py
- Telegram 連携：python-telegram-bot
- スケジューリング：APScheduler
- 設定管理：YAML・環境変数
- 実行環境：Docker サポート
導入方法
1. リポジトリをクローン
git clone https://github.com/JessyTsui/Claude-Code-Remote.git
cd Claude-Code-Remote
2. 依存関係をインストール
pip install -r requirements.txt
3. 環境設定ファイルを作成
cp config.example.yaml config.yaml
4. config.yaml に認証情報を設定
- Claude API キー
- Gmail/メールサーバーの認証情報
- Discord トークン（オプション）
- Telegram トークン（オプション）
5. ツールを起動
python main.py
6. メール/Discord/Telegram で指示を送信 メール例：件名「Claude Task」→本文「Pythonスクリプトのエラーハンドリングを改善して」と返信するだけで自動実行開始
競合比較
| 項目 | Claude-Code-Remote | OpenAI GPT-4 with Code Interpreter | GitHub Copilot Chat | LangChain Agent |
|---|---|---|---|---|
| メール連携 | ✅ あり | ❌ なし | ❌ なし | ❌ なし |
| Discord 統合 | ✅ あり | ⚠️ 限定的 | ❌ なし | ❌ なし |
| Telegram サポート | ✅ あり | ❌ なし | ❌ なし | ❌ なし |
| ローカル実行 | ✅ フル対応 | ⚠️ クラウドのみ | ✅ IDE 内 | ✅ フル対応 |
| リモート操作 | ✅ 専用設計 | ❌ 限定的 | ❌ 基本的に Web | ⚠️ カスタム必要 |
| セキュリティ | ✅ ローカル安全 | ⚠️ API 送信 | ✅ IDE 内安全 | ✅ 自由設定 |
差別化ポイント：Claude-Code-Remote の最大の強みは、複数の通信チャネル（メール・Discord・Telegram）を統合し、どのプラットフォームからでも同じ Claude Code タスクを操作できる点です。Claude Codeの基本的な使い方を整理したい場合はEverything Claude Code：Claude Code 使い方と設定の完全ガイドを参照してください。また、セッション管理をローカルで体系化したい場合はcc-sessions：Claude Code 使い方を極める開発セッション管理フレームワーク完全ガイドとの組み合わせも検討してみてください。開発者の日常的な コミュニケーションツールをそのまま AI 操作インターフェースにしたため、学習コスト がほぼ不要。また、ローカル実行を保証しながらリモート操作ができるため、セキュリティと利便性の両立を実現しています。
こんな人におすすめ
-
フルスタック開発者：ローカル開発環境で長時間のコード生成・テスト実行を背景で走らせながら、別タスクに集中できるため、開発効率が大幅に向上します
-
DevOps・インフラエンジニア：デプロイスクリプトやシステム監視ツールの自動生成を、オンコール中のスマートフォンから指示できるため、対応時間が大幅短縮されます
-
データサイエンティスト：データ分析やモデル学習のタスクを夜間に自動実行させ、朝にはレポートが完成している仕組みを作れるため、反復の速度が上がります
-
リモートワーク勤務者：カフェ・図書館・出張先からメール 1 通で PC のタスク処理を指示できるため、場所の制約を受けずに生産性を保つことができます
-
チームリーダー・PM：開発チーム全体で共有の Claude-Code-Remote インスタンスを運用し、各メンバーがメール・Discord で AI 支援を受けられるため、ボトルネック解消と知識レベルの均準化が同時に実現します