Mein Open-Source-Projekt  ·  Plugin für Obsidian

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.

Von Björn-Olaf LangeVersion 2.5.1Lizenz MITOberfläche in fünf Sprachen (EN/DE/FR/IT/ES)Plattform Desktop (Mac/Win)Downloads über 1.000 (laut Obsidian, Oktober 2026)
Das Token-Usage-Dashboard mit den drei Tachos für das Fünf-Stunden-Fenster, den heutigen Tag und die laufende Woche

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.

01  Seitenleiste

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.
Die Seitenleiste mit drei Ringen, Aktivitäts-Heatmap und den Token-Arten Input, Output, Cache Write und Cache Read
02  Dashboard

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.

Der Projects-Tab des Dashboards mit Verbrauch je Vault und Projekt
03  Export

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.

Das CSV-Exportmenü im Dashboard mit den drei Exportdateien

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.

2.5.1Oktober 2026
  • 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.
Ganzer Changelog →
2.6noch ohne festen Termin
  • 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.

  1. Plugin suchen. In Obsidian unter Einstellungen, Community-Plugins, Durchsuchen nach Token Usage suchen.
  2. Installieren und aktivieren. Danach erscheint das Symbol in der linken Leiste und die Seitenleiste öffnet sich.
  3. 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.