Ccusage

(Be the first to comment)
ccusage (claude-code-usage)는 로컬 JSONL 파일에서 Claude Code 사용량을 분석해 토큰 소비 패턴과 예상 비용을 파악하도록 돕는 강력한 CLI 도구입니다.0
웹사이트 방문하기

What is Ccusage?

ccusage는 Claude Code 토큰 소비량에 필수적인 투명성을 제공하도록 설계된 강력한 명령줄 인터페이스(CLI) 도구입니다. ccusage는 Claude Code가 생성하는 로컬 JSONL 사용량 파일을 분석함으로써 무제한 요금제 사용자들의 공통적인 문제, 즉 실제 사용량을 수치화하고 비용 유발 요인을 파악하며 구독의 진정한 가치를 평가하는 문제를 해결합니다. 이 도구는 AI 상호작용을 관리하고 최적화하기 위한 상세하고 실행 가능한 보고서를 제공합니다.

주요 기능

저희는 세부적인 정보와 실질적인 통찰력을 제공하여 토큰 사용량 및 지출에 대한 완벽한 가시성을 보장하는 데 중점을 둡니다.

📊 포괄적인 보고서 모음

단순한 일일 총계를 넘어 다양한 관점에서 통합된 사용량에 접근할 수 있습니다. 일별, 주별, 월별 및 세션별 보고서를 통해 장기적인 추세를 추적하고, 어떤 대화나 기간이 가장 높은 소비량을 발생시켰는지 즉시 파악할 수 있습니다. 이러한 세부적인 보기는 소급 사용량 분석에 필수적입니다.

⏰ 5시간 블록 및 실시간 모니터링

Claude의 백엔드 시스템에서 사용되는 특정 5시간 결제 주기 내의 소비량을 추적합니다. 이 독점적인 블록 보고서는 실시간으로 능동적인 모니터링, 비용 예측 및 소모율 계산을 제공하여 조기 경고를 제공하고, 기본 플랫폼 메커니즘에 맞춰 사용량을 관리하는 데 도움을 줍니다.

💰 상세 비용 및 모델 추적

ccusage는 현재 토큰 사용량과 모델별 가격을 기준으로 USD로 예상 비용을 제공합니다. 다양한 Claude 모델(Opus, Sonnet 등) 전반의 사용량을 자동으로 추적하며, 모델별 분석(Model Breakdown) 보기를 제공합니다. 또한, 표준 토큰과 캐시 읽기/생성 토큰을 정확하게 구분하여 순수 운영 비용에 대한 보다 정확한 그림을 제공합니다.

🔒 100% 로컬 및 비공개 분석

귀하의 프라이버시는 최우선입니다. ccusage는 전적으로 오프라인 모드에서 작동하며, Claude Code JSONL 파일을 읽어 귀하의 머신에서 모든 분석을 로컬로 수행합니다. 어떠한 데이터도 전송되거나 귀하의 컴퓨터를 떠나지 않으므로, 사용 패턴에 대한 완벽한 보안과 데이터 주권을 보장합니다.

🚀 초소형 설치 공간 및 즉각적인 접근

많은 복잡한 CLI 도구와 달리, ccusage는 놀랍도록 작은 번들 크기로 설계되었습니다. 효율성에 중점을 둔 덕분에 전체 설치 없이도 도구를 직접 실행할 수 있으며(예: bunx ccusage 사용), 최소한의 설정 오버헤드로 중요한 사용량 데이터에 즉시 접근할 수 있도록 합니다.

활용 사례

ccusage는 원시 사용량 데이터를 전략적 통찰력으로 전환하여 사용자들이 AI 워크플로우에 대해 정보에 기반한 결정을 내릴 수 있도록 합니다.

1. 무제한 요금제에 대한 투자 수익률(ROI) 평가

Max plan을 사용하고 있다면, 월별 및 세션별 보고서를 사용하여 종량제 요금제에서 귀하의 사용량이 얼마의 비용이 발생할지 계산하십시오. 이 비교는 현재 구독 모델이 충분한 가치를 제공하는지 판단하는 구체적이고 정량화 가능한 측정 기준을 제공하여, 요금제를 정당화하거나 조정하는 데 도움이 됩니다.

2. 비용 집약적인 워크플로우 식별

