나의 Claude Code 통계를 보여주는 작은 데스크 배지

재미 삼아 무언가를 만들어 왔는데, 이 커뮤니티 분들이 좋아하실 것 같아 가져왔습니다: ccstats는 당신의 Claude Code 세션을 실시간 통계로 변환하여 책상 위에 놓인 작은 배지에 표시해 줍니다 (하드웨어가 없다면 조금 덜 세련된 웹 대시보드로도 볼 수 있습니다). 이 프로젝트는 셀프 호스팅(self-hosted) 방식이며 오픈 소스입니다. Repo: https://github.com/eksdeexD/ccstats

이것은 무엇인가
작은 Linux 측 파이프라인이 cron에 따라 Claude Code 세션 트랜스크립트(transcripts)를 스크래핑하고, 수많은 통계를 계산하여 내구성이 있는 SQLite 원장(ledger)에 저장합니다. 덕분에 Claude Code가 오래된 트랜스크립트를 정리하더라도 전체 합계가 유지됩니다. 완성된 수치는 토큰 기반 인증(token-gated) HTTPS를 통해 JSON으로 제공되며, WiFi에 연결된 배지는 이를 그리기만 합니다. 배지는 수치 계산을 전혀 하지 않으며, 서버가 모든 연산을 수행합니다. 세션 트랜스크립트의 어떤 내용도 작업 중인 기기를 떠나지 않으며, 오직 컴파일된 통계 데이터만 전송됩니다.

표시되는 통계
제가 궁금했지만 한곳에서 볼 수 없었던 여러 항목들이 있습니다:

• 다음 리셋까지의 카운트다운을 포함한 세션 및 주간 사용량 제한 (몇 분마다 업데이트)
• 토큰 사용량 (캐시가 없는 입력+출력 관점 포함)
• 당신의 일간/주간 리듬 - 실제로 작업하는 시간 (올빼미형 등)
• 입력한 단어 및 문자 수, 프롬프트 횟수, 스트릭(streaks)
• 프로젝트별 및 도구별 세부 내역
• 비용 추정치 (현재 API 가격 기준)

취향에 맞게 조정할 수 있도록 여러 가지 색상 팔레트와 디스플레이 옵션이 제공되며, 다양한 아바타도 선택할 수 있습니다.

내 책상 위의 Tufty
내 책상 위에는 약 50파운드 상당의 Badgeware Tufty 2350 장치가 놓여 있으며, 상태 변화에 따라 단 몇 초의 지연 시간만 두고 반응하는 실시간 애니메이션 아바타가 작동 중입니다. 이는 작업 중(working) / 유휴(idle) / 대기(waiting) 상태를 보여줍니다. 실시간 상태를 가져오기 위해 서버는 초당 몇 번씩 트랜스크립트와 함께 Claude API로 향하는 각 세션의 실시간 트래픽을 모니터링하여 당신이 실제로 무엇을 하고 있는지 파악합니다. 에디터에서 설정할 것은 아무것도 없습니다. 그 후에는 버튼을 통해 순환하며 볼 수 있는 약 21개의 통계 화면이 나타납니다.

아바타는 하루 중 가장 많은 프롬프트를 입력했을 때와 같이 새로운 스트릭 (streak)이나 마일스톤 (milestone)에 도달했을 때 축하를 해주기도 하며, 열려 있는 질문에 응답하지 않으면 잔소리를 하기도 합니다. 애니메이션이 포함된 실제 하드웨어가 "데모 모드 (Demo Mode)"로 작동하는 짧은 영상은 다음을 참조하세요 - https://imgur.com/a/mkZL1o4.

한 대 이상의 기기: CCSTATS는 여러 대의 기기, 예를 들어 집의 워크스테이션과 원격 서버를 아우를 수 있습니다. 추가되는 각 기기는 세션별 사용량을 메인 서버로 전송하며, 서버는 이를 하나의 통합된 총합으로 합산합니다. 따라서 통계가 여러 기기에 분산되지 않고 사용자를 따라다니게 됩니다.

"VERSUS 모드": 동일한 파이프라인 (pipeline)을 실행 중인 친구와 대결할 수 있는 선택적인 헤드 투 헤드 (head-to-head) 경쟁 모드도 있습니다. 대결 화면과 트로피까지 제공됩니다.

제작 방식: 서버 파이프라인, 웹 대시보드 (web dashboard), 그리고 MicroPython 배지 펌웨어 (firmware)를 포함한 전체 시스템이 Claude Code로 구축되었으며, 솔직히 그것이 이 프로젝트가 존재하는 이유의 절반입니다. 픽셀 단위로 완벽한 디자인을 독특한 마이크로컨트롤러 (microcontroller)로 포팅하고, 그리드에 정확한 폰트를 구현하며 기기 내 드로잉 (on-device drawing) 시 발생하는 문제들을 해결하고, 서버를 연결하는 과정은 보통 "아, 펌웨어 부분은 너무 힘들어"라며 포기하게 되는 사이드 프로젝트의 전형적인 모습입니다. 하지만 Claude Code 덕분에 과정 내내 즐거움을 유지할 수 있었고, 약 805개의 프롬프트와 60.2K 단어를 사용한 끝에 결과물에 진심으로 만족하고 있습니다.

직접 시도해 보세요:
코드: https://github.com/eksdeexD/ccstats (GPLv2 — 하드웨어 없이 서버 전용 대시보드만 설치하여 작동 가능)
배지: https://badgewa.re/

서버를 설정할 때 가장 빠른 방법은 말 그대로 다음과 같습니다: 저장소를 클론 (clone)하고, 해당 저장소에서 Claude Code를 연 뒤, "README.md를 읽고 설정해줘"라고 말하는 것입니다. 나머지는 Claude가 처리합니다. 배지 펌웨어의 경우도 마찬가지이며, Claude가 문제없이 처리할 것입니다. 지침이 포함되어 있으며, 변경을 원할 경우를 대비해 Claude를 위한 유용한 메모도 준비되어 있습니다.

제출자: /u/Zapador [link] [comments]