Clawdmeter：用 ESP32 做一个 Claude Code 使用量桌面仪表盘

Clawdmeter 是什么？

Clawdmeter 是一个基于 ESP32 的桌面小仪表盘，用来实时显示 Claude Code 的使用情况。它运行在 Waveshare ESP32-S3-Touch-AMOLED-2.16 开发板上，通过蓝牙与笔记本配对，显示当前的 API 使用量。

这个项目的亮点在于它的像素风格动画——当你的使用率升高时，屏幕上的 Claude 像素角色会变得越来越忙碌。两个侧边按钮还可以发送快捷键，用于 Claude Code 的语音模式和模式切换。

硬件准备

要制作一个 Clawdmeter，你需要以下硬件：

• Waveshare ESP32-S3-Touch-AMOLED-2.16：这是一款带触摸屏的 AMOLED 显示屏开发板，分辨率 466×466
• USB-C 数据线：用于烧录固件和供电
• 3D 打印外壳（可选）：项目提供了外壳设计文件

软件环境搭建

Clawdmeter 使用 Arduino 框架开发，需要安装以下依赖：

1. 安装 Arduino IDE 或 PlatformIO
2. 安装 ESP32 开发板支持包
3. 安装项目所需的库：
   • TFT_eSPI 或项目指定的显示驱动库
   • BLE 库（用于蓝牙通信）
   • NimBLE-Arduino（轻量级 BLE 实现）

固件烧录步骤

1. 克隆项目仓库：

   git clone https://github.com/HermannBjorgvin/Clawdmeter.git
   cd Clawdmeter

2. 用 Arduino IDE 或 PlatformIO 打开项目
3. 选择正确的开发板：ESP32S3 Dev Module
4. 配置分区表（选择大容量分区方案，因为需要存储动画资源）
5. 编译并烧录到开发板

与 Claude Code 配对

烧录完成后，需要在电脑端配置蓝牙连接：

1. 打开开发板电源，屏幕会显示启动动画
2. 按下中间的 PWR 按钮切换到蓝牙配对界面
3. 在电脑上搜索蓝牙设备，找到 Clawdmeter 并配对
4. 配对成功后，仪表盘会自动开始显示 Claude Code 的使用数据

屏幕功能

Clawdmeter 有三个主要界面：

• 启动画面：显示像素风格的 Claude 动画，会根据使用率变化
• 使用量界面：实时显示当前的 API 调用量和剩余额度
• 蓝牙界面：管理蓝牙连接状态

自定义和扩展

如果你想修改或扩展 Clawdmeter，项目代码结构清晰：

• 动画资源来自 claudepix，可以替换为其他像素动画
• 显示布局可以自定义，项目使用了模块化的 UI 组件
• 蓝牙通信协议简单，可以扩展支持其他 AI 工具的监控

简评

Clawdmeter 是一个非常有趣的 DIY 项目，特别适合经常使用 Claude Code 的开发者。虽然实际功能比较简单（就是显示使用量），但把它放在桌面上确实很有科技感。如果你有 ESP32 开发板和 OLED 屏幕，不妨试试这个项目。

项目地址：https://github.com/HermannBjorgvin/Clawdmeter

来源：

• Clawdmeter GitHub 仓库
• Claudepix 像素动画库