Clawdmeter 是一款小巧却充满巧思的开源硬件项目——它把一块 ESP32-S3 触控 AMOLED 屏幕变成你桌面上的「Claude Code 使用实时看板」。当你在笔记本上用 Claude Code 编程、写文档或调试时，它默默通过蓝牙连接，实时显示当前的 API 调用频次、响应延迟等关键指标；更妙的是，它用像素风小爪子（Clawd）动画直观反映使用强度：越忙，小爪子跳得越欢！它不只是显示器，更是开发者工作流中一个有温度、有反馈的实体伙伴。
核心功能
- 实时用量可视化：精准显示 Claude Code 当前会话的请求次数、平均响应时间及活跃度趋势，告别“黑盒式调用”
- 动态像素艺术反馈：基于 claudepix 开源像素库，生成 8-bit 风格 Clawd 动画——用量低时慵懒踱步，高频调用时满屏翻滚跳跃，让数据“活”起来
- 一键快捷控制：左右侧物理按键直连 BLE HID 协议，左键发送
Space（唤醒 Claude Code 语音模式），右键发送Shift+Tab（快速切换对话/代码模式） - 三模智能交互界面：支持 Splash（开机动画）、Usage（数据仪表盘）、Bluetooth（连接状态）三屏循环切换，轻按中间电源键即可切换，触控任意区域返回主屏
- 即插即用蓝牙配对：无需额外驱动，自动与 macOS / Windows 笔记本建立低功耗蓝牙连接，稳定传输 HID 指令与用量数据
- 全开源可定制固件：C 语言编写，模块清晰（BLE、AMOLED 驱动、动画引擎、HTTP 状态轮询），支持修改主题色、添加自定义 API 监控逻辑或扩展新快捷键
适合哪些人用
如果你是 Claude Code 的深度使用者——比如 AI 辅助编程的工程师、技术写作爱好者、教育工作者，或单纯喜欢用实体设备掌控数字工具的极客，Clawdmeter 就是为你而生。它不替代软件，而是补足「注意力闭环」：让你一眼看清自己和 AI 的协作节奏，避免无意识刷屏式提问；同时用物理按键降低操作路径长度，把常用功能从键盘组合键解放到指尖一按。哪怕你刚接触嵌入式开发，它也是学习 ESP32 + BLE + 图形驱动的绝佳入门项目。
快速上手
项目已预编译好固件，新手可直接刷写：
① 下载最新 firmware.bin（见 GitHub Releases）；
② 使用 esptool 命令行工具烧录（推荐命令：esptool.py --chip esp32s3 -p [端口号] -b 460800 --before=hard_reset --after=hard_reset write_flash --flash_mode dio --flash_size detect --flash_freq 80m 0x0 firmware.bin）；
③ 上电后长按中间 PWR 键进入 Usage 模式，确保笔记本已开启蓝牙并信任该设备；
④ 打开 Claude Code 应用，开始编码——你的桌面小爪子将立刻同步心跳！进阶用户可参考 README 修改 config.h 中的 API 端点、刷新间隔或动画帧率。
项目信息
HermannBjorgvin/Clawdmeter
GitHub
ESP32 desk dashboard that shows Claude Code usage
920
Stars
75
Forks
C
—
编程语言：C｜Star 数：920｜开源协议：未明确声明（作者鼓励自由使用与衍生）｜GitHub 项目地址
它用一块屏幕、几行代码和一只像素小爪子，把 AI 编程从「看不见的云端服务」变成了你桌上会呼吸、会回应、有个性的数字搭档。
