BLE メーカー向けのプロトコル参照
このプロジェクトは、Claude のデスクトップアプリで使われる Bluetooth LE ワイヤープロトコルを、サービス UUID、改行区切りの JSON メッセージ、ハートビートのスナップショット、許可 निर्णयメッセージを含めて文書化しています。
Claude Desktop Buddy
Claude Desktop Buddy は、macOS と Windows の Claude に Bluetooth Low Energy で接続するメーカー向け参照実装兼サンプル firmware です。デスクトップ橋渡しプロトコル、ペアリング手順、ステータス表示や許可制御の動作例を解説します。
Claude Desktop Buddy
`claude-desktop-buddy` は、macOS と Windows の Claude に Bluetooth Low Energy で接続するメーカー向けの参照リポジトリ兼サンプル firmware です。ワイヤープロトコル、ペアリング手順、Claude のセッション状態を表示し、許可プロンプトに反応できるハードウェアを作るために必要なサンプルデバイスの動作に重点を置いています。
このリポジトリはデスクペット風の ESP32 ビルドを中心に据えつつ、他のデバイスがサンプルコードを使わずに同じ流れを実装できるよう、基盤となる Bluetooth API も文書化しています。デスクトップブリッジは開発者モードで動作し、Nordic UART Service を使用して、スナップショット、ターンイベント、許可の判断を改行区切りの JSON でやり取りします。
提供内容
開発者モードのペアリングと再接続
Hardware Buddy ウィンドウからデバイスとペアリングでき、開発者モードが有効になると、両方が起動しているときに自動で再接続します。
ESP32 向けサンプル firmware
サンプル firmware は Arduino フレームワークの ESP32 を対象としており、M5StickCPlus ディスプレイ、IMU、ボタンを使う特定のハードウェア構成に合わせて作られています。
ライブのセッション状態表示
サンプルデバイスの UI は、実行中のセッション、承認待ち、最近のトランスクリプト項目、トークン数などの Claude セッション状態を、コンパクトな画面向けに追跡します。
カスタムキャラクター描画ワークフロー
このリポジトリは ASCII ペットと GIF キャラクターパックをサポートし、BLE または USB 経由でカスタムキャラクターを読み込むためのツールを備えています。
ハードウェアからのプロンプト応答
デバイスは許可プロンプトに対して承認または拒否の निर्णयを返せるため、デスクトップブリッジを小さなハードウェア制御面として使えます。
主な使い方
メーカー向けハードウェアのステータス表示
Claude がアイドル中、作業中、承認待ちのいずれかを表示する小さなデスクアクセサリを作り、セッション状態をひと目で確認できるようにします。
許可プロンプトの制御
ハードウェアから直接 Claude のツール呼び出しを承認または拒否できる、ボタン駆動のデバイスを作成します。
カスタムハードウェア統合
サンプル firmware をコピーするのではなく、ワイヤープロトコル参照に従って独自の BLE 対応デバイスを実装します。
キャラクターベースのデバイス UX
ASCII ペットやアニメーション GIF キャラクターを、Claude に接続されたメーカー向けデバイスの遊び心あるフロントエンドとして試します。
高速なハードウェア試作
開発中は USB 経由でキャラクターパックを送ってデバイスのグラフィックと動作をローカルで反復し、通常運用では BLE を使います。
Pros and Cons
Pros
- ビルダーが逆解析なしで使える具体的なワイヤープロトコル参照を提供します。
- 動作例と、JSON メッセージ形式、UUID、ペアリング手順の基礎情報の両方をカバーしています。
- 承認プロンプト、トランスクリプト表示、セッション状態フィードバックなどのライブなハードウェア連携をサポートします。
- USB ベースの反復経路を含む、キャラクターパックの作成と書き込みのためのサンプルツールを備えています。
Cons
- Bluetooth API は開発者モードでのみ利用できるため、一般的なエンドユーザー向け機能ではありません。
- サンプル firmware は ESP32 の Arduino 設定と M5StickCPlus ライブラリに結びついており、そのため他のボードへそのまま再利用しにくくなっています。
- このリポジトリはプロトコル参照とサンプルを提供するもので、単体のホスト型サービスやパッケージ化されたアプリではありません。
FAQ
Claude Desktop Buddy は Claude Desktop にどのように接続しますか？
Claude Desktop Buddy は、Claude デスクトップアプリ向けの Bluetooth Low Energy ブリッジです。開発者モードで Hardware Buddy ウィンドウを開き、Nordic UART Service を広告するデバイスに接続すると、デスクトップアプリがスナップショットやプロンプトを改行区切りの JSON で送信します。
どのようなハードウェアをサポートしていますか？
ソースでは、Arduino フレームワークで構築された ESP32 デバイスのサポートが説明されており、現在の firmware は表示、IMU、ボタンのドライバーとして M5StickCPlus ライブラリに依存していると記されています。また、Nordic UART Service を広告し、改行区切りの JSON を解析できるデバイスであれば動作するとも説明されています。
ビルダー向けにリポジトリには何が含まれていますか？
このリポジトリは、ワイヤープロトコルの参照情報とサンプル実装の両方を提供します。README では、UUID、JSON スキーマ、フォルダープッシュの転送詳細、ハートビートのスナップショット、許可 निर्णयメッセージについて REFERENCE.md を参照するよう案内しています。
Bluetooth API は一般ユーザー向けに広く利用できますか？
このブリッジは、デスクトップアプリが開発者モードのときにのみ利用でき、公式にサポートされた製品機能というよりは、メーカーや開発者向けに説明されています。
どのようなデバイス体験を構築できますか？
サンプル firmware は、ASCII ペットや GIF キャラクターパックに対応しており、さらにセッション状態を表示し、ハードウェアから許可プロンプトを承認または拒否できるデスクペット風デバイスも作れます。
Quick Facts
- カテゴリ
- 開発者ツール
- 主要プラットフォーム
- macOS と Windows の Claude
- ハードウェアの重点
- ESP32 サンプルデバイス
- 転送
- Nordic UART Service 経由の Bluetooth Low Energy
- ソースドメイン
- github.com
- 提供状況
- 開発者モードのみ
Claude Desktop Buddyの代替品
CreateOS Sandbox
CreateOS Sandboxは、FirecrackerマイクロVM上でコードやエージェントのワークロードを実行できる分離型コンピュート環境です。SDK、CLI、MCPで制御可能。
GitBot
GitBotは、Claude Code、Codex、OpenCodeを活用した再利用可能なコーディングボットを作成できるローカルブラウザワークスペースです。永続スレッドと権限設定で、リポジトリ内の作業を効率化します。
Exodus
Exodusは無料の開発者向けツール。アプリのリポジトリを監査し、現在のデプロイとGoogle Cloud Run設計を比較して、コーディングエージェント向けの移行計画を作成。新規製品の構成・コスト見積もりにも対応。
AakarDev AI
AakarDev AIは、AIプロバイダーのアクセス管理、プロジェクト別設定、ログ、分析を1つのダッシュボードで管理できるチーム向けツールです。BYOKに対応し、OpenAI、Google Gemini、Anthropic、Groq、Mistral AI、Perplexity AIをサポートします。
Trigger.dev chat agent
Trigger.dev chat agentは、リフレッシュやクラッシュ、長時間の会話も維持できる、開発者向けの耐久性あるAIチャットバックエンドです。AI SDKのuseChatに対応し、ターンにタイムアウトがありません。
ByteAsk
ByteAskは、C/C++向けのターミナル起点AIコーディングエージェント。リポジトリを編集し、コンパイラやデバッガ、サニタイザ、テストで変更を検証してから差分を表示。無料枠あり。