Channelsで外部イベントに反応させるときの確認手順

Channelsは「チャットからメッセージを送れば、実行中のClaude Codeに届く」という接続です。実際に使うときは、Claude Code本体、Channel用のサーバーまたは連携設定、外部サービスの認証、対象セッションの4つを分けて確認します。

最小の試験

実データを変えずに、届いた内容が正しいかを確かめます。

1. 1ダミーイベントテスト用の送信元と、識別できる内容を用意。
2. 2受信を照合時刻・本文・送信元・対象セッションを確認。
3. 3処理を確認要約や固定文など限定した結果と実行ツールを見る。
4. 4再送と停止を試す重複しないこと、処理を止められることを確認。

受信できたことだけで、自動修正やpushまで許可した状態にはしません。

1. 作業用のテストプロジェクトでChannelを有効にする。
2. 書き込み権限を絞り、statusを返すだけの依頼を用意する。
3. DiscordやTelegram、Slackなど対象サービスからダミーイベントを送る。
4. Claude Code側でイベントの受信時刻、本文、送信元、実行したツールを確認する。

イベントが届かない時は、サーバーの起動ログ、認証トークン、購読対象、ネットワーク、Claude Codeセッションがアイドルかを順に確認します。外部サービスのアプリ権限とChannel側の許可を同じものとして扱わないでください。イベントを受信できても、ファイル編集やPR作成には別途ツール許可が必要です。

自動修正へ進む前に

通知を受けたら「失敗箇所を説明して」と返す段階と、「修正してpushして」と実行させる段階には大きな違いがあります。後者は対象ブランチ、変更範囲、承認者、秘密情報の扱い、ロールバック方法を明記します。CI失敗を即時に修正させる用途は、まずパッチ案だけ返させてレビューします。

Channelsは実行中セッションへのイベント入力で、クラウドRoutineのような独立した定期実行や、MCPの外部API接続そのものではありません。公式の自動化比較、Channelsの情報、MCP設定を照合しました。実機検証はしていません。

最初のテストでは、外部サービスへ返信するだけの固定文を使い、リポジトリ変更を許可しません。受信時の本文が長い場合は必要な項目だけ渡し、ユーザー名やトークンがログに残らないことを確認します。Channelの実装差は公式の個別資料を優先します。

Slackから新しいクラウドセッションを始める用途はClaude Code in Slack、既存ローカルセッションの遠隔操作はRemote Controlです。