telegram プラグイン
プラグイン Claude Code 生産性 プロジェクト管理・チーム連携Claude Code 拡張・ワークフロー以下の解説は生成 AI によるものです。出典と照らし合わせてご確認ください。
telegram プラグインは、MCP サーバーを介して Telegram の bot と Claude Code を接続し、bot 宛のメッセージを Claude Code のセッションへ転送します。README によると、セットアップには Bun が必要で、BotFather での bot 作成、プラグインのインストール、/telegram:configure でのトークン設定、--channels plugin:telegram フラグ付きでの Claude Code 再起動、送られてくるコードによるペアリングという手順を踏みます。アクセス制御は /telegram:access コマンドで行い、pairing や allowlist などのポリシーは ACCESS.md に記載されています。アシスタントは reply・react(Telegram 固定の絵文字リストのみ)・edit_message(bot 自身が送ったメッセージの編集)の各ツールを使えますが、Telegram の Bot API はメッセージ履歴や検索機能を提供していないため、bot は到着したメッセージのみを認識します。
概要
これは単体の SaaS ではなく、Claude Code のプラグインです。Bun 上で動作するローカルの MCP サーバーが Telegram に bot としてログインし、ユーザーのメッセージを Claude Code のセッションへ転送します。あわせて reply・react・edit_message のツールをアシスタントに提供し、access.json に保存されたペアリングコードや allowlist でアクセスを管理する仕組みです。
telegram でできること
- BotFather で Telegram bot を作成し、/telegram:configure と claude --channels plugin:telegram@claude-plugins-official 起動フラグで Claude Code に接続する
- /telegram:access pair で Telegram アカウントをペアリングし、DM をアシスタントに届ける
- ペアリング後は /telegram:access policy allowlist でアクセスを制限し、未承認の相手にペアリングコードの返信をしないようにする
- アシスタントに chat への reply、Telegram 固定の絵文字による react、bot 自身が送ったメッセージの edit_message(進捗更新など)を行わせる
- 最大50MBまでの画像・文書を送受信し、受信した画像は ~/.claude/channels/telegram/inbox/ に保存されアシスタントが読み取れる
- TELEGRAM_STATE_DIR をインスタンスごとに分けることで、1台のマシン上で複数の bot をそれぞれ別のトークンと allowlist で動かす
出典
原文の説明(英語)
Telegram messaging bridge with built-in access control. Manage pairing, allowlists, and policy via /telegram:access.
telegram の変更履歴
- プラグイン telegram を追加