CCUsage에서 비용보다 먼저 봐야 할 세 가지

Claude Code에는 분석만 맡기고 로컬 기록은 밖으로 보내지 않습니다. 다음은 예시 세션입니다. 프로젝트 루트에서 계획 모드로 시작하고 CCUsage 출력과 팀 규칙만 읽게 합니다.

claude --permission-mode plan

이 작업은 사용량 분석만 합니다. 코드는 수정하지 마세요.
읽기: /tmp/ccusage-daily.json, CLAUDE.md, 비용 운영 규칙
허용 도구: Read, Grep
금지: 네트워크, 파일 쓰기, 원본 프롬프트 출력
반환: 급증 후보 / 반복 입력 근거 / 완료 결과 / 불확실성
중단: 기록 범위나 기기 누락을 확인할 수 없을 때

사람이 후보를 고른 뒤 비교만 이어갑니다. 반환 표에서 실제 완료 작업과 연결된 세션만 사람이 고릅니다. 후속 프롬프트는 “선택한 두 세션만 비교하고 다른 파일은 읽지 마세요. 개선 전후의 재탐색과 미완료를 표로 돌려주세요”처럼 좁힙니다.

마지막에는 `npx ccusage@latest --help`, 같은 기간의 `daily`와 `session`, `git diff --exit-code`를 확인합니다. 분석 파일 생성 외 코드 변경이 보이거나 공식 청구와 비교 범위를 설명할 수 없으면 중단하고, 재개 메모에 기간·버전·누락 기기를 남깁니다.

총액이 오른 날을 세션으로 다시 쪼갭니다. 일별 합계가 커진 날에는 세션별 입력과 작업 목표를 나눠 봅니다. 같은 로그를 반복해서 읽고 서로 다른 버그를 한 대화에서 처리한 세션이 있다면, 비용 증가의 원인은 모델 단가보다 목표 혼합과 반복 입력에 가깝습니다.

반면 대규모 마이그레이션 한 건이 높은 사용량을 만들고 회귀 테스트까지 끝냈다면 줄일 대상이 아닐 수 있습니다. 사용량은 산출물과 함께 읽어야 합니다.

재현 가능한 명령으로 같은 기간을 비교합니다. 현재 옵션은 공식 저장소의 도움말을 기준으로 확인합니다. JSON 출력은 원본을 외부에 올리지 않고 로컬 분석에만 씁니다.

npx ccusage@latest daily
npx ccusage@latest session
npx ccusage@latest daily --json > /tmp/ccusage-daily.json

# 실행 전 현재 옵션 확인
npx ccusage@latest --help

세 숫자가 다음 행동을 가릅니다. 첫째는 한 세션 안에서 입력이 급격히 커지는 시점입니다. 둘째는 비슷한 시간대에 겹친 세션 수입니다. 셋째는 높은 사용량 뒤 남은 완료 결과입니다. 긴 세션 하나가 테스트 통과를 만들었다면 유지하고, 세 세션이 같은 문서를 읽은 뒤 모두 미완료라면 작업 분할을 고칩니다.

예를 들어 다음 주에는 서로 다른 목표를 새 세션으로 나누고, 대용량 로그는 오류 주변만 읽습니다. 변경 뒤 입력량이 30% 줄었지만 재작업과 완료 시간이 늘었다면 절약은 실패입니다.

숫자가 맞지 않을 때 청구서를 고치려 들지 않습니다. CCUsage는 로컬 파일에서 사용 기록을 해석합니다. 다른 기기, 삭제된 기록, 구독 포함량, 서버 측 조정과 최종 청구를 모두 대표하지 않습니다. 로컬 합계와 Console 또는 계정의 공식 사용량이 다르면 두 값의 범위가 다른 것으로 봐야 합니다.

분석 파일에는 프로젝트 이름과 작업 시각 같은 정보가 남을 수 있습니다. 팀 공유 전에는 원본 JSON 대신 집계표만 내보내고, 프롬프트 내용이나 고객 데이터가 포함되는지 확인합니다.

중단 기준은 비용이 아니라 분석 신뢰도입니다. 기록 경로를 확인하지 못했거나 여러 기기의 데이터가 빠졌다면 월 비용 결론을 내리지 않습니다. 도구 업데이트 뒤 같은 기간 합계가 크게 달라지면 버전과 파싱 변경을 먼저 확인합니다.

CCUsage의 가장 좋은 결과는 “비용이 비싸다”가 아니라 “두 목표를 섞은 세션이 반복 입력을 만들었다”처럼 다음 작업 방식을 바꿀 수 있는 문장입니다. 그 문장이 나오지 않으면 더 많은 차트를 만들 이유가 없습니다.