Token Usage

Token Usage

Changelog

Was in welcher Version dazugekommen ist, neueste Version zuerst. Jeder Eintrag hält fest, was damals ausgeliefert wurde.

Ältere Einträge können Aussagen enthalten, die spätere Versionen korrigiert haben, vor allem zu den Limits. Die Korrekturen stehen unter 2.0.0.

2.0.0Oktober 2026

Release auf GitHub →

Drei Annahmen, die dieses Plugin über Anthropics Rate Limits getroffen hatte, waren falsch. Alle drei sind hier korrigiert, deshalb können deine Zahlen nach dem Update anders aussehen.

Korrekturen

  • Es gibt kein Tageslimit. Frühere Versionen haben „Heute“ an einem „fairen Tagesanteil“ des Wochenlimits gemessen, einer Zahl, die das Plugin selbst erfunden hatte, indem es das Wochenlimit durch sieben teilte. Anthropic erzwingt kein solches Limit, der Vergleich stellte also einen echten Tag gegen ein Budget, das es nicht gibt. „Heute“ wird jetzt mit deinem eigenen 29-Tage-Durchschnitt pro aktivem Tag verglichen: Das beansprucht keine Quote und sagt dir nur, ob heute mehr oder weniger los ist als sonst
  • Das 5-Stunden-Fenster ist verankert, nicht gleitend. Es öffnet sich mit deiner ersten Nachricht und läuft genau fünf Stunden. Ein neues Fenster beginnt erst, wenn diese Spanne vollständig abgelaufen ist, in festen Blöcken und unabhängig von Pausen dazwischen. Frühere Versionen haben „die letzten fünf Stunden ab jetzt“ summiert. Beim Wechsel eines Fensters mischte das den Schwanz des alten mit dem Kopf des neuen Fensters, eine Zahl, die zu keinem von beiden gehörte, und zwar genau dann, wenn du sehen wolltest, dass dein Budget zurückgesetzt wurde
  • Nur Input und Output zählen aufs Limit. Cache-Lesen und Cache-Schreiben zählen nicht. Das habe ich an über 80 beobachteten Limit-Treffern geprüft, statt es anzunehmen: Ich habe ein gewichtetes Modell getestet, und die Gewichte, die die echten Daten am besten erklärten, waren für beide Cache-Arten null. Das daraus entstehende mittlere 5-Stunden-Budget deckt sich mit dem, was Nutzer tatsächlich beobachten

Neu

  • Aktivitäts-Heatmap rund um deine Abrechnungswoche. Eine Zeile pro Kalendertag, zwölf 2-Stunden-Felder pro Zeile, über dein tatsächliches Wochenfenster von der Reset-Stunde bis zur Reset-Stunde. Weil dieses Fenster acht Kalendertage berührt, zeigt die Ansicht acht Zeilen, die Felder außerhalb des Fensters sind sichtbar inaktiv. Einklappbar, mit einem Active-Days-Panel daneben
  • Der Wochen-Reset erkennt sich selbst. Das Wochenlimit wird zu einer Stunde zurückgesetzt, die sich je nach Konto unterscheidet. Das Plugin ermittelt diese Stunde jetzt aus deiner eigenen Sitzungshistorie, statt dich raten zu lassen, und sagt in den Einstellungen, ob der Wert erkannt oder von Hand gesetzt wurde
  • CSV-Export, auf zwei Wegen. Aus der Kopfzeile der Seitenleiste in einen einstellbaren Vault-Ordner oder über die Befehlspalette. Drei Dateien (Projekte, Tagesdetail, Kennzahlen), RFC 4180 mit UTF-8-BOM, damit Excel sie auf Anhieb korrekt öffnet
  • 5-Stunden-Schätzung mit üblichem Band. Seitenleiste und Dashboard zeigen den Median und die mittlere Hälfte deiner beobachteten Treffer (zum Beispiel „meist zwischen 214K und 364K“), und der CSV-Export enthält beide Grenzen. Die Schätzung selbst wird jetzt innerhalb der verankerten 5-Stunden-Fenster gemessen, genau so, wie der Ring zählt, beide sind also direkt vergleichbar. Die Zahlen können sich deshalb nach dem Update leicht verschieben
  • Der Kalender zeigt zwei Monate statt einem, damit der Monatsanfang nicht mehr ein fast leeres Raster ist
  • Spanisch. Die Oberfläche und das komplette Glossar gibt es jetzt auch auf Spanisch, neben Englisch, Deutsch, Französisch und Italienisch

