Claude 桌宠 claude-desktop-buddy 完全指南让 ESP32 硬件变成你的 Claude 权限审批通知中心【免费下载链接】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-buddyclaude-desktop-buddy 是一个面向硬件玩家的开源项目它提供了一套蓝牙BLE协议参考固件把 ESP32 小板变身成 Claude 的桌面伴侣。设备能实时显示 Claude 会话状态、最近消息最重要的是——当 Claude 需要你授权执行命令时它会立刻提醒你你直接在设备上按 A 键批准、B 键拒绝不用盯着电脑屏幕。本指南将带你从零完成刷机、配对、使用到深度玩法把这个 ESP32 硬件桌宠完整跑起来。为什么 Claude 桌宠值得一做用 Claude Code 写代码时权限审批弹窗是高频场景跑一个rm -rf /tmp/foo、执行git pushClaude 都会停下来等你确认。传统做法是切回电脑盯着屏幕而 claude-desktop-buddy 让你把审批中心搬到桌面上的一块小屏幕上秒级提醒审批请求到达时桌宠进入着急状态LED 闪烁绝不漏掉任何一次授权一键操作A 键批准、B 键拒绝离键盘远也能处理会话可视化实时显示正在运行的会话数、最近几条消息、Token 消耗养成乐趣Token 每攒够 5 万桌宠升一级撒花庆祝快速批准还会飘爱心翻面放倒还能让它睡觉回血它基于 M5StickC PlusESP32 1.1 寸竖屏 三颗按键 IMU 加速度计 蜂鸣器固件用 Arduino 框架编写项目同时提供完整的协议文档你甚至可以用任何带 BLE 的设备Arduino、nRF52、树莓派 蓝牙适配器自研硬件。硬件准备与一键刷写固件你需要的设备项目说明主控设备M5StickC PlusESP32含屏幕、A/B 键、电源键、IMU电脑运行 Claude for macOS 或 Windows 桌面版工具链PlatformIO Core编译烧录用固件目标平台在 platformio.ini 中定义ESP32 Arduino 框架依赖M5StickCPlus、AnimatedGIF、ArduinoJson三个库文件系统为 LittleFS。最快刷写步骤克隆仓库如需用到仓库源码git clone https://gitcode.com/gh_mirrors/cl/claude-desktop-buddy用 USB 线连接设备执行pio run -t upload如果是刷过其他程序的旧设备建议先擦除再烧录pio run -t erase pio run -t upload 设备也有自救方式开机后长按 A 键 → 设置 → reset → factory reset → 双击即可在设备端恢复出厂。三步完成配对连接 Claude 权限通知配对是新手最容易卡住的环节按下面三步走即可。第一步开启开发者模式Help → Troubleshooting → Enable Developer Mode菜单栏会出现 Developer 菜单。注意BLE API 仅在开发者模式下可用它面向创客并非官方正式功能。第二步打开配对窗口Developer → Open Hardware Buddy…从下拉菜单进入配对界面。第三步点击Connect在扫描列表中选择你的设备设备广播名为Claude-XXXX后两位是蓝牙 MAC 末两字节多台设备放一起也不会混淆。macOS 首次连接会弹出蓝牙权限请求点击允许即可。配对完成后无需保持窗口常开——桥接会在两侧都清醒时自动重连窗口只在首次配对、查看状态面板或拖入角色包时才需要打开。扫不到设备怎么办两个高频原因设备睡着了按任意键唤醒设备设置菜单里蓝牙没开Hold A → bluetooth确认开启。桌面审批操作指南A 键批准、B 键拒绝桌宠的日常交互全部围绕三颗按键和手势展开核心对照表如下操作常规界面审批界面A正面大键切换屏幕主页 → 桌宠 → 信息✅批准B右侧键滚动最近消息❌拒绝长按 A打开菜单设置/关机/帮助打开菜单电源键短按息屏—电源键按住约 6 秒强制关机再按一次开机—摇一摇晕头转向动画—翻面扣放小睡能量回满—细节设计很贴心屏幕 30 秒无交互自动熄屏任何按键唤醒当审批请求弹出时屏幕强制保持点亮直到你做出决定。七种状态桌宠如何活起来固件用七个状态映射 Claude 的工作节奏这是整个项目最有灵魂的部分状态机见 src/main.cpp统计逻辑在 src/stats.h状态触发条件视觉效果sleep睡眠桥接未连接闭眼慢呼吸idle发呆已连接、无紧急事项眨眼、东张西望busy忙碌有会话正在生成冒汗搬砖attention待审批权限请求等待中警觉表情 LED 闪烁celebrate庆祝升级每 5 万 Token彩带蹦跳dizzy眩晕你摇了设备螺旋眼摇晃heart心动5 秒内批准了请求漂浮爱心除了状态设备还持久化了一套养成数据存进 NVS累计批准/拒绝次数、响应速度中位数、心情等级拒绝率太高会拉低它的心情 、小睡时长和 Token 等级——重启也不丢。18 只 ASCII 桌宠与自定义 GIF 角色内置 ASCII 角色固件内置18 个物种每个物种独立一个源文件src/buddies/分别实现 7 种状态动画 美西螈 axolotl、 史莱姆 blob、 仙人掌 cactus、 卡皮巴拉 capybara、 猫 cat、 chonk、 龙 dragon、 鸭子 duck、 幽灵 ghost、 鹅 goose、 蘑菇 mushroom、 章鱼 octopus、 猫头鹰 owl、 企鹅 penguin、 兔子 rabbit、 机器人 robot、 蜗牛 snail、 乌龟 turtle菜单里next pet即可轮换选择会保存到 NVS重启记住。换装 GIF 角色拖一个文件夹就行想要更精致的形象把角色包文件夹拖到 Hardware Buddy 窗口的 drop targetApp 会通过 BLE 流式传输到设备桌宠实时切换到 GIF 模式传输协议实现在 src/xfer.hGIF 解码在 src/character.cpp。角色包就是一个文件夹manifest.json 96px 宽的 GIF 文件官方示例见 characters/bufo/15 只 GIF 的青蛙bufo含 9 帧 idle 轮换动画。要点高度不超过约 140px适配 135×240 竖屏角色裁紧透明边距浪费屏幕整个文件夹压缩后须小于1.8MBgifsicle --lossy80 -O3 --colors 64通常能减 40–60%素材任意尺寸可用 tools/prep_character.py 统一缩放到 96px 且保持角色比例一致开发调试想跳过 BLE 来回传tools/flash_character.py 可把角色包直接经 USB 刷入 LittleFS想回到 ASCII 模式Settings → delete char进阶自建硬件只需读懂一份协议如果你不想用 M5StickC也可以完全自研设备——项目特意把稳定接口设计成协议而非代码。REFERENCE.md 是唯一契约核心内容传输层BLE Nordic UART Service标准三 UUID设备广播名以Claude开头即可被设备选择器识别数据格式UTF-8 换行分隔 JSON一行一个对象跨包自动重组心跳快照桌面端每 10 秒发一次状态会话数total/running/waiting、最近消息entries、Token 数、待审批prompt超过 30 秒收不到快照即视为断连审批回执只要回一行{cmd:permission,id:...,decision:once}或deny且id与prompt.id一致安全建议链路中会流过命令片段官方强烈建议要求LE Secure Connections 配对6 位数字配对码 AES-CCM 加密并处理{cmd:unpair}清除绑定写在最后Fork 它做出你自己的项目维护者的一句话很坦诚最好的贡献是 fork。见 CONTRIBUTING.md——它不是要长期维护的应用而是一份参考实现可以换成 Pi Pico W、换墨水屏、装 3D 打印外壳或者只保留 src/ble_bridge.cpp 和 JSON 解析自己重写 UI。把 Claude 从屏幕里请出来放到桌面上让它变成一个会打盹、会着急、会庆祝的小生物——这就是 claude-desktop-buddy 的全部魔法。现在给你的 ESP32 刷上固件配对上 Claude你的审批通知中心就上线了 【免费下载链接】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），仅供参考