Werkzeuge & Agenten · KI für Developer mit Claude und Codex
Fehler mit Codex finden und beheben lassen
Kurz gesagt
Beschreiben Sie den Fehler mit Meldung, Schritten zum Nachstellen und erwartetem Verhalten, lassen Sie Codex zuerst die Ursache erklären und erst dann eine kleine Korrektur vornehmen. Prüfen Sie den Diff, lassen Sie einen Test ergänzen, der den Fehler vorher aufzeigt, und führen Sie alle Tests aus. Die Korrektur ist erst gut, wenn Sie sie verstehen.
Das Problem
Die Seite zeigt nach dem Absenden des Formulars eine weisse Fläche. Oder die Monatsabrechnung rechnet falsch, aber nur bei Kundinnen mit zwei Adressen. In den Protokollen steht eine Fehlermeldung, die Sie nicht verstehen. Sie haben keine Zeit, stundenlang im Code zu suchen.
Ein KI-Programmierassistent wie Codex kann beim Eingrenzen helfen: Er liest Fehlermeldungen, durchsucht den Code, schlägt Ursachen vor und kann Korrekturen vornehmen. Das beschleunigt vieles. Gleichzeitig ist Debugging mit KI heikel. Der Assistent behebt oft das Symptom statt der Ursache, ändert Code, der gar nicht fehlerhaft war, oder «repariert» einen Test, statt den Fehler zu beheben.
Mit einem geordneten Vorgehen nutzen Sie die Stärken und begrenzen die Risiken: erst verstehen, dann minimal ändern, dann mit Test absichern. Stand: Oktober 2026; Bedienung und Umfang von Codex ändern sich.
So lösen Sie es mit KI – Schritt für Schritt
- Fehler reproduzieren. Stellen Sie fest, wie sich der Fehler zuverlässig auslösen lässt. Notieren Sie die Schritte, Eingaben und Umgebung.
- Informationen sammeln. Fehlermeldung wörtlich, Protokollzeilen, betroffene Datei, erwartetes und tatsächliches Verhalten. Entfernen Sie Zugangsdaten und Personendaten aus Protokollen.
- Zweigbasis schaffen. Arbeiten Sie in einem eigenen Zweig der Versionsverwaltung, damit alles rückgängig zu machen ist (Änderungen rückgängig machen).
- Ursache zuerst erklären lassen. Bitten Sie Codex, ohne Änderungen die wahrscheinlichen Ursachen zu nennen, mit Dateiverweisen, und zu sagen, was er prüfen würde.
- Hypothese prüfen. Überprüfen Sie die Vermutung selbst: ein Ausgabe-Eintrag, ein Haltepunkt, ein kleiner Versuch. Wählen Sie die plausibelste Ursache.
- Fehler mit Test festhalten. Lassen Sie einen Test schreiben, der den Fehler zeigt und derzeit fehlschlägt (Tests erstellen).
- Minimale Korrektur. Beauftragen Sie eine möglichst kleine Änderung an der Ursache. Der Test muss danach bestehen, ebenso alle anderen.
- Diff prüfen und übernehmen. Lesen Sie jede geänderte Zeile. Passt sie zur Ursache? Gibt es Nebenwirkungen? Erst danach übernehmen (Code-Review).
Vorlage zum Kopieren
Es gibt einen Fehler in meinem Projekt. Ändere zunächst nichts.
Verhalten: [Was passiert?]
Erwartet: [Was sollte passieren?]
Schritte zum Nachstellen: [1., 2., 3.]
Fehlermeldung oder Protokoll (ohne Zugangsdaten und Personendaten):
[Meldung einfügen]
Umgebung: [Sprache, Version, Betriebssystem, lokal/Server]
Was ich schon versucht habe: [Liste]
Bitte:
1. Nenne die drei wahrscheinlichsten Ursachen mit Datei und Zeile, jeweils mit Begründung und der Frage, wie ich sie überprüfen kann.
2. Sage, welche Information dir fehlt, falls du die Ursache nicht sicher bestimmen kannst. Rate nicht.
3. Schlage erst nach meiner Zustimmung eine minimale Korrektur und einen Test vor, der den Fehler zeigt.
Ändere keine anderen Stellen und «repariere» keine Tests, damit sie bestehen.Ersetzen Sie die Angaben. Geben Sie in Protokollen enthaltene Passwörter und Kundendaten nie weiter.
| Schritt | Ziel | Prüfpunkt |
|---|---|---|
| Reproduzieren | Fehler auslösbar | gleiche Schritte, gleiches Ergebnis |
| Ursache erklären | Verständnis | Verweise stimmen |
| Test schreiben | Fehler festhalten | Test schlägt vorher fehl |
| Minimal korrigieren | Ursache beheben | kleiner Diff |
| Alles testen | keine Nebenwirkung | alle Tests bestehen |
Worauf Sie achten müssen
- Symptom statt Ursache. KI-Korrekturen verdecken manchmal nur die Fehlermeldung. Fragen Sie, warum der Fehler entstand.
- Veränderte Tests. Achten Sie darauf, dass Tests nicht abgeschwächt oder entfernt werden, um Erfolg zu melden.
- Zu grosse Änderungen. Eine «Korrektur» in vielen Dateien ist verdächtig. Verlangen Sie die kleinste mögliche Änderung.
- Vertrauliche Daten in Protokollen. Protokolle enthalten oft Personendaten und Zugangsdaten. Bereinigen Sie sie, bevor Sie sie in ein KI-Werkzeug geben (Geheimnisse schützen).
- Produktionssysteme. Beheben Sie Fehler nicht direkt auf dem Live-System. Testen Sie in einer Kopie.
- Verantwortung. Sie verantworten die Korrektur. Verstehen Sie sie, bevor Sie sie übernehmen. Bei sicherheitsrelevanten Fehlern ziehen Sie Fachleute bei.
Ein Beispiel aus der Praxis
Ein Beispiel: In einem kleinen Online-Shop für Berner Honig bricht die Bestellung ab, wenn der Warenkorb mehr als neun Artikel enthält. Die Inhaberin und ihr nebenberuflicher Entwickler stellen den Fehler nach und finden eine Fehlermeldung im Protokoll.
Der Entwickler lässt Codex die Ursachen erklären. Die plausibelste: Eine Hilfsfunktion sortiert Mengen als Text, sodass «10» vor «9» steht. Er lässt einen Test mit zehn Artikeln schreiben, der fehlschlägt, und dann eine Korrektur in einer Zeile ausführen. Der Test besteht, alle anderen auch. Beim Prüfen des Diffs fällt ihm auf, dass Codex zusätzlich eine unbeteiligte Datei formatiert hat. Er macht das rückgängig.
Vorher gingen Bestellungen verloren, nachher funktionieren sie, und der Test schützt vor Wiederholung. Das Protokoll hat er vor dem Einfügen von Kundennamen bereinigt.
So hilft Ihnen Alpasana
Wie man mit KI Fehler sucht, Korrekturen delegiert und Ergebnisse prüft, vermittelt der Kurs KI für Developer mit Claude und Codex von absofort. Beschrieben sind Debugging, Refactoring und Review, das Delegieren von Aufgaben und Verifizieren von Ergebnissen sowie ein Entwickler-Playbook mit Prompts, Review-Regeln, Tests und Datenschutzgrenzen.
Der Kurs ist online mit Abschlussquiz, KI-geprüfter Praxisaufgabe und verifizierbarem Zertifikat.
Häufige Fragen
Soll Codex den Fehler gleich beheben?
Besser erst erklären lassen, dann gemeinsam entscheiden. So verstehen Sie die Ursache und vermeiden Zufallskorrekturen.
Was, wenn Codex die Ursache nicht findet?
Liefern Sie mehr Information: Protokolle, Schritte, Version. Oder grenzen Sie den Fehler selbst ein. Raten Sie nicht und lassen Sie keine Änderungen ins Blaue zu.
Darf ich Fehlermeldungen mit Kundendaten einfügen?
Nur bereinigt. Entfernen Sie Personendaten und Zugangsdaten, bevor Sie Protokolle in ein KI-Werkzeug einfügen.
Wie vermeide ich neue Fehler durch die Korrektur?
Mit Test vor und nach der Korrektur, kleinem Diff und Ausführen aller Tests (Code-Review mit Codex).
Erstellt mit KI-Unterstützung, redaktionell verantwortet von der Alpasana GmbH · 10.10.2026. Fehler entdeckt? Melden Sie es uns.
Quellen
Weiterlesen in der Galaxie
- Codex Prompt Vorlage für klare ProgrammieraufträgeCodex Prompt Vorlage: Formulieren Sie Ziel, Kontext, betroffene Dateien und Abnahmekriterien so, dass Änderungen klein und überprüfbar bleiben.
- Codex Tests erstellen: Änderungen gezielt absichernCodex Tests erstellen: Formulieren Sie Testfälle für normales Verhalten, Grenzen und Fehler und prüfen Sie, ob sie Änderungen gezielt absichern.
- Codex-Code prüfen: Checkliste vor der ÜbernahmeCodex-Code prüfen: Checkliste für Fachpersonen und Verantwortliche, damit von KI vorgeschlagene Änderungen verstanden, getestet und erst dann übernommen werden.
- Codex-Änderungen rückgängig machen: Sicher mit Git arbeitenCodex-Änderungen rückgängig machen: Mit Git sichern Sie den Stand vorher, arbeiten in einem eigenen Zweig und nehmen misslungene KI-Änderungen sicher zurück.
- Claude Code: Fehlermeldung verständlich beschreibenBei einer Claude-Code-Fehlermeldung helfen Angaben zu Auslöser und Umgebung. Grenzen Sie Ursachen ein und entfernen Sie vertrauliche Daten vor der Eingabe.