Automatischer Push: 46 Datei(en) geändert

- .claude/agents/planer.md - .claude/settings.json - .claude/workflows/executer-welle.js - .claude/workflows/plankritik.js - .claude/workflows/planung.js - .claude/workflows/quorum.js - .claude/workflows/verbrauch.js - .claude/workflows/welle-mit-pruefung.js - .vault-tools/shell-wache/ENTWURF.md - .vault-tools/shell-wache/docs/code/shell_wache.md - .vault-tools/shell-wache/docs/plans/2026-10-30-shell-wache/00-uebersicht.md - .vault-tools/shell-wache/docs/plans/2026-10-30-shell-wache/task-01-shell-wache.md - … und 34 weitere Erzeugt vom PostToolUse-Hook .vault-tools/auto-push/auto_push.py. Co-Authored-By: Claude Opus 5 <[email protected]>
2026-10-31 03:00:01 +01:00
1 parent f2ccec39d6
commit 13213ea0ac
@@ -0,0 +1,88 @@
+---
+type: resource
+status: active
+title: "Verbrauchsauswertung: Tokens und Listenpreis aus den Claude-Code-Transkripten"
+summary: "analyse_transkripte.py zählt je Nachricht Tokens, Modell, Effort und Listenpreis über alle Transkripte eines projects-Ordners, mit Auswahl einzelner Sitzungen für Effort-Messungen; dazu zwei Hilfsskripte für die Ablageorte unter D:\\ClaudeData. Entstanden 2026-10-30 im Workflow-Review."
+tags: [vault-tools, codeworkflow]
+created: 2026-10-30
+updated: 2026-10-30
+---
+
+# Verbrauchsauswertung — Anleitung
+
+Zählt, wo Tokens und Listenpreis hingehen: je Modell, Effort, Woche, Sitzung, Subagent und Werkzeug. Warum so: [Hintergrund](LIESMICH-hintergrund.md)
+
+**Voraussetzungen**
+
+- Python ab 3.12 unter dem Befehl `python`.
+- Lesezugriff auf den projects-Ordner von Claude Code, auf dieser Maschine `D:\ClaudeData\config\projects`.
+- Ein Ausgabeordner **außerhalb des Vaults**, etwa das Scratchpad der Sitzung unter `D:\ClaudeData\claude\D--Claude\<sitzung>\scratchpad`.
+
+**Schritte**
+
+1. Fälle fahren, bevor du Zahlen verwendest:
+
+   ```bash
+   # Fixture und Mutanten, rund 5 Sekunden
+   python -I -X utf8 .vault-tools/verbrauch-auswertung/faelle.py
+   ```
+
+2. Auswertung starten:
+
+   ```bash
+   # Gesamtauswertung ab dem Stichtag, Ausgabe ins Scratchpad
+   python -I -X utf8 .vault-tools/verbrauch-auswertung/analyse_transkripte.py D:/ClaudeData/config/projects --ausgabe "D:/ClaudeData/claude/D--Claude/<sitzung>/scratchpad/verbrauch" --seit 2026-10-01
+   ```
+
+   ⚠ Ein Ausgabeordner im Vault bricht mit Exit 2 ab. Das ist Absicht.
+
+3. Für eine Messung einzelne Sitzungen auswählen:
+
+   ```bash
+   # Sitzungen, deren Titel, Slug oder Kennung den Ausdruck trifft; schreibt zusätzlich auswahl.md
+   python -I -X utf8 .vault-tools/verbrauch-auswertung/analyse_transkripte.py D:/ClaudeData/config/projects --ausgabe "<scratchpad>/verbrauch" --seit 2026-10-30 --auswahl "paket 1|paket 2"
+   ```
+
+   ⚠ Die Kennung ist die der Claude-Code-Sitzung (Dateiname des Transkripts), nicht die `local_…`-Kennung der App. Sicher zuordnen kannst du nur über den Titel.
+
+4. Ablageorte ansehen, wenn es ums Aufräumen geht:
+
+   ```bash
+   # Zufallsordner unter D:\ClaudeData nach Alter und Größe
+   python -I -X utf8 .vault-tools/verbrauch-auswertung/claudedata_wurzel.py D:/ClaudeData
+   # Scratchpads ab 50 MB, laufende Sitzungen als Kennungsanfänge angeben
+   python -I -X utf8 .vault-tools/verbrauch-auswertung/scratchpads.py --laufend 370f5095,13a29464
+   ```
+
+   ⚠ Beide Skripte löschen nichts und wissen nicht, welche Sitzung läuft. Das liest du in der App nach.
+
+**Prüfen**
+
+- `faelle.py` endet mit „11 Fälle grün; 10 von 10 Mutanten gefangen“ und Exit 0.
+- Die erste Zeile der Auswertung nennt Dateien, Zeilen, Sekunden, Kopien und Nachrichten mit Teilausgabe.
+- `auswertung.md` nennt unter dem Kopf die Teilausgaben nach Claude-Code-Version. Tauchen dort Versionen ab 2.1.308 auf, stimmt die Annahme zur Teilausgabe nicht mehr; dann erst nachsehen, dann Zahlen weitergeben.
+- In `auswertung.md` stehen Sitzungstitel. Kopierst du Tabellen in den Vault, prüfst du sie vorher auf Kundennamen.
+
+## Ausgabe
+
+| Datei | Inhalt |
+|---|---|
+| `auswertung.md` | Tabellen je Modell, Effort, Woche, teuerste Sitzungen, Kontextgröße, Subagenten, Werkzeuge, Lesezugriffe |
+| `auswertung.json` | dieselben Summen plus je Sitzung und Subagent ein Datensatz, zum Weiterrechnen |
+| `auswahl.md` | nur mit `--auswahl`: je getroffene Hauptsitzung Effort, Runden, Dauer, Ausgabe je Runde, USD; darunter ihre Subagenten nach Typ und Effort |
+
+## Fassungen
+
+| Fassung | Datum | Änderung |
+|---|---|---|
+| 2 | 2026-10-30 | Größter usage-Wert je Nachricht, Deduplizierung über Dateien, Haiku-5.5-Stufe über 100k. Als Werkzeug abgelegt mit `--ausgabe`, Vault-Sperre, `--seit`, `--auswahl`, Teilausgabe nach Version, Typprüfung je Zeile. |
+
+## Dateien
+
+| Datei | Zweck |
+|---|---|
+| `analyse_transkripte.py` | die Auswertung |
+| `faelle.py` | Regressionstreiber: Fälle unter `fixture/` und Mutanten |
+| `fixture/` | je Fall ein synthetischer projects-Ordner mit zwei bis drei JSONL-Zeilen |
+| `claudedata_wurzel.py` | Einträge unter `D:\ClaudeData` nach bekannt und zufällig benannt |
+| `scratchpads.py` | Sitzungs-Scratchpads mit Größe, Titel und Alter |