字?jǐn)?shù) 1467，閱讀大約需 8 分鐘
這兩年 AI 編程工具越來(lái)越多，但大多數(shù)使用狀態(tài)仍然停留在軟件界面里。
Clawdmeter 有意思的地方，是它把 Claude Code 的使用量提醒做成了一塊實(shí)體桌面儀表盤。它不是一個(gè)宏大的硬件平臺(tái)，也不是復(fù)雜的開(kāi)發(fā)板教程，而是一個(gè)邊界很清楚的小項(xiàng)目：用 ESP32 小屏顯示 Claude Code 的當(dāng)前會(huì)話用量和周用量，再通過(guò)藍(lán)牙和電腦同步。
Clawdmeter 的目標(biāo)很直接：做一個(gè)放在桌上的 Claude Code 使用情況顯示器。
它主要運(yùn)行在 Waveshare 的 ESP32-S3-Touch-AMOLED-2.16 這類帶觸摸 AMOLED 屏的開(kāi)發(fā)板上，倉(cāng)庫(kù)也已經(jīng)列出 2.16 英寸、1.8 英寸以及 ESP32-C6 版本的板級(jí)支持。固件側(cè)使用 Arduino 框架、LVGL、NimBLE 和 ArduinoJson，整體更像一個(gè)可落地的桌面小設(shè)備，而不是只停留在原理驗(yàn)證的 demo。
界面上，它會(huì)顯示當(dāng)前 session 的使用百分比、每周使用百分比以及重置時(shí)間。屏幕還有一個(gè) Clawd 像素動(dòng)畫(huà)，使用率變高時(shí)，動(dòng)畫(huà)狀態(tài)也會(huì)變得更忙碌。
這類設(shè)計(jì)有點(diǎn)巧。它沒(méi)有把信息做得很復(fù)雜，而是把“我現(xiàn)在用到哪里了”這個(gè)狀態(tài)從命令行和網(wǎng)頁(yè)里拿出來(lái)，變成一個(gè)隨手可見(jiàn)的物理反饋。
從 README 描述看，Clawdmeter 由兩部分組成：電腦側(cè) daemon 和 ESP32 固件。
電腦側(cè) daemon 會(huì)讀取 Claude Code 的 OAuth 憑據(jù)，然后周期性發(fā)起一個(gè)很小的 API 請(qǐng)求，從響應(yīng)頭里取出 Claude 使用限制相關(guān)字段。隨后 daemon 通過(guò) BLE 把整理后的 JSON 數(shù)據(jù)寫入 ESP32 的 GATT 特征值，固件解析后刷新 LVGL 儀表盤。
這個(gè)鏈路對(duì)嵌入式學(xué)習(xí)者也有參考價(jià)值。它不是單點(diǎn)技術(shù)，而是把桌面系統(tǒng)服務(wù)、藍(lán)牙連接、GATT 數(shù)據(jù)通道、屏幕 UI、觸摸交互和物理按鍵串在一起。
更細(xì)一點(diǎn)看，項(xiàng)目還把側(cè)邊按鍵做成了 BLE HID 鍵盤輸入。左鍵可以發(fā)送 Space，用于 Claude Code 語(yǔ)音模式的按住說(shuō)話；右鍵可以發(fā)送 Shift+Tab，用于模式切換。也就是說(shuō)，這塊小屏不只是顯示器，還順手變成了一個(gè)很輕量的 Claude Code 控制器。
我推薦這個(gè)項(xiàng)目，不是因?yàn)樗夹g(shù)棧多，而是因?yàn)樗龅搅恕巴暾薄?/span>
它有可看的 UI，有實(shí)際硬件適配，有 macOS 和 Linux 安裝腳本，有固件燒錄流程，也有板級(jí)移植文檔。倉(cāng)庫(kù)里的 porting 文檔把板級(jí)適配拆成 display、touch、input、power、imu、caps 等幾個(gè) HAL 模塊，新板子主要通過(guò)新增 board 文件夾和 PlatformIO env 接入，共享的 main、ui、splash 邏輯盡量不動(dòng)。
這對(duì)想練工程組織的人很有價(jià)值。很多 ESP32 小項(xiàng)目能跑起來(lái)，但代碼會(huì)逐漸和某一塊板子綁死。Clawdmeter 的結(jié)構(gòu)至少在方向上是清楚的：公共邏輯做公共邏輯，板級(jí)差異放到板級(jí)目錄。
另外，它也不是只關(guān)注“顯示一個(gè)數(shù)字”。項(xiàng)目里有藍(lán)牙連接狀態(tài)、bond reset、屏幕切換、動(dòng)畫(huà)輪播、字體轉(zhuǎn)換、Lucide 圖標(biāo)轉(zhuǎn)換、CJK 字體支持說(shuō)明，這些細(xì)節(jié)讓它更像一個(gè)真正被使用過(guò)的桌面設(shè)備。
最后總結(jié)一下，Clawdmeter 的價(jià)值不在于把用量數(shù)字顯示出來(lái)這件事本身，而在于它把一個(gè)軟件工作流里的隱性狀態(tài)，做成了可觸摸、可觀察、可擴(kuò)展的桌面設(shè)備。
如果你平時(shí)就用 Claude Code，又喜歡 ESP32 小屏、BLE 和實(shí)體工具感，這個(gè)項(xiàng)目可以收藏。它不會(huì)替你寫代碼，但會(huì)讓你看到：AI 編程工具周邊，也可以做得很工程、很具體。
