Claude Media
Claude Code Channels対応アプリと研究プレビューの制約
Claude Codeチュートリアル

Claude Code Channels対応アプリと研究プレビューの制約

Claude Code ChannelsはTelegram・Discord・iMessageに対応します。3アプリのセットアップ手順と、研究プレビューゆえの利用環境の制約をまとめます。

読了目安 約10分

Claude Code Channelsが研究プレビューの時点で対応するチャットアプリは、Telegram・Discord・iMessageの3つです。加えて、認証も外部サービスも不要なローカルデモのfakechatがあります。どのアプリも、Botとして登録してペアリングを済ませればすぐに使えます。Channelsという仕組み自体の動き方はClaude Code Channelsとはで扱ったので、本記事は対応アプリの選び方と個別のセットアップ手順、そして研究プレビューならではの制約に絞ります。

Claude Code Channelsの対応チャットアプリ

どのアプリを選ぶ場合でも、共通して次の前提が要ります。

  • Claude Codeがインストール済みで、claude.aiアカウントかConsole APIキーで認証済みであること
  • Bunがインストール済みであること(各プラグインはBunスクリプトとして動く)
  • Team・Enterprise・管理対象Consoleの組織に所属している場合は、管理者がすでにChannelsを有効化していること

各対応アプリはclaude-plugins-officialマーケットプレイスで配布されるプラグインです。実際のプラットフォームに接続する前に、まずローカルのfakechatで流れを確認できます。

/plugin install fakechat@claude-plugins-official

インストール後にclaude --channels plugin:fakechat@claude-plugins-officialで再起動すると、http://localhost:8787にチャットUIが立ち上がります。ブラウザで入力したメッセージがセッションに届き、Claudeの返信がそのままブラウザに戻る様子を、外部アカウントを一切作らずに体験できます。

3つの対応アプリを比較する

用途とセットアップの手間が大きく違うので、迷ったら次の早見表で選びます。

アプリBotトークンの取得元特徴的な制約
TelegramBotトークンの取得元BotFather(/newbot)特徴的な制約セットアップが最も単純。ペアリングコードで自分のアカウントを登録
DiscordBotトークンの取得元Discord Developer Portal特徴的な制約Message Content Intentの有効化とBot招待用URLの生成が必要
iMessageBotトークンの取得元不要(macOSのMessages DBを直接読む)特徴的な制約macOS専用。Full Disk Accessの許可が要る

Botトークンを外部サービスで発行する手間を避けたいならiMessageが最短ですが、macOS以外では使えません。チームで複数人が使う可能性があるならDiscord、個人で試すだけならTelegramが手順の少なさで扱いやすい選択です。

Telegramをchannelとして使う

TelegramでBotFatherから/newbotを送ってBotを作成し、返ってきたトークンを控えます。

/plugin install telegram@claude-plugins-official
/telegram:configure <token>

設定したトークンは~/.claude/channels/telegram/.envに保存されます。シェル環境変数TELEGRAM_BOT_TOKENで渡すこともできます。設定後は--channelsを付けて再起動し、Telegram側から自分のBotへ何かメッセージを送るとペアリングコードが返ります。

claude --channels plugin:telegram@claude-plugins-official

セッション内で/telegram:access pair <code>を実行してペアリングを完了し、/telegram:access policy allowlistで自分のアカウント以外からのメッセージを弾く設定にします。

Discordをchannelとして使う

Discord Developer PortalでApplicationを作成し、Bot欄でトークンを発行します。Message Content Intentを有効にしないと、送られてきたメッセージの本文をBotが読めない点に注意します。OAuth2のURL Generatorでbotスコープを選び、次の6つの権限にチェックを入れてからURLを生成し、そのURLを開いてBotをサーバーへ招待します。

  • View Channels(チャンネル閲覧)
  • Send Messages(メッセージ送信)
  • Send Messages in Threads(スレッドへの送信)
  • Read Message History(履歴の読み取り)
  • Attach Files(ファイル添付)
  • Add Reactions(リアクション追加)
/plugin install discord@claude-plugins-official
/discord:configure <token>
claude --channels plugin:discord@claude-plugins-official

トークンは~/.claude/channels/discord/.envに保存され、DISCORD_BOT_TOKEN環境変数でも指定できます。再起動後にBotへDMを送るとペアリングコードが返り、/discord:access pair <code>で承認します。許可リストの絞り込みはTelegramと同じく/discord:access policy allowlistです。

iMessageをchannelとして使う — macOS限定

iMessageチャネルはBotトークンが不要な代わりに、~/Library/Messages/chat.dbへの読み取り権限が要ります。初回起動時にmacOSがFull Disk Accessの許可を求めるので許可し、プロンプトが出ない場合はシステム設定 > プライバシーとセキュリティ > フルディスクアクセスからターミナルアプリを手動で追加します。許可がないとauthorization deniedでサーバーが即座に終了します。

