Claude Code 토큰 사용량 확인하는 방법: 에이전트가 지출하는 내용을 확인하는 4가지 방법

하루에 몇 분 이상 Claude Code를 실행한다면, 토큰은 당신의 진짜 통화입니다. 토큰은 당신이 요금 한도에 도달할 때, 구독을 얼마나 빨리 소모하는지, 그리고 긴 에이전트 실행이 가치가 있었는지를 결정합니다. 문제는 Claude Code가 그 숫자를 소리치지 않는다는 것입니다. 당신은 직접 찾아봐야 합니다.

여기 Claude Code 토큰 사용량을 확인하는 네 가지 방법이 있습니다. 가장 빠른 내장 명령부터 실시간으로 모든 에이전트를 보여주는 라이브 미터까지. 필요한 깊이에 맞는 방법을 선택하세요.

1. 가장 빠른 방법: /cost 명령

어떤 Claude Code 세션 안에서든지 다음을 입력하세요:

/cost

Claude Code는 현재 세션의 총 비용과 토큰 수, 그리고 실행된 시간을 출력합니다. 이는 "이 세션이 지금까지 얼마나 썼는가"에 대한 가장 빠른 답변이며, 아무것도 설치할 필요가 없습니다.

단점: /cost는 당신이 있는 세션에 한정됩니다. 어제 지출한 금액, 다른 프로젝트의 비용, 또는 특정 에이전트가 다른 에이전트와 어떻게 비교되는지는 알려주지 않습니다. 단일 빠른 확인에는 완벽하지만, 역사적인 데이터가 필요하다면 계속 읽어보세요.

2. 출처를 읽어라: 세션 전사

Claude Code는 모든 세션을 JSONL 전사로 디스크에 기록합니다. macOS와 Linux에서는 여기에서 찾을 수 있습니다:

~/.claude/projects/<encoded-project-path>/<session-id>.jsonl

각 줄은 하나의 메시지이며, 어시스턴트 메시지는 정확한 수치를 담고 있는 usage 객체를 포함합니다: input_tokens, output_tokens, 그리고 캐시 필드(cache_creation_input_tokens, cache_read_input_tokens). 캐시 읽기는 흥미로운 부분입니다: 이는 새로운 입력보다 훨씬 저렴하므로, 높은 캐시 적중률을 가진 세션은 원시 토큰 수치가 제안하는 것보다 훨씬 적은 비용이 듭니다.

이것이 진실입니다. 아래의 두 도구를 포함한 모든 다른 도구는 동일한 파일을 읽습니다. 자신만의 보고서를 스크립트하고 싶다면, JSONL에 대해 jq를 사용하면 됩니다.

3. 전용 CLI: ccusage

자신만의 파서를 작성하고 싶지 않다면, 커뮤니티 도구인 ccusage가 그 전사를 읽고 일일, 월간 및 세션별 총액으로 집계합니다:

npx ccusage@latest

이는 좋은 중간 지점입니다: /cost보다 더 많은 역사적 데이터, jq를 수작업으로 작성하는 것보다 적은 작업. 그러나 터미널에 남아 있으므로 "내가 얼마를 썼지"에 대한 답변은 하지만 "현재 어떤 에이전트가 지출하고 있는가"에 대한 답변은 아닙니다.

4. 라이브 미터: AgentsRoom에서의 세션별 사용량

위의 세 가지 방법은 모두 하나의 맹점을 공유합니다: 사후 분석이며 단일 스트림입니다. 여러 에이전트를 병렬로 실행하는 순간, 각 에이전트의 사용량을 실시간으로 보고 싶고, 각 터미널에 명령을 입력할 필요가 없습니다.

그것이 바로 AgentsRoom의 Claude Code 토큰 사용량 미터가 하는 일입니다. 이는 동일한 JSONL 전사를 세션별로 읽고 다음을 표시합니다:

• 에이전트별 입력, 출력 및 캐시 토큰, 세션이 실행되는 동안 업데이트
• 캐시 적중률, 컨텍스트가 재전송되지 않고 재사용될 때를 볼 수 있도록
• 세션이 요금 한도로 기울어지기 전에 경고

세션별로 사용량을 속성화하기 때문에, 여러 Claude Code 계정을 나란히 실행할 때도 정확성을 유지합니다: 각 계정은 자신의 총액을 유지하므로 클라이언트별 재청구가 간단합니다.

어떤 것을 사용해야 할까요

• 이 세션의 숫자만 필요하신가요? /cost.
• 사용자 정의 보고서를 스크립트하고 싶으신가요? JSONL 전사를 직접 읽어보세요.
• 터미널에서 일일 및 월간 총액이 필요하신가요? ccusage.
• 여러 에이전트를 실행하고 각 에이전트 및 계정별로 사용량을 실시간으로 보고 싶으신가요? AgentsRoom의 미터를 사용하세요.

사용량 확인은 첫 번째 단계입니다. 숫자가 불편하게 느껴진다면, 다음 단계는 그것을 줄이는 것입니다: Claude Code 토큰 비용을 줄이는 방법을 참조하여 캐시 재사용부터 시작하여 실제로 중요한 지렛대를 확인하세요.