如何把 Claude 桌面端连上 ESP32 桌宠？claude-desktop-buddy 配对分步教程（附故障排查）

如何把 Claude 桌面端连上 ESP32 桌宠claude-desktop-buddy 配对分步教程附故障排查【免费下载链接】claude-desktop-buddyReference and an example for the Bluetooth API for makers in Claude Cowork Claude Code Desktop项目地址: https://gitcode.com/gh_mirrors/cl/claude-desktop-buddy想把 Claude 桌面端连上 ESP32 桌宠吗开源项目 claude-desktop-buddy 正是为此而生它让 macOS / Windows 上的 Claude 桌面应用通过 BLE低功耗蓝牙与 M5StickC Plus 等 ESP32 硬件通信把你的 Claude Cowork / Claude Code 会话状态投射到小屏幕上——闲时桌宠打盹、有任务时忙碌冒汗、等待权限批准时 LED 闪烁催你决策甚至能直接在设备上点按批准或拒绝。下面这篇 claude-desktop-buddy 配对教程带你从零完成烧录、配对和常见故障排查。配对前准备硬件与固件烧录⚠️ 前置条件本教程使用 M5StickC Plus 开发板固件依赖其屏幕、IMU 和按键驱动。其他 ESP32 板可以 fork 后自行改驱动协议本身不限定硬件详见 REFERENCE.md。安装 PlatformIO Core克隆仓库git clone https://gitcode.com/gh_mirrors/cl/claude-desktop-buddy用 USB 连接开发板烧录固件pio run -t upload如果是复刷旧设备建议先擦除再烧录pio run -t erase pio run -t upload。板型与依赖在 platformio.ini 中定义基于 ESP32 Arduino 框架。确认设备已开机按任意按钮即可唤醒并在设备设置菜单中确认bluetooth已开启。设备会以Claude-XXXX名称广播蓝牙信号名称生成逻辑见 main.cpp。第一步在 Claude 桌面端开启开发者模式BLE 桥接功能默认关闭只有开启开发者模式后才会出现。路径是Help → Troubleshooting → Enable Developer Mode开启后菜单栏会多出一个Developer菜单这是后续打开配对窗口的入口。第二步打开 Hardware Buddy 窗口并配对点击菜单Developer → Open Hardware Buddy…打开配对窗口。点击窗口中的Connect按钮在扫描列表里选中你的设备。macOS 首次连接会弹出蓝牙权限申请记得允许。配对成功后窗口状态变为已连接此后桥接会在两侧都醒着时自动重连你平时只需要窗口开着才用于查看统计或推送文件。配对成功后桌宠如何打工配对完成后桌面端会通过 Nordic UART Service 周期性推送会话快照会话数、近期消息、token 统计、待批准的权限请求等设备据此切换七种状态状态触发条件表现sleep未连接闭眼缓慢呼吸idle已连接无紧急事项眨眼、张望busy有会话正在运行冒汗干活attention等待权限批准警觉、LED 闪烁celebrate每 5 万 token 升级撒花dizzy你晃了晃设备晕眩heart5 秒内快速批准冒爱心常用按键审批界面中按A 批准 / B 拒绝长按A进菜单Power 短按息屏。ASCII 形态内置 18 只桌宠喜欢 GIF 角色如示例包 characters/bufo/可以把角色文件夹拖进 Hardware Buddy 窗口的投放区通过 BLE 直接推送到设备免插线。故障排查配对失败的常见原因症状排查方法Connect 列表里找不到设备① 设备是否唤醒按任意按钮② 设备设置菜单 → bluetooth 是否打开③ 电脑蓝牙是否开启连接成功但立刻断开设备端若约 30 秒收不到快照即视为掉线检查电脑蓝牙是否被休眠/省电策略断连重新 Connect 即可桥接会自动重连刷不进去 / 行为异常执行pio run -t erase pio run -t upload全擦重刷或从设备端操作长按 A → settings → reset → factory reset → 点两下macOS 无反应系统设置 → 隐私与安全性 → 蓝牙确认已授权 Claude想彻底重来在 Hardware Buddy 窗口点Forget解绑设备端会清空 BLE 绑定协议见 REFERENCE.md下次配对会重新输入 6 位配对码想自己造一台读这份协议文档claude-desktop-buddy 官方定位为参考实现——它示范了一种完整做法但协议才是稳定契约。REFERENCE.md 里有全部线缆协议Nordic UART Service 的三个 UUID、逐行 JSON 心跳快照、权限批准命令、6 位配对码的加密绑定要求和文件夹推送流程。任何支持 BLE 的设备Arduino、ESP32、nRF52、树莓派 蓝牙适配器照此实现即可接入 Claude 桌面端。核心源码供进阶阅读src/ble_bridge.cpp — Nordic UART 服务与收发实现src/data.h — 协议解析与 JSON 定义src/main.cpp — 状态机与界面主循环注意该 BLE API 仅在桌面端处于开发者模式时可用官方定位为创客/开发者功能不属于正式支持的产品特性。【免费下载链接】claude-desktop-buddyReference and an example for the Bluetooth API for makers in Claude Cowork Claude Code Desktop项目地址: https://gitcode.com/gh_mirrors/cl/claude-desktop-buddy创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考