Jede lange Claude Code-Sitzung endet auf dieselbe Weise: Du verlierst Stunden an Arbeit und musst von vorne beginnen.
Die Lösung ist kein intelligenteres Modell, sondern ein System, das das Claude Code-Team intern nutzt – und für das es nie eine Anleitung geschrieben hat.
Die meisten Entwickler haben es nicht und wissen nicht einmal, dass es existiert.
Hier ist das vollständige System 👇
🧠 Bevor wir eintauchen: Ich teile tägliche Notizen zu KI und Vibe Coding in meinem Telegram-Kanal: https://t.me/zodchixquant
Was Context Engineering eigentlich bedeutet
Claude liest in jeder Sitzung tausende Zeilen. Das meiste ist Rauschen, und die 5 %, die wirklich zählen, sind nach zwei Stunden vergraben.
Dann fängt Claude an, Funktionen zu erfinden und Bugs zu beheben, die du nie geschrieben hast. Die Lösung ist kein größeres Modell, sondern die Kontrolle darüber, was in die Sitzung gelangt.
Das sind die 6 Patterns, die das Claude Code-Team in seinem eigenen Monorepo verwendet.
Pattern 1: Gestaffelte CLAUDE.md (Schritte 1–3)
Eine einzelne CLAUDE.md reicht nicht. Das Claude Code-Team verwendet drei Ebenen, jede mit einem eigenen Fokus.
Schritt 1: Root-CLAUDE.md mit projektweiten Regeln
Lege eine CLAUDE.md im Stammverzeichnis deines Repos an. Halte sie unter 100 Zeilen. Sie sollte vier Fragen beantworten, die Claude bei jedem Prompt hat:
1# Projekt: [Name]23## Stack4- Runtime: Node 22, TypeScript 5.55- Framework: Next.js 15, React 196- Datenbank: Postgres 16, Drizzle ORM7- Tests: Vitest, Playwright89## Konventionen10- Importe: absolute Pfade nur über `@/`11- Komponenten: Dateien in kebab-case, Exports in PascalCase12- Tests: direkt neben der Datei als `[Datei].test.ts`13- Commits: Conventional Commits, kein Co-Author-Footer1415## Nicht anfassen16- `infra/terraform/` (wird von Ops verwaltet)17- `migrations/` (generiert, niemals von Hand bearbeiten)18- `vendor/` (abhängige Pakete, fest eingecheckt)1920## Standardabläufe21- `npm test` ausführen, bevor eine Aufgabe als erledigt markiert wird22- Typcheck mit `tsc --noEmit` nach jeder Bearbeitung23- Formatierung mit Prettier beim Speichern
Schritt 2: Unterverzeichnis-CLAUDE.md für modulspezifischen Kontext
Füge CLAUDE.md in jedem Ordner hinzu, in dem die Regeln abweichen. Claude liest die nächstgelegene Datei, wenn er in diesem Ordner arbeitet – zusätzlich zur Root-CLAUDE.md.
Beispiel: src/auth/CLAUDE.md:
1# Auth-Modul23Dieses Modul verwaltet Sitzungsverwaltung und OAuth-Abläufe.45## Regeln6- Niemals Tokens loggen, auch nicht gekürzt7- Alle Sitzungsabfragen erfolgen über `getSession()`, niemals über rohe Cookies8- Neue Anbieter erfordern vor dem Merge ein Sicherheits-Review910## Zuerst zu lesende Dateien11- `session.ts` für das Interface12- `providers/index.ts` für das Registry-Pattern
Schritt 3: Persönliche CLAUDE.md unter ~/.claude/CLAUDE.md
Das ist deine globale Präferenzebene. Sie liegt außerhalb jedes Repos und gilt überall.
1## Meine Präferenzen - Erkläre mir, was du tun willst, bevor du es tust, bei Datei-übergreifenden Änderungen - Widersprich mir, wenn meine Anfrage wahrscheinlich etwas kaputt macht - Bevorzuge Komposition vor Vererbung - Ich arbeite in zsh auf macOS
Die drei Ebenen stapeln sich: globale Präferenzen + Projektregeln + Modulregeln. Claude liest bei jedem Prompt alle drei, ohne sie erneut in seinen Kontext hochladen zu müssen.
Pattern 2: Gezielte Dateireferenzen (Schritte 4–5)
Der Standard „Lass Claude selbst herausfinden, welche Dateien wichtig sind" ist die langsamste, dümmste Art, Kontext zu nutzen.
Schritt 4:@file-Referenzen mit Autovervollständigung
Wenn du in einem Prompt @ eingibst, öffnet Claude eine Fuzzy-Dateiauswahl. Nutze sie, anstatt Dateien in Prosa zu beschreiben.
Schlecht: „Sieh dir den Code zur Benutzerauthentifizierung und den Sitzungshelfer an"
Gut: „Sieh dir
@src/auth /session.ts und
@src/auth /providers/google.ts an, behebe die Token-Aktualisierung"
Gezielte Referenzen laden exakt diese Dateien. Beschreibungen in Prosa zwingen Claude zu suchen, 4–5 Kandidatendateien zu lesen und in der Hälfte der Fälle die falsche auszuwählen.
Schritt 5: /focus, um einen gesamten Workflow einzugrenzen
Bei längeren Aufgaben schränke Claudes gesamte Sitzung auf bestimmte Ordner ein:
1/focus src/auth src/api/auth-routes
Jetzt arbeiten alle Such-, grep- und Lesevorgänge nur noch innerhalb dieser beiden Ordner.
Reduziert die Kontextnutzung bei fokussierten Aufgaben um 60–80 %, und Claude hört auf, „hilfreich" irrelevante Dateien für Kontext zu lesen, den es nicht braucht.
Führe /focus clear aus, um zurückzusetzen.
Pattern 3: Komprimieren und weitermachen (Schritte 6–8)
Lange Sitzungen erreichen das Kontextlimit und stürzen ab. Der Trick ist nicht, lange Sitzungen zu vermeiden, sondern sie durch kontrollierte Komprimierung zu führen.
Schritt 6: Kontextnutzung mit /stats überwachen
Führe regelmäßig /stats aus.
Wenn du über 70 % Kontextnutzung bist, bist du in der Gefahrenzone. Über 85 % beginnt Claude, frühere Nachrichten fallen zu lassen, ohne dich zu informieren.
Schritt 7: /compact mit Erhaltungsanweisungen
/compact allein fasst die Konversation zusammen. Mit Anweisungen sagst du Claude, was wörtlich erhalten bleiben soll:
1/compact preserve: aktueller Aufgabenplan, alle Entscheidungen zum Auth-Refactoring, die Ausgabe des fehlgeschlagenen Tests aus Schritt 3
Schritt 8: /resume für Sitzungen über mehrere Tage
Wenn eine Aufgabe mehrere Tage dauert, beende jede Sitzung mit /compact preserve: … und starte die nächste mit:
1claude --resume [Sitzungs-ID]
Oder einfach claude --continue für die letzte Sitzung. Sie setzt genau dort fort, wo du aufgehört hast, mit dem komprimierten Zustand intakt.
Pattern 4: Lesen vor dem Schreiben (Schritte 9–10)
Das größte Kontextleck ist, wenn Claude Dateien bearbeitet, bevor es sie versteht. Der Plan-Modus zwingt Claude, zuerst zu lesen, dann zu schreiben.
Schritt 9: Plan-Modus bei jeder riskanten Aufgabe aktivieren
Drücke Shift+Tab, um vor jeder Aufgabe, die mehr als eine Datei betrifft, in den Plan-Modus zu wechseln.
Im Plan-Modus kann Claude nur lesen. Es erklärt, was es tun würde, listet jede Datei auf, die es bearbeiten will, und zeigt die vorgeschlagenen Änderungen. Nichts wird ausgeführt, bis du es genehmigst.
Die Einsparungen sind real: Einmal lesen, einmal bearbeiten, statt: 8-mal lesen, 3-mal falsch bearbeiten, rückgängig machen, nochmal lesen, nochmal bearbeiten.
Schritt 10: Plan-Modus für sensible Pfade per Hook erzwingen
Mache den Plan-Modus für riskante Bereiche verpflichtend. In .claude/settings.json:
1{2 "hooks": {3 "PreToolUse": [4 {5 "matcher": "Edit(src/auth/**)|Edit(migrations/**)",6 "hooks": [7 {8 "type": "command",9 "command": "claude-require-plan-mode"10 }11 ]12 }13 ]14 }15}
Jeder Bearbeitungsversuch in src/auth/*\ oder migrations/\\ * löst eine Plan-Modus-Anforderung aus. Claude kann das nicht umgehen.
Pattern 5: Kontextisolierung durch Sub-Agenten (Schritte 11–13)
Sub-Agenten sind der sauberste Weg, um den Hauptkontext klein zu halten. Jeder Sub-Agent läuft in einem eigenen Fenster, sodass die übergeordnete Sitzung das Rauschen nie zu sehen bekommt.
Schritt 11: Sub-Agenten mit minimaler Werkzeugoberfläche entwerfen
Beschränke die Werkzeuge auf das Nötigste.
Ein Code-Reviewer braucht kein Write oder Edit.
Ein Doc-Updater braucht kein Bash. Weniger Oberfläche, weniger Kontext, der für irrelevante Dokumentationen und Werkzeugbeschreibungen verbraucht wird.
1---2name: code-reviewer3description: Überprüfe Codeänderungen auf Fehler und Sicherheitsprobleme4tools: Read, Grep, Glob5model: sonnet6---
Schritt 12: Gib nur die Dateireferenzen, die der Agent braucht
Sage nicht: „Überprüfe die letzten Änderungen." Sage: „Überprüfe [@src/auth](https://x.com/@src/auth)/session.ts und [@src/auth](https://x.com/@src/auth)/providers/google.ts.**"
Der Sub-Agent liest nur diese, nicht seine beste Vermutung, was „aktuell" bedeutet.
Schritt 13: Verwende günstigere Modelle für Sub-Agenten
Setze das Modell pro Agent basierend auf der Aufgabe.
Sonnet für Review- und Testaufgaben, Haiku für Doc-Updates und Lints, Opus nur für Architektur- oder Sicherheitsaudits, wo tiefgreifendes Denken wichtig ist.
Falls gewünscht global setzen:
1export CLAUDE_CODE_SUBAGENT_MODEL="claude-sonnet-4-6"
Günstigere Sub-Agenten = mehr Sub-Agenten-Aufrufe pro Euro = mehr Isolation = kleinerer Hauptkontext.
Der 30-minütige Einstieg in Context Engineering
10 Minuten: Schreibe eine prägnante Root-CLAUDE.md mit Stack, Konventionen, „Nicht-Anfassen"-Liste und Standardabläufen.
5 Minuten: Füge Unterverzeichnis-CLAUDE.md in deinen 2–3 am häufigsten bearbeiteten Modulen hinzu.
5 Minuten: Lege eine persönliche CLAUDE.md unter ~/.claude/CLAUDE.md mit deinen Präferenzen an.
5 Minuten: Baue eine Fähigkeit in .claude/skills/ für den Workflow, den du am häufigsten durchführst.
5 Minuten: Mache Shift+Tab zur Muskelgedächtnis-Aktion und starte jede dateiübergreifende Aufgabe im Plan-Modus.
Fertig!
Deine nächste Sitzung wird 50–70 % weniger Kontext für die gleiche Arbeit verbrauchen. Nach Sitzung 5 werden die Patterns zum Reflex, und du erreichst das Limit gar nicht mehr.
Kontext ist nichts, was Claude für dich verwaltet. Es ist etwas, das du entwickelst.
Jetzt hast du das System.
Danke fürs Lesen!
Ich teile tägliche Notizen zu KI, Finanzen und Vibe Coding in meinem Telegram-Kanal: https://t.me/zodchixquant
