Warum Claude Code das gesamte Projekt erneut einliest und wie man das behebt

Ailoot-Dokumentation: API, Schlüssel und Verbindung.

Warum liest Claude Code das Projekt jedes Mal von Grund auf neu?#

Viele halten das für einen Fehler. Tatsächlich ist Claude Code so konzipiert: Es hat keinen eigenen Projektindex. Wenn du es bittest, etwas zu reparieren, liegt keine fertige Codeübersicht bereit – es erkundet das Projekt erneut: findet relevante Dateien, sucht nach den benötigten Zeichenfolgen und liest Dateien in den Speicher.

Dieser Ansatz hat echte Vorteile. Der Code ist immer aktuell – es gibt keinen veralteten Index. Es gibt nichts zu konfigurieren. Dein Code wird an keine Datenbank gesendet.

Doch es gibt einen Nachteil: Jede neue Aufgabe bedeutet eine neue Runde der Suche und des Einlesens von Dateien. Tokens werden erneut dafür ausgegeben, herauszufinden, wo alles liegt, obwohl Claude das bereits in der vorherigen Sitzung ermittelt hat. Je größer das Projekt, desto mehr kostet diese Erkundung. Genau deshalb kann es sich so anfühlen, als würde der Agent „alles lesen“.

Wie viele Tokens werden dabei tatsächlich verbraucht?#

Die Kosten entstehen schon vor deiner Anfrage. Eine unabhängige Messung zeigt es einfach: Claude Code sendet rund 33.000 Tokens an Systemprompt und Werkzeugbeschreibungen, bevor es das erste Zeichen deiner Nachricht liest. Zum Vergleich: OpenCode beginnt bei rund 7.000.

Dann kommt das erneute Lesen hinzu. Jede Dateisuche und jeder Lesevorgang fügt dem Kontext Tokens hinzu. Die offizielle Claude-Code-Dokumentation sagt es direkt: Das Lesen von Dateien dominiert den Kontextverbrauch. Eine Analyse von auth.ts mit 2.400 Tokens bedeutet, dass Claude allein diese 2.400 Tokens sieht. Dasselbe gilt für jede Datei, die es während der Erkundung öffnet.

Für unser Publikum bedeutet das Kosten und ausgeschöpfte Limits. Die größte Sorge unter Menschen, die mit Vibe Coding anfangen, ist: „Ich habe bezahlt, und die Limits waren umsonst aufgebraucht.“ Wenn der Agent das Projekt durchsucht und bei jeder Aufgabe Dateien von Grund auf neu einliest, wird der Kontext doppelt so schnell verbraucht: zuerst durch den System-Overhead, dann durch die Erkundung. In der Anleitung „Wofür Claude-Code-Tokens draufgehen“ habe ich die vollständige Übersicht darüber behandelt, wohin genau die Claude-Code-Tokens fließen – das erneute Einlesen des Projekts ist eines von neun Mustern darin.

Was ist ein dauerhaftes Code-Gedächtnis?#

Ein Code-Gedächtnis schließt genau die Lücke, durch die Claude das Projekt erneut einliest. Die Idee ist einfach: Lass etwas den gesamten Code einmal scannen, daraus eine Übersicht erstellen und diese griffbereit halten. Dann muss der Agent nicht jedes Mal von vorn suchen, sondern fragt die Übersicht ab.

Technisch funktioniert es so: Ein separates Werkzeug scannt das Projekt und zerlegt es in Komponenten: Welche Funktionen und Klassen existieren, wer wen aufruft und welche Dateien miteinander verbunden sind. Diese Struktur wird auf der Festplatte gespeichert. Wenn Claude wissen muss, wo die Zahlungslogik liegt oder was beim Bearbeiten einer Funktion kaputtgehen könnte, stellt es eine gezielte Abfrage an die Übersicht, statt Dutzende Dateien zu lesen.

Diese Übersicht wird über MCP verbunden – dem Standard, um ein externes Werkzeug an Claude Code anzuschließen (wie man andere Server verbindet, habe ich in der Anleitung „MCP-Server für Claude Code“ behandelt). Das Code-Gedächtniswerkzeug fügt eigene Befehle zur Suche in der Übersicht hinzu, und Claude verwendet sie selbstständig, wenn es sich im Projekt orientieren muss.

