Claude Code 토큰 사용량 확인하는 세 가지 방법과 차이

게시 2026.07.18 · 약 7분 분량

최근 Claude Code가 같은 작업에 다른 코딩 에이전트보다 토큰을 몇 배씩 더 쓴다는 측정이 나오면서, 도구 선택에 앞서 내 사용량부터 정확히 재보자는 관심이 커졌다. 로깅 프록시로 Claude Code와 OpenCode를 같은 모델에 고정해 비교한 Systima의 측정에 따르면, 첫 턴 베이스라인에서 Claude Code가 OpenCode의 약 4.7배 토큰을 썼다. 이 벤치마크가 이 글을 쓰게 된 계기다. 자세한 수치는 뒤에서 따로 다루고, 먼저 내 토큰 사용량을 어디서 어떻게 확인하는지부터 정리한다.

Claude Code에서 토큰을 얼마나 썼는지 비교하는 길은 크게 세 가지다. CLI 안에서 바로 치는 /usage·/cost 명령, 로컬 세션 로그를 읽어 일·월·세션별로 집계하는 오픈소스 CLI인 ccusage, 그리고 팀·조직 단위 집계용 Claude Console 대시보드다. 2026년 7월 기준 Anthropic의 Claude Code 비용 관리 공식 문서에 따르면 세션 사용량은 /usage 화면 맨 위 Session 블록에서 모델별 입력·출력·캐시 토큰과 추정 비용으로 확인한다. 이 글은 구독(Pro·Max)과 API 종량제를 함께 쓰는 개인 개발자가 자기 사용량을 재고 비교하는 방법을 다룬다. 팀 청구 관리의 세부 설정은 범위 밖이다.

토큰 사용량은 어디서 확인하나

가장 빠른 방법은 Claude Code 안에서 /usage를 치는 것이다. 이 명령은 현재 세션의 모델별 토큰(입력·출력·캐시 읽기·캐시 쓰기)과 로컬에서 계산한 추정 달러 값을 보여 준다. 출력은 대략 이런 형태다.

Total cost:  $0.55
Total duration (API): 6m 20s
Total code changes: 0 lines added, 0 lines removed
Usage by model:
 sonnet: 1.2k input, 5.3k output, 940.0k cache read, 50.0k cache write

공식 문서는 이 달러 값이 로컬 토큰 집계로 계산한 추정치라 실제 청구서와 다를 수 있다고 밝힌다. 특히 Pro·Max 구독자는 사용량이 구독에 포함되므로 세션 달러 값 자체는 청구와 무관하고, 대신 플랜 한도 대비 사용 바가 뜬다. 같은 화면에서 d·w를 누르면 최근 24시간과 7일을 오갈 수 있고, skill·subagent·MCP 서버별로 사용 비중이 나뉘어 나온다.

API 키(종량제)로 붙였다면 /cost가 현재 세션의 누적 지출을 따로 보여 준다. 무엇이 컨텍스트 창을 차지하는지 알고 싶으면 /context를 쓴다. 한 가지 주의할 점은 /clear로 새 세션을 시작하면 /usage의 누적 합계가 0으로 초기화된다는 것이다. 작업 하나가 끝날 때마다 정리하면 다음 작업의 숫자를 깨끗하게 잴 수 있다.

ccusage로 일·월·세션 단위 비교하기

기간별 추이를 보려면 ccusage가 편하다. ccusage는 로컬에 쌓인 세션 로그를 읽어 사용량을 집계하는 오픈소스 CLI다. ccusage 저장소 문서에 따르면 이 도구는 ~/.claude/projects/ 아래 JSONL 파일만 읽어 분석하며 데이터를 외부로 보내지 않는다. 각 줄이 API 호출 한 번의 토큰 정보를 담고 있어서, 이걸 날짜·세션 기준으로 다시 묶어 준다.

설치 없이 npx로 바로 돌릴 수 있다. 아무 인자 없이 실행하면 일별 리포트가 기본이고, 하위 명령으로 집계 단위를 바꾼다.

# 일별 사용량 (기본)
npx ccusage

# 월별 집계
npx ccusage monthly

# 대화 세션별
npx ccusage session

# 5시간 청구 창 단위
npx ccusage blocks

같은 저장소 문서 기준으로 ccusage는 모델별 비용 분해, 날짜 범위 필터, 캐시 토큰 별도 집계, JSON 출력을 지원한다. 세션·일·월로 나눠 보면 어떤 작업이 토큰을 많이 먹는지가 눈에 띈다. 리팩터링 한 번에 하루치 평균을 넘겼다면, 그 세션의 프롬프트나 컨텍스트 크기를 되짚어 볼 신호다.

세 방법, 무엇을 골라야 하나

결론부터 말하면 목적이 다르다. 지금 이 세션이 궁금하면 내장 명령, 며칠·몇 주 추이가 궁금하면 ccusage, 팀 정산이 필요하면 Console이다. 아래 표로 정리했다.

