Claude Code公式Telegramプラグインの問題点
Claude Codeの公式Telegramプラグインは、基本は押さえています。つまり「テキストを入力して、テキストを出す」。しかし、1日以上使っていると、壁にぶつかります。
- 音声メッセージなし（スマホからClaudeに話しかける？ だめです）
- グループでの会話スレッドなし
- ステッカー/GIF対応なし（Claudeが混乱します）
- セッションをまたいだ永続メモリなし
- クラッシュすると文脈が失われる
claude-telegram-superchargedを使いましょう。既存のボット設定を変えずに、15+の機能を追加する「ドロップイン置き換え」です。
できること
音声メッセージ — 双方向
これが決め手です。Telegramでマイクボタンを押して「認証ミドルウェアをJWTを使うようにリファクタして」と言うと、ClaudeはWhisperの文字起こしを経由してテキストとして受け取ります。さらに、ElevenLabs TTSで音声として返信することもできます。
Claude Code向けのWispr Flowだと考えてください。散歩しながらAIアシスタントに話しかける。タイピングは不要です。
文字起こしは、賢いフォールバックチェーンで行われます：OpenAI Whisper API → Groq → Deepgram → ローカルのwhisper-cli。APIキーを1つ設定して、あとは忘れてください。
会話スレッディング
グループチャットでは、プラグインが返信チェーンに従います。誰が何を言ったかを理解し、正しいスレッドに対して適切に返信します。最大3階層まで。フォーラムトピックも完全にサポートされており、各トピックは分離されます。
永続メモリ
チャット履歴を消すとき、Claudeはまず要約をディスクに保存します。再起動すると、そのメモリが読み込まれます。あなたのアシスタントは本当には忘れません。クラッシュ、再起動、そして/clearコマンドでも文脈が生き残ります。
メッセージのバッチ処理
20件以上のメッセージを一度に転送すると、それらは1つのバッチとして収集されます（5秒のデバウンス）。自動で要約され、Claudeはそれらすべてに対して1回の返信で応答します。「このグループチャットを要約して」に最適です。
自動再起動付きデーモンモード
監視（supervisor）スクリプトは、Claudeを子プロセスとして管理し、以下を実現します：
- 指数バックオフによる再起動（1s → 2s → 4s → 最大30s）
- 文脈ウォッチドッグ — 文脈使用量が70%に達すると自動再起動
- シングルインスタンスロック（重複ボットが競合しない）
- Telegramからのクリーンな再起動のためのシグナルファイルプロトコル
チャットで「すべて消して」と言う → Claudeがメモリを保存 → 監視プロセスが新しい文脈で再起動。ダウンタイムはゼロです。
さらに多くの機能
- ステッカー & GIF — アニメーションステッカーはマルチフレームのコラージュになり、Claudeは実際にそれを見られます
- MarkdownV2の自動エスケープ — 崩れたフォーマットにもう悩まされません
- ドキュメント対応 — PDF、DOCX、CSV（最大10MB）
- インラインキーボタン — 確認用のタップ可能な選択肢
- リアクションステータス — 未読 → 処理中 → 完了
- Telegraph Instant View — 長文レスポンスをネイティブなTelegramの記事として公開
- 2段階のモデルルーティング — 簡単な問い合わせは高速モデル、複雑なものはOpus
- Google Calendar連携 — 予定の確認、チャットからのイベント作成
- スケジュールされたメッセージ — リマインダーと繰り返しタスク
5分でセットアップ
前提条件
-
Bun ランタイム（
curl -fsSL https://bun.sh/install | bash） - @BotFather から取得したTelegramボットトークン
- Claude Codeがインストール済み
手順1：公式プラグインをインストール
# Claude Codeセッション内
/plugin install telegram@claude-plugins-official
手順2：クローン＆スーパーチャージ版を適用
git clone https://github.com/k1p1l0/claude-telegram-supercharged.git
# enhanced版のサーバーを公式のものに上書き
cp claude-telegram-supercharged/server.ts \
~/.claude/plugins/cache/claude-plugins-official/telegram/0.0.1/server.ts
# デーモンの監視（supervisor）をインストール
mkdir -p ~/.claude/scripts
cp claude-telegram-supercharged/supervisor.ts \
~/.claude/scripts/telegram-supervisor.ts
手順3：ボットトークンを設定
# Claude Code内
/telegram:configure YOUR_BOT_TOKEN_HERE
手順4：起動
# オプションA：標準（Telegramチャンネルあり）
claude --channels plugin:telegram@claude-plugins-official
# オプションB：デーモンモード（推奨：自動再起動）
bun ~/.claude/scripts/telegram-supervisor.ts
手順5：ペアリング
TelegramでボットにDMを送ります。6文字のコードが返信されます。Claude Codeでは：
/telegram:access pair <code>
完了です。次のメッセージがClaudeに届きます。
手順6：締め固める
見知らぬ人がやり取りできないように、allowlistモードに切り替えます：
/telegram:access policy allowlist
音声セットアップ（任意だけど価値あり）
音声→Claudeのワークフローでは、OpenAIキーを~/.claude/channels/telegram/.envに追加してください：
OPENAI_API_KEY=sk-proj-...
以上です。プラグインがフォーマット変換、チャンク分割、文字起こしを自動で行います。完全オフラインで文字起こしするには、代わりにwhisper.cppをインストールしてください。
macOSのlaunchdで常時稼働
Macを使っていて、ボットを24/7動かし続けたい（フタを閉じる、ログアウト、再起動にも耐える）場合は、launchdのplistを作成します：
# ~/Library/LaunchAgents/com.user.claude-telegram.plist
リポジトリのREADMEに、完全なXMLテンプレートがあります。重要な設定：RunAtLoad: true、KeepAlive: true、さらにスリープを防ぐためにcaffeinate -sで包みます。
なぜこれが重要か
「ターミナル内のAIアシスタント」と「ポケットに入ったAIアシスタント」のギャップはとても大きいです。私の知っている多くの開発者はClaude Codeを動かしていますが、主にデスクでしか使っていません。音声メッセージ＋Telegramなら、次のことができます：
- 外出先でのデバッグ — エラーを説明して、歩きながら修正案をもらう
- タスク管理 — 「明日10時にPR #42のレビューをリマインドして」
- 素早い調べもの — 「PostgreSQLのUPSERTの構文、もう一度何だっけ？」
- グループでの共同作業 — 正しいスレッド付きでClaudeをチームチャットに追加する
強化（スーパー）されたプラグインはTelegramを、単なるチャット中継ではなく、きちんとしたAIインターフェースに変えます。
リンク
- GitHub: k1p1l0/claude-telegram-supercharged
- 公式プラグイン: anthropics/claude-plugins-official
Telegram経由でClaude Codeを実行してみましたか？ どんな構成ですか？ 下のコメント欄に書き込んでください。