In der Praxis ist der Unterschied der zwischen „den ganzen Ordner lesen, um eine Funktion zu finden“ und „die Übersicht fragen, wo diese Funktion liegt“. Das Erste kostet Zehntausende Tokens, das Zweite Hunderte.

Zwei Ansätze für ein Code-Gedächtnis: Worin unterscheiden sie sich?#

Code-Gedächtniswerkzeuge unterscheiden sich darin, was sie aus deinem Projekt erstellen. Am einfachsten kann man es sich so vorstellen: Eines gibt dir die Hände eines Chirurgen für Änderungen, und das andere sucht nach Bedeutung.

Die GitHub-Sternzahlen stammen vom 15. Juli 2026 (laut GitHub-API). Beide Werkzeuge sind kostenlos und Open Source, funktionieren mit Claude Code und lassen sich als MCP-Server verbinden.

Kurz gesagt für Nichtprogrammierer: Serena ist die Chirurgenhand: Nutze sie, wenn du dasselbe Teil im ganzen Projekt bearbeitest und Präzision wichtig ist. claude-context ist eine Bedeutungssuche: Sie findet Code anhand einer Beschreibung, erfordert dafür aber die Einrichtung einer Cloud-Datenbank und einen Schlüssel.

Wann solltest du Serena oder claude-context wählen?#

Die zwei Werkzeuge konkurrieren nicht um einen einzigen Preis. Sie merken sich unterschiedliche Dinge, deshalb hängt die Wahl von der Aufgabe ab.

Wähle Serena, wenn du viel refaktorisierst. Es ermöglicht dem Agenten die Code-Navigation einer intelligenten Entwicklungsumgebung: Es findet eine Funktionsdefinition und alle tatsächlichen Aufrufstellen und benennt die Funktion dann sorgfältig um oder ersetzt ihren Rumpf im ganzen Projekt. Der Autor beschreibt den Vorteil so.

Serena veröffentlicht keinen genauen Prozentsatz der Einsparung, und ich werde ihr keine erfundene Zahl zuschreiben. Der Vorteil ist ein anderer: Während eine gewöhnliche Suche vierzig Treffer einschließlich Kommentaren und Zeichenfolgen zurückgibt, woraufhin Claude vier ganze Dateien liest, liefert Serena die Antwort mit einigen präzisen Abfragen. Das bedeutet weniger Aufrufe und weniger falsche Treffer und damit ein geringeres Risiko, dass der Agent das Falsche bearbeitet.

Wähle claude-context, wenn du eine Bedeutungssuche brauchst und der Einrichtungsaufwand dich nicht abschreckt. Es wandelt Code in Vektoren um (numerische Fingerabdrücke der Bedeutung) und sucht anhand einer Beschreibung: „Finde, wo unsere Zahlungslogik liegt“, auch wenn du die Funktionsnamen nicht kennst. Der Preis für diese Suche ist der zusätzliche Einrichtungsaufwand.

claude-context benötigt eine externe Vektordatenbank, einen Schlüssel eines Embedding-Anbieters und eine aktuelle Node-Version. Von den beiden Werkzeugen ist die Einrichtung hier aufwendiger. Deshalb empfehle ich Anfängern, mit etwas anderem zu starten.

Was kannst du direkt in Claude Code ohne Drittanbieterwerkzeuge tun?#

Bevor du Drittanbieterwerkzeuge installierst, hole das Beste aus dem heraus, was Claude Code bereits mitbringt. Diese Befehle sind kostenlos und funktionieren sofort.

