diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..c7cf493
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,47 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Projektübersicht
+
+**Milchwaerme** ist ein Kommandozeilen-Werkzeug zur Auslegung einer Wärmerückgewinnung
+aus der Milchkühlung. Aus der täglich zu kühlenden Milchmenge werden Wärmepumpe,
+PV-Anlage, Batterie und Natriumacetat-Latentspeicher dimensioniert — inklusive
+Abhollogistik, versorgbarer Haushalte und Brennstoffkosten-Vergleich. Alle Annahmen
+liegen in einer `config.json`, sodass Varianten ohne Codeänderung nachgerechnet werden.
+
+## Konzept
+
+```text
+Milchabwärme (37→4 °C) ─► Wärmepumpe (PV-Strom) ─► Latentspeicher (Natriumacetat, 58 °C) ─► Abholung per LKW
+```
+
+## Projektstruktur
+
+```text
+Milchwaerme/
+├── bin/          # Start-Skripte (.bat/.sh): setenv, auslegung, revival, get_cmd
+├── lib/          # Python-Quellcode
+│   ├── auslegung.py   # Berechnungsprogramm
+│   ├── report_md.py   # Markdown-Report
+│   └── revival.py     # Revival-/Zusatzberechnung
+├── cfg/          # Konfiguration (config.json mit allen Annahmen)
+├── doc/          # Dokumentation
+└── out/          # Ausgaben
+```
+
+## Voraussetzungen
+
+- Python 3.8+
+- Keine externen Abhängigkeiten (nur Standardbibliothek)
+
+## Nutzung
+
+```cmd
+bin\auslegung.bat
+```
+```bash
+bin/auslegung.sh
+```
+
+Varianten rechnet man durch, indem man `config.json` kopiert und anpasst.