Claude Desktop Buddy icon

Claude Desktop Buddy

Claude Desktop Buddy 是用於以 Bluetooth Low Energy 連接 maker 裝置到 macOS 與 Windows 上 Claude 的參考韌體與範例,涵蓋桌面橋接協定、配對流程與狀態顯示、權限控制的硬體行為示例。

Claude Desktop Buddy

Claude Desktop Buddy

`claude-desktop-buddy` 是用於以 Bluetooth Low Energy 連接 maker 裝置到 macOS 與 Windows 上 Claude 的參考儲存庫與範例韌體。它著重於線上通訊協定、配對流程,以及建立可顯示 Claude 工作階段狀態並回應權限提示的硬體所需的範例裝置行為。

此儲存庫以桌上寵物風格的 ESP32 實作為核心,也記錄了底層 Bluetooth API,因此其他裝置可以不使用範例程式碼,仍依相同流程實作。桌面橋接在開發者模式下執行,使用 Nordic UART Service,並以以換行分隔的 JSON 交換快照、回合事件與權限決策。

它提供什麼

適用於 BLE maker 的協定參考

專案記錄了 Claude 桌面應用程式所使用的 Bluetooth LE 線上通訊協定,包括服務 UUID、以換行分隔的 JSON 訊息、心跳快照與權限決策訊息。

開發者模式配對與重連

啟用開發者模式後,桌面橋接可從 Hardware Buddy 視窗與裝置配對,之後在雙方都喚醒時自動重新連線。

ESP32 範例韌體

範例韌體以 ESP32 搭配 Arduino framework 為目標,並圍繞使用 M5StickCPlus 顯示器、IMU 與按鈕的特定硬體堆疊而撰寫。

即時工作階段狀態顯示

範例裝置介面會追蹤 Claude 的工作階段狀態,例如執行中的工作階段、等待核准、最近的轉錄項目與 token 數,適合小型螢幕顯示。

自訂角色渲染流程

儲存庫支援 ASCII 寵物與 GIF 角色包,並提供可透過 BLE 或 USB 載入自訂角色的工具,以便更快迭代。

硬體提示回應

裝置可對權限提示回應核准或拒絕決定,讓桌面橋接變成一個小型硬體控制面板。

常見用途

  • maker 硬體狀態顯示

    打造一個小型桌面配件,顯示 Claude 是閒置、工作中或正在等待核准,讓你一眼掌握工作階段狀態。

  • 權限提示控制

    建立一個以按鈕操作的裝置,讓使用者直接從硬體上核准或拒絕 Claude 工具呼叫。

  • 自訂硬體整合

    依照線上通訊協定參考自行實作支援 BLE 的裝置,而不是直接複製範例韌體。

  • 以角色為基礎的裝置體驗

    以 ASCII 寵物或動畫 GIF 角色作為 Claude 連接 maker 裝置的有趣前端,進行實驗。

  • 更快速的硬體原型設計

    在開發期間透過 USB 推送角色包,在本機反覆調整裝置圖像與行為,之後再用 BLE 進行一般操作。

Pros and Cons

Pros

  • 為開發者提供具體的線上通訊協定參考,而不是要求逆向工程。
  • 同時涵蓋可運作的範例,以及底層 JSON 訊息格式、UUID 與配對流程。
  • 支援即時硬體互動,例如核准提示、轉錄顯示與工作階段狀態回饋。
  • 包含建立與燒錄角色包的範例工具,也支援透過 USB 進行迭代。

Cons

  • Bluetooth API 只有在開發者模式下可用,因此不是一般終端使用者功能。
  • 範例韌體綁定 ESP32 Arduino 設定與 M5StickCPlus 函式庫,這限制了範例在其他開發板上的直接重用性。
  • 這個儲存庫提供的是協定參考與範例,而不是代管服務或獨立封裝的應用程式。

FAQ

Claude Desktop Buddy 如何連接到 Claude Desktop?

Claude Desktop Buddy 是透過 Bluetooth Low Energy 連接 Claude 桌面應用程式的橋接工具。啟用開發者模式後,你可以開啟 Hardware Buddy 視窗,連線到廣播 Nordic UART Service 的裝置,桌面應用程式會透過以換行分隔的 JSON 傳送快照與提示。

它支援哪些硬體?

原始內容說明它支援以 Arduino framework 建置的 ESP32 裝置,且目前韌體仰賴 M5StickCPlus 函式庫來驅動顯示器、IMU 與按鈕。內容也指出,只要任何裝置能廣播 Nordic UART Service 並解析以換行分隔的 JSON,應該都可以運作。

這個儲存庫為開發者提供了什麼?

這個儲存庫同時提供了通訊協定參考與範例實作。README 指向 REFERENCE.md,裡面包含 UUID、JSON schema、資料夾推送傳輸細節、心跳快照與權限決策訊息。

Bluetooth API 是否對所有使用者都普遍可用?

只有在桌面應用程式處於開發者模式時,這個橋接功能才可使用,且其定位是面向 maker 與開發者,而非正式支援的產品功能。

可以用它打造哪些裝置體驗?

範例韌體支援 ASCII 寵物與 GIF 角色包,也支援能顯示工作階段狀態並讓你從硬體上允許或拒絕權限提示的桌寵風格裝置。

Quick Facts

類別
開發者工具
主要平台
Claude for macOS 與 Windows
硬體重點
ESP32 範例裝置
傳輸方式
透過 Nordic UART Service 的 Bluetooth Low Energy
來源網域
github.com
可用性
僅限開發者模式