Was ist eine CLAUDE.md-Datei?

Eine CLAUDE.md-Datei liegt im Repo-Root und beschreibt Claude den Projekt-Kontext: Stack, Konventionen, wichtige Pfade, Workflows. Claude Code liest sie automatisch beim Start jeder Session und nutzt sie als Onboarding für das jeweilige Projekt.

Wozu dienen Memories in Claude Code?

Memories sind das Langzeitgedaechtnis von Claude. Sie speichern Praeferenzen, Entscheidungen und Lernpunkte über Sessions hinweg. Du arbeitest weiter, ohne jedes Mal alles neu zu erklären. Ideal für wiederkehrende Aufgaben und langlaufende Projekte.

Warum sind Code-Kommentare in der KI-Aera wichtiger geworden?

KI liest deinen Code blitzschnell, aber das Warum hinter Entscheidungen steht selten im Code selbst. Gut platzierte Kommentare erklären Trade-offs und Annahmen, sodass KI und Mensch Monate später nachvollziehen können, warum etwas so gebaut wurde.

Wie unterscheiden sich Memories von CLAUDE.md?

CLAUDE.md ist projekt-spezifisch und im Repo versioniert, sichtbar für alle. Memories sind nutzer-spezifisch und persistent, aber nicht im Code. Faustregel: Was alle im Team brauchen, gehört in CLAUDE.md. Was nur deinen Workflow betrifft, in Memories.

Lohnt sich das für kleine Projekte?

Ja, sogar besonders. Bei kleinen Projekten bleibt der Setup-Aufwand minimal, der Hebel ist gross: KI versteht in der naechsten Session sofort, womit sie es zu tun hat. Du sparst die ersten 10 Minuten Kontext-Aufbau jedes Mal.

Memories, CLAUDE.md und Code-Kommentare

Die meisten Menschen nutzen KI wie einen Taschenrechner. Frage rein, Antwort raus, Tab schließen. Kein Kontext, kein Gedächtnis, kein Aufbau. Jede Session beginnt bei Null.

Das ist wie jeden Morgen einen neuen Mitarbeiter einzustellen, ihm nichts über das Unternehmen zu erzählen, und sich zu wundern warum er langsamer ist als der letzte.

// 01 / 04Die drei Säulen

Memories

Persistentes Wissen über Projekte, Präferenzen, Tech-Stack und Kontext. Claude erinnert sich an dein Setup, deinen Schreibstil, deine Repos.

Effekt: Null Onboarding-Zeit. Jede Session beginnt da wo die letzte aufgehört hat.

CLAUDE.md

Projektspezifische Konfigurationsdatei im Repo-Root. Definiert Regeln, Konventionen, Verbote und Präferenzen für genau dieses Projekt.

Effekt: Claude kennt die Spielregeln bevor er eine Zeile Code schreibt.

Code-Kommentare

Nicht was der Code tut, warum er so gebaut ist. Entscheidungskontext, Trade-offs, Anpassungsstellen. Für dein zukünftiges Ich und für Claude.

Effekt: Wartbarkeit steigt. Onboarding-Zeit sinkt. Fehlerquote fällt.

// 02 / 04Memories: Das Langzeitgedächtnis

Claude's Memories sind kein Chat-Verlauf. Sie sind destilliertes Wissen, extrahiert aus hunderten Gesprächen, verdichtet auf das Wesentliche. Dein Tech-Stack. Deine Repos. Deine Deployment-Workflows. Deine Schreibstil-Präferenzen.

Gut gepflegte Memories eliminieren die grösste Produktivitätsbremse bei KI-Nutzung: den kalten Start. Statt bei jeder Session "Ich arbeite an Projekt X mit Tech-Stack Y" zu erklären, weiß Claude das bereits. Die Session beginnt bei der eigentlichen Arbeit.

// 03 / 04CLAUDE.md: Das Projekt-Onboarding

Eine Datei im Repo-Root. Markdown. Wird von Claude Code automatisch gelesen. Darin steht alles was Claude über das Projekt wissen muss, ohne dass du es bei jeder Session erklärst.

# CLAUDE.md, while.chat

## Projekt
Static Blog, Vanilla HTML/CSS/JS, Three.js
Repo: VibeGoette/while-chat, Deploy: Vercel

## Regeln
- Kein Reading-Mode-Toggle
- Keine Emojis in UI oder Content
- Datum: Nur Monat + Jahr
- Shared style.css: NIE inline duplizieren
- Git: max@while.chat / VibeGoette

## Deploy-Workflow
HTML in posts/, Card in artikel/index.html,
sitemap.xml updaten, git push → Vercel auto-deploy

Das ist keine Dokumentation. Das ist ein Vertrag zwischen dir und deinem KI-Assistenten. Je präziser der Vertrag, desto weniger Korrekturen. Je weniger Korrekturen, desto mehr echte Arbeit pro Session.

// 04 / 04Code-Kommentare: Das Warum dokumentieren

Schlechter Kommentar: // Cookie-Banner anzeigen, das sieht man am Code.

Guter Kommentar: // Cookie-Banner: DSGVO-konform nach TDDDG §25. 2-Klick-Lösung weil Google Fonts erst nach Consent geladen werden. Anpassen: Zeile 34 für Custom-Font-URLs, Zeile 51 für andere Cookie-Kategorien.

Der Unterschied: Der erste Kommentar ist für Menschen die den Code lesen. Der zweite ist für Menschen (und KI-Agenten) die den Code ändern müssen.

Weiterführend: Snippet-Bibliothek auf GitHub zeigt Context Engineering in der Praxis. SKILL.md Aufbau ist die technische Referenz. Claude Skills erstellen führt durch den Workflow. Und der Vibe Coding Guide zeigt wie alles zusammenspielt.

Häufige Fragen

Quellen

Anthropic, "Agent Skills", platform.claude.com/docs
Claude Code Docs, "Extend Claude with Skills", code.claude.com/docs
Anthropic, "The Complete Guide to Building Skills for Claude", resources.anthropic.com

Verwandt: Implizites Wissen und Maschinentraining

// micro-journal

Was sollte als Erstes in deine CLAUDE.md?

Ein Satz reicht. Das Journal bleibt lokal in deinem Browser — kein Konto, kein Server.

notierenMG

Max Götte

SEO Strategist · Founder · while.chat

SEO-Berater aus Bochum. Spezialisiert auf technisches SEO, Local SEO und Generative Engine Optimization für KMU im DACH-Raum. Von Audit über Content-Strategie bis Local SEO, evidenzbasiert, ohne Hype-Versprechen.

projekt anfragen → WhatsApp mehr Artikel