Claude Code: Fehlermeldung verständlich beschreiben

Das Problem

Ihr Programm bricht ab, die Website zeigt eine weisse Seite, oder ein Import meldet «Error 500». Sie wissen, dass Claude Code bei der Fehlersuche helfen kann, aber Ihre erste Eingabe lautet: «Es funktioniert nicht, bitte beheben.» Die Antwort ist unbrauchbar oder die KI ändert vorschnell Dinge, die gar nicht kaputt waren.

Das Problem liegt selten bei der KI, sondern bei der Fehlerbeschreibung. Ein menschlicher Entwickler würde zuerst nachfragen: Was genau passiert? Seit wann? Was wurde zuletzt geändert? Auf welchem Gerät? Claude Code kann ebenfalls viel mehr leisten, wenn es solche Angaben von Anfang an bekommt. Je vollständiger die Schilderung, desto zielgenauer die Hilfe.

Zugleich lauert hier eine Falle: Fehlermeldungen und Protokolle enthalten oft Zugangsdaten, Adressen, Namen oder Kundendaten. Wer sie ungeprüft kopiert, gibt vertrauliche Informationen weiter. Dieser Leitfaden zeigt, welche Angaben helfen und wie Sie sie sicher aufbereiten.

So lösen Sie es mit KI – Schritt für Schritt

1. Fehler reproduzieren. Versuchen Sie, den Fehler zu wiederholen, und notieren Sie die genauen Schritte. Ein Fehler, den man auslösen kann, ist halb gelöst.
2. Meldung wörtlich festhalten. Kopieren Sie die Fehlermeldung vollständig und im Wortlaut, nicht aus dem Gedächtnis. Dazu gehören Fehlercode, Dateiname und Zeilennummer.
3. Auslöser beschreiben. Was haben Sie unmittelbar vorher getan? Wurde etwas geändert, aktualisiert oder neu installiert?
4. Erwartung und Ist-Zustand trennen. Schreiben Sie: «Erwartet: …», «Tatsächlich: …».
5. Umgebung nennen. Betriebssystem, Programmversion, Browser, Datenbank, Testsystem oder Produktivsystem. Das hilft, Ursachen einzugrenzen.
6. Bisherige Versuche aufführen. Was haben Sie schon probiert, und mit welchem Ergebnis? So vermeiden Sie Wiederholungen.
7. Heikles entfernen. Ersetzen Sie Passwörter, Schlüssel, Namen, Adressen und Kundendaten durch Platzhalter wie [PASSWORT] oder [KUNDE]. Siehe Passwort an KI weitergegeben.
8. Erst Ursachen eingrenzen lassen. Bitten Sie Claude Code, zuerst mögliche Ursachen zu nennen und zu prüfen, ohne etwas zu verändern. Erst danach folgt der Änderungsvorschlag. Siehe Erst planen lassen.
9. Lösung prüfen. Testen Sie, ob der Fehler behoben ist und nichts anderes kaputt gegangen ist. Siehe Tests auswerten.

Vorlage zum Kopieren

Mit dieser Vorlage schildern Sie einen Fehler vollständig und sicher:

Fehlerbeschreibung für Claude Code
Programm / Projekt: [Name, kurze Beschreibung]
Umgebung: [Betriebssystem, Versionen, Test- oder Produktivsystem]
Was ich getan habe: [Schritte, die zum Fehler führen]
Erwartet: [Was hätte passieren sollen]
Tatsächlich: [Was geschieht stattdessen]
Fehlermeldung (wörtlich, ohne Geheimnisse): [Meldung einfügen, Passwörter/Namen durch Platzhalter ersetzt]
Seit wann / was wurde zuletzt geändert: [Änderungen, Updates]
Bereits versucht: [Massnahmen und Ergebnis]
Auftrag:
1. Nenne die wahrscheinlichsten Ursachen und wie du sie prüfen würdest.
2. Untersuche zuerst nur lesend. Ändere noch nichts und führe keine Befehle aus, die etwas verändern.
3. Lege danach einen kleinen Korrekturvorschlag vor und warte auf meine Freigabe.
Wenn dir Informationen fehlen, stelle Rückfragen.

