Claude Code 사용량 및 속도 제한을 실시간으로 모니터링하는 하드웨어 장치

커뮤니티 반응

작성자가 직접 제작한 하드웨어 결과물에 대해 긍정적인 반응이며, 실용적인 도구라는 평가를 받고 있다.

합의점 vs 논쟁점

합의점

터미널에서 매번 사용량을 확인하는 것이 번거롭다는 점에 공감함
보안을 위해 토큰을 암호화하여 저장하는 방식이 적절함

실용적 조언

Claude Code 사용량이 많아 제한에 자주 걸린다면 ESP32 보드를 활용해 전용 모니터를 구축해볼 것
GitHub 저장소(oauramos/claude-usage-stick)에서 소스 코드를 내려받아 직접 펌웨어를 업로드할 수 있음

섹션별 상세

Anthropic API를 주기적으로 폴링하여 Claude Code의 사용량 데이터를 수집한다. ESP32 보드가 Wi-Fi를 통해 API 서버에 직접 요청을 보내고, 응답받은 5시간 및 7일 단위의 사용량 윈도우 정보를 파싱하여 LCD 화면에 막대 그래프 형태로 출력한다. 이를 통해 사용자는 PC 터미널을 확인하지 않고도 현재 남은 할당량을 즉시 파악할 수 있다.

M5StickC Plus 기기 화면에 Claude 사용량(5시간 및 7일 윈도우)이 표시된 모습 — Photo실제 제작된 하드웨어가 Anthropic API로부터 데이터를 받아 5시간 윈도우(44%)와 7일 윈도우(3%) 사용량을 막대 그래프로 보여주는 대시보드를 확인할 수 있다. 리셋까지 남은 시간(2h 00m, 2d 15h)과 배터리 상태(100%) 등 구체적인 UI 구성이 포함되어 있다.

보안을 위해 OAuth 토큰을 기기 내부에 AES-256-GCM 방식으로 암호화하여 저장한다. 사용자가 설정한 PIN 번호를 기반으로 암호화가 수행되며, 해당 PIN은 기기에 별도로 저장되지 않아 물리적 탈취 시에도 토큰 유출 위험을 최소화했다. 초기 설정은 스마트폰을 통한 캡티브 포털(Captive Portal) 방식으로 구현하여 사용자 편의성을 높였다.

M5StickC Plus와 LilyGo T-Display S3 등 저렴한 상용 ESP32 개발 보드를 지원한다. 하드웨어 버튼을 통해 화면 밝기 조절, 수동 새로고침, 공장 초기화 기능을 제어할 수 있으며 배터리 잔량과 Wi-Fi 신호 강도도 대시보드에 함께 표시된다. 전체 프로젝트는 MIT 라이선스로 GitHub에 공개되어 누구나 재현 가능하다.

용어 해설

요청 속도 제한(Rate Limit): — API 서버가 특정 시간 동안 처리할 수 있는 요청의 최대 횟수이다. Anthropic API는 5시간 및 7일 단위의 사용량 창을 통해 이를 관리하며, 한도를 초과하면 일정 시간 동안 모델 사용이 제한된다.
ESP32 마이크로컨트롤러(ESP32): — Wi-Fi와 블루투스 기능이 내장된 저전력, 저비용 시스템 온 칩(SoC)이다. 이 프로젝트에서는 Anthropic API와 통신하여 사용량 데이터를 수집하고 LCD 화면에 출력하는 하드웨어 제어 장치로 사용됐다.
AES-256-GCM 암호화(AES-256-GCM): — 데이터의 기밀성과 무결성을 동시에 보장하는 고급 암호화 표준 방식이다. 사용자의 OAuth 토큰을 기기 내부에 안전하게 저장하기 위해 사용되며, PIN 번호를 통한 복호화 과정을 거친다.

언급된 도구

M5StickC Plus추천

사용량 표시를 위한 LCD 내장 ESP32 개발 보드

LilyGo T-Display S3추천