チャンネルを使って実行中のセッションにイベントをプッシュする
概要
- Claude Codeで利用可能なChannel機能の概要解説
- TelegramやDiscordなど対応チャットサービスの導入方法
- セキュリティや管理者向け設定のポイント整理
- Fakechatによるローカルデモの手順説明
- カスタムチャンネル開発や制限事項の注意点
Claude CodeのChannel機能概要
- Channelは、MCPサーバー経由でイベントをClaude Codeセッションにプッシュする仕組み
- セッション外でもリアルタイム通知や双方向通信が可能
- 例:TelegramやDiscordのチャットイベントを受信し、Claudeが応答
- イベントはセッションが開いている間のみ受信
- 常時稼働にはバックグラウンドプロセスや永続ターミナルでClaudeを実行
- プラグインとしてチャンネルをインストールし、各自の認証情報で設定
- Claudeからの返信はターミナルには確認メッセージのみ表示、実際の返信は外部プラットフォームで確認
サポートされるChannelとセットアップ
- 現在TelegramとDiscordがリサーチプレビューで利用可能
- 各チャンネルはBunを必要とするプラグイン構成
- 初回はFakechatによるローカルデモ推奨
- Fakechatは認証不要、localhost上で動作する公式デモチャットUI
- Claude Codeがインストール済み、かつBunが導入されていることが前提
- Team/Enterpriseユーザーは管理者がChannel機能を有効化する必要
- Fakechatで動作確認後、TelegramやDiscord連携を試行
セキュリティと許可リスト管理
- 各チャンネルプラグインは送信者許可リスト(allowlist)を保持
- 許可リストに登録されたIDのみメッセージ送信が可能
- Telegram/Discordではペアリング操作で許可リスト登録
- Botにメッセージ送信→Botがペアリングコード返信→Claude Codeセッションで承認→ID登録
- --channelsオプションで有効サーバーを指定
- Team/Enterpriseでは組織管理者がchannelsEnabled設定で利用可否を管理
- .mcp.jsonへの設定だけではメッセージプッシュ不可、--channels指定が必須
- --dangerously-skip-permissionsでプロンプト省略可能(信頼できる環境のみ利用推奨)
Enterprise向け管理機能
- Pro/Max:デフォルトでチャンネル利用可、ユーザーごとに**--channels**で選択
- Team/Enterprise:デフォルト無効、管理者が明示的に有効化
- 管理者はclaude.ai > Admin settings > Claude Code > Channelsで有効化
- 機能無効時はMCPサーバーやツールは動作するが、チャンネル経由メッセージは受信不可
- スタートアップ時に管理者設定の必要性を警告表示
リサーチプレビューと制限事項
- Channel機能はリサーチプレビューとして段階的に提供
- --channelsフラグはAnthropic公式許可リストのプラグインのみ許容
- 許可外プラグイン指定時は起動時に理由を通知し、チャンネルは登録されない
- 独自チャンネル開発時は**--dangerously-load-development-channels**でテスト可
- 問題やフィードバックはClaude Code GitHubリポジトリで受け付け
関連機能・次のステップ
- 未対応システム向けカスタムチャンネル開発
- Remote Controlによるスマートフォンからのローカルセッション操作
- Scheduled tasksによる定期ポーリングイベント実行