Mein Open-Source-Projekt · Plugin für Obsidian
Token Usage
Kennst du eigentlich dein Claude-Limit? Mein Plugin für Obsidian zeigt es dir und nimmt dafür auch nur deine eigenen Daten.
Mein Plugin Token Usage liest die Sitzungsdateien, die Claude Code ohnehin auf deinem Rechner ablegt, und zeigt den Verbrauch, die Fünf-Stunden-Fenster und das Wochenlimit direkt in der Obsidian-Seitenleiste. Das Tool braucht dafür keinen API-Key und keine Cloud.
Das sind Beispieldaten und keine echten Nutzungszahlen.
Warum habe ich das gemacht
Anthropic hält die meisten Details rund um Token für sich, aber die Details finden sich bei dir auf der Festplatte.
Anthropic, wie die meisten anderen großen KI/AI-Anbieter, veröffentlicht nicht, wie viele Tokens hinter einem Limit stecken. Token Usage macht für Claude Code, auch im Agent Mode der Claude Desktop App, daraus eine Berechnung und Annäherung mit deinen eigenen Daten: Jedes Mal, wenn du also ins Limit läufst, merkt sich das Plugin, wie viel du bis dahin verbraucht hattest. Mit jedem Treffer wird diese Berechnung genauer.
Angezeigt wird sie als Median zusammen mit einem üblichen Band, also der mittleren Hälfte deiner bisherigen Treffer. Eine einzelne Zahl würde mehr Genauigkeit vortäuschen, als die Daten hergeben.
Eine Schätzung ist nur so gut wie die Annahmen dahinter und in der aktuellen Version 2.0 habe ich drei davon korrigiert. Mehr dazu im Changelog →
Was das Plugin kann
Ein Blick reicht, für mehr Inhalte und Details gibt es das Dashboard.
Drei Ringe, eine Heatmap
Das aktuelle Fünf-Stunden-Fenster und die laufende Woche stehen gegen das geschätzte Limit, der heutige Tag gegen deinen eigenen Durchschnitt. Darunter die Heatmap deiner Abrechnungswoche in Zwei-Stunden-Zellen.
- Das Fünf-Stunden-Fenster öffnet mit deiner ersten Nachricht und läuft genau fünf Stunden.
- Der Wochen-Reset wird aus deiner eigenen Historie erkannt. Ich nutze im Tool alle verfügbaren und echten Daten, die Anthropic dafür lokal ablegt.
- Der heutige Tag wird mit deinem eigenen Durchschnitt verglichen, nicht mit einem theoretischen Tageslimit, das es nachweislich nicht gibt.
Projekte und Vaults vergleichen
Das HTML-Dashboard zeigt eine Prognose, die Limits und Modellverteilung. Im Projects-Tab siehst du, welcher Vault oder welches Projekt wie viel Verbrauch verursacht, bis in die Unterordner. Damit ist auch eine Projektabrechnung möglich.
Praktisch, wenn du für mehrere Kunden arbeitest und den Verbrauch zuordnen willst.
Deine Zahlen gehören dir
Projekte, Tagesdetail und Kennzahlen lassen sich als CSV exportieren, drei Dateien im Format, das Excel auf Anhieb öffnet. Die Tageswerte werden zusätzlich in deinem Vault archiviert, auch über die Aufbewahrungsfrist von Claude Code hinaus.
Was das Plugin bewusst lässt
Es liest mit, und sonst passiert nichts.
Nichts verlässt deinen Rechner
Keine Netzwerkanfragen, keine Telemetrie, kein Server. Jede Zahl wird lokal berechnet.
Nur lesen
Das Plugin liest die Sitzungsdateien von Claude Code. Neue Dateien entstehen nur in deinem eigenen Vault: das Tagesarchiv und, wenn du es auslöst, Bericht, Dashboard und Export. Prompts und Antworten stehen in keiner davon.
Offen einsehbar
Der Quellcode liegt unter MIT-Lizenz auf GitHub, und die Release-Dateien tragen eine überprüfbare Herkunftsbestätigung.
Stand und Ausblick
Was gerade neu ist und was ich als Nächstes plane.
- Kein Tageslimit mehr: Der heutige Tag wird mit deinem Durchschnitt verglichen.
- Das Fünf-Stunden-Fenster ist verankert statt gleitend, die Schätzung wird im selben Fenster gemessen.
- Heatmap rund um deine Abrechnungswoche, CSV-Export und eine spanische Oberfläche.
- GeplantKosten von C.Write nach Cache-Dauer unterscheiden, eine Stunde gegenüber fünf Minuten.
- Wird geprüftEigenes Wochenlimit für einzelne Modelle, etwa Fable, und ob es die Wochenschätzung verzerrt.
- GeplantDokumentation einheitlich gestalten und um Italienisch ergänzen.
Ob etwas kommt, hängt davon ab, was meine Daten belegen. Nichts davon ist ein festes Versprechen.
Installation
In drei Schritten eingerichtet.
- Plugin suchen. In Obsidian unter Einstellungen, Community-Plugins, Durchsuchen nach
Token Usagesuchen. - Installieren und aktivieren. Danach erscheint das Symbol in der linken Leiste und die Seitenleiste öffnet sich.
- Claude Code nutzen. Das Plugin liest die vorhandenen Sitzungsdateien, nach der ersten Sitzung siehst du Zahlen.
Voraussetzungen: Obsidian ab Version 1.4.0 auf dem Desktop und Claude Code auf demselben Rechner. Getestet unter Windows und macOS.
Hintergrund
Gebaut aus einem eigenen Bedürfnis, mit mehr Überblick zu arbeiten.
Ich wollte eine Tankanzeige für meine Arbeit mit Claude Code und habe keine gefunden, die dort sitzt, wo ich arbeite. Also habe ich sie mit Claude Code selbst gebaut. Die Geschichte dazu steht in meinem Blog, ebenso die Fehler, die ich im Prozess gemacht habe.