KI-Coding-Agenten halluzinieren API-Endpunkte bei Next.js Server Actions

KI-Agenten erfinden nicht existierende API-Endpunkte

Ein aktueller Blogbeitrag auf dev.to beschreibt ein grundlegendes Problem beim Einsatz von KI-Coding-Agenten in Next.js-Projekten: Werkzeuge wie Claude Engineer oder Cursor halluzinieren regelmäßig API-Endpunkte, die es gar nicht gibt. Der Grund liegt in der Architektur von Next.js Server Actions. Anders als klassische REST-Schnittstellen sind diese Funktionen nicht als explizite Routen im Code erkennbar, sondern werden durch die Direktive 'use server' implizit definiert und sind tief in der Dateistruktur verborgen. Die KI-Agenten, die auf Basis von Trainingsdaten und sichtbarem Code arbeiten, können diese versteckten Verbindungen nicht zuverlässig interpretieren. Statt die tatsächlichen Server Actions aufzurufen, erfinden sie dann eigene Endpunkte – etwa '/api/user' – oder versuchen, nicht existierende Schnittstellen anzusteuern. Der Blogautor schildert, dass Agenten bei scheinbar einfachen Aufgaben wie einem Profil-Update scheitern, weil sie die Lücke zwischen UI-Logik und den verstreuten 'use server'-Direktiven nicht schließen können. Das Problem ist bislang nicht offiziell bestätigt, deckt sich aber mit Berichten über ähnliche Halluzinationen bei KI-gestützter Entwicklung.

Offizielle Next.js-Empfehlungen und Update 16.2

Next.js hat auf die Herausforderungen der KI-gestützten Entwicklung reagiert. In einer offiziellen Anleitung wird beschrieben, wie Projekte so konfiguriert werden können, dass Coding-Agenten aktuelle Dokumentation statt veralteter Trainingsdaten nutzen. Dadurch sollen Agenten die Next.js-eigenen Konzepte – insbesondere Server Actions – besser verstehen und korrekt anwenden. Zusätzlich enthält das bereits veröffentlichte Next.js 16.2 gezielte Verbesserungen für die KI-unterstützte Entwicklung. Details zu den technischen Änderungen nannte das Team bislang nicht, die Aktualisierung soll jedoch die Arbeit von Agenten am Code erleichtern. Beide Maßnahmen zielen darauf ab, die Zuverlässigkeit von KI-Assistenten in Next.js-Projekten zu erhöhen und die beschriebenen Halluzinationen zu reduzieren.

Wenn der KI-Assistent lieber rät als liest

Während einige Entwickler berichten, dass moderne Modelle wie Claude Code mit ausreichendem Kontext kaum noch API-Endpunkte halluzinieren – etwa durch eine zentrale `AGENTS.md` und spezialisierte Skills suncoasthost in r/nextjs –, bleibt das Problem für andere akut. Besonders das Erfinden nicht existierender Pfade („path hallucination“) ist ein wiederkehrender Frust, selbst wenn man dem Agenten den Import-Graphen mitgibt No_Device_9098 in r/nextjs. Die Ursache sehen manche schlicht in der Modellqualität: Effiziente Codebase-Erkundung sei eine der Fähigkeiten, die sich mit den neuesten Modellgenerationen erst spürbar verbessert haben Normal_Capital_234 in r/nextjs.