출처
- 원문: https://discuss.pytorch.kr/t/clawdmeter-claude-code-esp32/11186
- 작성자: 9bow
- 원문 보존: raw source:
web-2026-07-11-pytorchkr-topic-11186-clawdmeter-claude-code-esp32
개요
Clawdmeter는 Claude Code의 5시간 세션 한도와 주간 사용률을 책상 위 작은 화면에 표시하는 ESP32 기반 오픈소스 가젯이다. Hermann Björgvin이 책상용으로 만든 프로젝트로, Waveshare ESP32-S3/C6 Touch AMOLED 보드와 컴퓨터를 블루투스로 연결한다. 호스트 데몬이 Claude Code OAuth 토큰으로 Anthropic API에 최소 호출을 보내 응답 헤더의 사용률을 읽고, 60초마다 BLE를 통해 펌웨어에 전달한다.
핵심 포인트
- 사용량 표시: 화면을 탭하면 대기 화면과 세션·주간 사용률 화면을 전환할 수 있다.
- 상태 기반 픽셀 아트: 최근 5분 동안 세션 사용률이 증가하는 속도를 추적해 Clawd 대기 애니메이션의 분위기 그룹을 바꾼다. 스프라이트는
claudepix라이브러리에서 가져왔다. - 물리 버튼 단축키: 양옆의 버튼은 BLE HID 키보드 입력으로
Space와Shift+Tab을 보내 Claude Code 음성 모드와 모드 전환에 사용할 수 있다. - 호스트 데몬과 BLE 전송: 데몬은 macOS 키체인, Linux의
~/.claude/.credentials.json, Windows의%USERPROFILE%\\.claude\\.credentials.json에서 OAuth 토큰을 읽고,api.anthropic.com/v1/messages의 응답 헤더에서anthropic-ratelimit-unified-5h-utilization같은 사용률 값을 가져온다. 이후 JSON을 BLE GATT 특성으로 보내면 펌웨어가 LVGL 대시보드를 갱신한다. - 보드 확장성: Waveshare ESP32-S3/C6 Touch AMOLED 2.16인치와 1.8인치 보드 네 종을 기본 지원하며, 보드별 폴더로 나뉜 얇은 HAL 구조를 사용해 다른 보드로 포팅할 여지를 둔다.
- 설치 환경: Linux(Ubuntu 테스트), macOS, Windows 10/11을 지원한다. PlatformIO CLI와 활성 Claude Code 구독이 필요하며, Linux는 systemd 사용자 서비스, macOS는 LaunchAgent, Windows는 네이티브 시스템 트레이 앱으로 데몬을 실행한다.
왜 중요한가
Clawdmeter는 터미널에서 확인하던 Claude Code 사용량 정보를 별도 화면에 상시 표시해, 세션·주간 한도를 확인하는 인터페이스를 책상 위 물리 장치로 옮긴 사례다. 호스트 데몬, Anthropic 응답 헤더, BLE GATT, LVGL 화면, BLE HID 버튼을 조합해 사용량 표시와 Claude Code 단축키 입력을 한 장치에 묶었다. 원문은 성능 비교나 별도의 보안 평가보다는 프로젝트 구조, 동작 흐름, 지원 환경과 설치 방법을 소개한다.
후속으로 볼 링크와 키워드
- GitHub 저장소: https://github.com/HermannBjorgvin/Clawdmeter
- 보드 포팅 문서: https://github.com/HermannBjorgvin/Clawdmeter/blob/main/docs/porting/adding-a-board.md
- 애니메이션 스프라이트: https://claudepix.vercel.app
- 관련 위키: moc-claude-code, 2026-07-10-pytorchkr-claude-usage
- 관련 원문: ccusage, MimiClaw, ElatoAI
- 키워드:
ESP32-S3,ESP32-C6,AMOLED,BLE GATT,BLE HID,LVGL,OAuth token,Anthropic rate limit headers,PlatformIO,systemd,LaunchAgent