ccusage/ccusage

어떤 프로젝트인가요?

핵심 기능

• 01일별, 주별, 월별 및 세션별 사용량 보고서
• 02여러 코딩 에이전트 CLI의 데이터를 하나의 보고서로 통합
• 03Claude Code의 5시간 과금 구간 추적
• 04JSON 출력과 날짜, 시간대 및 프로젝트 필터
• 05캐시된 가격을 사용하는 오프라인 모드와 모델별 가격 재정의

활용 사례

• 이번 달 AI 코딩 에이전트에 지출한 비용 확인
• Claude Code, Codex 및 다른 에이전트 도구의 토큰 사용량 비교
• 추가 분석이나 대시보드를 위해 사용량 데이터를 JSON으로 내보내기
• Claude Code의 5시간 과금 구간별 사용량 모니터링

빠른 시작

1. 1

   npx로 ccusage 실행(설치 불필요)

   npx ccusage@latest
2. 2

   bunx로 Claude Code 일일 보고서 표시

   bunx ccusage claude daily

사용 전 알아둘 점

• !라이선스가 명확히 확인되지 않았으므로(NOASSERTION), 상업적으로 사용하기 전에 LICENSE 파일을 확인하세요.
• !비용은 가격 데이터를 기반으로 한 추정치입니다. README에 따르면 --offline을 사용하지 않는 경우 가격 정보를 가져오는 데 네트워크 액세스가 필요할 수 있습니다.
• !statusline 기능은 베타로 표시되어 있습니다.

토픽

자주 묻는 질문

ccusage은(는) 무엇인가요?

Claude Code, Codex 같은 코딩 에이전트 도구의 로컬 데이터를 분석해 토큰 사용량과 예상 비용을 보여주는 CLI입니다. ccusage는 코딩 에이전트 CLI가 로컬 머신에 저장한 사용량 데이터를 읽어 토큰 사용량과 비용 보고서로 정리합니다. 결과를 일별, 주별, 월별 또는 세션별로 묶어 볼 수 있으며, Claude Code의 5시간 과금 구간 보기 기능도 제공합니다. Claude Code, Codex, OpenCode, Amp, Gemini CLI, GitHub Copilot CLI 등 폭넓은 데이터 소스를 지원합니다.

ccusage은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

ccusage은(는) Other 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

ccusage은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. ccusage의 마지막 커밋은 2026년 10월 20일입니다.

ccusage은(는) 어디에 사용할 수 있나요?

이번 달 AI 코딩 에이전트에 지출한 비용 확인 Claude Code, Codex 및 다른 에이전트 도구의 토큰 사용량 비교 추가 분석이나 대시보드를 위해 사용량 데이터를 JSON으로 내보내기 Claude Code의 5시간 과금 구간별 사용량 모니터링

ccusage는 어떻게 설치하나요?

npx로 ccusage 실행(설치 불필요): npx ccusage@latest bunx로 Claude Code 일일 보고서 표시: bunx ccusage claude daily

ccusage은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/ccusage/ccusage