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. Bis Version 2.1 hat Token Usage daraus eine Schätzung aus deinen eigenen Limit-Treffern gemacht, und gegen die offiziellen Werte gemessen lag sie beim Fünf-Stunden-Fenster im Schnitt 36 Punkte daneben (eigene Messung, 37 Ablesungen, Oktober 2026). Seit 2.5 zeigt das Plugin für Claude Code, auch im Agent Mode der Claude Desktop App, einen Prozentwert deshalb nur noch, wenn er von Anthropic selbst kommt, immer mit der Uhrzeit der Ablesung.
Alles andere wird gezählt statt geschätzt: deine Tokens im laufenden Fenster und in der Woche, die Zeit bis zum Reset und die Spanne, in der dein Fenster bisher voll war. Die Spanne ist breit, und genau das ist die ehrliche Antwort.
Eine Schätzung, die im Schnitt 36 Punkte danebenliegt, hilft niemandem, deshalb zeige ich seit 2.5 nur noch, was Anthropic selbst meldet. 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 zeigen den offiziellen Prozentwert von Anthropic mit der Uhrzeit der Ablesung, der heutige Tag das Vielfache deines üblichen Tages. 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 kommt aus dem offiziellen Feed oder aus deiner eigenen Historie und folgt der Zeitumstellung. 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.
- Prozentwerte nur noch von Anthropic, mit der Uhrzeit der Ablesung, die Woche dazwischen gekennzeichnet hochgerechnet.
- Ohne Feed zeigt das Plugin gezählte Tokens, die Zeit bis zum Reset und die Spanne, in der dein Fünf-Stunden-Fenster bisher voll war.
- Zwei Sicherheitslücken geschlossen, die wir selbst gefunden haben (Dashboard und CSV-Export), dazu ein Wochen-Reset, der der Zeitumstellung folgt.
- Wird geprüftOffizielle Ablesungen auch ohne Statuszeile, ohne dass jede Ablesung eine eigene kleine Anfrage kostet.
- Wird geprüftDen Anteil der Anfragen mit großem Kontext zählen und zeigen, so wie ihn /usage seit Oktober 2026 nennt.
- GeplantBilder der aktuellen Oberfläche in der Dokumentation, in allen fünf Sprachen.
- GeplantDie Tokens insgesamt seit Beginn der Aufzeichnung, mit dem Hinweis, dass die Summe nur so weit zurückreicht wie die Logs von Claude Code und das Tagesarchiv.
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, eigentlich nur für mich. Heruntergeladen wurde sie inzwischen über 1.000 Mal. Die Geschichte dazu steht in meinem Blog, ebenso die Fehler, die ich im Prozess gemacht habe.