Claude Code 사용량 확인하는 법: Claudelytics 설치부터 활용까지

---

저는 Claude Code를 쓰면서 항상 불안했습니다. 대화창에서 코드를 짜고, 문서를 만들고, 디버깅을 하다 보면 "이거 토큰이 얼마나 나가는 거지?" "오늘 비용이 얼마지?" 하는 생각이 계속 들더라고요. Claude Pro 구독료는 매달 내고 있지만, 실제로 내가 얼마나 쓰는지는 눈에 보이지 않으니까요.

그러다가 Claudelytics라는 도구를 알게 됐습니다. Claude Code 사용 패턴을 분석해주는 오픈소스 도구인데, 생각보다 괜찮아서 설치 과정부터 사용법까지 정리해봤습니다.

Claudelytics가 뭔가요?

간단하게 말하면 Claude Code 사용량 분석기입니다. 얼마나 썼는지, 어떤 프로젝트에서 토큰을 많이 썼는지, 오늘 비용이 얼마인지 등을 보여줍니다. 터미널에서 명령어 몇 개만 치면 예쁜 표로 정리해서 보여주는데, 생각보다 유용했습니다.

설치가 막혔던 이유

처음에는 그냥 brew로 설치하면 될 줄 알았습니다. 근데 안 되더라고요. Homebrew tap도 없고, 설치 스크립트도 404 에러만 뱉어냈습니다.

알고 보니 Rust로 만들어진 프로그램이라 Cargo를 통해 설치해야 했습니다. 저처럼 Rust를 안 쓰시는 분들은 아마 Cargo가 없을 텐데, 그래서 처음부터 차근차근 정리해봤습니다.

실제 설치 과정

1. Rust 설치

Cargo를 쓰려면 Rust가 있어야 합니다. 터미널에 이거 하나만 입력하면 됩니다:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

설치 옵션이 나오는데 그냥 1번 누르면 됩니다. 기본 설치가 제일 무난합니다.

설치하면서 /Users/사용자명/.cargo 폴더에 파일들이 깔립니다. 시스템 영역을 건드리지 않아서 나중에 지우기도 쉽습니다.

2. 환경 변수 로드

설치가 끝나면:

source ~/.cargo/env

이걸 한 번 실행해주면 됩니다. 터미널을 새로 열면 자동으로 적용됩니다.

3. Claudelytics 설치

이제 진짜 설치:

cargo install claudelytics

컴파일하면서 설치하기 때문에 시간이 좀 걸립니다. 커피 한 잔 마시고 오면 끝나 있습니다.

4. 확인

claudelytics --version

버전이 나오면 성공입니다.

사용법

설치하고 나서 가장 먼저 한 건 오늘 비용 확인이었습니다:

claudelytics cost --today

딱 떠서 "$X.XX" 이렇게 보여줍니다. 생각보다 별로 안 나가서 다행이었습니다.

세션별로 얼마나 썼는지 보고 싶으면:

claudelytics session

프로젝트별로 정리되어서 나옵니다. 어떤 작업에서 토큰을 많이 쓰는지 한눈에 보입니다.

TUI(터미널 UI)도 있습니다:

claudelytics tui

이건 진짜 신기했는데, 터미널 안에서 탭 이동하면서 여러 정보를 볼 수 있습니다. 화살표 키로 이동하고 q 누르면 나가고, 직관적입니다.

별칭 설정

매번 claudelytics 타이핑하기 귀찮아서 별칭을 만들었습니다:

echo "alias ctoday='claudelytics cost --today'" >> ~/.zshrc
echo "alias ctui='claudelytics tui'" >> ~/.zshrc
source ~/.zshrc

이제 ctoday만 치면 바로 오늘 비용이 나옵니다.

쓰면서 느낀 점

처음에는 "굳이 이걸 써야 하나?" 싶었는데, 막상 쓰니까 패턴이 보입니다. 어떤 날은 토큰을 엄청 쓰고, 어떤 날은 거의 안 쓰고. 세션별로 보니까 "아, 이 작업에서 많이 썼구나" 하는 게 보입니다.

무엇보다 불안감이 줄었습니다. 얼마나 쓰는지 모르니까 막연히 불안했는데, 이제는 숫자로 보이니까 안심이 됩니다. 생각보다 많이 안 쓰더라고요.

다만 설치가 좀 귀찮았습니다. Rust 환경이 없으면 처음부터 깔아야 하니까요. 근데 한 번만 하면 되고, Rust는 나중에 다른 도구 쓸 때도 필요할 수 있어서 나쁘지 않았습니다.

주의할 점

Claudelytics는 ~/.claude 폴더에 있는 데이터를 읽습니다. Claude Code를 한 번이라도 써야 이 폴더가 생깁니다. 처음 설치하고 바로 실행하면 "데이터가 없다"고 나올 수 있습니다.

그리고 이건 로컬 분석 도구입니다. Anthropic 서버랑 통신하지 않습니다. 그냥 내 컴퓨터에 저장된 로그 파일을 읽어서 분석하는 거라 개인정보 걱정은 안 해도 됩니다.

마무리

Claude Code 쓰면서 비용이나 사용량이 궁금하셨던 분들은 한번 깔아보세요. 설치가 살짝 번거롭긴 한데, 막상 쓰면 쏠쏠합니다.

저는 이제 하루 끝날 때 ctoday 한 번씩 칩니다. 오늘 얼마나 썼나 보는 게 습관이 됐네요.