Kein Feature ist beim ersten Versuch garantiert fehlerfrei - und das neue Suchfeature aus dem letzten Kapitel hat tatsächlich einen kleinen Fehler. Beim Testen fällt auf: Rezepte mit der Zutat " Tomate" (mit einem führenden Leerzeichen, weil beim Anlegen aus Versehen ein Leerzeichen mit eingegeben wurde) tauchen bei der Suche nach "Tomate" nicht auf, obwohl sie eigentlich sollten. Dieses Kapitel zeigt, wie man einen solchen Fehler so beschreibt, dass Claude Code ihn zielsicher findet.

Warum die Fehlerbeschreibung so wichtig ist

Genau wie bei einem Feature-Prompt gilt: Je konkreter die Beschreibung, desto zielgerichteter die Fehlersuche. Ein Bug-Report profitiert besonders von vier Angaben: was du erwartet hast, was tatsächlich passiert ist, wie sich der Fehler reproduzieren lässt, und - falls vorhanden - die genaue Fehlermeldung.

Schlechte Fehlerbeschreibung

> Die Suche funktioniert nicht richtig.

Diese Beschreibung zwingt Claude Code dazu, den Fehler erst selbst zu suchen, bevor überhaupt mit der Behebung begonnen werden kann - das kostet Zeit und führt möglicherweise zum falschen Fehler, falls es mehrere kleine Unschönheiten im Code gibt.

Gute Fehlerbeschreibung

> Bug in der Zutatensuche: Ein Rezept mit der Zutat " Tomate" (mit einem führenden Leerzeichen) wird bei der Suche nach "Tomate" NICHT gefunden, obwohl es gefunden werden sollte. Erwartet: die Suche soll führende/folgende Leerzeichen bei Zutaten ignorieren. Betroffen ist vermutlich die Route GET /api/recipes in server.js.

Diese Version nennt den genauen Reproduktionsfall (welche Zutat, welcher Suchbegriff), das erwartete Verhalten, und sogar eine Vermutung, wo der Fehler liegen könnte. Claude Code kann damit direkt in server.js nachsehen, den Fehler nachvollziehen und gezielt beheben.

Die Behebung

Die Ursache: Der Vergleich ingredient.toLowerCase().includes(searchTerm) berücksichtigt zwar Groß-/Kleinschreibung, aber keine überflüssigen Leerzeichen. Die Lösung ist eine kleine, gezielte Edit-Änderung:

const filtered = recipes.filter((recipe) =>
  recipe.ingredients.some((ingredient) =>
    ingredient.trim().toLowerCase().includes(searchTerm)
  )
);

Eine einzige zusätzliche Methode (.trim()), an genau der richtigen Stelle - möglich, weil die Fehlerbeschreibung präzise genug war, um die Ursache ohne Umwege zu finden.

Fehler für Claude Code reproduzierbar machen

Bei komplexeren Fehlern hilft es zusätzlich, Claude Code den Fehler selbst nachstellen zu lassen, bevor die Behebung beginnt - zum Beispiel mit einem gezielten curl-Aufruf oder einem kleinen Testskript. So bestätigt sich der Fehler zunächst objektiv, und nach der Behebung lässt sich mit demselben Aufruf sofort prüfen, ob er tatsächlich verschwunden ist.

Im nächsten Kapitel geht es einen Schritt weiter: statt auf einen konkreten Fehler zu warten, lässt du Claude Code bestehenden Code aktiv durchsehen und verbessern - ein Code-Review.