CLAUDE.md: 6 Ebenen für Claude Code ohne Verluste

Claude.md Systemkonfiguration: 6 Schichten für stabiles Kontextmanagement im Claude Code

Claude Code startet jede Sitzung von null: Kein Projektwissen, keine Serverdetails, keine früheren Fixes. Das führt zu wiederholten Erklärungen und Risiken – vom Löschen von Produktionsdaten bis zum Einchecken von Geheimnissen ins Repo. Die 582-zeilige CLAUDE.md löst das mit 6 Schichten: von Regeln bis zu automatisierten Hooks. Jede Schicht entstand aus realen Vorfällen.

Vorfälle, die die Architektur prägten

Drei Pannen definierten den Ansatz:

• SNI-Proxy über localhost. Der Agent ersetzte 127.0.0.1 durch eine echte IP und brach Uploads. Ursache: Kein Verständnis, warum dieser Wert entscheidend war.
• Fail2ban-Sperre. Mehrere SSH-Logins pro Minute wurden als Brute-Force-Angriff gewertet und stoppten das Modelltraining.
• Datensatz-Löschung. Ein "Filter"-Befehl löschte Dateien statt sie nur zu verschieben.

Erkenntnisse: Regeln müssen Werte vor Änderungen prüfen, einen einzigen SSH-Tunnel erzwingen und Löschungen explizit bestätigen lassen.

Die 6-Schichten-Struktur

Schicht 1: Regeln (9 Dateien)

Kontextuell geladen: SSH-Regeln belasten keine Textaufgaben, Debug-Regeln überspringen Stilguides.

Schicht 2: Speicher (78 Dateien)

Wissensgraph mit 178 Verweisen via [[filename]]. Kern-Dateien immer im Kontext; themenspezifische bei Bedarf. Deckt Infrastruktur, Fixes und Fallstricke ab.

Schicht 3: Übergaben

Sitzungs-Zusammenfassungen: Ziel, Erfolge, Misserfolge, nächste Schritte. Beispiel:

## Sitzungsziel
Farbprüfer: CNN-Sweep + Diffusion.

## Erledigt
- CNN-Basislinie: Median 1,99 Grad (11 Mio. Parameter)
- Sweep: crop128(3,17), bs16(2,04)
- Diffusion: Epoch 5/50, Loss 0,827

## Was schiefging
- EfficientNet-B0: Hash-Konflikt
- lr=3e-4: NaN ohne Clipping

## Nächstes
Inference für Diffusion + visuelle Sheets.

27 Übergaben in 4 Tagen verhindern das Durchkauen toter Enden. Funktioniert über Abos hinweg.

Schicht 4: Chroniken

Zeitlinie von Entscheidungen: 3–7 Zeilen pro Meilenstein. Ergänzt Übergaben mit der vollen Geschichte.

Schicht 5: Hooks

Automatisierte Python-Skripte, ausgelöst durch Events (SessionStart, Stop, PreToolUse). Unabhängig vom Modellspeicher.

Beispiel-Übergabe-Hook:

# remind_handoff.py (Stop hook)
age = session_age_minutes()
if age < 15 or fresh_handoff_exists():
    return
print(json.dumps({
    "decision": "block",
    "reason": f"Sitzung {int(age)} Min., keine Übergabe aufgezeichnet."
}))

Schicht 6: Fähigkeiten (16 Kits)

Auslösebasierte Anleitungen: "Nutze das bei hängenden GPUs" statt vager Hinweise.

Hooks vs. Regeln: Ausführung garantiert

Prompt-Regeln geraten in langen Sitzungen in Vergessenheit. Hooks laufen mechanisch. Der Start-Hook prüft CLAUDE.md-Links; der Shutdown-Hook mahnt zu Übergaben.

Lieferketten-Schutz: Einzeilige Konfig

In .npmrc:

min-release-age=7

Blockt Pakete jünger als 7 Tage. Rettete uns vor dem axios-1.14.1-Angriff (Sapphire Sleet, 31. März 2026, 3-Stunden-Fenster). Python-Äquivalent in uv.toml:

exclude-newer = "7 days"

Prinzipien aus 37 Forschungsarbeiten

Verdichtet in Regeln:

• Beweis-Schleife. Keine Selbstbestätigung: Externe Beweise fordern (Tests aus frischer Sitzung).
• Strukturiertes Denken. Format: Fakten → Spur → Schlüsse → verifizierte Hypothesen. Patch-Genauigkeit: 78 % → 93 %.
• Deterministische Orchestrierung. Feste Aufgaben (Tests, Linting) via Shell-Skripte.
• Rote Linien. Harte Verbote: "Keine Löschungen ohne Bestätigung", verknüpft mit Vorfällen.

Andere: Generator-Evaluator, Multi-Agent-Aufschlüsselung, Agent-Sicherheit.

Metriken und Selbstaktualisierung

• 78 Speicherdateien, 178 Links.
• 27 Übergaben in 4 Tagen.
• 96,9 % KV-Cache-Trefferquote (83 Sitzungen).

Die Konfig validiert sich selbst: SessionStart-Hook prüft Links nach Edits.

Wichtige Erkenntnisse:

• Übergaben und Speicher verhindern Kontextverlust über Sitzungen.
• Hooks stellen kritische Aktionen sicher.
• Lieferketten-Schutz: min-release-age=7 in .npmrc / uv.toml.
• Strukturiertes Denken steigert Debug-Genauigkeit auf 93 %.
• Rote Linien minimieren Produktionsrisiken.

Minimaler Stack: Deterministische Orchestrierung + Strukturiertes Denken + Lieferketten-Schutz + Übergaben.

Repo: github.com/AnastasiyaW/claude-code-config (MIT).

— Editorial Team