GitHub 저장소 · 작성자 Benjamin410

token-usage

Name: token-usage
Author: Benjamin410

최근 7일간 Token 사용량을 플랜 사용률（5시간 및 7일 창）과 비교해 보여 주는 Claude Code mod입니다. 상태 표시줄 Sparkline, /tokens 패널, API 가격 비교, 모델별 분석을 포함합니다.

Benjamin410@Benjamin410

Benjamin410/claude-mods/tree/main/mods/token-usage

번역 완료

이 mod 소개

이 mod는 ~/.claude/projects/**/*.jsonl（또는 $CLAUDE_CONFIG_DIR）의 로컬 트랜스크립트를 읽어 최근 7일간 Token 사용량을 보여 줍니다. 입력 영역 위의 상태 표시줄에는 7일 추이를 Sparkline으로 표시하고 합계, 플랜 사용률（5h/7T, 70/90%부터 녹색/노란색/빨간색）, 재설정 시각, 플랜 1%당 Token 수를 보여 줍니다. /tokens는 날짜별 막대, 합계（Cache-Read 없음/있음）, Input/Output/Cache 분할, 모델별 사용량을 보여 주는 패널을 엽니다. 같은 사용량을 API 공개 가격 기준 USD 비용으로도 계산합니다（모델별, 5 min/1 h Cache-Write, Cache-Read, Fast Mode 포함）. 상태 표시줄에는 7일 합계가, 패널에는 날짜별·모델별·플랜 창 시작 이후 금액이 표시되며 가격표는 hooks/pricing.ts에 있습니다. 5시간 및 7일 창의 플랜 사용률은 최근 API 응답에서 가져오고（구독 로그인일 때만）, 세션을 넘어 저장합니다. 현재 7일 플랜 창 시작 이후의 Token과 백분율을 비교해 1%당 Token 수와 100%까지의 추정치를 계산합니다. 시작할 때와 10분마다 트랜스크립트를 다시 읽습니다. 제한: Token은 이 장치의 로컬 기록만 사용하지만 플랜 백분율은 모든 장치와 표면을 세므로 추정은 하한/대략값입니다. 플랜은 모델과 캐시 Token을 단순한 Token 합계와 다르게 가중합니다. 4 MiB를 넘는 트랜스크립트는 grep으로 걸러 읽고（Windows에서 grep이 없으면 건너뜀）, 설치는 저장소를 복제해 install.sh를 실행합니다. 업데이트는 pull + /reload-plugins, 테스트는 claude --plugin-dir ~/claude-mods/mods/token-usage 또는 ~/.claude/settings.json의 CLAUDE_CODE_PLUGIN_DIRS를 사용하며 claude plugin validate mods/token-usage와 claude plugin test mods/token-usage로 확인합니다.

설치

먼저 작성자의 README에서 marketplace와 플러그인 이름을 확인하세요. 저장소 구조에 따라 명령어가 달라질 수 있습니다.

claude plugin marketplace add Benjamin410/claude-mods
claude plugin install token-usage

원문 / README

claude-mods

Eigene Claude-Code-Mods (Plugins mit Function-Hooks), privat geteilt ueber alle Geraete. Das Repo ist zugleich ein Plugin-Marketplace (.claude-plugin/marketplace.json).

Einrichten auf einem Geraet

git clone [email protected]:<dein-user>/claude-mods.git ~/claude-mods
~/claude-mods/install.sh

Aktualisieren: git -C ~/claude-mods pull, danach in einer laufenden Sitzung /reload-plugins.

Nur fuer eine Sitzung testen, ohne Installation: claude --plugin-dir ~/claude-mods/mods/token-usage. Fuer Desktop-App/SDK-Sitzungen alternativ CLAUDE_CODE_PLUGIN_DIRS im env-Block von ~/.claude/settings.json auf die Mod-Ordner setzen.

Mods

token-usage

Zeigt den Token-Verbrauch der letzten 7 Tage im Vergleich zur Plan-Auslastung.

Leiste oberhalb der Eingabe: Verlauf der 7 Tage als Sparkline, Summe, Plan 5h/7T in Prozent (gruen/gelb/rot ab 70/90 %), Reset-Zeitpunkt und Tokens je 1 % Plan. Knopf „Details“.
„Details“ bzw. /tokens oeffnet ein Pane: Balken je Tag, Summe (ohne/mit Cache-Reads), Aufteilung Input/Output/Cache, Verbrauch je Modell.
API-Preis: was derselbe Verbrauch nach API-Listenpreis in USD gekostet haette (je Modell, inkl. Cache-Write 5 min/1 h, Cache-Read und Fast Mode), in der Leiste als Summe der 7 Tage, im Pane je Tag, je Modell und seit Beginn des Plan-Fensters. Preistabelle: hooks/pricing.ts.
Plan-Auslastung: 5-Stunden- und 7-Tage-Fenster in Prozent mit Reset-Zeitpunkt, so wie die letzte API-Antwort sie meldet (nur mit Abo-Login, nicht mit API-Key). Der letzte Stand wird sitzungsuebergreifend gespeichert.
Vergleich: Tokens seit Beginn des aktuellen 7-Tage-Plan-Fensters gegen dessen Prozentwert, daraus Tokens je 1 % und eine Hochrechnung bis 100 %.
Transkripte werden beim Start und alle 10 Minuten neu eingelesen.

Grenzen:

Tokens stammen aus den lokalen Transkripten (~/.claude/projects/**/*.jsonl, bzw. $CLAUDE_CONFIG_DIR) dieses Geraets. Der Plan-Prozentwert zaehlt dagegen alle Geraete und Oberflaechen (claude.ai, Cloud-Sitzungen). Die Hochrechnung ist daher eine Untergrenze/Schaetzung.
Der Plan gewichtet Modelle und Cache-Tokens anders als eine reine Token-Summe; als Vergleichsbasis dienen Tokens ohne Cache-Reads.
Transkripte ueber 4 MiB werden per grep gefiltert gelesen (unter Windows ohne grep uebersprungen).

Pruefen: claude plugin validate mods/token-usage und claude plugin test mods/token-usage.