Channelsとは？Claude Codeへ外部イベントを届ける仕組み

Channelsは、チャットアプリや自分のサーバーなどで起きたイベントを、実行中のClaude Codeセッションへ流し込むための接続です。定期的に状態を取りに行く/loopとは違い、対応するChannelサーバーがイベントを受けてセッションへ送ります。外部サービスとの認証・サーバー・権限が必要なので、初心者が最初に使う機能ではありません。

何が起きるか

受信と、その後の変更を別の段階として設計します。

1. 1外部サービスのイベント通知、メンション、CIの結果など。
2. 2Channelサーバー認証・接続を通してイベントを送る。
3. 3実行中のClaude Code入力を受け取り、内容を確認・要約する。
4. 4許可した対応提案や変更へ進む範囲を別途決める。

セッションや接続が止まっていれば受け取れません。再送時の二重処理と停止方法も用意します。

CIの失敗、チャットでのメンション、監視システムの通知などがChannelへ入り、Claudeはそのイベントを会話の入力として扱います。Claude Codeが終了している、Channelサーバーが接続していない、権限がない場合は受け取れません。イベントを受けたからといって、勝手に本番修正や投稿を完了する保証もありません。

導入前の確認

まず対象Channelの公式設定、対応バージョン、認証方式、送信するデータ、必要なツール権限を確認します。テストはダミーイベントで行い、受信→内容の要約→人の承認→書き込み、の境界を明確にします。イベント本文に秘密情報や顧客データが含まれる可能性がある場合は、送信前のマスキングと保存期間を決めます。

外部イベントに反応させるだけなら、最初は読み取り専用の通知を作ると切り分けやすいです。チャットサービスとの具体例はChannels検証記事、外部ツール接続はMCP解説、全体の選択は自動化まとめを参照してください。公式Channels関連情報と共通ワークフローを確認しました。実機検証はしていません。

イベントの処理を設計する時は、受信だけ、要約、提案、変更の4段階を分けます。Channelには再送や遅延があり得るため、同じイベントを二重処理しない識別子と、停止できる手順を用意してから書き込みへ進みます。

Channelsのイベントが会話へ入るだけで、Claudeが常時待機しているとは限りません。セッションの起動状態、接続の切断時、失敗時の通知先を運用手順へ書き、イベントが届かなかった場合の再送方法を確認します。