M5StickC Plus 刷写 claude-desktop-buddy

M5StickC Plus 刷入 claude-desktop-buddy

前言

前段时间看见 claude-desktop-buddy 这个项目，十分感兴趣，于是买了一个 M5StickC Plus，准备刷入 claude-desktop-buddy。本文记录整个流程。

步骤

1. 安装 platformio

使用下面的命令安装 platformio：

 复制代码uv pip install platformio

2. clone claude-desktop-buddy 项目

 复制代码git clone 

3. 连接 M5StickC Plus 到电脑

用 USB-C 数据线把 M5StickC Plus 连接到电脑。

4. 刷固件

进入项目目录，执行：

 复制代码pio run -t upload

PlatformIO 会自动下载工具链、依赖库并开始编译、烧录。下面是部分关键输出（完整日志较长，已省略中间编译过程）：

 复制代码 pio run -t uploadProcessing m5stickc-plus (platform: espressif32; board: m5stick-c; framework: arduino)
--------------------------------------------------------------------------------
...（自动安装 esptoolpy / mkspiffs / M5StickCPlus / ArduinoJson 等依赖）...PLATFORM: Espressif 32 (7.0.1) > M5Stick-C
HARDWARE: ESP32 160MHz, 320KB RAM, 4MB FlashDependency Graph
|-- M5StickCPlus @ 0.1.1
|-- AnimatedGIF @ 2.2.2
|-- ArduinoJson @ 7.4.3
|-- ESP32 BLE Arduino @ 2.0.0
|-- LittleFS @ 2.0.0
|-- Preferences @ 2.0.0...（编译各模块）...RAM:   [==        ]  22.4% (used 73492 bytes from 327680 bytes)
Flash: [======    ]  64.8% (used 1357937 bytes from 2097152 bytes)Auto-detected: /dev/cu.usbserial-8D52B9E74F
Chip is ESP32-PICO-D4 (revision v1.1)
Writing at 0x0015bd46... (100 %)
Wrote 1364512 bytes (839192 compressed) at 0x00010000 in 10.5 seconds...
Hash of data verified.Leaving...
Hard resetting via RTS pin...
========================= [SUCCESS] Took 61.01 seconds =========================

很快，固件就刷好了。

其它：清除旧固件

如果你的设备之前已经刷过机，请先将其擦除再刷：

 复制代码pio run -t erase && pio run -t upload

运行后，你还可以清除设备本身的所有内容：

配对

打开 Claude 桌面端软件，启用开发者模式：

然后在 developer 选项中打开 open hardware buddy。

【图 2：open hardware buddy 选项截图 open_hardware_buddy.png】

点击连接。

【图 3：连接成功截图 connected.png】

效果

配对成功后，设备上就会显示 buddy 的状态界面，包括 mood、fed、energy 等信息。

【图 4：设备状态界面 device_stats.jpg】

按 A 键可以切换屏幕，B 键翻页，长按 A 进入菜单。下面是说明页：

【图 5：设备说明页 device_help.jpg】

小结

整个过程比想象中要简单：装好 platformio，clone 项目，连上 M5StickC Plus，一条 pio run -t upload 就能把固件刷进去，全程不到一分钟。配对也只需要在 Claude 桌面端打开开发者模式，连接硬件 buddy 即可。

刷好后，这只小宠物会显示 mood、fed、energy 等状态，可以通过按键切换屏幕和翻页，把 Claude 真正「摆」到了桌面上，是个很有趣的小玩具。如果你手上正好有一块 M5StickC Plus（或其它兼容的 M5Stack 设备），不妨花几分钟动手试试。

几个小提示：

• 如果设备之前刷过其它固件，记得先 pio run -t erase 再刷，避免残留数据导致异常。
• 刷机和配对都依赖 USB-C 数据线，确保用的是数据线而非仅供电的线。
• 配对走的是 BLE，连接时让设备和电脑保持在较近的距离。

参考

1. M5Stack 官方介绍：Bring Claude to Your Desk — Exploring claude-desktop-buddy
2. claude-desktop-buddy 项目地址
3. PlatformIO 安装文档