세션 보고서를 활용하여 가장 많은 토큰을 소비하는 특정 프로젝트나 대화 스레드를 정확히 파악하십시오. 이를 모델 추적세부 분석 기능과 결합함으로써, 고비용 세션이 프리미엄 모델(예: Opus)에 불균형적으로 의존했는지 판단하고, 특정 작업에 대해 저비용 모델이 유사한 결과를 달성할 수 있는지 평가할 수 있습니다.

3. 사용자 정의 대시보드에 사용량 데이터 통합

JSON 출력 기능은 모든 통합 분석 결과를 구조화된, 프로그래밍 가능한 형식으로 내보낼 수 있도록 합니다. 개발자와 고급 사용자들은 이 데이터를 내부 모니터링 시스템, 사용자 정의 분석 대시보드 또는 스프레드시트 도구로 직접 파이프하여 더 심층적인 추세 분석과 광범위한 프로젝트 관리 시스템과의 통합을 할 수 있습니다.

차별화된 장점

ccusage는 세부적인 정보와 데이터에 대한 사용자 제어에 중점을 두어 독특한 가치를 제공합니다.

플랫폼 논리에 부합하는 세분화된 보고

우리는 단순한 달력 요약뿐만 아니라, 5시간 블록 보고서를 제공합니다. 이 수준의 세부 정보는 Claude의 기본 결제 주기와 일치하기 때문에 중요하며, 이는 표준 달력 보고서가 놓치는 사용량에 대한 기능적인 이해를 제공합니다.

개발자 생태계를 위한 내장 지원

통합된 모델 컨텍스트 프로토콜(MCP) 서버는 ccusage가 다른 개발자 도구 및 시스템과 원활하게 상호작용할 수 있도록 합니다. 이 기능은 ccusage를 단순한 뷰어가 아니라, 더 큰 툴체인의 능동적인 구성 요소로 자리매김하게 하여 더 깊이 있는 자동화 및 통합을 가능하게 합니다.

유연한 구성 및 시간대 제어

ccusage는 광범위한 구성 옵션을 제공하며, 유효성 검사 및 자동 완성을 위한 IDE 지원을 포함하는 JSON 구성 파일과 유연한 시간대 및 로캘 지원을 포함합니다. 이는 보고서가 귀하의 특정 운영 환경 및 지리적 위치에 따라 정확하게 그룹화되고, 표시되며, 형식화되도록 보장합니다.

결론

ccusage는 Claude Code 소비를 마스터하는 데 필요한 명확성과 제어권을 제공합니다. 불투명한 사용량 데이터를 상세하고 실행 가능한 보고서로 전환함으로써, 워크플로우를 최적화하고, 비용을 정확하게 추적하며, AI 투자의 가치를 극대화할 수 있는 확신을 얻게 됩니다.

오늘 ccusage가 귀하의 사용량을 제어하는 데 어떻게 도움이 되는지 알아보십시오. GitHub에서 도구 및 문서를 확인하십시오.


More information on Ccusage

Launched
Pricing Model
Free
Starting Price
Global Rank
Follow
Month Visit
<5k
Tech used
Ccusage was manually vetted by our editorial team and was first featured on 2025-10-18.
Aitoolnet Featured banner

Ccusage 대체품

더보기 대체품
  1. opcode: Claude Code용 직관적인 데스크톱 GUI입니다. 프로젝트를 시각적으로 관리하고, 맞춤형 AI 에이전트를 생성하며, 비용을 추적하고, 로컬 데이터 제어를 통해 안전하게 개발할 수 있습니다.

  2. Claudia: Claude Code를 위한 우아한 데스크톱 동반자. 아름다운 GUI를 통해 AI 코딩 세션, 에이전트, 사용량까지 간편하게 관리할 수 있습니다.

  3. Desktop Commander MCP는 클로드 데스크톱 앱에서 터미널 명령 실행 및 파일 편집을 직접 수행할 수 있게 해주는 오픈 소스 도구입니다. 클로드와 함께 AI 워크플로우를 더욱 효율적으로 만들어보세요.

  4. runCLAUDErun은 macOS에서 Claude 코드 자동화를 간편하게 만들어줍니다. AI 작업을 예약하고, 로컬 데이터의 개인 정보 보호를 보장하며, 편안하게 잠든 사이에도 모든 작업이 완료된 상태로 아침을 맞이할 수 있습니다.

  5. Claude Context는 AI 코딩 에이전트가 전체 코드베이스 컨텍스트를 완벽하게 활용할 수 있도록 지원합니다. 그 결과, 정확하고 비용 효율적인 코드를 얻고, 토큰 비용을 절감하며 개발 속도를 가속화할 수 있습니다.