프로젝트 소개

ccusage는 로컬에 저장된 데이터에서 코딩 에이전트 CLI의 토큰 사용량과 비용을 분석하는 명령줄 도구입니다. npx, bunx, pnpm dlx 또는 Nix와 같은 패키지 러너를 통해 설치 없이 실행되며, 일별, 주별, 월별, 세션 및 5시간 청구 블록 보고서를 생성합니다. 지원되는 소스에는 Claude Code, Codex, OpenCode, Amp, Droid, Codebuff, Hermes Agent, pi-agent, Goose, OpenClaw, Kilo, Kimi, Qwen, GitHub Copilot CLI, Gemini CLI, Antigravity, Grok Build CLI 및 ZCode가 포함됩니다. 각 소스에는 전용 하위 명령이 있습니다(예: `ccusage claude daily` 또는 `ccusage codex daily`). 반면 `ccusage daily`, `weekly`, `monthly`, `session`은 감지된 모든 소스를 하나의 보고서로 집계합니다. `--by-agent` 옵션은 통합 보고서를 에이전트별로 그룹화하고, `--sections`는 포함할 보고서 섹션을 선택합니다. 보고서 기능에는 모델별 추적 및 비용 분석, 캐시 생성 및 캐시 읽기 토큰 열, `--since` 및 `--until`을 사용한 날짜 필터링, `--last`를 사용한 최근 기간 단축키, 시간대 선택, 사용자 지정 로컬 데이터 경로, `--instances` 및 `--project`를 통한 Claude Code 프로젝트 그룹화가 포함됩니다. 출력은 반응형 컬러 테이블로, 좁은 터미널에서는 컴팩트 레이아웃으로 전환되며, 스크린샷을 위해 `--compact` 플래그로 강제할 수 있습니다. `--json`으로 구조화된 JSON 내보내기가 가능하며, `--no-cost`로 비용 열과 JSON 비용 필드를 숨길 수 있습니다. 가격은 사전 캐시된 데이터에서 오프라인으로 사용할 수 있으며, 모델별 가격은 재빌드 없이 `ccusage.json` 구성 파일에서 재정의할 수 있습니다. 구성 파일은 IDE 자동 완성 및 검증과 함께 기본값 설정도 허용합니다. 상태 표시줄 모드는 Claude Code 상태 표시줄 훅을 위한 컴팩트 디스플레이를 제공하며 Beta로 표시됩니다. 이 프로젝트는 TypeScript로 작성되었으며 npm으로 배포되고, Nix flake가 기본 패키지 및 앱으로 도구를 노출합니다. 개발은 nix-direnv 및 `just` 레시피를 사용한 Nix flake 개발 환경에서 포맷, 테스트 및 검사를 수행합니다. LiteLLM 가격 스냅샷은 flake lock을 통해 고정되고 예약된 워크플로로 새로 고쳐집니다. 저장소는 MIT 라이선스입니다.