Claude Desktop Buddy

Что такое claude-desktop-buddy?

Claude Desktop Buddy (anthropics/claude-desktop-buddy) — справочный и примерный проект, показывающий, как Claude для macOS и Windows подключается к «maker-устройствам» по Bluetooth Low Energy (BLE). Он предназначен для разработчиков и мейкеров, желающих создать аппаратную часть, отображающую запросы разрешений, недавние сообщения и другие состояния взаимодействия из Claude Cowork и Claude Code Desktop.

Репозиторий в основном содержит документацию и пример прошивки для BLE-устройства «buddy». Код не обязателен для концептуальной сборки аппаратной части, но вы можете следовать описанию wire-протокола в REFERENCE.md, чтобы реализовать протокол на своём BLE-устройстве.

Ключевые возможности

• Справочник BLE wire-протокола (UUID Nordic UART Service, JSON-схемы): помогает реализовать совместимое поведение устройства без догадок о форматах сообщений.
• Пример прошивки-моста для взаимодействий с Claude: подключает устройство к Claude, чтобы аппарат реагировал на состояния взаимодействия.
• Рабочий процесс подключения устройства с Developer Mode и окном Hardware Buddy: описывает, как спарить стик-подобное BLE-устройство с Claude Desktop.
• Целевая прошивка для ESP32 с фреймворком Arduino: даёт конкретную отправную точку для embedded-реализаций.
• Поддержка двух режимов отображения «питомца» — ASCII и GIF: примерное устройство показывает набор ASCII-анимаций или стримит кастомный GIF-пакет персонажей по BLE.

Как использовать claude-desktop-buddy

1. Начните с примера прошивки: аппаратная прошивка ориентирована на ESP32 с фреймворком Arduino. Пример в репо зависит от библиотеки M5StickCPlus для дисплея, IMU и драйверов кнопок; вам понадобится эта плата или форк с заменой драйверов под ваши пины/макет.
2. Установите PlatformIO Core, затем прошейте пример прошивки командой pio run -t upload.
3. При перепрошивке уже запрограммированного устройства сначала сотрите: pio run -t erase && pio run -t upload.
4. Спарьте устройство с Claude Desktop:
   • Включите developer mode в Claude Desktop (Help → Troubleshooting → Enable Developer Mode).
   • Откройте окно Hardware Buddy (Developer → Open Hardware Buddy…), нажмите Connect и выберите устройство из списка.
   • На macOS при первом подключении запросит разрешение на Bluetooth; предоставьте его.
5. Используйте процесс спаривания для тестирования запросов взаимодействия и откликов устройства. Мост автоматически переподключается, когда обе стороны активны.

Сценарии использования

• Создайте BLE-устройство для «запросов разрешений»: используйте справочный протокол и поведение примерной прошивки, чтобы устройство запрашивало у пользователей одобрение или отказ от запросов Claude.
• Сделайте интерактивного десктопного компаньона, реагирующего на состояние сессии: пример включает «питомца», меняющего состояние в зависимости от подключения сессии, занятости, ожидания одобрения или завершения взаимодействия.
• Разверните энергоэффективный контроллер дисплея для уведомлений: пример desk pet описывает сон при бездействии и пробуждение при старте сессий.
• Настройте визуалы персонажа на устройстве с GIF-паком: предоставьте папку с manifest.json и GIF-файлами шириной 96px для состояний; приложение стримит пак по BLE и переводит устройство в GIF-режим.
• Итерации над ассетами дисплея без BLE-обменов: репо включает workflow tools/flash_character.py для staging данных персонажей и загрузки по USB напрямую.

FAQ

Нужно ли использовать предоставленный код устройства для совместимой аппаратной части?
Нет. Репозиторий указывает, что код здесь не обязателен для вашей сборки; REFERENCE.md даёт детали wire-протокола (UUID, JSON-схемы, транспорт push-папок).

Какую аппаратную часть поддерживает примерная прошивка?
Прошивка ориентирована на ESP32 с фреймворком Arduino. Как написано, зависит от библиотеки M5StickCPlus для дисплея, IMU и драйверов кнопок, так что нужна эта плата или форк с другими драйверами.

Как спарить устройство с Claude Desktop?
Включите developer mode, откройте окно Hardware Buddy (Developer → Open Hardware Buddy…), нажмите Connect и выберите устройство. На macOS при первом подключении требуется разрешение Bluetooth.

Что если BLE-устройство не обнаруживается?
Репо рекомендует убедиться, что стик бодрствует (нажмите любую кнопку), и проверить включён ли Bluetooth в меню настроек стика.

Может ли устройство отображать кастомные анимации персонажа?
Да. Пример поддерживает ASCII-питомцев и GIF-питомцев. Для GIF-режима предоставьте папку с паком персонажа, содержащую manifest.json и GIF шириной 96px для состояний; файлы состояний — одиночное имя или массив для ротации анимаций.

Альтернативы

• Реализуйте своё BLE-устройство с использованием предоставленного протокола обмена: вместо справочной прошивки вы можете написать собственный BLE-стек, следующий документированным UUID Nordic UART Service и схемам JSON.
• Используйте другую встроенную платформу с BLE, но с той же логикой приложения: если ESP32 не ваша цель, вы можете адаптировать протокол и обработку состояний (сон/пробуждение, отображение запроса на одобрение и обновления UI) для предпочитаемого микроконтроллера.
• Создайте чисто программный «десктопный компаньон» без BLE-аппаратуры: если нужен только интерфейс на компьютере, рассмотрите подход с чисто программной интеграцией вместо физического дисплея/анимационного устройства.