Claude Desktop Buddy

Was ist claude-desktop-buddy?

Claude Desktop Buddy (anthropics/claude-desktop-buddy) ist ein Referenz- und Beispielprojekt, das zeigt, wie Claude für macOS und Windows über Bluetooth Low Energy (BLE) mit „Maker-Geräten“ verbinden kann. Es ist für Entwickler und Maker gedacht, die Hardware bauen möchten, die Berechtigungsprompts, aktuelle Nachrichten und andere Interaktionszustände von Claude Cowork und Claude Code Desktop anzeigen kann.

Das Repository enthält hauptsächlich Dokumentation und Beispiel-Firmware für ein BLE-„Buddy“-Gerät. Sie benötigen den Code nicht, um Hardware konzeptionell zu bauen, aber Sie können dem Wire-Protocol-Referenz in REFERENCE.md folgen, um das Protokoll in Ihrem eigenen BLE-Gerät zu implementieren.

Wichtige Funktionen

• BLE-Wire-Protocol-Referenz (Nordic UART Service UUIDs, JSON-Schemas): Hilft Ihnen, kompatibles Geräteverhalten ohne Raten der Nachrichtenformate zu implementieren.
• Beispiel-Firmware-Bridge für Claude-Interaktionen: Verbindet das Gerät mit Claude, damit die Hardware auf Interaktionszustände reagieren kann.
• Geräteverbindungs-Workflow mit Developer Mode und Hardware Buddy-Fenster: Dokumentiert, wie man ein stiftförmiges BLE-Gerät mit Claude Desktop koppelt.
• ESP32-Firmware-Ziel mit Arduino-Framework: Bietet einen konkreten Einstieg für eingebettete Implementierungen.
• Unterstützung für zwei „Pet“-Anzeigemodi – ASCII und GIF: Das Beispielgerät kann ein ASCII-Animationsset anzeigen oder ein benutzerdefiniertes GIF-Charakterpack über BLE streamen.

Wie verwendet man claude-desktop-buddy?

1. Starten Sie mit dem Firmware-Beispiel: Die Hardware-Firmware zielt auf ESP32 mit Arduino-Framework ab. Das Repo-Beispiel hängt von der M5StickCPlus-Bibliothek für Display-, IMU- und Button-Treiber ab; Sie benötigen dieses Board oder eine Fork, die Treiber für Ihre Pins/Layout austauscht.
2. Installieren Sie PlatformIO Core, dann flashen Sie die Beispiel-Firmware mit pio run -t upload.
3. Beim erneuten Flashen eines bereits programmierten Geräts zuerst löschen mit pio run -t erase && pio run -t upload.
4. Koppeln Sie Ihr Gerät mit Claude Desktop:
   • Aktivieren Sie den Developer Mode in Claude Desktop (Hilfe → Problembehandlung → Developer Mode aktivieren).
   • Öffnen Sie das Hardware Buddy-Fenster (Entwickler → Hardware Buddy öffnen…), klicken Sie auf Verbinden und wählen Sie Ihr Gerät aus der Liste.
   • Unter macOS fordert die erste Verbindung zur Bluetooth-Berechtigung auf; erteilen Sie diese.
5. Nutzen Sie den Kopplungsablauf, um Interaktionprompts und Geräteantworten zu testen. Die Bridge verbindet automatisch neu, wenn beide Seiten wach sind.

Anwendungsfälle

• Bauen Sie ein BLE-„Berechtigungsprompt“-Gerät: Nutzen Sie das Referenzprotokoll und das Beispiel-Firmware-Verhalten, damit das Gerät Nutzer zur Genehmigung oder Ablehnung von Anfragen von Claude auffordern kann.
• Erstellen Sie einen interaktiven Desktop-Begleiter, der auf Sitzungsstatus reagiert: Das Beispiel enthält ein Geräte-„Pet“, das seinen Status basierend auf verbundener Sitzung, Busy-Status, ausstehender Genehmigung oder abgeschlossener Interaktion ändert.
• Setzen Sie einen stromsparenden Display-Controller für Benachrichtigungen ein: Das Desk-Pet-Beispiel beschreibt Schlafen bei Inaktivität und Wecken beim Sitzungsstart.
• Passen Sie On-Device-Charakter-Visuals mit einem GIF-Pack an: Stellen Sie einen Ordner mit manifest.json plus 96px-breiten GIF-Dateien für Zustände bereit; die App streamt das Pack über BLE und schaltet das Gerät in den GIF-Modus.
• Iterieren Sie Display-Assets ohne BLE-Roundtrips: Das Repo enthält einen tools/flash_character.py-Workflow, der Charakterdaten stagiert und direkt über USB hochlädt.

FAQ

Brauche ich den bereitgestellten Gerätecode, um kompatible Hardware zu bauen?
Nein. Das Repository gibt an, dass Sie den Code hier nicht benötigen, um Ihr eigenes Gerät zu bauen; REFERENCE.md liefert die Wire-Protocol-Details (UUIDs, JSON-Schemas und Folder-Push-Transport).

Welche Hardware unterstützt die Beispiel-Firmware?
Die Firmware zielt auf ESP32 mit Arduino-Framework ab. Wie geschrieben, hängt sie von der M5StickCPlus-Bibliothek für Display-, IMU- und Button-Treiber ab, daher benötigen Sie dieses Board oder eine Fork mit anderen Treibern.

Wie koppelt man ein Gerät mit Claude Desktop?
Aktivieren Sie den Developer Mode, öffnen Sie dann das Hardware Buddy-Fenster (Entwickler → Hardware Buddy öffnen…), klicken Sie auf Verbinden und wählen Sie Ihr Gerät. macOS erfordert Bluetooth-Berechtigung beim ersten Verbinden.

Was, wenn das BLE-Gerät nicht erkannt wird?
Das Repo empfiehlt, sicherzustellen, dass der Stift wach ist (beliebigen Button drücken), und Bluetooth in den Geräteeinstellungen zu aktivieren.

Kann das Gerät benutzerdefinierte Charakter-Animationen anzeigen?
Ja. Das Beispiel unterstützt ASCII-Pets und GIF-Pets. Für den GIF-Modus liefern Sie einen Charakter-Pack-Ordner mit manifest.json und 96px-breiten GIFs für Zustände; Zustandsdateien können ein einzelner Dateiname oder ein Array für rotierende Animationen sein.

Alternativen

• Implementieren Sie Ihr eigenes BLE-Gerät mit dem bereitgestellten Drahtprotokoll: Statt der Referenzfirmware können Sie einen benutzerdefinierten BLE-Stack schreiben, der den dokumentierten Nordic-UART-Service-UUIDs und JSON-Schemas folgt.
• Verwenden Sie eine andere eingebettete Plattform mit BLE, aber derselben Anwendungslogik: Wenn ESP32 nicht Ihr Ziel ist, können Sie das Protokoll und die Zustandsverwaltung (Schlaf/Wach, Genehmigungs-Prompt-Darstellung und UI-Updates) an Ihren bevorzugten Mikrocontroller anpassen.
• Bauen Sie einen rein softwarebasierten „Desktop-Companion“ ohne BLE-Hardware: Wenn Sie nur eine Oberfläche am Computer benötigen, ziehen Sie einen softwarebasierten Integrationsansatz in Betracht statt eines physischen Anzeige-/Animationsgeräts.