TL;DR

  • Claude Usage Monitor는 네이티브 윈도우 앱으로 Claude Code 세션 정보와 Anthropic 계정 사용량을 한눈에 표시함.
  • 5시간·7일 사용량과 초기화 카운트다운, 현재 세션, 모델·노력 수준, 토큰 및 컨텍스트 창 사용량을 제공함.
  • C11과 Win32로 작성됐으며, 외부 라이브러리·런타임·설치 프로그램 없이 단일 실행 파일로 동작함.
  • Claude Code의 로컬 세션 파일을 읽고 Anthropic 사용량 서비스에 연결하며, 대화 내용이나 OAuth 자격 증명을 수집·전송·저장하지 않음.
  • 첫 실행 시 필요하면 Claude Code 상태 표시줄을 설정하고, 기존 설정 파일을 수정하기 전에 백업함.

Claude Usage Monitor

  • 버전 1.0.0의 네이티브 윈도우 모니터로 Claude Code 사용량, 세션 토큰, 컨텍스트 창, Anthropic 계정 한도를 표시함.
  • Claude Code 실행 중 필요한 정보를 제공함.
  • 5시간 사용량과 초기화 카운트다운
  • 7일 사용량과 초기화 카운트다운
  • 현재 Claude Code 세션
  • 입력·출력·캐시 생성·캐시 읽기 토큰
  • 현재 컨텍스트 창 사용량
  • 현재 모델과 노력 수준
  • Anthropic 계정 수준 사용 한도
  • Claude Code 상태 표시줄 자동 설치
  • 단일 네이티브 윈도우 실행 파일로 동작

왜 또 다른 Claude 사용량 모니터인가?

  • Claude 사용량 모니터는 이미 많지만, 이 앱은 의도적으로 다른 접근을 취함.
  • C11로 작성된 소형 네이티브 윈도우 애플리케이션이며 Win32를 사용함.
  • Python, Node.js, Electron, 설치할 런타임, 타사 라이브러리, 원격 분석, 클라우드 서비스를 사용하지 않음.
  • 실행 파일을 내려받아 실행하는 방식임.

작동 방식

  • 컴퓨터에 저장된 Claude Code 로컬 세션 데이터를 읽어 현재 세션 정보를 표시함.
  • Anthropic에 요청할 때 Claude Code가 이미 관리하는 자격 증명을 사용하며, 별도 자격 증명 사본을 만들거나 관리하거나 저장하지 않음.
  • 계정 수준 사용량과 초기화 정보는 Anthropic 사용량 서비스에서 가져옴.
  • 대화 내용은 어디에도 전송하지 않음. 로컬 Claude Code JSONL 파일을 컴퓨터에서 직접 읽어 세션 통계를 추출하며, 대화 내용은 수집하거나 전송하지 않음.
  • 소스 코드를 확인할 수 있음.

설치

  • 최신 릴리스를 내려받아 ClaudeUsageMonitor.exe를 실행함.
  • 첫 실행 시 필요한 경우 Claude Code 상태 표시줄을 자동으로 설정함.
  • Claude Code 설정을 변경하기 전에 기존 설정 파일을 백업함.
  • 설치 프로그램은 필요하지 않음.
  • 실행 파일에 디지털 서명이 없어 처음 실행할 때 Windows SmartScreen 경고가 표시될 수 있음. 이는 평판 경고이며, 앱에 설치 프로그램이나 추가 소프트웨어가 필요하다는 뜻은 아님.
  • 보안을 위해 이 GitHub 저장소에서만 릴리스를 내려받아야 함.

요구 사항

  • Windows 10 이상
  • Claude Code
  • Claude Usage Monitor는 Claude Code의 로컬 세션 및 설정 형식에 의존하며, 이 형식은 Claude Code 릴리스에 따라 변경될 수 있음.

문제 해결

  • 모니터를 시작한 뒤 Claude Code 상태 표시줄이 나타나지 않으면 Claude Code를 다시 시작함.
  • 모니터는 Claude Code 설정만 변경하며, 재시작하면 업데이트된 설정이 로드됨.

표시 정보

  • 계정 수준 사용 한도와 현재 Claude Code 세션을 함께 표시함.

계정 사용량

  • 5시간 사용량
  • 5시간 초기화 시각
  • 7일 사용량
  • 7일 초기화 시각

현재 세션

  • 모델
  • 노력 수준
  • 입력 토큰
  • 출력 토큰
  • 캐시 생성 토큰
  • 캐시 읽기 토큰
  • 현재 사용 중인 총 컨텍스트
  • Claude Code가 실행 중이 아닐 때도 계정 사용량을 계속 표시할 수 있음.
  • 계정 사용량과 세션 토큰 수는 서로 다른 데이터 소스에서 가져오므로 직접 대응할 것으로 기대해서는 안 됨.

개인정보 보호

  • Claude Usage Monitor는 데이터를 로컬에 유지하도록 설계됨.
  • 원격 분석을 수집하지 않음
  • 계정이 필요하지 않음
  • 대화 내용을 수집하거나 전송하지 않음
  • Anthropic OAuth 자격 증명 사본을 유지하거나 저장하지 않음
  • Claude Code의 로컬 파일을 직접 읽음
  • 계정 수준 할당량 정보에 Anthropic 사용량 엔드포인트를 사용함
  • 전체 소스 코드가 포함돼 있어 동작을 직접 확인할 수 있음.

소스에서 빌드

  • 프로젝트는 C11로 작성됐으며 네이티브 Win32를 대상으로 함.
  • Visual Studio 2022로 빌드할 수 있음.
  • 외부 라이브러리는 필요하지 않음.

프로젝트 상태

  • 대형 데스크톱 애플리케이션을 실행하지 않고 Claude Code의 동작을 간단히 확인하려는 필요에서 만든 소형 유틸리티임.
  • 모든 기능을 갖춘 대시보트를 지향하지 않음.
  • Claude Code가 현재 사용하는 정보를 알려주는 소형 윈도우 실행 파일이 필요한 경우를 위한 프로젝트임.

라이선스

  • Claude Usage Monitor는 MIT 라이선스로 배포됨.
  • MIT 라이선스는 Claude Usage Monitor 소스 코드에 적용됨. Claude Code, Anthropic API, Anthropic 상표 또는 기타 타사 소프트웨어나 서비스에 대한 권리를 부여하지 않음.