사용량 카운터에서 고객별 비용으로
ccusage는 Claude Code, Codex 등 코딩 에이전트의 로컬 로그를 읽어 일·월·세션별 토큰과 추정 비용을 보여 주는 무료 오픈 소스 커맨드라인 도구입니다. 내 사용량을 확인하는 용도로는 따라올 도구가 드뭅니다.
그 사용량이 고객의 몫이 되면 ccusage 대안이 필요합니다. 어느 프로젝트를 위한 것이었는지, 유로로 얼마가 들었는지, 작업 시간과 함께 어떻게 청구서에 올라가는지. Time Momentum이 하는 일입니다. ccusage에 관한 내용은 2026년 10월 11일 기준 저장소와 문서에 따른 것입니다.
ccusage가 잘하는 것
- 무료이며 MIT 라이선스입니다. 설치나 가입 없이
npx ccusage@latest로 실행합니다. - 로컬 전용: 문서에 따르면 데이터를 업로드하지 않고 사용량 로그를 읽습니다.
- Claude Code, Codex, OpenCode, Gemini CLI, GitHub Copilot CLI 등 18개 소스.
- 일·주·월·세션별 보고서. 캐시 토큰은 따로 집계하고 비용은 모델 가격으로 USD 추정치를 냅니다.
--offline은 네트워크 없이 동작합니다. - Claude Code 부가 기능:
--instances는 프로젝트 폴더별로 사용량을 묶고,statusline은 Claude Code 상태 표시줄에 사용량을 띄우며,--json은 직접 만든 스크립트에 데이터를 넘깁니다. - 널리 쓰입니다. 2026년 10월 10일까지 한 주 동안 npm 다운로드가 약 290,000회였습니다.
Time Momentum이 더 나은 ccusage 대안인 경우
Time Momentum은 AI 에이전트와 함께 고객 업무를 하는 프리랜서와 에이전시를 위해 만들어졌습니다.
- 고객별 비용: 모든 세션은 폴더나 저장소에 따라 프로젝트에 배정되고, 프로젝트는 고객에 속합니다.
- 달러 추정치 대신 유로: 각 세션은 시작 시점의 모델 정가로 평가하고 그날의 ECB 환율로 환산합니다. Claude나 ChatGPT 구독을 쓰면 대신 월 요금을 토큰 비율에 따라 프로젝트별로 나눕니다.
- 전체 공수: 실제 에이전트 실행 시간, 토큰, 커밋을 병렬 타이머로 기록한 작업 시간과 함께 봅니다.
- 청구서까지(Pro): AI 비용을 고객에게 넘기고, 전자 인보이스를 발행하고, 입금을 기록하고, 프로젝트별 마진을 봅니다.
- 여러 도구를 한곳에서: Claude Code, Codex, Cursor를 같은 프로젝트에서, 훅으로 자동 기록하며 오프라인에서도 빠지지 않습니다.
ccusage vs. Time Momentum
| 기능 | ccusage | Time Momentum |
|---|---|---|
| 가격 | 무료, 오픈 소스 | 무료 요금제, 청구는 Pro |
| 계정 없이 사용 | – | |
| AI 코딩 도구 | 에이전트 CLI 18종 | Claude Code, Codex, Cursor |
| 세션별 비용 | USD 추정치 | 유로, 정가 기준 |
| 고객 프로젝트별 비용 | 일부폴더별, Claude Code | 프로젝트·고객별 |
| 작업 시간 | – | 병렬 타이머 |
| 청구서와 전자 인보이스 | – | Pro |
| 지난 세션 | 모든 로컬 로그 | 일부Claude Code, Codex |
기준일: 2026년 10월 11일
ccusage를 계속 쓰면 좋은 경우
- 고객에게 받을 금액이 아니라 내가 쓴 양을 알고 싶을 때
- 데이터가 내 컴퓨터를 전혀 떠나면 안 될 때
- Gemini CLI, OpenCode, Copilot CLI처럼 Time Momentum이 기록하지 않는 에이전트 CLI를 쓸 때
함께 쓰기
ccusage는 로그 파일만 읽고, Time Momentum은 훅을 추가합니다. 서로 방해하지 않으므로 터미널에서 빠르게 확인할 때는 ccusage를, 고객과 청구서에는 Time Momentum을 쓸 수 있습니다.
프롬프트, 응답, 코드는 절대 내 컴퓨터를 떠나지 않습니다. Time Momentum이 받는 것은 모델, 토큰, 실행 시간, 작업 폴더, 저장소, 세션 제목이며, 제목과 폴더는 끄거나 폴더별로 제외할 수 있습니다.
ccusage에서 전환하기
ccusage에서 가져오는 기능은 없습니다. 대신 Time Momentum이 같은 로컬 Claude Code·Codex 로그를 읽습니다.
계정 만들기
설치 명령 실행
macOS 또는 Linux에서 실행합니다. tm 커맨드라인을 설치하고, 앱에서 발급한 API 키를 묻고, Claude Code·Codex·Cursor를 찾아 기존 훅 옆에 자체 훅을 추가합니다.
curl -fsSL https://app.time-momentum.com/install.sh | sh지난 세션도 함께
로컬 로그에 남아 있는 Claude Code·Codex 세션을 바로 가져옵니다. Claude Code는 기본적으로 30일 동안 보관합니다.
폴더를 프로젝트에 배정
폴더나 저장소마다 한 번만 하면 이후 세션은 자동으로 따라갑니다.
Time Momentum이 세션마다 기록하는 것: 프로젝트의 전체 공수.
자주 묻는 질문
ccusage란 무엇인가요?
Claude Code, Codex 등 코딩 에이전트의 로컬 로그를 읽어 일·주·월·세션별 토큰과 추정 비용을 보여 주는 오픈 소스 커맨드라인 도구입니다.
ccusage는 무료인가요?
네. MIT 라이선스이며 계정 없이 npx ccusage@latest로 실행합니다.
ccusage는 Codex에서도 동작하나요?
네. Codex는 Claude Code와 함께 18개 소스 중 하나입니다. Time Momentum도 서브에이전트와 실제 실행 시간을 포함해 Codex를 기록합니다.
프로젝트별 Claude Code 비용은 어떻게 확인하나요?
ccusage는 --instances로 Claude Code 사용량을 프로젝트 폴더별로 묶습니다. Time Momentum은 각 세션을 프로젝트와 고객에 배정하고, 작업 시간과 함께 유로로 평가합니다.
ccusage 데이터를 Time Momentum으로 가져올 수 있나요?
아니요. 설정할 때 Time Momentum은 ccusage가 쓰는 것과 같은 로컬 로그에서, 도구가 보관하는 범위까지 지난 Claude Code·Codex 세션을 읽어 옵니다.
Time Momentum은 프롬프트나 코드를 업로드하나요?
아니요. 받는 것은 모델, 토큰, 실행 시간, 작업 폴더, 저장소, 세션 제목입니다. 프롬프트, 응답, 코드는 내 컴퓨터에 남습니다.