Claude Usage Tracker

Was ist Claude Usage Tracker?

Claude Usage Tracker ist ein Local-First-Tool, das Claude AI-Nutzungskosten automatisch über mehrere lokale Entwicklungstools erkennt und aggregiert. Es scannt bekannte Datenverzeichnisse, parst JSONL-/Logdateien, berechnet Kosten basierend auf modell-spezifischen Preisen und zeigt die Ergebnisse in einem interaktiven Dashboard an.

Der Kernzweck ist die Kostenverfolgung und -visualisierung – so können Sie Ausgaben nach Quelle, Modell und Zeitraum prüfen, ohne Nutzungsdaten in die Cloud zu senden. Alles läuft lokal auf Ihrem Rechner, das Dashboard basiert auf Chart.js.

Wichtige Funktionen

• Erkennt automatisch 9+ Claude-integrierte Tools und fasst Nutzungsdaten zu einer einheitlichen Ansicht zusammen.
• Kostenberechnung mit modell-spezifischen Preisen pro Million Tokens für Anthropic-Modellfamilien (Opus, Sonnet, Haiku), inklusive Input/Output und Cache-Lesen/Schreiben wo zutreffend.
• Dark-themed interaktives Dashboard mit Chart.js inklusive visueller Diagramme und Aufschlüsselungen.
• Zeitbasierte Kostenverfolgung mit Ansichten für täglich, wöchentlich, monatlich und Gesamtzeitraum.
• Modell- und Quellenanalysen inklusive Kostenaufteilung pro Modell und Filter (Quelle, Modell, Datumsbereich, Mindestkosten).
• Spitzenmuster-Visualisierung via Heatmaps und zwei Ansichten: Peak Hours (Tag × Stunde-Gitter) und Peak Days (GitHub-Style-Kalender).
• Sitzungsdetails inklusive erweiterbarem Sitzungslog mit farbcodierten Quellenkarten, pro-Sitzung-Kostenhinweisen (z. B. teuerste Sitzung) und Sitzungsdetails-Panel.
• Projektkadenz-Prognose mit monatlichen Prognosen basierend auf dem aktuellen Ausgaberhythmus.
• macOS-App-Bundle-Option zum Erstellen einer eigenständigen .app für Double-Click-Start.

So verwenden Sie Claude Usage Tracker

1. Installieren und starten Sie entweder die neueste Release (empfohlen) oder führen Sie das Tool lokal aus dem Quellcode aus.
2. Führen Sie einen Scan durch, um Daten zu sammeln und das Dashboard zu rendern: Die macOS-App sammelt frische Daten und zeigt das interaktive Dashboard an, der Browser-Modus startet einen lokalen Server und lädt dashboard.html.
3. Erkunden Sie das Dashboard, um Gesamtkosten zu prüfen und sie nach Quelle/Modell sowie Zeitraum mit Diagrammen, Heatmaps und Filtern aufzuschlüsseln.

Quick-Start-Optionen (aus dem Repository):

• macOS (Apple Silicon/Intel): Neueste Release herunterladen, entpacken, Claude Usage Dashboard.app in Programme verschieben, dann per Double-Click starten.
• Aus Quellcode bauen: Repo klonen, ./build-app.sh ausführen, dann die gebaute App per Double-Click starten.
• Browser-Modus (beliebiges OS): node collect-usage.js ausführen, lokalen Server mit python3 -m http.server 8765 starten und http://localhost:8765/dashboard.html öffnen.

Anwendungsfälle

• Ausgaben über mehrere Claude-Tools konsolidieren: Wenn Sie lokale Integrationen nutzen (z. B. Cursor, Windsurf, Claude Desktop und Continue.dev), fasst der Tracker die Nutzung in ein Dashboard zusammen.
• Höchste Ausgaben identifizieren: Nutzen Sie Peak Hours (Tag × Stunde-Heatmap) und Peak Days-Kalender, um teuerste Zeiten und Tage zu finden.
• Sitzungen oder Tage prüfen: Erweitern Sie den Sitzungslog für ein Datum, um pro-Sitzung-Kosten zu inspizieren sowie Token-Aufschlüsselung und Konversationsverlauf im Detail-Panel.
• Tagesvergleiche: Nutzen Sie Yesterday Delta, um Ausgaben von heute mit gestern zu vergleichen.
• Monatsprognosen planen: Prüfen Sie Monthly Projections, um monatliche Kosten basierend auf dem aktuellen Rhythmus zu schätzen.

FAQ

• Sendet der Tracker Nutzungsdaten an einen Server? Nein. Die Projektbeschreibung betont „No cloud“ und „No telemetry“, alles bleibt auf Ihrem Rechner.

• Welche Tools werden unterstützt? Das Repository listet Claude-Nutzung von OpenClaw/Clawdbot, Claude Code CLI, Claude Desktop (Local-Agent-Modus), Cursor, Windsurf, Cline, Roo Code, Aider und Continue.dev. Die Tool-Erkennung ist automatisch.

• Welche Datenformate werden gelesen? Es scannt bekannte Verzeichnisse und parst JSONL-/Logdateien; der Abschnitt zu unterstützten Tools spezifiziert JSONL für jedes Tool.

• Was, wenn ein Tool nicht installiert ist oder keine Daten hat? Die Tool-Erkennung wird so beschrieben: Fehlende Installation oder Daten werden stillschweigend übersprungen.

• Wie werden Kosten berechnet? Kosten basieren auf Anthropics Preisen pro Million Tokens für unterstützte Modellfamilien (Opus, Sonnet, Haiku), unter Berücksichtigung von Input/Output und Cache-Lesen/Schreiben wo angegeben.

Alternativen

• Lokale Log-Analyse + Tabellenkalkulationen: Exportieren oder sammeln Sie Ihre Claude-Nutzungslogs und berechnen Sie Kosten manuell in einer Tabellenkalkulation. Das ist manueller als ein interaktives Dashboard, passt aber zu individuellen Workflows.
• Nutzungs-Dashboards der Anbieter (falls verfügbar): Manche Anbieter bieten Nutzungsübersichten für Abrechnung und Berichterstattung. Diese konzentrieren sich meist auf ein einzelnes Produkt/Konto statt Aggregation über mehrere lokale Tools.
• Allgemeine Entwickler-Zeit-/Kosten-Analyse-Tools: Tools, die IDE-Aktivitäten analysieren oder Kosten basierend auf Nutzungsevents berechnen, können helfen, modellieren aber oft keine Claude-spezifischen Token-Preise und parsen nicht automatisch die Speicherformate der Tools.
• Andere Local-First-Monitoring-Dashboards: Ähnliche Tools, die lokale Logs im Browser visualisieren, bieten vergleichbare Diagramme, erfordern aber oft Datenaufbereitung statt Auto-Detection und JSONL-Parsing des Trackers.