Clawdmeter: Màn hình ESP32 32$ theo dõi mức usage Claude Code theo thời gian thực

Một lập trình viên trong cộng đồng r/ClaudeCode vừa chia sẻ một dự án phần cứng thú vị: Clawdmeter — màn hình để bàn nhỏ gọn giúp theo dõi mức sử dụng Claude Code theo thời gian thực, chạy trên bo mạch ESP32 giá chỉ 32$.

Nó làm được gì

Clawdmeter hiển thị hai chỉ số quan trọng mà bất kỳ ai dùng Claude Code nhiều cũng quan tâm: phần trăm usage của phiên hiện tại và phần trăm usage trong tuần. Thay vì phải mở terminal gõ lệnh kiểm tra, bạn chỉ cần liếc qua màn hình nhỏ trên bàn.

Ngoài ra, màn hình còn có chế độ splash screen với hoạt ảnh pixel-art Clawd — linh vật của Claude — tự động thay đổi tốc độ dựa trên mức usage hiện tại. Dùng càng nhiều, Clawd càng "bận rộn".

Hai nút bấm vật lý ở cạnh bên đóng vai trò như phím tắt cho Claude Code: nút trái giữ để kích hoạt voice mode (push-to-talk), nút phải nhấn để chuyển đổi mode (Shift+Tab). Tín hiệu được gửi qua BLE HID, tương thích với bất kỳ cửa sổ nào đang focus trên máy.

Phần cứng

Toàn bộ dự án xoay quanh bo mạch Waveshare ESP32-S3-Touch-AMOLED-2.16 với màn hình AMOLED 480×480, cảm ứng điện dung, có hỗ trợ pin Li-Po rời. Chi phí phần cứng chỉ khoảng 32$, cộng thêm pin và cáp USB-C nếu cần.

Cách nó hoạt động

Luồng dữ liệu khá gọn:

1. Một daemon chạy trên laptop, mỗi 60 giây gọi API của Anthropic — chỉ tốn 1 token Haiku, gần như miễn phí
2. Thông số usage được trích xuất từ response headers (anthropic-ratelimit-unified-5h-utilization và các header liên quan)
3. Daemon gửi JSON payload qua BLE đến ESP32
4. Firmware trên ESP32 parse dữ liệu và cập nhật giao diện LVGL

Firmware còn theo dõi tốc độ thay đổi usage trong cửa sổ 5 phút để chọn nhóm hoạt ảnh phù hợp trên màn hình splash.

Cài đặt nhanh

Tác giả cung cấp script install.sh và flash.sh để thiết lập tự động. Sau khi flash firmware qua PlatformIO, bạn chỉ cần pair Bluetooth một lần và khởi động daemon:

cd firmware
pio run -t upload --upload-port /dev/ttyACM0
./install.sh
systemctl --user start claude-usage-daemon

Toàn bộ mã nguồn có sẵn trên GitHub, bao gồm firmware LVGL, daemon Python, và công cụ chuyển đổi font/icons.

Hạn chế hiện tại

Dự án hiện chỉ hỗ trợ Linux (đã test trên Ubuntu). Hỗ trợ macOS được mô tả là "hoàn toàn khả thi, ngay khi ai đó tạo pull request". Nếu bạn dùng macOS và muốn build BLE stack cho nền tảng này, đây là cơ hội đóng góp tốt.

Tổng kết

Clawdmeter là một ví dụ điển hình cho thấy cộng đồng Claude Code đang mở rộng ra ngoài phần mềm thuần túy. Một thiết bị vật lý nhỏ gọn, giá rẻ, giúp anh em không phải đoán mò xem mình còn bao nhiêu usage — đặc biệt hữu ích khi làm việc với nhiều phiên Claude Code song song.