Ersetzen Sie die Platzhalter. Je genauer Ihre Angaben, desto kürzer die Fehlersuche.

Welche Angaben was bringen

Worauf Sie achten müssen

• Geheimnisse entfernen. Protokolle und Fehlermeldungen enthalten oft Zugangsdaten und Personendaten. Prüfen Sie vor dem Einfügen. Siehe Passwörter und Kundendaten schützen.
• Nicht auf Produktivsystemen ausprobieren. Fehlersuche gehört in eine Testumgebung. Siehe Test und Produktion trennen.
• Vorschläge nicht blind übernehmen. Die erste vermutete Ursache stimmt nicht immer. Prüfen Sie, ob die Lösung zum Fehler passt.
• Behandeln Sie Ursache, nicht Symptom. Ein Fehler kann «verschwinden», weil die KI die Meldung unterdrückt. Fragen Sie, warum er aufgetreten ist.
• Nicht zu viel auf einmal ändern. Eine Änderung pro Versuch hält Ursache und Wirkung getrennt.
• Verbrauch. Lange Protokolle verbrauchen Nutzung. Fügen Sie nur relevante Ausschnitte ein. Siehe Verbrauch senken.

Wenn Sie den Fehler nicht selbst beschreiben können

Nicht jede Mitarbeiterin sieht die technischen Details. In diesem Fall genügt es, Datum, Uhrzeit, Bildschirmfoto und die Tätigkeit festzuhalten und der Fachperson weiterzugeben. Siehe auch Fehlermeldung mit ChatGPT erklären für Meldungen auf dem Bildschirm.

Gute Fehlerberichte helfen auch ohne KI: Sie sparen Zeit bei Dienstleistern und beschleunigen jede Fehlersuche. Legen Sie im Betrieb eine einfache Vorlage an, mit der alle Fehler auf dieselbe Weise gemeldet werden. Mehr zur Fehlersuche mit KI bietet KI-Code-Fehler finden.

Ein Beispiel aus der Praxis

Ein Beispiel: Ein Reisebüro in Chur nutzt ein Buchungsformular, das plötzlich keine Bestätigungs-Mails mehr versendet. Der freiberufliche Entwickler Herr Candrian soll den Fehler finden.

Vorher: Die Büroleiterin meldet «Mails gehen nicht raus». Er sucht eine Stunde. Nachher: Sie nutzt die Vorlage. Sie nennt den Zeitpunkt des ersten Ausfalls, die Fehlermeldung aus dem Protokoll (Passwort durch Platzhalter ersetzt) und dass am Vortag der Server aktualisiert wurde. Claude Code grenzt die Ursache auf eine geänderte Mail-Einstellung ein. Herr Candrian prüft die Einstellung im Testsystem, korrigiert sie und testet den Versand.

So hilft Ihnen Alpasana

Wer lernen möchte, Fehler mit KI systematisch einzugrenzen und zu beheben, findet bei absofort den Kurs KI für Developer mit Claude und Codex: Codegenerierung, Debugging, Refactoring und Review, Delegieren und Verifizieren von Ergebnissen, Entwickler-Playbook mit Prompts, Review-Regeln, Tests und Datenschutzgrenzen sowie verifizierbares Zertifikat.

Häufige Fragen

Soll ich das ganze Protokoll einfügen?

Besser nur die relevanten Abschnitte rund um den Fehler. Lange Protokolle verbrauchen Nutzung und enthalten oft mehr vertrauliche Angaben.

Was, wenn der Fehler nur manchmal auftritt?

Notieren Sie Häufigkeit und Umstände. Gelegentliche Fehler hängen oft von Eingaben, Zeit oder Last ab. Je mehr Muster Sie erkennen, desto eher findet sich die Ursache.

Darf Claude Code selbst Dinge ausprobieren?

In einer Testumgebung und mit enger Freigabe ja. Auf dem Produktivsystem sollte es nichts verändern. Siehe Claude Code fragt nach Erlaubnis.

Wie erkenne ich, dass die Lösung wirklich funktioniert?

Der ursprüngliche Fehler tritt nicht mehr auf, Tests laufen durch, und andere Funktionen verhalten sich wie zuvor.