Claude Code 토큰 사용량,
세션별로 실시간 추적
AgentsRoom은 모든 에이전트 터미널에서 Claude Code 토큰 사용량을 감시합니다. 작은 토큰 카운터가 컴포저에 위치하며 실시간으로 업데이트됩니다. 단일 Claude 세션에서 토큰 소비가 많아지면 배지가 빨간색으로 변하고 컨텍스트 창을 초과하기 전에 경고합니다.
배지를 클릭하면 세션 모니터가 열립니다: 입력 토큰, 출력 토큰, 캐시 읽기, 캐시 쓰기, 캐시 적중률, 메시지 수, 라우팅된 모델, 세션 지속 시간 및 도구 사용. 하나의 패널, 하나의 Claude 세션, Claude Code 토큰 사용량을 결정하는 모든 숫자.
무료 · macOS · 100% 로컬, 프록시 없음
AgentsRoom에서 Claude Code 토큰 사용량 배지의 실시간 데모: 모든 에이전트 컴포저에 위치하며, 토큰 소비가 많아지면 빨간색으로 변하고 입력 토큰, 출력 토큰, 캐시 읽기 및 캐시 쓰기가 포함된 전체 세션 모니터를 엽니다.
Claude Code 토큰 사용량은 AI 코딩 에이전트를 운영하는 데 있어 가장 큰 변동 비용입니다. 모든 프롬프트, 모든 도구 호출, 모든 CLAUDE.md 재주입이 토큰을 소모합니다. 가시성이 없으면 API가 제한되거나 청구서가 도착할 때 예산을 초과했다는 사실을 알게 됩니다. AgentsRoom은 모든 에이전트 세션에 실시간 Claude Code 토큰 사용량 미터를 제공하여 소비가 발생하는 즉시 확인할 수 있습니다.
토큰 카운터는 터미널 컴포저에서 전송 버튼 바로 옆에 위치합니다. 각 Claude 턴 후 몇 초 후에 업데이트됩니다. 토큰은 전체 세션에 걸쳐 누적됩니다: 입력 토큰, 출력 토큰, 캐시 쓰기 및 캐시 읽기, 모두 합산되고 색상으로 구분되어 한눈에 읽을 수 있습니다. 세션별 Claude Code 토큰 사용량이 과다 소비 임계값을 초과하면 배지가 빨간색으로 변하고 경고 아이콘이 나타납니다. 이는 연료 게이지가 탱크가 비기 전에 경고하는 것과 같습니다.
클릭하면 세션 모니터가 열립니다. 활성 Claude 세션의 실시간 스냅샷을 얻습니다: 첫 번째 메시지 이후의 지속 시간, 사용자 프롬프트 수와 어시스턴트 턴 수, 도구 사용, 대화를 처리한 모델, Claude 세션 ID(복사 가능), 전체 토큰 분석. 캐시 적중률은 즉시 계산되며, 색상으로 구분되어 초록색/호박색/빨간색으로 표시되며, 캐시 읽기가 신선한 입력보다 대략 10배 저렴하다는 한 줄의 알림이 있습니다. 이 단일 패널은 Claude Code 토큰 사용량을 블랙박스에서 실시간 게이지로 전환합니다.
토큰 배지는 보내기 버튼 바로 옆에 있으며, 세션의 소비가 많아지면 빨간색으로 바뀝니다.
세션별 Claude Code 토큰 사용량이 중요한 이유
대부분의 Claude 래퍼는 계정 수준에서 하루에 한 번 토큰 사용량을 보고하며, 열어야 하는 대시보드에서 확인해야 합니다. 그때는 이미 피해가 발생했습니다. AgentsRoom은 모든 에이전트 터미널에서 Claude Code 토큰 사용량을 표면으로 끌어올려 무시할 수 없게 만듭니다. 토큰 카운터는 전송 버튼에서 두 센티미터 떨어져 있습니다. 당신은 그것을 스마트폰의 읽지 않은 배지를 보는 것처럼 흘끗 봅니다.
세션별은 올바른 세분화입니다. 병렬로 실행되는 에이전트 팀은 누가 토큰을 소모하고 있는지 알려주지 않습니다. 한 에이전트가 멈춘 프롬프트에서 루프를 돌고 있을 수 있고, 다른 네 명은 조용할 수 있습니다. 세션별 Claude Code 토큰 사용량 미터가 있으면 시끄러운 에이전트가 즉시 눈에 띕니다: 배지가 빨간색이고, 캐시 적중률이 낮으며, 메시지 수가 빠르게 증가하고 있습니다. 당신은 개입하여 프롬프트를 수정하고 예산을 절약합니다.
전체 기능은 로컬입니다. AgentsRoom은 ~/.claude/projects/에 Claude가 작성한 JSONL 전사에서 직접 Claude Code 토큰 사용량을 읽습니다. 아무것도 당신의 기계를 떠나지 않습니다. 제3자 사용 추적기도 없습니다. API 앞에 프록시도 없습니다. AgentsRoom의 토큰 카운터는 Anthropic이 이미 디스크에 저장한 데이터를 더 빠르고 가시적으로 읽는 것입니다.
AgentsRoom의 Claude Code 토큰 사용량 패널. 모든 에이전트 컴포저에서 세션별 토큰 배지를 클릭하면 모든 중요한 숫자와 함께 토큰 소비를 줄이는 팁을 얻습니다.
Claude Code 토큰 사용량 패널이 보여주는 것
토큰 배지를 클릭하면 실시간 세션 모니터가 열립니다. 활성 Claude 세션에서 얻는 모든 숫자는 다음과 같습니다.
세션 지속 시간
활성 Claude 세션의 첫 번째 메시지와 마지막 메시지 사이의 경과 시간으로, 실시간으로 새로 고쳐집니다. 몇 시간 동안 컨텍스트를 소모한 에이전트를 찾는 데 유용합니다.
실시간 에이전트 상태
대기 중, 작업 중, 완료 또는 입력 필요. 상태는 토큰 카운터와 쌍을 이루어 어떤 Claude 세션이 소비 중인지, 어떤 세션이 그냥 대기 중인지 한눈에 볼 수 있습니다.
메시지 및 어시스턴트 턴
활성 Claude 세션에서 사용자 프롬프트 수와 어시스턴트 턴 수의 비율입니다. 불균형 비율은 에이전트가 루프에 빠지거나 프롬프트가 너무 모호하다는 강력한 신호입니다.
도구 사용
세션에서 Claude가 실행한 Read, Edit, Bash, Grep, Glob 및 기타 도구 호출의 총 수입니다. 도구 호출은 입력 토큰의 큰 비율을 차지하므로 이 숫자는 Claude Code 토큰 사용량을 밀접하게 추적합니다.
사용된 모델
세션에서 턴을 처리한 모든 Claude 모델: Sonnet, Opus, Haiku, 날짜가 있는 변형. AgentsRoom은 이름을 중복 제거하고 단축하여 세션이 모델 간에 자동으로 라우팅되었는지 즉시 확인할 수 있습니다.
Claude 세션 ID
내부 Claude 세션 식별자로, 한 번의 클릭으로 복사할 수 있습니다. 이를 사용하여 CLI에서 --resume을 통해 동일한 대화를 컨텍스트를 잃지 않고 재개할 수 있습니다.
입력 토큰
세션 중 Claude에 전송된 신선한 입력 토큰으로, 캐시 재사용 이전입니다. 이는 Claude Code 토큰 사용량의 가장 비싼 항목입니다.
출력 토큰
세션에서 Claude가 생성한 토큰입니다. 출력 토큰은 입력보다 높은 요금이 부과되므로 진행 없이 높은 값은 에이전트가 회전하고 있음을 의미합니다.
캐시 쓰기
세션 중 Claude가 프롬프트 캐시에 작성하는 토큰입니다. 캐시 쓰기는 소량의 프리미엄이 부과되지만 다음 턴에서 저렴한 캐시 읽기를 잠금 해제합니다.
캐시 읽기
신선한 입력으로 재가격이 책정되는 대신 프롬프트 캐시에서 제공되는 토큰입니다. 캐시 읽기는 입력 토큰보다 대략 10배 저렴하므로 캐시 적중률은 Claude Code 토큰 사용량의 주요 지표입니다.
캐시 적중률
캐시에서 제공된 입력 측 토큰의 비율로, 70% 이상은 초록색, 30%에서 70% 사이에는 호박색, 30% 미만은 빨간색으로 색상 구분됩니다. 높을수록 저렴합니다. Claude Code 토큰 사용량에 대한 최고의 레버입니다.
총 토큰
활성 세션의 입력, 출력, 캐시 쓰기 및 캐시 읽기의 누적 합계입니다. 에이전트 간의 토큰 소비를 비교할 때 단일 헤드라인 숫자로 유용합니다.
토큰 미터가 빨간색으로 변하는 이유
AgentsRoom은 모든 폴링에서 세션별 Claude Code 토큰 사용량을 확인합니다. 실행 중인 총합이 과다 소비 임계값을 초과하면 배지가 빨간색으로 변하고 경고 아이콘이 나타납니다. 이는 세션 모니터를 열고 무엇을 할지 결정하라는 신호입니다: 압축, 새로운 에이전트 포크, 모델 전환 또는 단순히 작업을 완료하고 마무리합니다.
빨간색은 엄격한 한계가 아닙니다. AgentsRoom은 에이전트를 제한하거나 실행을 중단하지 않습니다. 이는 단일 에이전트에 대한 시각적 알림으로, 도망가는 루프가 다른 창에 집중하는 동안 조용히 Anthropic 예산을 소모하지 않도록 합니다. 건강한 캐시 적중률을 가진 긴 세션은 완벽하게 괜찮으며 초록색을 유지합니다.
AgentsRoom이 Claude Code 토큰 사용량을 추적하는 방법
세 가지 레이어: 사용량 폴러, JSONL 파서 및 실시간 UI.
폴러가 15초마다 토큰 총계를 읽습니다
백그라운드 작업이 로컬 Claude 상태에서 세션별 토큰 사용량을 읽고 이를 렌더러 스토어로 푸시합니다. API에 프록시가 없고 추가 네트워크 호출이 없습니다. Claude가 이미 디스크에 기록한 숫자를 더 빠르고 가시적으로 읽는 것입니다.
JSONL 파서가 모달이 열려 있는 동안 10초마다 새로 고쳐집니다
세션 모니터는 활성 Claude 세션의 JSONL 전사를 탐색하여 메시지 수, 어시스턴트 턴, 도구 사용, 라우팅된 모델 및 첫 번째/마지막 타임스탬프를 계산하는 일회성 IPC 호출을 추가합니다. 패널이 화면에 있는 동안 새로 고침이 10초마다 실행되므로 숫자는 실시간으로 유지되며 매 렌더러 폴링마다 파서를 소모하지 않습니다.
실시간 UI: 배지 및 세션 모니터
터미널 컴포저의 배지가 토큰 총계를 읽고 초록색 또는 빨간색을 결정합니다. 클릭하면 세션 모니터가 열리며, 전체 창을 덮는 포털에서 표시됩니다. 숫자는 천 단위 구분 기호로 형식화되고, 캐시 적중률은 색상으로 구분되며, 팁 섹션이 소비를 줄이도록 유도합니다.
Claude Code 토큰 사용량을 줄이는 팁
세션 모니터는 실시간 캐시 적중률에 따라 이러한 팁을 맥락적으로 제공합니다. 클릭 한 번으로 에이전트 터미널에 직접 전송할 수 있습니다.
낮은 캐시 적중률: 프롬프트 접두사 안정화
30% 미만일 경우, Claude는 매 턴마다 전체 입력 가격을 지불하고 있습니다. 세션 중 CLAUDE.md를 편집하거나 모델을 전환하거나 초기 시스템 메시지를 재배열하면 캐시가 파괴됩니다. 프롬프트의 상단을 고정하고 캐시 적중률이 상승하는 것을 지켜보세요.
/compact 사용 대신 /clear 사용
슬래시 clear는 대화를 지우고 다음 턴에서 전체 입력 가격을 강제합니다. 슬래시 compact는 작업을 유지하고 이력을 요약으로 축소하여 캐시 접두사가 유지됩니다. 같은 신선한 느낌, 훨씬 낮은 Claude Code 토큰 사용량.
전체가 아닌 부분 읽기
100줄 이상의 파일에서 에이전트에게 오프셋과 제한을 사용하여 Read를 요청하거나 먼저 기호를 grep하도록 요청하세요. 매 턴마다 4000줄 파일을 로드하는 것은 조용한 1위 Claude Code 토큰 사용량 소모입니다.
쓰기 대신 편집
편집 도구는 변경 사항만 Claude에 다시 전송합니다. 쓰기는 전체 파일을 재전송합니다. 600줄 구성 요소에서 이는 출력 토큰을 두 배로 늘리고 다음 턴의 입력을 부풀립니다.
광범위한 검색을 위해 하위 에이전트 생성
Glob 및 Grep은 수백 개의 파일에서 많은 노이즈를 주요 컨텍스트로 덤프합니다. 에이전트 도구는 자체 컨텍스트 창에서 실행되며 요약만 반환하여 부모 프롬프트를 작게 유지합니다.
CLAUDE.md 축소
CLAUDE.md는 매 턴에 앞에 추가됩니다. 그곳의 쓸모없는 각 단락은 모든 메시지에 대해 캐시된 입력 토큰을 소모합니다. 긴 컨텍스트를 context/로 이동하고 필요에 따라 참조하세요.
세션 모니터는 실시간 캐시 적중률을 읽고 바로 보낼 수 있는 수정안을 제시합니다. Fix this를 한 번 클릭하면 프롬프트가 에이전트로 바로 전송됩니다.
AgentsRoom 토큰 미터 vs 기본 Claude Code
기본 Claude Code는 세션이 끝날 때 토큰 총계를 보여주며, 찾기 위해 스크롤해야 하는 작은 바닥글에 표시됩니다. 실시간 미터가 없습니다. 세션별 분석이 없습니다. 한눈에 캐시 적중률이 없습니다. 소비가 급증할 때 경고가 없습니다. API가 속도를 제한하거나 월 청구서가 너무 높을 때 과다 사용을 발견하게 됩니다.
AgentsRoom은 Claude Code 토큰 사용량을 일급 신호로 전환합니다. 모든 에이전트는 고유한 토큰 카운터를 갖습니다. 과다 사용 시 빨간색. 전체 분석을 클릭하세요. 실시간으로 계산된 캐시 적중률. 실시간 숫자를 읽고 누수를 수정하기 위한 준비된 프롬프트를 제안하는 팁. 동일한 Claude 세션, 동일한 JSONL 전사, 그러나 병렬 에이전트의 가시성이 필요합니다.
Claude Code 토큰 사용량 미터가 당신을 구하는 경우
세션별 토큰 추적기가 스스로 비용을 지불하는 세 가지 실제 상황.
에이전트가 루프에 갇혔습니다
한 에이전트가 같은 파일을 계속 읽고 같은 수정을 반복합니다. 그 토큰 배지는 몇 분 내에 빨간색으로 변하고, 캐시 적중률은 급격히 떨어지며, 메시지 비율은 불균형합니다. 대시보드에서 이를 발견하고 개입하여 프롬프트를 수정하고 예산을 절약합니다.
긴 작업이 잘 진행되고 있습니다
리팩토링을 시작한 지 세 시간이 지나면 에이전트가 여전히 올바른 경로에 있는지 궁금해집니다. 세션 모니터를 열어보세요: 700개의 메시지, 180개의 도구 사용, 78%의 캐시 적중률, 모두 초록색입니다. 토큰 소비는 절대적으로 높지만 효율성에서는 정상입니다. 계속 진행하세요.
야간에 플릿에서 실행
다섯 개의 에이전트가 당신이 자는 동안 백로그를 처리합니다. 아침에 세션별 토큰 사용량이 어떤 에이전트가 효율적이었는지, 어떤 에이전트가 루프에 빠졌는지, 어떤 에이전트가 컨텍스트가 부족했는지를 알려줍니다. 모든 전사를 읽는 대신 2분 만에 분류합니다.
Claude Code 토큰 사용량 미터는 더 큰 모니터 표면의 한 부분입니다. 실시간 에이전트 상태, 도크 배지 및 모바일 푸시 알림이 전체 그림을 완성합니다.
AgentsRoom이 AI 에이전트를 모니터링하는 방법 보기숫자를 보는 것이 첫 번째 단계입니다. 우리의 전체 가이드는 Claude Code 토큰이 어디로 가는지와 청구서를 줄이는 방법을 자세히 설명합니다: 더 긴 컨텍스트, 올바른 모델, 위임 등.
읽기: Claude Code 토큰 비용 줄이기FAQ
Claude Code 토큰 사용량 추적기는 정확한가요?
네. AgentsRoom은 Claude가 ~/.claude/projects/에 작성한 동일한 JSONL 전사를 읽습니다. 입력 토큰, 출력 토큰, 캐시 쓰기 및 캐시 읽기는 Anthropic이 방출하는 메시지별 사용량 페이로드에서 직접 가져옵니다. 추정치, 프록시, 반올림이 없습니다. 세션 모니터의 숫자는 Anthropic이 청구하는 것과 일치합니다.
토큰 카운터가 내 에이전트를 느리게 하나요?
아니요. 폴러는 15초마다 로컬 파일을 읽습니다. JSONL 파서는 세션 모니터가 열려 있을 때만 실행되며, 10초마다 새로 고쳐집니다. Anthropic에 대한 추가 네트워크 호출이 없고, Claude에 주입된 계측이 없으며, 도구 호출에 대한 오버헤드가 없습니다. 당신의 에이전트는 전속력으로 실행됩니다.
배지가 언제 빨간색으로 변하나요?
누적 세션별 Claude Code 토큰 사용량이 일반적인 장기 코딩 세션에 맞춰 조정된 과다 소비 임계값을 초과할 때입니다. 임계값은 보수적이어서 대기 중인 세션은 결코 이를 초과하지 않으며, 도망가는 루프는 몇 턴 내에 빨간색으로 변합니다. 빨간색은 경고이지 제한이 아닙니다.
캐시 적중률이 왜 그렇게 중요한가요?
캐시 읽기는 신선한 입력 토큰보다 대략 10배 저렴합니다. 80% 캐시 적중률의 세션은 0%의 동일한 세션보다 대략 5배 더 저렴합니다. 캐시 적중률은 Claude Code 토큰 사용량에 대한 최고의 레버입니다. AgentsRoom은 이를 실시간으로 보여주어 세션 중에 경로를 수정할 수 있도록 합니다.
Codex, Antigravity, OpenCode, Aider, Grok Build, Mistral Vibe 및 Kimi Code도 지원하나요?
현재 형태의 세션 모니터는 Claude 전용입니다. Claude의 JSONL 전사를 읽고 프롬프트 캐시 분석은 Claude 전용 청구 기능입니다. 상태, 역할 및 알림은 모든 공급자에 대해 작동합니다. 우리는 로드맵에서 공급자 비종속 사용량을 추적하고 있습니다.
AgentsRoom이 내 Claude Code 토큰 사용량을 서버에 전송하나요?
아니요. 토큰 카운터, 세션 모니터 및 캐시 적중률은 모두 로컬 파일에서 Mac에서 완전히 계산됩니다. 아무것도 당신의 기계를 떠나지 않습니다. 모바일 동반자에 대한 선택적 암호화된 동기화를 활성화하면 명시적으로 선택한 데이터만 전송되며, AgentsRoom 릴레이를 통해 종단 간 암호화됩니다.
팁을 재사용 가능한 프롬프트로 저장할 수 있나요?
네. 세션 모니터의 각 팁에는 수정 가능한 준비된 프롬프트를 여는 Fix this 버튼이 있습니다. 이를 에이전트 터미널에 직접 전송하거나 클립보드에 복사하거나 전역 프롬프트 라이브러리에 저장하여 동일한 수정을 모든 프로젝트에서 클릭 한 번으로 사용할 수 있습니다.
Claude Code 토큰 사용량을 추측하지 마세요
AgentsRoom을 다운로드하고 모든 Claude 에이전트에서 실시간 세션별 토큰 미터를 얻으세요. 과다 사용 시 빨간색, 한눈에 보는 캐시 적중률, 소비를 줄이기 위한 팁. 모두 로컬, 모두 당신의 것입니다.
컴패니언 앱: 이동 중에도 에이전트를 모니터링
Claude, Codex, Antigravity CLI 또는 다른 AI 공급자를 사용하세요.
버그와 요청을 공개 백로그로 바로 보내세요.
AgentsRoom의 실제 모습.