Geändert

  • Neues Aussehen. Die Farbwelt ist nach einer Regel neu aufgebaut: Eine Farbe kennzeichnet entweder eine Token-Art oder einen Status, nie beides. Vorher konnte dasselbe Grün in einem Panel „Output-Tokens“ und im nächsten „alles in Ordnung“ bedeuten
  • Die Classic-Seitenleiste ist entfernt. Was als „NextGen“ optional war, ist jetzt einfach die Seitenleiste, die Einstellung „Sidebar appearance“ gibt es nicht mehr
Nach oben

1.9.0September 2026

Release auf GitHub →
  • Dashboard: Limit-Hero-Banner. Die empirischen Schätzungen für Session-, Tages- und Wochenlimit bekommen jetzt ein auffälliges Banner ganz oben im Dashboard, über den KPI-Karten, statt in einer KPI-Karte und einer Datentabelle weiter unten zu verschwinden
  • Seitenleiste: Limit Pulse (NextGen). Dieselben Zahlen für „Heute gegen fairen Tagesanteil“ und „diese Woche gegen geschätztes Wochenlimit“ stehen jetzt auch ganz oben auf der Today-Seite, du siehst sie also, sobald du die Seitenleiste öffnest, ohne das Dashboard. Gleiche Berechnung wie beim Limit Hero im Dashboard, die beiden können nie unterschiedliche Zahlen zeigen
  • Aktivitätskalender: größere Trefferfläche. Der Tooltip hängt jetzt an der ganzen Tageszelle und nicht nur am kleinen farbigen Punkt, das lässt sich mit der Maus deutlich leichter treffen
  • Aktivitätskalender: Notizen pro Tag. Klicke einen Tag an und schreibe eine kurze persönliche Notiz zu seinem Verbrauch. Alles bleibt lokal, gespeichert in den Plugin-Einstellungen, als kleine Markierung am Tag und im Tooltip sichtbar
  • Klarheit zu den Plattformen. Token Usage lief schon vollständig unter macOS und Linux: Das Lesen der Sitzungsdateien war von Anfang an plattformneutral (~/.claude/projects/ über Node os.homedir()), dafür war keine Codeänderung nötig
  • Agent-Mode-Suche korrekt auf Windows beschränkt. Die in v1.8.0 hinzugefügte Suche nach Claude-Desktop-Agent-Mode-Sitzungen ist, wie sich zeigte, nur unter Windows nötig, weil nur die Windows-App ihr eingebettetes Claude Code in einer MSIX-Sandbox laufen lässt, die das Dateisystem virtualisiert. Unter macOS und Linux landen Agent-Mode-Sitzungen bereits im selben Standardordner ~/.claude/projects/, den das Plugin ohnehin liest, dort wird nichts geraten und nichts ergänzt
  • Ein kurz eingebauter, nicht belegter Pfad im Stil des Windows-Stores für macOS wurde entfernt und durch eine dokumentierte, belegbare Plattformgrenze im Code ersetzt (die Grundlage steht in claude-dev.tools/docs/log-locations)
  • Die Dokumentation nennt jetzt ausdrücklich, wo die Sitzungsdaten je Plattform liegen
Nach oben

1.8.0September 2026

