Claude Code Channels で Telegram から Claude とやり取りしよう！ステップバイステップ設定ガイド
目次
ターミナルの前にいなくても、スマホから Claude Code にメッセージを送れたら便利だと思いませんか？僕もそういった環境を目指すべく、自分で Discord と連携する環境を作ってはみたものの、あまり納得のいくものにはなっていませんでした。しかし、先日（2026年3月21日）にリサーチプレビューとして公開された Claude Code Channels を使えば、それが簡単に実現できます！
この記事では、チャットアプリ Telegram を使って Claude Code Channels を設定する手順を、ゼロからわかりやすく解説していきます。
Claude Code Channels とは
Claude Code Channels は、外部からの通知やメッセージを、動作中の Claude Code セッションにリアルタイムで届ける仕組みです。技術的には MCP（Model Context Protocol）サーバーとして動作し、Claude Code のサブプロセスとして起動します。
たとえば、こんな使い方ができます。
- チャット連携: Telegram や Discord からメッセージを送ると、ローカルで動いている Claude Code がそれを受け取って作業してくれる
- Webhook 連携: CI/CD の結果やモニタリングのアラートを Claude Code に直接流し込んで、自動で対応させる
一方通行（通知を送るだけ）にも、双方向（Claude が返信もする）にも対応しています。チャットアプリとの連携では、スマホでメッセージを送って、Claude が作業した結果をそのチャットに返してくれるという双方向のやり取りが可能です。
なぜ Telegram を選んだのか
リサーチプレビューの段階では、チャットアプリとして Telegram と Discord が公式にサポートされています。今回は Telegram を選びました。その理由をいくつか挙げてみます。
1. Bot の作成がとにかく簡単
Telegram では「BotFather」という公式 Bot にメッセージを送るだけで、ものの数分で新しい Bot を作れます。開発者ポータルにログインしてアプリケーションを作成して…といった手順が不要なので、気軽に試せるのが魅力です。
2. スマホからの操作と相性が抜群
Telegram はモバイルアプリの動作が軽快で、どこからでもサクッとメッセージを送れます。出先でふと「あのファイルの内容を確認したい」「テストを走らせておきたい」と思ったとき、ポケットのスマホから Claude Code に指示を飛ばせるのは大きなメリットです。
3. セットアップ手順がシンプル
Discord の場合は、Developer Portal でアプリケーションを作成して、Message Content Intent を有効にして、権限を細かく設定して、サーバーに招待して…とステップが多くなりがちです。Telegram なら BotFather でトークンを取得するだけで準備完了なので、Channels の動作を素早く体験できます。
4. Claude Code 専用として切り分けられる
僕はそれまで Telegram をインストールすらしていなかったので、逆にそれが好都合でした。他の用途で通知が来ることがなく、Telegram を開けば Claude Code の通知だけ、という完全な専用チャンネルとして使えます。
それでは、実際にセットアップしていきましょう！
前提条件
セットアップを始める前に、以下の準備が整っていることを確認してください。
- Claude Code v2.1.80 以降 がインストールされていること
- claude.ai アカウント でログインしていること（Console や API キー認証は非対応です）
- Bun がインストールされていること（プラグインの実行に必要です）
- Telegram アカウント を持っていること
- Team / Enterprise プランの場合は、組織の管理者が Channels を有効にしていること
Bun がまだの方は、以下のコマンドで簡単にインストールできます。
curl -fsSL https://bun.sh/install | bash
インストール完了後、そのまま bun --version を実行すると command not found になることがあります。これはインストーラーが ~/.zshrc にパスを追加してくれるものの、現在のシェルにはまだ反映されていないためです。以下のどちらかを実行すれば使えるようになります。
# 方法1: 現在のシェルを再起動する（インストーラーの案内にも表示されます）
exec /bin/zsh
# 方法2: .zshrc を手動で再読み込みする
source ~/.zshrc
パスが通ったら、バージョンを確認しておきましょう。
bun --version
Step 1: Telegram Bot を作成する
まずは Telegram 側で Bot を用意します。
- Telegram アプリを開きます。初めて使う場合は、電話番号の認証などの初期セットアップを済ませてください。
- 画面下部の検索バー（虫めがねアイコン）をタップして、「BotFather」と入力します。検索結果に青いチェックマーク付きの「BotFather」が表示されるので、それをタップしてチャット画面を開きます。もし検索で見つからない場合は、ブラウザで https://t.me/BotFather にアクセスすると、直接 BotFather のチャットを開けます。
- BotFather とのチャットを開いたら、Start ボタンをクリックして
/newbotとメッセージを送信します。
- Bot の「表示名」を聞かれるので、好きな名前を入力します（例:
My Claude Bot）。
- 次に「ユーザー名」を聞かれます。これは
botで終わる必要があります（例:my_claude_code_bot）。
- 作成が完了すると、Bot トークンが表示されます。
110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsawのような長い文字列です。これを控えておいてください。
注意: Bot トークンは秘密情報です。他人に共有したり、公開リポジトリにコミットしたりしないでください。
Step 2: Telegram プラグインをインストールする
次に、Claude Code のセッション内で Telegram のチャネルプラグインをインストールします。
Claude Code を起動して、以下のコマンドを実行してください。
/plugin install telegram@claude-plugins-official
もし「プラグインが見つからない」というエラーが出た場合は、先にマーケットプレイスを登録する必要があります。
/plugin marketplace add anthropics/claude-plugins-official
マーケットプレイスを追加したら、もう一度インストールコマンドを実行してみてください。
インストールが完了したら一度 /exit でセッションを終了し、再び入り直しましょう。 /reload-plugins では /telegram コマンドが使えるようになりませんでした。
Step 3: Bot トークンを設定する
Step 1 で取得した Bot トークンを Claude Code に登録します。以下のコマンドで設定してください。<token> の部分を実際のトークンに置き換えます。
/telegram:configure <token>
トークンは ~/.claude/channels/telegram/.env に保存されます。シェルの環境変数 TELEGRAM_BOT_TOKEN として設定しておく方法でも大丈夫だそうです。
トークンを反映するために再び /exit でセッションを終了します。
Step 4: Channels を有効にして Claude Code を再起動する
トークンの設定ができたら、一度 Claude Code を終了して、--channels フラグ付きで再起動します。このフラグが、Telegram プラグインを有効化するスイッチになります。なお、僕は --dangerously-skip-permissions を付けますが、それについてはご自身の判断でお願いします。
claude --dangerously-skip-permissions --channels plugin:telegram@claude-plugins-official
起動すると、Telegram プラグインが自動的にサブプロセスとして立ち上がり、Bot へのメッセージをポーリング（定期的にチェック）し始めます。
Step 5: アカウントをペアリングする
セキュリティのために、最初に自分の Telegram アカウントと Claude Code セッションを紐づけ（ペアリング）する作業が必要です。
- Telegram アプリで、Step 1 で作成した Bot を最後のメッセージに書いていあるリンクから開いてOKをタップします。
- Bot に何かメッセージを送ります（「hello」など何でも OK です）
- Bot がペアリングコードを返信してきます
Bot が反応しない場合は、Claude Code が
--channels付きで起動しているか確認してください。Channel が有効なセッションが動いていないと、Bot は応答できません。
- Claude Code のターミナルに戻り、以下のコマンドでペアリングを完了させます。
<code>の部分は Bot から受け取ったコードに置き換えてください。
/telegram:access pair <code>
- 最後に、アクセスポリシーを設定して、自分以外のユーザーからのメッセージをブロックします。
/telegram:access policy allowlist
これで、自分の Telegram アカウントだけが Claude Code にメッセージを送れる状態になりました。
使ってみよう！
セットアップが完了したので、早速使ってみましょう。Telegram アプリを開いて、Bot にメッセージを送ります。
今のワーキングディレクトリにあるファイルを教えて
これで現在のセッションのワーキングディレクトリのパスを Telegram に答えてくれるハズです。
メッセージが Claude Code セッションに届くと、Claude はそれに基づいてファイルを読んだり、コマンドを実行したりします。処理結果は Telegram のチャットに返信として届きます。
ターミナル側では、受信したメッセージと、返信のためのツール呼び出し（「sent」という確認）が表示されます。実際の返信テキストは Telegram 側に表示される仕組みです。
セキュリティについて知っておきたいこと
Channels を使う上で、セキュリティ面でいくつか押さえておきたいポイントがあります。
送信者の許可リスト
Telegram チャネルプラグインは、ペアリング済みのアカウントからのメッセージだけを受け付けます。許可リストに載っていない送信者からのメッセージは無視されます。これにより、第三者が Bot 経由で Claude Code に不正な指示を送り込むこと（プロンプトインジェクション）を防いでいます。
セッション単位の有効化
.mcp.json にサーバーが登録されているだけでは、メッセージは届きません。--channels フラグで明示的に有効化したセッションでのみ、Claude Code Channels が機能します。
権限プロンプトへの注意
Claude Code がファイルの編集やコマンドの実行など、権限が必要な操作を行おうとすると、ターミナルに確認プロンプトが表示されます。外出中にメッセージを送った場合、このプロンプトで処理が一時停止することがあります。
完全に無人で動かしたい場合は --dangerously-skip-permissions フラグがありますが、名前の通り危険を伴うオプションです。信頼できる環境でのみ使用してください。
動かないときのチェックリスト
うまくいかない場合は、以下を確認してみてください。
- Claude Code のバージョン: v2.1.80 以降になっていますか？
- 認証方式: claude.ai アカウントでログインしていますか？（API キー認証では Channels は使えません）
- Bun のインストール:
bun --versionでバージョンが表示されますか？ --channelsフラグ: Claude Code を起動するときにフラグを付けましたか？- ペアリング: Bot にメッセージを送り、受け取ったコードで
/telegram:access pairを実行しましたか？
うまくいかなかったらまずは Claude Code に聞いてみましょう。
まとめ
Claude Code Channels と Telegram を組み合わせることで、ターミナルから離れていても Claude Code に指示を送れる環境が手に入ります。設定手順をおさらいしておきましょう。
- BotFather で Telegram Bot を作成してトークンを取得
- Claude Code で Telegram プラグインをインストール
/telegram:configureで トークンを設定--channelsフラグ付きで Claude Code を再起動- Bot にメッセージを送って ペアリングを完了
たったこれだけのステップで、スマホから Claude Code を操作できるようになります。
Channels はまだリサーチプレビューの段階なので、今後フラグの仕様やプロトコルが変わる可能性があります。最新の情報は公式ドキュメントを確認してくださいね。
フィードバックや不具合の報告は Claude Code の GitHub リポジトリ で受け付けているとのことです。気になった方はぜひ試してみてください！
