diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..6b3efc0
--- /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
+
+**SimulationTuplesort** ist ein Werkzeug zur Simulation verschiedener Sortierverfahren in
+einer Anlage — **Picksort** und **Tuplesort**. Modelliert werden Kreisel (`Roundabout`),
+Weichen (`Switch`) und deren Zusammenspiel; das Verhalten wird über Unittests
+veranschaulicht (siehe `README.md` mit Animationen in `video/`).
+
+## Projektstruktur
+
+```text
+SimulationTuplesort/
+├── Roundabouts.py    # Simulationslogik (Roundabout, Switch, Sortierverfahren)
+├── doc/              # Dokumentation
+├── video/            # Animationen der Verfahren (picksort.gif u. a.)
+├── LICENSE
+└── README.md
+```
+
+## Konzept
+
+- **Picksort:** holt bei jeder Umdrehung das kleinstmögliche Objekt aus dem ersten
+  Kreisel → sortierte Liste im zweiten Kreisel.
+- **Tuplesort:** alternatives Verfahren (siehe README).
+
+## Nutzung
+
+```cmd
+python Roundabouts.py
+```
+Beispiel/Unittest siehe `README.md` (`Roundabout`, `Switch`).