토큰 보고서은(는) 무엇을 하나요?
이 스킬의 스크립트를 사용하여 로컬 Claude Code 사용량 보고서를 빌드하세요.
보고서는 Claude Code 세션 대화 기록과 보존된 로컬 캡처 기록을 읽습니다. 헤드라인에는 기록된 프롬프트 횟수(기본 입력 + 캐시 생성 + 캐시 읽기)가 사용됩니다. 구성 보기는 레이블이 지정된 UTF-8 바이트 인벤토리이며, Claude 토큰 속성이 아닙니다. 이 스크립트는 외부로 전송하지 않으며 종속성을 설치하지 않습니다.
Python 3.8 이상이 필요합니다. Windows에서 실행:
python "${CLAUDE_SKILL_DIR}/scripts/report.py" --no-open
macOS 또는 Linux에서 실행:
python3 "${CLAUDE_SKILL_DIR}/scripts/report.py" --no-open
사용자 요청이 지원하는 옵션만 추가하세요.
--since YYYY-MM-DD및--until YYYY-MM-DD: 포함할 로컬 캡처 일자를 선택합니다.--session PREFIX: 하나의 세션 패밀리(캡처된 하위 에이전트 및 연속 대화 포함)를 선택합니다.--style clinical,--style matisse또는--style nocturne: 시작 스타일을 선택합니다.--json PATH: 상세 수치와 데이터 품질 카운터를 JSON 파일로 기록합니다.--metrics-only: 텍스트 바이트 인벤토리를 건너뜁니다.--no-account: 계정 파일을 완전히 건너뜁니다.--sessions-root PATH: 다른 대화 기록 루트와 해당 로컬 상태를 선택합니다.--live-only: 현재 존재하는 대화 기록만 표시합니다. 보존된 기록은 캡처된 상태로 유지됩니다.--no-cache: 휘발성 인덱스를 사용하지 않습니다.--rebuild: 휘발성 인덱스만 지우고, 라이브 파일을 다시 추출하며, 보존된 기록을 삭제하지 않고 병합합니다.--doctor: 경로, 파싱 지원 및 로컬 상태를 확인하며, 쓰기나 전송은 수행하지 않습니다.--out PATH: HTML 출력 경로를 선택합니다.
Windows의 모든 명령어에는 python을, macOS/Linux에는 python3을 사용하세요.
스크립트 경로는 따옴표로 감싸 표시된 그대로 유지하세요.
결과를 설명하기 전에 터미널 요약과 주요 데이터 품질 카운터를 읽으세요. 생성된 HTML 및 요청된 JSON 파일을 링크로 제공하세요. 누락되거나 불완전한 측정값에 대해 설명하세요. 달러 수치는 API 리스트 값이라고 부르고, 지출 또는 청구서라고 부르지 마세요. 기록된 토큰 수와 바이트 구성, 추론된 이미지 수, 피팅된 응답 시간 수치를 구분하세요.
캡처된 기록은 기본적으로 포함됩니다(Claude Code가 대화 기록을 정리할 수 있기 때문). 완전한 계정 사용량이나 달력 사용량을 주장하지 마세요. 인덱스를 복구하기 위해 기록을 지우지 마세요.
로컬 페이지는 허용된 이메일 또는 조직 메타데이터에서 계정 이름을 표시할 수 있습니다. 공개 출력 및 공유 시 해당 신원은 생략됩니다. 기록에는 계정 요금제 필드와 파싱된 구독 생성 날짜만 보관됩니다.
역사적 요금제 레이블은 캡처된 계정 관찰을 사용합니다. 스크립트는 관찰 규칙과 구독 생성 가드가 모두 통과된 경우에만 요금제를 제공하고, 그렇지 않으면 null을 사용합니다. 요금제 레이블이나 날짜 선언을 임의로 만들지 마세요.
subscriptionCreatedAt을 변경하지 않는 요금제 변경은 이후 실행에서 새 등급을 관찰할 때까지 감지할 수 없습니다.
따라서 해당 실행 이전에 종료된 기간은 이전 요금제를 가질 수 있습니다.
업그레이드 또는 다운그레이드 시 해당 날짜가 변경되는지는 확인되지 않았습니다.
절대로 .credentials.json, 기타 자격 증명 파일, 외부 도구 결과 파일, 이미지 URL을 열지 마세요.
프롬프트, 출력, 사고 또는 도구 내용을 검사하거나 반복하지 마세요.
가격을 가져오거나 패키지를 설치하지 마세요.
tokenusage.dev에서 공개 공유를 위해서는 사용자가 명시적으로 공유, 게시, 업데이트 또는 삭제를 요청할 때만 별도의 token-share 스킬을 사용하세요. 이 보고서를 실행하는 것은 공유를 허가하지 않습니다.