상세 가이드 · 9 / 15

토큰 사용량

상태줄의 토큰 배지를 클릭하면 사용량 팝업이 열립니다. 화면 스크랩이 아니라 ~/.claude/*.jsonl 트랜스크립트 회계를 권위 출처로 삼아 cache_read 까지 정확히 집계합니다(스크랩 누계는 실제의 약 0.4% 에 불과합니다).

여는 법과 탭 이동

상태줄 토큰 배지 클릭 또는 claude-token-log로 엽니다. 기간 / 세션 / 한도 / 경고 노트북 탭과 [/usage] · [시나리오] 버튼으로 구성되고, 상단 요약줄(5h% · 주% · ~Σ)은 모든 탭에 공통으로 붙습니다. 탭 사이는 클릭 말고 키로도 오갑니다.

  • Tab / Shift+Tab — 언제나 다음 / 이전 탭으로 옮깁니다. 띠의 차례(기간 · 세션 · 머신 · 한도 · 경고)를 따르고 끝에서 처음으로 감깁니다. 판은 닫히지 않고 내용만 바뀝니다.
  • ← / → — 그 줄에 다른 뜻이 없으면 같은 탭 이동입니다.
    • 세션 · 머신 탭에서는 바로 이웃 탭으로 갑니다.
    • 기간 · 경고 탭의 트리에서는 종전대로 펼침 · 접힘입니다.
    • 한도 탭의 모델 · 컨텍스트 줄에서는 값을 고르고, 그 아래 줄에서는 이웃 탭으로 갑니다.
  • 바로 가기 — p(세션) · l(한도) · o(머신). u 는 숨은 /usage 조회로 한도 값을 새로 받아 오고, s 는 시나리오 설정 (claude-settings)을 엽니다.

「Tab 은 언제나 이웃 탭, ←→ 는 그 줄에 다른 뜻이 없을 때 이웃 탭」이라는 규칙은 파이썬 클라이언트와 GUI 클라이언트(pytmux-gui)가 같습니다. GUI 판은 탭을 옮겨도 판의 높이가 그대로라 내용이 짧은 탭으로 가도 창이 들썩이지 않습니다.

여러 머신 토큰 동기화로 다른 컴퓨터 몫이 합쳐진 경우에만 [머신] 탭이 하나 더 생깁니다(o 또는 클릭). 어느 컴퓨터가 얼마를 썼는지 비중 순으로 갈라 보여 주고, 요약줄 Σ 뒤에도 같은 분해가 붙습니다. 머신이 하나면 탭도 생기지 않습니다.

머신은 등록할 때 붙인 기기 이름(보통 그 컴퓨터의 호스트 이름)으로 부릅니다. 이름은 동기화 서버의 기기 목록에서 받아 옵니다. 서버가 아직 이름을 내려 주지 않는 판이면 기기 id 의 앞 8자리로 보이고, [머신] 탭 · 요약줄 · GUI 의 머신 판이 모두 같은 표기를 씁니다.

기간 뷰 — 시간 흐름으로

토큰을 월 → 주 → 일 → 시각 계층 트리로 봅니다. 각 행에 토큰 합과 가로 막대가 붙고, Enter / ←→ 로 주를 일·시각까지 펼치고 접습니다. 언제 토큰이 몰렸는지 시간 축으로 짚을 때 씁니다.

토큰 사용량 — 기간 뷰
기간 뷰 — 월/주/일/시각 계층 트리(요약줄: 5h%·주%·~Σ).

세션 뷰 — Claude 세션별로

p 로 전환합니다. 행이 Claude 세션별 합(대표 탭:패널 라벨 · 타임스탬프 · 토큰)입니다. 닫히고 재사용되는 패널 id 대신 안정적인 세션 id 로 묶어, 어느 세션이 토큰을 많이 썼는지 비교할 때 씁니다. 계정이 여러 개면 claude-token-account 로 현재 패널의 계정을 직접 지정할 수 있습니다(빈값=자동).

토큰 사용량 — 세션 뷰
세션 뷰 — 세션별 합 · 탭:패널 · 타임스탬프 · 토큰 막대.

한도 뷰 — /usage 실측과 리셋

l 로 전환합니다. /usage 실측 한도(세션 5h · 주 전체 · 주 Sonnet)를 % 사용 막대와 리셋 시각으로 보여주고, 현재 5h 창 추정 Σ 와 다음 리셋까지를 블록 숫자 카운트다운 시계로 보여줍니다(매 초 갱신). 첫 두 행에서 ←→ 로 모델·컨텍스트를 바꿔 적용할 수도 있어, 한도를 보며 모델을 고를 때 씁니다.

실측 한도는 숨은 세션으로 /usage 를 조회하는 claude-usage(별칭 usage)로 갱신되고, 막대만 따로 보려면 usage-panel(별칭 limits)을 씁니다. 다음 리셋까지의 카운트다운만 크게 보려면 usage-view([popup|tab|pane])를 씁니다.

사용 한도 — 막대 뷰(usage-panel)
usage-panel(별칭 limits) — /usage 실측 세션 5h · 주 전체 · 주 Sonnet 을 % 사용 막대와 리셋 시각으로만 따로.

이 자동 조회는 살아 있는 Claude 패널이 있을 때뿐 아니라, Claude 를 pytmux 패널 밖(별도 터미널)에서 쓸 때도 최근 사용 기록을 신호로 주기적으로 떠, 그 시간대의 한도 %가 [기간] 뷰의 5h%·1w% 칸에 이어 기록됩니다(Claude 를 안 쓰는 동안엔 조회하지 않고, 이미 지나간 빈 시간대는 소급 기록되지 않습니다).

토큰 사용량 — 한도 뷰
한도 뷰 — /usage 실측 막대 · 리셋 카운트다운 시계 · 모델/컨텍스트 변경.

경고 배지

Claude 가 이상하게 돌 때 상태줄에 경고 배지가 뜹니다 — "⚠ 동일 결과 N회 반복 — 루프 의심", "Claude 포맷 미인식 — 추적 중단" 등. 팝업에는 이런 경고 이력도 함께 남습니다. 토큰 회계 자체를 진단하려면 claude-token-debug(기본 off) 로그를 켤 수 있습니다.