开发者用 ESP32 做出 Claude Code 桌面吉祥物，通过 hooks 实时联动

Claude Code 的吉祥物，活生生地出现在你的桌面上。 ▶ 浏览器里的在线演示 · 无需开发板 🖨️ 可在 MakerWorld 下载的 3D 打印外壳 claudinho-github.mp4 单板版本（E32R28T）。经典 Nextion 版本有它自己的视频。 Claudinho 是一个 Claude Code 插件，为 Clawd 赋予了一副身体：一块带触摸屏的 ESP32（推荐单板 E32R28T，或经典的 ESP32-C3 + Nextion），它会根据 Claude 正在做的事情做出反应（思考中、调用工具、等你输入、完成、出错），并显示你在 5 小时和 7 天窗口内已经用掉了多少额度。 试用 · 硬件 · 安装 · 用户手册 Claudinho 可运行在两种硬件上。如果是新组装，请选择单板（E32R28T）。 E32R28T（LCDWiki 的 "2.8inch ESP32-32E Display"）是一块内置 2.8 英寸触摸屏的 ESP32，分辨率 320×240。它让很多事情都简化了： 所有功能都能在上面运行（表情、用量、场景、打印机、游戏、演示模式、多语言），而且配置 skill 会自动识别这块板子。 部件 说明 E32R28T 板（ESP32 + 2.8" 触摸屏） 电阻触摸版本；商品页可能称其为 "ESP32-32E 2.8" 带 JST 1.25 插头的 8 Ω 扬声器 可选，用于语音；小号的 2415（24 × 15 mm）刚好合适 3.7 V 锂电池，带 JST 1.25 mm 2 针插头和保护板 可选。照片里的是 103450（10 × 34 × 51 mm，2000 mAh）： 其他容量也能用，但尺寸会变：请确认能装进外壳。注意有些商品用的是更大的 2.54 mm 插头。插上之前先确认极性（便宜的电池有时正负极是反的）。 USB-C 数据线 仅用于首次从电脑刷写 带 USB-A 接口的 5 V USB 电源，至少 1 A 为 Claudinho 供电并给电池充电（普通手机充电器即可），使用时通过 USB-A 转 USB-C 线接入外壳 USB-C 母座转接板（裸板，VBUS 和 GND） 外壳上的电源输入（见「供电」） 4 针 1.25 mm 线缆 从 UART 接口接到外壳的 USB-C；随板附带 3D 打印外壳 在 MakerWorld 上，选择 E32R28T 配置 供电 板子自带的 USB-C 仅用于首次从电脑刷写。 之后，更新都通过 Wi-Fi 进行。不要日常把 Claudinho 插在电脑的 USB 口上：一边给电池充电一边跑 Wi-Fi 会给那个端口带来负担。 日常使用时，通过外壳的 USB-C 供电：板子通过其 UART 接口（4 针、1.25 mm 间距的那个，常被叫做 "MX1.25"）以 5 V 供电： 在板子的原理图中，1 脚是 +5 V，2 脚是 GND。随板附带的 4 针线从这个接口接到外壳上的裸 USB-C 母座转接板（VBUS 接 +5 V，GND 接 GND）。 外壳用哪种充电器：这些裸转接板通常没有 CC 电阻（5.1 kΩ），所以 USB-C 转 USB-C 的充电器不会给它供电。 请使用 USB-A 转 USB-C 的线缆和充电器。 电池：该引脚上的 5 V 也会给电池充电（板子的 TP4054 充电芯片由同一路 +5 V 供电）。拔掉电源后，板子会自动切换到电池供电。充电时，屏幕上的电池图标里会显示一个闪电符号。 组装前先刷写。在把任何东西装进外壳之前， 先通过 USB 刷写基础固件（配置 skill 会完成这一步）。之后，更新都通过 Wi-Fi 进行，就不再需要 USB 口了。 供电：只能接一个电源。在把任何东西接到 UART 接口之前， 先查看板子上的丝印，并用万用表测量。切勿同时连接那个外部电源和板子的 USB 线：两个电源相互冲突可能损坏板子或你电脑的 USB 口。 Windows 上的 USB 驱动。板子的 USB 芯片是 CH340。如果在 Windows 上端口不显示，请安装 CH340 驱动。 打开 USB 口会重启板子。这正是它无需按键就能刷写的原因。屏幕可能会闪烁：这是正常的。 ILI9341 还是 ST7789？板子的规格书说是 ILI9341，但屏幕其实是 ST7789。固件已经知道这一点。 外壳：在 MakerWorld 上，和经典版是同一个模型； 选择 E32R28T 打印配置（0.2 mm 层高，3 层墙，10% 填充）。电池放在板子后面，USB-C 转接板装在后部。两个外壳的 SketchUp 源文件都在模型的文件里，可供二次创作。 电烙铁、电源和电脑 USB 口：很多地方都可能出问题， 最后你可能得到一块烧坏的板子、一块烧坏的屏幕，或者更糟，烧坏你电脑上的 USB 口。（开发期间，有一块测试板热到烫伤了我的手指。没什么教育意义，就是疼。） 所以，如果你不清楚自己在做什么，请停下来，学一学，或者问问懂行的人，之后别来怪 Claudinho 或 Argeu。许可证（MIT）已经用更无聊的方式说明了这一点：本项目按「原样」提供，不附带任何形式的担保。 顺便说一句：我的高中学历是电子技术，并且拥有 gambiarra（巴西葡语，意为「临时拼凑」）的硕士和博士学位。更准确地说：是低成本、高风险的替代技术方案方向。 Claude Code，运行在来自「已测试环境」的系统上： 在 Windows 11 的 WSL2 上完成了端到端测试；编写时以原生 Linux、macOS 和带 Git Bash 的 Windows 为目标（尚未在真实硬件上测试）。脚本使用 bash、curl 和 python3。 板子（E32R28T 或 经典版）以及一根 USB 数据线 （很多线缆只能充电）。 一个 2.4 GHz 的 Wi-Fi 网络。ESP32 看不到 5 GHz 网络。 安装 为项目创建一个文件夹，并在其中打开 Claude Code： mkdir ~/LittleClaude && cd ~/LittleClaude && claude 添加市场并安装插件（在 Claude Code 内）： /plugin marketplace add argeuthiesen/claudinho /plugin install claudinho@claudinho 重启 Claude Code。插件的 hooks 只有在那之后才会生效 （/exit 然后 claude --continue 会带你回到同一个对话）。每次更新插件后都要这样做。 仅经典版：先把 ESP32 接到 Nextion 上（4 根线，见「接线」）。单板不需要任何接线。 用数据线把板子插到电脑上，然后输入： /claudinho:configurar （这个 skill 名称在葡萄牙语中意为「配置」；Claude 会用

（原文较长，此处译出前 6000 字，完整内容请点「打开原文」。）