Ratgeber
Warum bearbeitet die KI ständig die falsche Datei in meinem Projekt?
Veröffentlicht:
Du bittest deinen KI-Assistenten, das Login-Formular zu reparieren, und er bearbeitet seelenruhig eine Datei, die mit dem Login nichts zu tun hat. Oder schlimmer, er verweist auf eine Datei, die es gar nicht gibt. Frustrierend, und es wirkt, als wäre die KI nachlässig. Ist sie nicht. Die KI bearbeitet die falsche Datei, weil sie dein ganzes Projekt nicht sieht und rät, wo die Dinge liegen. Die gute Nachricht: Die Lösung ist einfach, und sie lautet nicht „schreib einen besseren Prompt“. Sie lautet: Gib der KI eine Karte deines Codes. Schauen wir uns an, was da wirklich passiert.
Die KI tappt im Dunkeln
Ein KI-Coding-Assistent hat nicht deine gesamte Codebasis im Kopf. Er arbeitet mit einem begrenzten Kontextfenster, einem Ausschnitt deines Projekts, den er in einem Moment sehen kann. Bei einem kleinen Projekt ist dieser Ausschnitt vielleicht schon das Ganze. Bei einem echten Projekt mit Hunderten Dateien ist er nur ein Bruchteil. Sagst du also „repariere das Login-Formular“, muss die KI raten, welche Datei du meinst, anhand von Namen und Mustern, die sie schon gesehen hat.
Meistens rät sie richtig. Aber Raten skaliert schlecht. Je größer und ungewöhnlicher dein Projekt, desto öfter greift sie zu einer falschen Datei, die nur plausibel aussieht, oder sagt einen Dateinamen voraus, der wahrscheinlich klingt und schlicht nicht existiert. Letzteres ist eine Halluzination: kein Lügen, sondern das selbstbewusste Füllen einer Lücke in dem, was sie nicht sehen kann.
Warum „gib ihr einfach mehr Kontext“ nach hinten losgeht
Der erste Impuls: die ganze Codebasis auf die KI werfen. Ein größeres Fenster löst das doch bestimmt? Meistens eben nicht. Ein riesiger Kontext voller falscher Dateien ist nicht besser als ein kleiner. Es kommt nicht darauf an, wie viel Code die KI sehen kann, sondern ob der richtige Code vor ihr liegt. Stopfst du alles hinein, geht die relevante Datei im Rauschen unter, sie wird schwerer zu finden, nicht leichter. Reine Menge ist der falsche Hebel.
Stell es dir wie eine Wegbeschreibung vor. Jemandem sämtliche Straßenkarten des Landes in die Hand zu drücken hilft ihm nicht, eine Adresse zu finden. Eine einzige klare Karte dieses Viertels schon.
Die echte Lösung: Gib der KI eine Karte
Was tatsächlich funktioniert, ist eine Code-Karte, eine kompakte Übersicht der Struktur deines Projekts: welche Dateien und Funktionen es gibt und wie sie miteinander verbunden sind. Mit dieser Karte hört die KI auf zu raten. Statt „diese Datei heißt wahrscheinlich irgendwie login“ sieht sie „die Login-Logik liegt hier, und sie ruft diese zwei Dinge auf“ und geht direkt an die richtige Stelle.
Diese Idee trägt ein paar Namen und steckt in ein paar Tools:
- Repo-Maps, wie die in Aider eingebaute, die die wichtigsten Teile deines Codes nach Bedeutung sortiert und der KI eine strukturierte Übersicht zeigt.
- Code-Knowledge-Graphs, wie graphify, die eine abfragbare Karte deines ganzen Projekts bauen (Dateien, Funktionen und die Beziehungen zwischen ihnen), damit der Assistent nachschlagen kann, wo etwas liegt, statt es vorherzusagen.
Beide tun im Kern dasselbe: Sie ersetzen Raten durch Wissen. Und weil die KI eine kleine, genaue Karte liest, statt sich durch Stapel von Dateien zu wühlen, gehen falsche Datei-Edits und erfundene Verweise deutlich zurück.
Wie das in der Praxis aussieht
Sobald dein Assistent eine Karte der Codebasis hat, ändert sich das Erlebnis spürbar:
- „Repariere das Login-Formular“ landet schon beim ersten Versuch beim tatsächlichen Login-Code.
- Die KI verweist nicht mehr auf Dateien, die es nicht gibt.
- Sie versteht, wie sich eine Änderung an einer Stelle auf eine andere auswirkt, weil die Karte die Verbindungen zeigt.
Du ringst nicht länger mit dem Tool um die einfachste Navigation, du arbeitest mit etwas, das das Gelände kennt. Genau deshalb wird das umso wichtiger, je größer dein Projekt wird: Je umfangreicher die Codebasis, desto klarer schlägt eine Karte den rohen Brute-Force-Kontext.
Rüste deine KI richtig aus
Falsche Datei-Edits sind meist ein Zeichen dafür, dass die KI für dein Projekt schlecht ausgerüstet ist, nicht dafür, dass das Tool nichts taugt. Unser kostenloses Tool KI für Entwickler hilft dir, den richtigen Assistenten zu wählen, ihn für dein Betriebssystem zu installieren und eine Starter-Regeldatei zu erzeugen, die der KI von der ersten Sitzung an erklärt, wie dein Projekt aufgebaut ist. Gib deinem Assistenten ein Fundament und eine Karte, und „warum hat sie die falsche Datei bearbeitet?“ ist keine Frage mehr, die du stellen musst.
Weiterlesen
Häufige Fragen
Warum bearbeitet mein KI-Coding-Assistent die falsche Datei? +
Weil er dein ganzes Projekt nicht auf einmal sieht und rät, wo etwas liegt. KI-Assistenten arbeiten mit einem begrenzten Ausschnitt deines Codes, deshalb greifen sie bei größeren Projekten oft zu einer plausibel aussehenden statt der richtigen Datei, oder verweisen auf eine, die es gar nicht gibt. Die Lösung ist kein cleverer Prompt, sondern eine genaue Karte deiner Code-Struktur.
Löst ein größeres Kontextfenster das nicht? +
Nicht zuverlässig. Ein riesiger Kontext voller falscher Dateien ist nicht besser als ein kleiner. Entscheidend ist, ob die richtigen Dateien vor der KI liegen, nicht wie viele. Alles hineinzustopfen kann es sogar schlimmer machen, weil der relevante Code im Rauschen untergeht. Eine fokussierte Karte schlägt reine Größe.
Was ist eine Code-Karte und wie hilft sie? +
Eine Code-Karte (oder Code-Knowledge-Graph) ist eine kompakte Übersicht der Struktur deines Projekts: welche Dateien und Funktionen es gibt und wie sie zusammenhängen. Mit dieser Karte findet die KI die richtige Stelle, statt zu raten, was falsche Datei-Edits und erfundene Verweise stark reduziert. Die Repo-Map von Aider und graphify bauen dir so eine Karte.
Warum erfindet die KI manchmal Dateien, die es gar nicht gibt? +
Das ist eine Halluzination: Wenn die KI deinen Aufbau nicht wirklich kennt, sagt sie einen Dateinamen voraus, der nach gelernten Mustern wahrscheinlich wirkt, und liegt daneben. Bei größeren oder unbekannten Codebasen passiert das häufiger. Eine echte Karte deines Projekts nimmt ihr das Rätselraten ab.