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

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

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

1. 가장 빠른 방법: /usage, /context, 그리고 상태 표시줄

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

/usage

Claude Code는 현재 세션의 토큰 사용량을 출력하고, Claude.ai 요금제라면 쿼터가 얼마나 남았는지도 보여줍니다: 5시간 및 7일 사용 한도, 그리고 컨텍스트 창을 얼마나 쓰고 있는지입니다. /cost와 /stats도 여전히 동작하며, 같은 명령의 별칭입니다. Claude가 답변하는 도중에 실행해도 답변을 중단하지 않고 숫자가 표시됩니다(v2.1.234 이전에는 명령이 턴이 끝날 때까지 기다렸습니다).

하나의 백분율 대신 컨텍스트 창을 자세히 보고 싶으신가요? /context를 입력하세요: 창을 색상 격자로 그려 주고, 무엇이 창을 잡아먹고 있는지 표시합니다. 출력이 무거운 도구, 비대해진 메모리 파일, 용량에 가까워진 세션 같은 것들입니다.

두 명령에는 공통된 단점이 있습니다: 직접 입력해야 하고, 지금 있는 세션만 봅니다. 어제 얼마를 썼는지, 다른 프로젝트가 얼마나 들었는지는 알려주지 않습니다. 화면에 계속 남아 있는 숫자를 원한다면 상태 표시줄을 사용하세요. Claude Code에게 대신 작성해 달라고 요청하세요:

/statusline show model name and context percentage with a progress bar

~/.claude/에 스크립트가 생성되고 설정에 연결됩니다. 직접 작성하고 싶다면 ~/.claude/settings.json에 statusLine 항목을 추가하세요. 스크립트는 stdin으로 JSON 객체를 받는데, 여기에는 context_window.used_percentage, cost.total_cost_usd, 그리고 Pro 및 Max 구독자의 경우 rate_limits.five_hour.used_percentage가 들어 있습니다. 한 줄이면 충분합니다:

{
  "statusLine": {
    "type": "command",
    "command": "jq -r '\"[\\(.model.display_name)] \\(.context_window.used_percentage // 0)% context\"'"
  }
}

상태 표시줄은 API 응답마다 갱신되므로, 세션이 실행되는 동안 백분율이 움직입니다. 그래도 여전히 터미널당 세션 하나입니다: 과거 데이터나 여러 에이전트를 한꺼번에 보려면 계속 읽어보세요.

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

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

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

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

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

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

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

어떤 것을 사용해야 할까요

• 이 세션의 숫자만, 또는 쿼터가 얼마나 남았는지만 필요하신가요? /usage, 그리고 항상 보이게 하고 싶다면 상태 표시줄.
• 사용자 정의 보고서를 스크립트하고 싶으신가요? JSONL 전사를 직접 읽어보세요.
• 터미널에서 일일 및 월간 총액이 필요하신가요? ccusage.
• 여러 에이전트를 실행하고 각 에이전트 및 계정별로 사용량을 실시간으로 보고 싶으신가요? AgentsRoom의 미터를 사용하세요.

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