自律的Claudeコードセッション用Discordブリッジ

開発者は、Claudeがツールが起動するかCLI入力が送信されたときのみ動作するというプルベースの制限を解決するために、自律的なClaude Codeセッション用のDiscordブリッジを構築しました。このシステムは、WebSocketによるリアルタイム双方向チャットを可能にし、ローカルファイルキューイングと停止/エラーイベント時のプッシュ通知を実装しています。

アーキテクチャ

インバウンドフロー： Discord → WebSocket → bridge.js → discord-inbox.jsonl → PostToolUseフック → Claude

アウトバウンドフロー： Claude → Discord MCP → #claude-code-chat → 電話プッシュ通知

コンポーネント

• bridge.js（約50行、discord.js v14）：専用チャンネルを監視し、メッセージをJSONL形式でローカルインボックスファイルに書き込む、Discordゲートウェイへの永続的WebSocket接続。APIポーリングは一切不要。
• PostToolUseフック： ネットワーク呼び出しやスロットリングなしで、すべてのツール呼び出し時にローカルインボックスを読み取ります。以前使用していた2分間のポーリング間隔と比較して、わずかマイクロ秒単位のファイル読み取りです。
• PreToolUseフック： 各セッションの最初のツール呼び出し時にブリッジを自動起動し、すでに実行中の場合は何もせずに処理を続行します。
• アウトバウンドWebhook： 停止/エラーイベント時に構造化されたSTATUS更新を送信し、Discordのthread_nameパラメータを使用してセッションごとに名前付きスレッドを自動生成します（channel_idを取得するには?wait=trueが必要 — デフォルトでは空の204レスポンスが返されます）。

主要な設計判断

主なアーキテクチャの転換点は、APIポーリングの代わりにローカルファイルキューを使用したことです。JSONLとアトミックな切り捨て操作により、競合状態を防止しています。このブリッジはセッションに依存せず、Discordの履歴はクラッシュや再起動をまたいで保持され、複数のエージェントが同じチャンネルを共有できます。

制限事項

権限承認プロンプト（1/2/3）は、Claudeがその時点でアイドル状態でありツールが起動していないため、依然として端末入力が必要です。これはアクティブ実行中のリダイレクトには機能しますが、停止したプロンプトへの応答には対応できません。

テスト結果

2つの並列セッションで27,000行を一晩かけて分析し、15個のバグを発見し、午前5時42分に6ヶ月分のロードマップを提供しました。セットアップには3つのbashファイルと約20分が必要です。