Kostenverfolgung

Verwenden Sie diese Funktion, um die Kosten- und Nutzungshistorie von Claude Code anhand des Metriken-Protokolls zu analysieren, das der „stop:cost-tracker“- Hook von ECC schreibt.

Speicherort der Daten

Der Tracker fügt pro Session-Stop ein JSON-Objekt an die Datei ~/.claude/metrics/costs.jsonl an. Jede Zeile ist eine kumulative Momentaufnahme für diese Session. Um die Gesamtausgaben zu ermitteln, nehmen Sie daher die neueste Zeile pro session_id und summieren über alle Sessions hinweg – dabei werden die Zeilen mehrfach gezählt.

Zeilenschema:

Verwenden Sie „estimated_cost_usd“ anstelle von manuell berechneten Preisen – Modell- und Cache-Preise ändern sich, und der Tracker ist die maßgebliche Quelle.

Anwendungsfälle

• Der Nutzer fragt: „Wie viel habe ich ausgegeben?“, „Was hat diese Sitzung gekostet?“ oder „Wie hoch ist mein Token-Verbrauch?“
• Der Benutzer erwähnt Budgets, Ausgabenobergrenzen, Überschreitungen oder Kostenkontrollen.
• Der Nutzer wünscht eine Kostenaufschlüsselung nach Modell, Sitzung oder Datum oder einen CSV-Export.

So funktioniert es

Überprüfen Sie zunächst, ob das Protokoll vorhanden ist (verwenden Sie „node“, nicht „sqlite3“ – der Tracker schreibt JSONL, und „node“ ist plattformübergreifend):

node -e 'const fs=require("fs"),os=require("os"),p=require("path");const f=p.join(os.homedir(),".claude","metrics","costs.jsonl");console.log(fs.existsSync(f)?"Kostenprotokoll gefunden":"Kostenprotokoll nicht gefunden: "+f)'

Falls das Protokoll fehlt, dürfen keine Nutzungsdaten erfunden werden. Teilen Sie dem Nutzer mit, dass die Kostenverfolgung erst nach Beendigung der ersten Sitzung mit aktiviertem „stop:cost-tracker“-Hook mit Daten gefüllt wird.

Beispiel – Zusammenfassung nach Modell für die letzten 7 Tage

node -e '
const fs=require("fs"),os=require("os"),path=require("path");
const f=path.join(os.homedir(),".claude","metrics","costs.jsonl");
if(!fs.existsSync(f)){console.log("Kostenprotokoll nicht gefunden: "+f);process.exit(0);}
const rows = fs.readFileSync(f, „utf8“).split(/\r?\n/).filter(Boolean).map(l => { try { return JSON.parse(l) } catch { return null } }).filter(Boolean);
const bySession = new Map();
for (const r of rows) { const k = r.session_id || r.transcript_path || r.timestamp; const p = bySession.get(k); if (!p || String(r.timestamp)>String(p.timestamp)), bySession.set(k, r);}
const latest = [...bySession.values()];
const cost = r => Number(r.estimated_cost_usd) || 0, day = r => String(r.timestamp || "").slice(0, 10), sum = a => a.reduce((s, r) => s + cost(r), 0), f4 = n => "$" + n.toFixed(4);
const today = new Date().toISOString().slice(0, 10), yest = new Date(Date.now() - 864e5).toISOString().slice(0, 10);
console.log("heute: "+f4(sum(latest.filter(r=>day(r)===today)))+" | gestern: " + f4(sum(latest.filter(r => day(r) === yest))) + " | insgesamt: " + f4(sum(latest)) + " (" + latest.length + " Sitzungen)");
const m = new Map(); for (const r of latest) { const k = r.model || „(unknown)“; m.set(k, (m.get(k) || 0) + cost(r)); }
console.log(„nach Modell:“); [...m.entries()].sort((a, b) => b[1] - a[1]).forEach(([k, v]) => console.log("  " + f4(v) + "  " + k));
'

Für einen Sitzungs-Drilldown oder einen CSV-Export durchlaufen Sie denselben aktuellen Datensatz (oder die Rohdatenzeilen für CSV) und geben Sie die benötigten Felder aus.

Hinweise zur Berichterstellung

Bei der Darstellung von Kostendaten sollten Sie die heutigen Ausgaben im Vergleich zu gestern, die Gesamtsumme über alle Sitzungen, eine Aufschlüsselung nach Modellen und die Anzahl der Sitzungen angeben. Formatieren Sie Beträge unter einem Dollar mit vier Dezimalstellen, größere Beträge mit zwei.

Anti-Muster

• Summieren Sie nicht jede Zeile – die Werte sind pro Sitzung kumulativ; reduzieren Sie die Daten zunächst auf die aktuellste Zeile pro session_id.
• Schätzen Sie die Kosten nicht anhand der rohen Token-Anzahlen, wenn „estimated_cost_usd“ vorhanden ist.
• Gehen Sie nicht davon aus, dass das Protokoll vorhanden ist, ohne dies zu überprüfen.
• Harten Sie die aktuellen Modellpreise nicht in benutzersichtbaren Antworten fest ein.
• Empfehlen Sie nicht die Installation von nicht geprüften Hooks oder Plugins, die beliebigen Code ausführen.

Verwandte Themen

• /cost-report – Bericht im Befehlsformat über dasselbe Metriken-Protokoll.
• cost-aware-llm-pipeline – Muster für Modell-Routing und Budgetgestaltung.
• token-budget-advisor – Kontext- und Token-Budget-Planung.
• strategic-compact – Kontextkomprimierung zur Reduzierung wiederholter Token-Ausgaben.