diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..61fd621
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,34 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Projektübersicht
+
+**python_template** ist ein Python-Projekttemplate mit Standard-Verzeichnisstruktur und
+Umgebungsverwaltung über `bin/`-Skripte. Es dient als Ausgangspunkt für neue Projekte
+(die `bin/`-Skripte verwalten nur Umgebung und pip-Installation; sie rufen kein
+konkretes Fachskript auf).
+
+## Projektstruktur
+
+```text
+python_template/
+├── bin/          # .bat-Skripte: setenv, install_py, manage_interpreter, get_cmd, dia
+├── lib/          # Python-Quellcode (dia.py) + requirements.txt
+├── cfg/          # Konfiguration
+├── data/         # Daten
+├── work/         # Arbeitsverzeichnis
+└── log/          # Log-Dateien
+```
+
+## Umgebungsvariablen (setenv)
+
+`setenv.bat` setzt Projektvariablen (`PROJECT`, `PV_BIN`, `PV_LIB`, `PV_CFG`, `PV_DATA`,
+`PV_LOG` …) und erweitert `PYTHONPATH` um `lib/`.
+
+## Setup
+
+```cmd
+bin\install_py.bat
+```
+Legt die virtuelle Umgebung an und installiert `lib/requirements.txt`.