Claude Desktop Buddy

Claude Desktop Buddy 是面向 macOS 和 Windows 的蓝牙低功耗参考仓库与示例固件，帮助制造者设备连接 Claude，涵盖桌面桥接协议、配对流程及状态显示和权限控制的样例行为。

Claude Desktop Buddy

`claude-desktop-buddy` 是一个参考仓库和示例固件，用于通过蓝牙低功耗将 maker 设备连接到 macOS 和 Windows 上的 Claude。它重点说明了构建能够显示 Claude 会话状态并响应权限提示的硬件所需的线缆协议、配对流程和示例设备行为。

该仓库以桌面宠物风格的 ESP32 构建为核心，同时记录了底层蓝牙 API，使其他设备无需使用示例代码也能实现相同流程。桌面桥接运行在开发者模式下，使用 Nordic UART Service，并通过换行符分隔的 JSON 交换快照、轮次事件和权限决策。

它提供什么

面向 BLE 制造者的协议参考

项目记录了 Claude 桌面应用所使用的蓝牙 LE 线缆协议，包括服务 UUID、换行符分隔的 JSON 消息、心跳快照以及权限决策消息。

开发者模式配对与重连

在启用开发者模式后，桌面桥接可在 Hardware Buddy 窗口中与设备配对，然后在双方都唤醒时自动重新连接。

ESP32 示例固件

示例固件以 Arduino 框架下的 ESP32 为目标，并围绕一套特定硬件栈编写，该栈使用 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

蓝牙 API 仅在开发者模式下可用，因此它不是面向普通终端用户的通用功能。
示例固件绑定于 ESP32 Arduino 环境和 M5StickCPlus 库，这限制了它在其他开发板上的直接复用性。
该仓库提供的是协议参考和示例，而不是独立托管服务或打包应用。

FAQ

Claude Desktop Buddy 如何连接到 Claude Desktop？

Claude Desktop Buddy 是通过蓝牙低功耗连接 Claude 桌面应用的桥接工具。在开发者模式下，打开 Hardware Buddy 窗口，连接一个广播 Nordic UART Service 的设备，桌面应用会通过以换行符分隔的 JSON 传输状态快照和提示。

它支持什么硬件？

源文档说明它支持使用 Arduino 框架构建的 ESP32 设备，并指出当前固件依赖 M5StickCPlus 库来驱动显示屏、IMU 和按钮。文档还提到，任何能够广播 Nordic UART Service 并解析换行符分隔 JSON 的设备都应该可以使用。

这个仓库为开发者提供了什么？

该仓库同时提供了协议参考和示例实现。README 指向 REFERENCE.md，其中包含 UUID、JSON 模式、文件夹推送传输细节、心跳快照和权限决策消息。

这个蓝牙 API 是否对所有用户普遍可用？

只有当桌面应用处于开发者模式时，这个桥接功能才可用；文档将其描述为面向制造者和开发者的功能，而不是官方支持的产品特性。

可以用它构建什么样的设备体验？

示例固件支持 ASCII 宠物和 GIF 角色包，还支持一种桌面宠物风格设备，可显示会话状态并允许你在硬件上批准或拒绝权限提示。

Quick Facts

类别: 开发者工具
主要平台: Claude for macOS 和 Windows
硬件重点: ESP32 示例设备
传输方式: 通过 Nordic UART Service 的蓝牙低功耗
来源域名: github.com
可用性: 仅开发者模式