Release auf GitHub →
  • Aktivitätskalender (NextGen-Seitenleiste). Ein Monatsraster am unteren Rand jeder Seite der Leiste, ein farbiger Punkt pro Tag, bemessen an deinem eigenen jüngsten Tagesdurchschnitt (grün darunter, bernstein darum herum, rot bei einer Spitze ab dem Doppelten). Du kannst in deiner Historie zurückblättern und den Kalender unter Einstellungen → Activity calendar ausschalten
  • Nutzung der Claude-Desktop-App zählt jetzt mit. Der in der Desktop-App eingebaute Agent Mode führt Claude Code aus und schreibt dieselben JSONL-Sitzungsdateien an einen eigenen Ort. Das Plugin liest sie jetzt ebenfalls, damit dieser Verbrauch nicht mehr in deinen Summen und Limit-Schätzungen fehlt. Ein einmaliger Neuaufbau des Archivs beim ersten Start füllt die betroffenen Tage nach
  • Dashboard: aufklappbares Unterprojekt-Detail. Die Projects-Ansicht zeigt standardmäßig eine Zeile pro Vault. Mit „Show sub-project detail“ klappst du einen Vault auf und siehst die Aufteilung nach Unterordnern direkt in der Tabelle, nicht nur im Markdown-Export
  • Klarerer Geltungsbereich. Ein neuer Glossareintrag „What is measured“ und ein Hinweis im Dashboard machen deutlich, dass das Plugin Claude Code überall erfasst, nicht aber normale Claude-Chats (die keine lokalen Token-Zahlen schreiben)
  • Handbuch. Ein kapitelweiser Leitfaden entsteht unter langeatn.de/media/token-usage/manual/, die Gliederung ist online, die Inhalte kommen in den nächsten Releases dazu
Nach oben

1.7.1September 2026

Release auf GitHub →
  • NextGen-Seitenleiste (optional unter Einstellungen → Sidebar appearance, die Classic-Seitenleiste bleibt standardmäßig unverändert). Icon-Leiste zur Navigation (Today / Overview / Settings), eine 7-Tage-Aktivitäts-Heatmap und farbige KPI-Kacheln mit Trend-Sparklines
  • Vault Token Usage Controlling. Die neue Projects-Ansicht im Dashboard schlüsselt den Token-Verbrauch nach Vault und Unterprojekt auf, sodass du den Verbrauch über mehrere Vaults hinweg (zum Beispiel getrennte Kunden-Arbeitsbereiche) an einer Stelle verfolgen und vergleichen kannst. Sortierbare Übersichts- und Tag-nach-Vault-Tabellen (Klick auf eine Spaltenüberschrift, Standard „heute zuerst“) sowie ein eigenständiger Export Vault_Token_Usage_Projects.md für die Abrechnung
  • Neu gestaltetes Dashboard. Fünf KPI-Karten (Wochenprognose, Limit-Gesundheit, Cache-Effizienz, Tagestempo, Focus Score), eine Wochen-Statusleiste mit Prognose, ein Zeitraum-Dropdown (30/60/180/360 Tage) und ein neuer Reports-Tab
  • Historische Auswertung über 30 Tage hinaus. Der Tagesverbrauch wird jetzt direkt in deinem Vault archiviert, die Ansichten über 60/90+ Tage funktionieren also auch dann, wenn Claude Code seine eigenen lokalen Logs schon gelöscht hat
  • Einstellbare Aufbewahrung der Claude-Daten. Du legst direkt in den Plugin-Einstellungen fest, wie lange die originalen Sitzungsdateien auf der Platte bleiben
  • „What's new“-Popup in der App. Nach einem Update erscheint einmal eine kurze Zusammenfassung der letzten Änderungen. Du kannst sie jederzeit über die Befehlspalette → „Show what's new“ wieder öffnen
Nach oben

1.6.0August 2026