1. /context – zeigt live, was das Kontextfenster belegt: Systemprompt, CLAUDE.md, Gedächtnis, Werkzeuge und Dateien. Der Befehl /mcp zeigt die Kosten jedes verbundenen Servers, und /memory zeigt, was beim Start geladen wurde.
2. /compact – komprimiert den Gesprächsverlauf zu einer kurzen Zusammenfassung und führt dieselbe Aufgabe fort. Du kannst den Schwerpunkt vorgeben, indem du zu /compact hinzufügst, was erhalten bleiben soll.
3. /clear – verwirft den gesamten Verlauf. Die offizielle Empfehlung lautet, den Befehl beim Wechsel zu einer nicht zusammenhängenden Aufgabe auszuführen, damit das alte Gespräch nicht den Platz der benötigten Dateien einnimmt.
4. /doctor (auch bekannt als /checkup, eingeführt am 8. Juli 2026) – diagnostiziert die Einrichtung und schlägt Korrekturen vor: entfernt Duplikate in CLAUDE.md, findet ungenutzte Werkzeuge und Server und erkennt langsame Handler.

Ein separater Hinweis zu CLAUDE.md: Diese Datei wird zu Beginn jeder Sitzung in den Kontext geladen und ist in jeder Nachricht enthalten. Ist sie übergroß, zahlst du ständig dafür. Die offizielle Empfehlung lautet, sie unter 200 Zeilen zu halten und Referenzdetails in Skills zu verschieben, die bei Bedarf geladen werden. Wie man CLAUDE.md richtig aufbaut, habe ich in der separaten Anleitung „CLAUDE.md richtig konfigurieren“ behandelt.

Ein weiterer integrierter Hebel sind Subagents. Sie haben einen eigenen, getrennten Kontext. So kannst du ihnen umfangreiches Lesen und Erkunden übertragen, ohne dein Hauptfenster aufzublähen. Anthropic formuliert das allgemeine Prinzip in seiner technischen Analyse so.

Macht ein zusätzlicher MCP-Server den Kontext noch größer?#

Die Überlegung „Ein weiterer Server bedeutet mehr Kontext-Overhead“ war früher richtig, aber Claude Code hat sich geändert. Beschreibungen von MCP-Werkzeugen werden nun standardmäßig zurückgestellt: Beim Start werden nur die Servernamen in den Kontext aufgenommen, und die vollständigen Beschreibungen werden geladen, wenn ein bestimmtes Werkzeug für die Aufgabe gebraucht wird. Die Dokumentation sagt es direkt.

Die Rechnung beim Code-Gedächtnis ist einfach: ein kleiner, fester Overhead für Werkzeugnamen gegenüber Tausenden eingesparter Tokens, weil der Agent Dateien nicht mehr erneut einliest. Die Bilanz spricht klar für den Index.

Ein paar ehrliche Einschränkungen, damit du keine Wunder erwartest: Der Index muss gelegentlich neu erstellt werden – die Übersicht spiegelt den Code zum Zeitpunkt des Scans wider und muss nach größeren Änderungen aktualisiert werden (das hängt vom Werkzeug ab: Manche erledigen das automatisch, andere benötigen einen Befehl). Und große Versprechen wie „120-mal weniger Tokens“ beschreiben den Bestfall bei ausgewählten Abfragen, nicht das, was du bei jeder Aufgabe sehen wirst. Die tatsächlichen Einsparungen sind bescheidener, aber immer noch deutlich. Wenn du genauer wissen möchtest, wie du generell vermeidest, an Limits zu stoßen, findest du dazu meine separate Analyse „Wie du vermeidest, deine Claude-Code-Limits aufzubrauchen“.

Womit solltest du heute anfangen?#

Wenn du alles Unnötige weglässt, ist der heutige Plan einfach:

1. Führe /doctor aus und räume auf, was der Befehl vorschlägt: Duplikate in CLAUDE.md und ungenutzte Werkzeuge.
2. Kürze CLAUDE.md auf 200 Zeilen und verschiebe Referenzmaterial in Skills.

Wähle dann nach Bedarf: Wenn du viel refaktorisierst, füge Serena für präzise Änderungen hinzu; wenn du eine Bedeutungssuche brauchst, richte claude-context ein. Ein Code-Gedächtnis und ein sauberer Kontext lösen heute das Hauptproblem.

Wenn du über Ailoot Zugang zu KI-Modellen benötigst, schau bei Ailoot vorbei.