공식 문서는 팀·조직 청구의 경우 API 조직은 Console의 사용량 페이지에서, Team·Enterprise 플랜은 관리자 분석 리포트에서 사용자·모델별 지출을 본다고 안내한다. 개인 개발자라면 내장 명령과 ccusage 조합만으로 충분하다.

Systima 벤치마크: Claude Code는 토큰을 얼마나 더 쓰나

내 숫자를 재는 법을 알았다면, 도구 자체가 토큰을 얼마나 얹는지도 함께 참고할 만하다. Systima의 측정에 따르면 로깅 프록시로 Claude Code(2.1.207)와 OpenCode(1.17.18)를 같은 모델(claude-sonnet-4-5)에 고정해 토큰 오버헤드를 비교했다. 모델을 같은 것으로 묶었으니 차이는 각 도구가 모델에 얹는 시스템 프롬프트·기본 툴·오케스트레이션에서 나온다.

핵심 수치를 보면 이렇다. Systima의 측정에 따르면 첫 턴 베이스라인에서 Claude Code가 약 32,800토큰, OpenCode가 약 6,900토큰으로 약 4.7배 차이가 났고, 시스템 프롬프트만 떼어 비교하면 약 3.3배였다. 같은 측정에서 파일 요약 작업의 캐시 쓰기 토큰은 53,839 대 1,003으로 최대 54배까지 벌어졌다. 독립적인 10레인 벤치에서는 두 도구 모두 다섯 문제 중 다섯 문제를 맞혔지만, 통과당 평균 입력 토큰이 268,000 대 72,000(약 3.7배)이었고 실행 시간은 4~8분 대 1~2분이었다.

Systima는 이 차이의 원인을 Claude Code의 더 큰 시스템 프롬프트, 기본 툴 27종(OpenCode는 10종), 대화 중간에 주입되는 system-reminder, 세션 간 불안정한 캐시 프리픽스로 설명했다. 그러면서 Systima는 이를 두 갈래로 나눴다. 더 큰 명령·툴·오케스트레이션처럼 '구조적으로 불가피한' 몫과, 파일명 인식 실패나 세션 도중 캐시 재작성처럼 줄일 수 있는 '낭비'다.

결론은 한쪽으로 기울지 않는다. Systima는 충분히 어려운 작업이라면 Claude Code의 더 큰 플랫폼이 그 토큰 값을 할 수 있다고 봤지만, 이번 테스트에서는 OpenCode가 약 4분의 1의 입력 비용과 절반의 실행 시간으로 같은 정답을 냈다고 정리했다. 측정 조건이 특정 버전과 특정 작업에 묶여 있는 만큼, 어느 도구가 낫다는 신호로 읽기보다 내 작업에서 토큰이 실제로 어디에 쌓이는지 앞의 방법들로 직접 재보는 편이 낫다. 측정 방법과 데이터 전체는 Systima의 벤치마크 글에 정리돼 있다.

사용량을 줄이려면 무엇을 바꿔야 하나

가장 크게 움직이는 지렛대는 모델 선택과 컨텍스트 관리 두 가지다. 공식 문서는 Sonnet이 대부분의 코딩 작업을 잘 처리하면서 Opus보다 저렴하니, Opus는 복잡한 설계나 여러 단계를 거치는 추론에 아껴 쓰라고 권한다. 세션 도중 /model로 모델을 바꾸고, 단순한 하위 작업을 맡기는 subagent에는 설정에서 model: haiku를 지정하는 식이다.

컨텍스트를 작게 유지하는 습관도 크다. 상관없는 작업으로 넘어갈 때 /clear로 컨텍스트를 비우면 이전 대화가 매 메시지마다 토큰을 갉아먹는 일이 사라진다. 반복되는 시스템 프롬프트는 프롬프트 캐싱(같은 내용을 다시 처리하지 않고 재사용해 비용을 낮추는 방식)이 자동으로 줄여 주고, 대화가 길어지면 오래된 이력을 요약하는 자동 압축이 돈다. 여러 인스턴스를 동시에 띄우는 기능은 비용이 특히 빠르게 붙는데, 공식 문서는 에이전트 팀이 계획 모드에서 돌 때 일반 세션의 약 7배 토큰을 쓴다고 밝힌다.

프로젝트 지식을 어디에 둘지도 토큰에 영향을 준다. 공식 문서는 세션 시작 때 통째로 불러오는 CLAUDE.md 대신, 필요할 때만 로드되는 스킬로 특정 워크플로 지침을 옮기면 기본 컨텍스트가 작아진다고 설명한다. 이 구성을 실무에서 어떻게 굴리는지는 팀 지식을 CLAUDE.md와 스킬로 남기는 방법을 다룬 글에서 더 볼 수 있다.

끝으로 규모 감각도 챙겨 두면 좋다. 공식 문서는 엔터프라이즈 배포 평균이 개발자당 활성일 약 13달러, 월 150~250달러 수준이고 사용자의 90%는 활성일 30달러 미만에 머문다고 밝힌다. 내 숫자가 이 범위에서 크게 벗어난다면, 위의 모델 선택과 세션 정리부터 손보는 편이 빠르다.