チャネルは MCP サーバーで、実行中の Claude Code セッションにイベントをプッシュするため、あなたがターミナルにいない間に起こることに Claude が対応できます。チャネルは双方向にすることができます。Claude がイベントを読み取り、同じチャネルを通じて返信します。チャットブリッジのようなものです。イベントはセッションが開いている間だけ到着するため、常時稼働セットアップの場合は、Claude をバックグラウンドプロセスまたは永続的なターミナルで実行します。
新しいクラウドセッションを生成するか、ポーリングされるのを待つ統合とは異なり、イベントはすでに開いているセッションに到着します。チャネルの比較方法を参照してください。
チャネルをプラグインとしてインストールし、独自の認証情報で設定します。Telegram、Discord、iMessage はリサーチプレビューに含まれています。
Claude がチャネルを通じて返信する場合、ターミナルに受信メッセージが表示されますが、返信テキストは表示されません。ターミナルはツール呼び出しと確認(「送信済み」など)を表示し、実際の返信は他のプラットフォームに表示されます。
Team、Enterprise、または Console 組織を管理している場合は、組織のチャネルを有効にするを参照してください。独自のチャネルを構築するには、チャネルリファレンスを参照してください。
サポートされているチャネル
サポートされている各チャネルはプラグインで、Bun が必要です。実際のプラットフォームを接続する前にプラグインフローの実践的なデモを試すには、fakechat クイックスタートを試してください。- Telegram
- Discord
- iMessage
完全なTelegram プラグインソースを表示します。
1
Telegram ボットを作成する
Telegram で BotFather を開き、
/newbot を送信します。表示名と bot で終わる一意のユーザー名を指定します。BotFather が返すトークンをコピーします。2
プラグインをインストールする
ターミナルで インストールが失敗した場合は、Claude Code が報告するメッセージと照合してください。
claude を実行して Claude Code を起動し、そのプロンプトで以下を入力します。Marketplace "claude-plugins-official" not found:/plugin marketplace add anthropics/claude-plugins-officialでマーケットプレイスを追加してから、インストールを再試行してください。- プラグインがマーケットプレイスで見つかりません:プラグイン名を確認してください。
Run /reload-plugins to activate. と報告されている場合は、プラグイン変更を再起動なしで適用するを参照して、プラグインの設定コマンドを利用可能にしてください。3
トークンを設定する
BotFather からのトークンで設定コマンドを実行します。これは
~/.claude/channels/telegram/.env に保存されます。Claude Code を起動する前に、シェル環境で TELEGRAM_BOT_TOKEN を設定することもできます。4
チャネルを有効にして再起動する
Claude Code を終了し、チャネルフラグで再起動します。これにより Telegram プラグインが起動し、ボットからのメッセージのポーリングが開始されます。
5
アカウントをペアリングする
Telegram を開き、ボットに任意のメッセージを送信します。ボットはペアリングコードで返信します。Claude Code に戻り、以下を実行します。その後、アクセスをロックダウンして、アカウントだけがメッセージを送信できるようにします。
ボットが応答しない場合は、前のステップから
--channels で Claude Code が実行されていることを確認してください。ボットはチャネルがアクティブな間だけ返信できます。クイックスタート
Fakechat は公式にサポートされているデモチャネルで、localhost 上でチャット UI を実行し、認証が不要で外部サービスの設定も必要ありません。 Fakechat をインストールして有効にすると、ブラウザで入力したメッセージが Claude Code セッションに到着します。Claude が返信し、その返信がブラウザに表示されます。Fakechat インターフェースをテストした後、Telegram、Discord、または iMessage を試してみてください。 Fakechat デモを試すには、以下が必要です。- Claude Code が インストールされ、認証済み(claude.ai アカウントまたは Claude Console API キーを使用)
- Bun がインストール済み。事前構築されたチャネルプラグインは Bun スクリプトです。
bun --versionで確認してください。失敗する場合は、Bun をインストールしてください。 - Team、Enterprise、または管理対象 Console org:管理者が管理設定で チャネルを有効にする 必要があります
1
Fakechat チャネルプラグインをインストールする
ターミナルで インストールが失敗した場合は、Claude Code が報告するメッセージに一致させてください。
claude を実行して Claude Code を起動し、そのプロンプトでインストールコマンドを入力します。Marketplace "claude-plugins-official" not found:/plugin marketplace add anthropics/claude-plugins-officialでマーケットプレイスを追加してから、インストールを再試行してください。- プラグインが マーケットプレイスで見つかりません:プラグイン名を確認してください。
Run /reload-plugins to activate. を報告する場合、ここで対応する必要はありません。次のステップで再起動するときにプラグインが取得されるためです。2
チャネルを有効にして再起動する
Claude Code を終了し、Fakechat サーバーが自動的に起動します。スタートアップ画面には、
--channels で再起動してインストールした Fakechat プラグインを渡します。plugin:fakechat@claude-plugins-official からのメッセージがこのセッションに直接注入されることを示すチャネル通知が表示されます。プラグインがインストールされていないか、承認許可リストにない場合、その問題を示す警告行がその通知の下に表示されます。3
メッセージを送信する
http://localhost:8787 で Fakechat UI を開き、メッセージを入力します。メッセージが Claude Code セッションに到着します。ターミナルは
← fakechat · web: what's in my working directory? のようなインバウンドチャネル行として表示し、モデルはプラグインのスコープ付きサーバー名を使用して <channel source="plugin:fakechat:fakechat"> イベントとして受け取ります。Claude がそれを読み、作業を実行し、Fakechat の reply ツールを呼び出します。Claude Code が最初の返信の権限を求める場合、それを承認してください。答えがチャット UI に表示されます。--dangerously-skip-permissions はほとんどのプロンプトをバイパスしますが、信頼できる環境でのみ使用してください。それでも、no モードが自動承認するアクションは引き続き適用されます。
チャネルを -p で非対話モードで実行する場合、複数選択質問やプランモード承認など、ターミナル入力が必要なツールは無効になり、セッションは入力を待つために停止することはありません。
セキュリティ
承認されたすべてのチャネルプラグインは送信者許可リストを保持します。追加した ID だけがメッセージをプッシュでき、他のすべては静かにドロップされます。 Telegram と Discord はペアリングでリストをブートストラップします。- Telegram または Discord でボットを見つけ、任意のメッセージを送信します。
- ボットはペアリングコードで返信します。
- Claude Code セッションで、プロンプトが表示されたときにコードを承認します。
- 送信者 ID が許可リストに追加されます。
/imessage:access allow でハンドルを使用して他の連絡先を追加します。
その上に、--channels で各セッションで有効なサーバーを制御し、組織は claude.ai Team および Enterprise プランと、管理設定をデプロイする Console 組織で channelsEnabled で可用性を制御します。
.mcp.json にあるだけではメッセージをプッシュするのに十分ではありません。サーバーも --channels で名前を付ける必要があります。
許可リストは、チャネルが宣言する場合、パーミッションリレーもゲートします。チャネルを通じて返信できるすべてのユーザーは、セッションでのツール使用を承認または拒否できるため、その権限を信頼できる許可リスト送信者だけを追加してください。
Enterprise コントロール
管理者は 2 つの管理設定を通じて可用性を制御します。ユーザーはこれらをオーバーライドできません。デフォルトは認証方法によって異なります。- claude.ai Team および Enterprise:チャネルは Owner が有効にするまでブロックされます。
- Anthropic Console と API キー認証:チャネルはデフォルトで許可されます。組織が管理設定をデプロイする場合のみこの設定が必要です。
--channels でセッションにオプトインするまで、チャネルは実行されません。
組織のない Pro および Max ユーザーはこれらのチェックを完全にスキップします。チャネルが利用可能で、ユーザーは
--channels でセッションごとにオプトインします。
組織のチャネルを有効にする
claude.ai → Admin settings → Claude Code → Channels から組織のチャネルを有効にします。これには Owner ロールが必要です。または、管理設定でchannelsEnabled を true に設定します。
有効にすると、組織内のユーザーは --channels を使用して個別のセッションにチャネルサーバーをオプトインできます。設定が無効または未設定の場合、MCP サーバーは接続され、そのツールは機能しますが、チャネルメッセージは到着しません。スタートアップ警告は、ユーザーに管理者が設定を有効にするよう指示します。
チャネルプラグインが実行できるものを制限する
デフォルトでは、Anthropic が管理する許可リスト上のプラグインはチャネルとして登録できます。Team および Enterprise プランの管理者は、管理設定でallowedChannelPlugins を設定することで、その許可リストを独自のものに置き換えることができます。これを使用して、許可されている公式プラグインを制限したり、独自の内部マーケットプレイスからチャネルを承認したり、その両方を行ったりします。各エントリは、プラグインとそれが由来するマーケットプレイスに名前を付けます。
--dangerously-load-development-channels はローカルテストのためにそのブロックをバイパスできます。開発フラグを含むチャネルを完全にブロックするには、代わりに channelsEnabled を設定されていないままにします。
この設定には channelsEnabled: true が必要です。ユーザーが --channels にリストにないプラグインを渡す場合、Claude Code は通常起動しますが、チャネルは登録されず、スタートアップ通知はプラグインが組織の承認リストにないことを説明します。v2 MCP クライアントランタイムで MCP_PROTOCOL_NEGOTIATION を auto に設定した場合、Claude Code がプロトコルリビジョン 2026-07-28 をネゴシエートするチャネルサーバーを登録しないため、チャネルも登録に失敗する可能性があります。
リサーチプレビュー
チャネルはリサーチプレビュー機能です。可用性は段階的にロールアウトされており、--channels フラグの構文とプロトコルコントラクトはフィードバックに基づいて変更される可能性があります。
プレビュー中、--channels と --dangerously-load-development-channels は claude --help に表示されません。フラグは表示されていなくても機能します。
プレビュー中、--channels は Anthropic が管理する許可リストからのプラグイン、または管理者が allowedChannelPlugins を設定している場合は組織の許可リストからのプラグインのみを受け入れます。claude-plugins-official のチャネルプラグインはデフォルトで承認されたセットです。有効な許可リストにないものを渡す場合、Claude Code は通常起動しますが、チャネルは登録されず、スタートアップ通知は理由を伝えます。
構築しているチャネルをテストするには、plugin:<name>@<marketplace> または server:<name> の形式で --dangerously-load-development-channels に渡してください。構築するカスタムチャネルのテストについては、リサーチプレビュー中のテストを参照してください。
Claude Code GitHub リポジトリで問題またはフィードバックを報告してください。
チャネルの比較方法
Claude Code のいくつかの機能はターミナルの外のシステムに接続し、それぞれ異なる種類の作業に適しています。
チャネルは、Claude 以外のソースからのイベントをすでに実行中のローカルセッションにプッシュすることで、そのリストのギャップを埋めます。
- チャットブリッジ:Telegram、Discord、または iMessage を通じて電話から Claude に何かを尋ね、答えが同じチャットに戻ってきます。作業はマシンで実際のファイルに対して実行されます。
- ウェブフックレシーバー:CI、エラートラッカー、デプロイパイプライン、または他の外部サービスからのウェブフックが、Claude がファイルをすでに開いており、デバッグしていたことを覚えている場所に到着します。
次のステップ
チャネルが実行されたら、これらの関連機能を探索してください。- 独自のチャネルを構築して、まだプラグインがないシステムに対応する
- リモートコントロールを使用して、イベントをそれに転送する代わりに電話からローカルセッションを駆動する
- スケジュール済みタスクを使用して、プッシュされたイベントに対応する代わりにタイマーでポーリングする