Claude Code 사용량, 리셋 예측, 컨텍스트 비율을 실시간으로 보여주는 모드 제작

맨날 사용량 확인하는 거 진짜 귀찮았거든. 설정 들어가서 확인하고, 사용량 페이지 보고, /usage 쳐보고, 아니면 컨텍스트 사용량 표시되는 작은 원형 아이콘 계속 쳐다보고 있었음. 게다가 컨텍스트 엄청 쌓여서 한도 팍팍 깎일 때까지 컴팩트(compact)하는 것도 맨날 까먹고. 그러다 어제 Claude Mods 기능 나온 거 보고, 프롬프트 위에 딱 붙어서 한눈에 다 보여주는 헬퍼 하나 만들었음. 데스크탑 앱에서 Claude Code 쓰면서 진작 있었으면 했던 기능들 다 때려 박았다 (터미널에서도 잘 돌아감).

이게 보여주는 것들:

• 5시간 및 주간 사용량: 앱 자체의 플랜 사용량 제한 패널이랑 똑같이 나옴 (계정 전체 사용량이라 채팅이랑 Cowork 사용량 다 포함됨)

• 리셋 시점 예상치: 평소 내 사용 속도를 학습해서, 컨텍스트 잠깐 튀었다고 호들갑 안 떰. 한도 다 떨어질 것 같으면 대충 언제쯤 바닥날지 알려줌.

• 컨텍스트 윈도우 %: /context 명령어처럼 메시지, 도구, 기타 항목별로 세부 분석해서 보여줌.

• 컴팩트 버튼: 자동 컴팩트 기능도 있는데, 원하는 % 설정 가능 (기본값 30%, 15%에서 99%까지 설정 가능). 세션마다 따로 설정되고 새 세션에선 기본적으로 꺼져 있어서, 큰 기능 만들 때는 컨텍스트 유지하고, 필요 없을 땐 자주 컴팩트해서 토큰 아끼면 됨.

기존 채팅이나 세션 열면 바로 로드되고, 한 줄로 접어놔도 사용량 정보랑 타이머는 다 보임. /quota 치면 껐다 켰다 할 수 있음. 다크/라이트 테마 다 지원하고, 데스크탑 앱에서 테마 바꾸면 알아서 따라감. 데스크탑 앱에서 창 제일 좁게 줄여도 다 잘 나옴.

이건 로컬에서 돌아가고 Claude Code가 이미 가지고 있는 데이터(컨텍스트 데이터랑 응답마다 따라오는 사용량 데이터)만 읽어옴. 2분마다 한 번씩 기존 로그인 정보로 서버에 /usage랑 /context 호출해서 데이터 최신으로 유지하는데, 특히 컨텍스트 세부 데이터는 이게 제일 정확함. 네트워크 호출은 이게 전부임. 자격 증명 같은 건 절대 안 건드림. MIT 라이선스고 파일도 거의 하나라 설치하기 전에 코드 한번 훑어봐라.

알려진 한계: 메시지 보내기 전인 데스크탑 'Welcome back' 화면에서는 세션이 없어서 표시 안 됨. 그리고 아직 v0.1.3이라 좀 투박할 수 있음.

Claude Code 안에서 설치: