Clawdmeter：用ESP32做一个桌面仪表盘，实时显示Claude Code使用量

对于重度使用Claude Code的开发者来说，监控API使用量和费用是个实际需求。最近GitHub上出现了一个叫Clawdmeter的项目，用ESP32微控制器做一个实体桌面仪表盘，放在桌上就能实时看到Claude Code的使用情况。项目9天获得近1000个星标，说明很多开发者都有这个需求。

Clawdmeter是什么

Clawdmeter是一个开源的桌面仪表盘项目，使用ESP32微控制器（一种常见的物联网开发板）配合一个小屏幕，实时显示你的Claude Code使用数据。它通过Claude Code的使用统计API获取数据，然后在实体屏幕上以仪表盘的形式展示出来。

想象一下：你的桌上放着一个小屏幕，上面实时显示着你今天用了多少Token、花了多少钱、还剩多少配额。不需要打开网页、不需要查后台，瞟一眼就知道。

需要什么硬件

• ESP32开发板：推荐ESP32-S3或ESP32-C3，淘宝/拼多多几块钱到十几块钱
• 显示屏：支持1.69寸TFT屏幕（240×280分辨率）或类似的小屏幕
• 数据线：USB-C或Micro-USB，用于给ESP32供电和烧录固件
• 3D打印外壳（可选）：项目提供了外壳STL文件，可以自己3D打印

硬件总成本大概在30-80元人民币之间，非常便宜。

安装步骤

1. 准备开发环境

需要安装PlatformIO（ESP32的开发工具链）。推荐用VS Code + PlatformIO插件：

pip install platformio

2. 克隆项目

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

3. 配置WiFi和API

编辑配置文件，填入你的WiFi信息和Claude Code API密钥：

// 在 src/config.h 中修改
#define WIFI_SSID "your_wifi_name"
#define WIFI_PASSWORD "your_wifi_password"
#define CLAUDE_API_KEY "your_api_key"

4. 烧录固件

pio run --target upload

烧录完成后，ESP32会自动连接WiFi并开始获取Claude Code使用数据。

5. 组装

把ESP32和屏幕连接好，放入3D打印的外壳中（如果有的话），插上USB线供电即可。

显示内容

仪表盘屏幕上会显示以下信息：

• Token使用量：当前计费周期内已使用的Token数量
• 费用统计：已产生的API费用
• 使用趋势：简单的使用量趋势图
• 连接状态：WiFi连接和API连接状态

适合谁使用

• Claude Code重度用户：每天大量使用Claude Code，需要实时监控使用量
• 团队管理者：监控团队的API使用情况
• 物联网爱好者：本身就是个有趣的ESP32项目
• 桌面美化爱好者：在桌上放个科技感十足的小仪表盘

技术细节

• 开发框架：Arduino / ESP-IDF
• 屏幕驱动：TFT_eSPI
• 通信方式：WiFi HTTP请求
• 刷新频率：可配置，默认每5分钟更新一次
• 功耗：USB供电，功耗很低

扩展玩法

Clawdmeter是开源的，你可以根据自己的需求修改：

• 修改显示内容，比如加上今天的对话次数、最长对话等
• 修改屏幕样式，换成自己喜欢的UI风格
• 加上LED指示灯，用不同颜色表示使用量级别
• 修改为监控其他AI服务的使用量（如OpenAI API）

项目地址

https://github.com/alexandresebrao/Clawdmeter

对于经常用Claude Code的开发者来说，这个小仪表盘不仅实用，放在桌上也挺有科技感的。硬件成本不高，动手能力强的话周末就能搞定。

本文参考来源：Clawdmeter – GitHub