Release auf GitHub →
  • Mehrsprachige Oberfläche. Englisch, Deutsch und Französisch. Das Sprach-Dropdown in den Einstellungen wirkt sofort, ohne Neustart. Die französische Übersetzung wurde muttersprachlich geprüft.
  • Einstellungs-Button (⚙) in der Kopfzeile der Seitenleiste. Er öffnet die Plugin-Einstellungen direkt, ohne Umweg über das Obsidian-Menü
  • Automatische Erkennung von Rate Limits. Session- und Wochenlimit-Treffer werden jetzt automatisch aus den lokalen JSONL-Dateien von Claude Code gelesen, ein manueller Button ist nicht mehr nötig. Das Plugin erkennt den genauen Moment, in dem ein Limit erreicht wurde, und welcher Art es war (Session oder Woche)
  • Dashboard: Rate-Limits-Abschnitt. Tabelle aller erkannten Limit-Ereignisse mit der jeweils relevanten Token-Kennzahl zum Zeitpunkt des Treffers (5-Stunden-Fenster bei Session-Limits, gesamte Abrechnungswoche bei Wochenlimits) sowie empirische Schätzungen der Schwellen für Session- und Wochenlimit aus deiner eigenen Nutzungshistorie
  • Dashboard: Diagramm zum Wochenverbrauch. Balkendiagramm über sechs Wochen, ausgerichtet an Claudes Abrechnungswochengrenze (Sonntag 18:00 → Sonntag 18:00 Europe/Berlin), mit Hervorhebung der Wochen, in denen das Wochenlimit erreicht wurde
  • Spike-Warnung. Bernsteinfarbenes Abzeichen neben „Heute“, wenn der Tagesverbrauch mindestens das Doppelte deines persönlichen 29-Tage-Durchschnitts beträgt (nur aktive Tage)
  • Last-Action-Chips. Vier farbige Chips (In / Out / C.Wr / C.Rd) ersetzen die reine Textzeile im Abschnitt Last Action, passend zum Farbschema der Minibalken in der ganzen Seitenleiste
  • Einklappbare Abschnitte. Alle fünf Zeitbereiche lassen sich einzeln mit einem Klick einklappen. Der Zustand bleibt über Datenaktualisierungen hinweg erhalten
  • Anzeige „Fenster geleert“. Zeigt in Grün „Window cleared · full 5h available“, wenn das 5-Stunden-Fenster leer ist, aber in den letzten sechs Stunden Aktivität aufgezeichnet wurde
  • Fehlerbehebung. Einträge mit null Tokens werden jetzt aus dem 5-Stunden-Fenster gefiltert und beeinflussen weder den Countdown noch die Anzeige
Nach oben

1.5.0August 2026

Release auf GitHub →
  • Kontext-Unterzeilen unter jedem Abschnittstitel. Sie zeigen auf einen Blick, was jeder Zeitbereich abdeckt („Rolling window · counts toward rate limit“, Startzeit der Session, „Calendar day · since midnight“)
  • ← Zurück-Button in der Kopfzeile des Glossars. Er führt zur Datenansicht zurück, ohne dass du nach dem ?-Button suchen musst
  • Logarithmische Skala der Minibalken. Alle vier Token-Arten (Input, Output, C.Write, C.Read) bleiben auch bei großen Größenunterschieden gut lesbar
  • Feststehende Kopfzeile. Logo und Buttons bleiben sichtbar, auch wenn das Panel klein ist oder gescrollt wird
  • Fehlerbehebung. Der C.Write-Balken war wegen einer fehlenden CSS-Klasse (.au-bar-purple) unsichtbar
  • Neuer Glossareintrag. „The three time views“ erklärt, dass Last 5 Hour Session, This Session und Today voneinander unabhängige Schnitte durch dieselben Daten sind
  • GitHub-Artifact-Attestierungen. Release-Dateien sind jetzt kryptografisch signiert
Nach oben

1.4.1August 2026

Release auf GitHub →
  • Neu gestaltete Kopfzeile mit Logo, SVG-Diagrammsymbol und Farbverlaufstext
  • Eingebautes Glossar, umschaltbar mit dem ?-Button, erklärt alle Token-Begriffe und enthält eine ungefähre Kostenübersicht
  • HTML-Dashboard mit 30-Tage-Diagrammen, Modell-Donut, Tabelle der größten Sessions und Analyse der Cache-Effizienz
  • C.Write und C.Read sind in der ganzen Seitenleiste in getrennte Zeilen aufgeteilt
  • Gestapelter 7-Tage-Balken zur Modellverteilung (Haiku / Sonnet / Opus / Fable)
  • Hilfeseite unter langeatn.de/media/token-usage/ (Englisch und Deutsch, automatisch erkannt)
Nach oben

1.0.0 – 1.0.2Juli 2026

Release auf GitHub →
  • Erstveröffentlichung
  • Live-Dateiüberwachung der aktiven Claude-Code-Sitzung
  • Token-Aufschlüsselung nach Last Action, This Session, Today, 7 Days, 30 Days
  • Ausweich-Abfrageintervall (einstellbar)
  • Freigegeben und gelistet im Obsidian-Community-Plugin-Verzeichnis
Nach oben

Quelle: Changelog in der README des Projekts, hier ins Deutsche übertragen. Zur Projektseite →