/plugin install imessage@claude-plugins-official
claude --channels plugin:imessage@claude-plugins-official

自分のApple IDから自分自身にメッセージを送ると、許可チェックを経由せずすぐにClaudeへ届きます。ほかの相手を許可するには/imessage:access allow +15551234567のように電話番号かApple IDメールを指定し、許可した相手からのメッセージだけを受け付ける状態にします。

研究プレビューの制約 — 使える環境と使えない環境

Channelsは研究プレビュー機能で、いくつかの利用環境で制約があります。

  • Amazon Bedrock・Google CloudのAgent Platform・Microsoft Foundryでは使えません。claude.aiのアカウントかConsole APIキーによるAnthropic認証が前提です
  • Team・Enterprise組織は管理者が明示的に有効化するまで使えません。個人のPro・Maxユーザーはこのチェックをスキップし、セッションごとに--channelsを付けて起動する(利用するかどうかをその都度選ぶ)だけで使えます
  • --channelsフラグと--dangerously-load-development-channelsフラグは、プレビュー期間中claude --helpの出力に表示されません。表示されないだけで、フラグ自体は動作します
  • プレビュー中は、Anthropicが管理する許可リスト(または組織が設定したallowedChannelPlugins)に載ったプラグインしか--channelsで受け付けません
  • MCPクライアントのv2ランタイムでMCP_PROTOCOL_NEGOTIATIONをautoにしていると、プロトコルのバージョンネゴシエーションの都合でチャネルサーバーが登録に失敗することがあります
  • 組織が許可プラグインを空配列に設定しても、開発中のチャネルを試す--dangerously-load-development-channelsはその制限を回避できます。対応アプリも含めて完全に遮断したい場合は、許可リストを空にするのではなくchannelsEnabled自体を未設定のままにします

Anthropicは段階的にロールアウトを進めており、--channelsのフラグ仕様やプロトコルの契約はフィードバックをもとに変わる可能性があります。問題を見つけた場合はClaude CodeのGitHubリポジトリで報告できます。組織管理者向けの有効化手順とプラグイン許可リストの設計はClaude Code Channels組織管理に、送信者許可リストの安全な運用はChannelsセキュリティ設計にまとめています。

よくあるつまずき

Marketplace "claude-plugins-official" not foundと出る

プラグインのマーケットプレイスがまだ登録されていません。次のコマンドでマーケットプレイスを追加してから、対象アプリのインストールをやり直します。

/plugin marketplace add anthropics/claude-plugins-official

インストールできたのにBotが反応しない

原因は主に2つです。ひとつは--channelsフラグを付けずにclaudeを起動していること。プラグインをインストールしただけではチャネルは有効にならず、--channels plugin:アプリ名@claude-plugins-officialを明示して再起動する必要があります。もうひとつは、インストール直後の要約に「Run /reload-plugins to activate.」と出ていたのに、その/reload-pluginsを実行し忘れているケースです。

ペアリングコードが返ってこない

Botが返信できるのは、前の手順で--channelsを付けたセッションが起動している間だけです。ペアリングコードが返ってこないときは、まず起動オプションを確認します。プラグインのインストールだけでは--channelsは有効にならないので、--channels plugin:アプリ名@claude-plugins-officialを付けて再起動してから、Telegramなら/telegram:access pair <code>、Discordなら/discord:access pair <code>を実行します。ターミナルを閉じてセッションが終了していないかも合わせて確認すると原因の切り分けが早くなります。

よくある質問

対応アプリ以外のチャットツールをChannelsに組み込めますか

組み込めます。対応アプリはAnthropicが公式に配布するプラグインの集合であって、Channelsという仕組み自体は任意のMCPサーバーとして自作できます。Webhookを受け取る独自チャネルの作り方はClaude Code ChannelsでWebhook受信サーバーを自作するで扱っています。

まとめ

対応アプリはTelegram・Discord・iMessageの3つで、それぞれBotトークンの取得先とOSの制約が違います。速く試したいならローカル完結のfakechat、外部サービスの手間を避けたいならmacOS限定のiMessage、クロスプラットフォームで動かしたいならTelegramが選びやすい入り口です。どのアプリを選んでも、送信者の許可リストで自分以外からのメッセージを弾く設定まで済ませてから実運用に入ります。研究プレビューである以上、対応クラウド基盤の制約とフラグ仕様の変更可能性は運用に組み込んでおく必要があります。スマホからClaude Codeにアクセスする他の経路との比較はClaude Codeをスマホから使う4つの経路の選び方を参照してください。

この記事を共有:XはてブLinkedIn

関連する記事

Claude Code をもっと見る →