Mit Claude Code unübersichtlichen Code aufräumen

Das Problem

Viele Betriebe besitzen ein Programm, das seit Jahren läuft: die Auftragsverwaltung, das Kundenportal, das Excel-Makro mit tausend Zeilen. Es funktioniert, aber niemand traut sich mehr, es anzufassen. Die Struktur ist unübersichtlich, Namen sind kryptisch, dieselben Abschnitte kommen mehrfach vor, und der Entwickler, der es geschrieben hat, ist nicht mehr im Betrieb.

Jede Änderung wird zum Risiko, weil man nicht weiss, was woran hängt. Das Aufräumen wäre sinnvoll, aber es kostet Zeit und birgt die Gefahr, dass danach etwas nicht mehr funktioniert. Claude Code kann hier helfen: Es kann Code lesen, erklären, Muster erkennen und Verbesserungen vorschlagen.

Der entscheidende Punkt beim Aufräumen: Das Verhalten muss gleich bleiben. Wer beim «Verschönern» unbemerkt etwas verändert, schafft neue Fehler. Deshalb braucht es ein Sicherheitsnetz aus Tests, kleine Schritte und eine genaue Prüfung. Frau Müller muss die Technik nicht beherrschen, aber sie sollte diese Regeln kennen und einfordern.

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

1. Ziel definieren. Was soll besser werden: Lesbarkeit, Struktur, weniger doppelter Code, bessere Namen? Und was darf sich nicht ändern: das Verhalten nach aussen. Schreiben Sie das auf.
2. Stand sichern. Sichern Sie den heutigen Stand in der Versionsverwaltung und arbeiten Sie auf einem eigenen Zweig. Siehe Änderungen rückgängig machen.
3. Tests als Sicherheitsnetz schaffen. Gibt es Tests? Wenn nicht, lassen Sie zuerst Tests schreiben, die das heutige Verhalten festhalten. Siehe Tests auswerten. Ohne Tests ist Aufräumen riskant.
4. Code erklären lassen. Bitten Sie Claude Code, den Bereich in einfacher Sprache zu erklären und Auffälligkeiten zu nennen. So verstehen Sie, was dort geschieht.
5. Plan verlangen. Lassen Sie einen Plan mit kleinen Schritten vorlegen und prüfen Sie ihn. Siehe Erst planen lassen.
6. Schritt für Schritt umbauen. Setzen Sie einen Schritt um, zum Beispiel Variablen besser benennen oder eine lange Funktion aufteilen. Danach Tests ausführen.
7. Änderungen prüfen. Sehen Sie sich an, was sich geändert hat. Wurden nur die erwarteten Stellen angefasst? Hat sich Logik verändert, nicht nur Form?
8. Zurücknehmen, wenn nötig. Zeigt ein Test Abweichungen, nehmen Sie den Schritt zurück und formulieren Sie ihn enger.
9. Dokumentieren. Halten Sie fest, was aufgeräumt wurde, und aktualisieren Sie die Beschreibung des Projekts. Siehe Dokumentation mit Claude Code.

Vorlage zum Kopieren

Mit diesem Auftrag starten Sie das Aufräumen kontrolliert. Fügen Sie nur Code ein, den Ihr Betrieb dafür freigegeben hat:

Aufgabe: Räume den Bereich [Datei/Ordner] auf, ohne dass sich das Verhalten ändert (reines Refactoring).
Ziel: [z. B. bessere Namen, kürzere Funktionen, weniger doppelter Code].
Nicht ändern: [Schnittstellen, Datenbank, Ausgabetexte, Berechnungen].
Vorgehen:
1. Erkläre zuerst in einfacher Sprache, was der Code tut, und nenne Auffälligkeiten.
2. Lege einen Plan mit kleinen, einzeln prüfbaren Schritten vor und warte auf meine Freigabe.
3. Führe nach jedem Schritt die Tests aus: [Testbefehl] und berichte das Ergebnis.
4. Wenn Tests fehlen, schlage zuerst Tests vor, die das heutige Verhalten absichern.
5. Ändere keine Funktionen, Berechnungen oder Texte. Wenn dir etwas unklar ist, frage nach.
6. Liste am Ende alle geänderten Dateien auf und nenne Stellen, bei denen sich das Verhalten ändern könnte.

Passen Sie Bereich und Befehle an. Geben Sie nur den ersten Schritt frei und prüfen Sie ihn gründlich.

Was Aufräumen ist und was nicht

Mischen Sie die Aufgaben nicht: Wer aufräumt und gleichzeitig Funktionen ändert, kann Fehler nicht mehr zuordnen.

Worauf Sie achten müssen

• Verhalten muss gleich bleiben. Das ist der Kern. Prüfen Sie mit Tests und mit echten Abläufen, nicht nur mit dem Eindruck, der Code sehe besser aus.
• Ohne Tests kein Mut. Fehlt ein Sicherheitsnetz, schreiben Sie zuerst Tests. Sonst ist jede Änderung ein Blindflug.
• Zu grosse Schritte. Wer alles auf einmal umbaut, kann Fehler nicht mehr eingrenzen. Arbeiten Sie in kleinen, einzeln prüfbaren Schritten.
• Wissen im Altcode. Manchmal steckt in unschönen Stellen ein Sonderfall, der aus gutem Grund existiert. Fragen Sie nach, bevor Sie Stellen «bereinigen» lassen.
• Vertraulichkeit. Alter Code enthält oft Zugangsdaten und Kundendaten. Siehe Passwörter und Kundendaten schützen.
• Kosten-Nutzen. Nicht jeder alte Code lohnt das Aufräumen. Manchmal ist Ersetzen günstiger. Siehe Alte Software mit KI modernisieren.

Ein Beispiel aus der Praxis

Ein Beispiel: Ein Transportunternehmen in Pratteln nutzt seit zehn Jahren ein selbstgeschriebenes Tourenplanungsprogramm. Der Informatiker Herr Lehmann möchte den unübersichtlichsten Teil, eine 600 Zeilen lange Funktion, aufräumen.

Vorher: Niemand versteht sie, und jede Anpassung ist riskant. Nachher: Er lässt zuerst Tests für fünf typische Touren schreiben, die das heutige Ergebnis festhalten. Dann lässt er Claude Code die Funktion in vier kleinere Teile aufteilen, jeweils mit Testlauf. Nach dem dritten Schritt zeigt ein Test eine Abweichung bei Sonntagstouren. Er nimmt den Schritt zurück und stellt fest, dass ein Sonderfall zuvor in einer scheinbar überflüssigen Zeile steckte.

So hilft Ihnen Alpasana

Wer lernen möchte, Altcode mit KI sicher aufzuräumen und Ergebnisse zu prüfen, findet bei absofort den Kurs KI für Developer mit Claude und Codex: Codegenerierung, Debugging, Refactoring und Review, Delegieren und Verifizieren, Entwickler-Playbook mit Prompts, Review-Regeln und Tests, Praxisprojekt und verifizierbares Zertifikat.

Häufige Fragen

Lohnt sich das Aufräumen überhaupt?

Wenn der Code noch lange gebraucht und häufig geändert wird, ja. Für Programme, die bald ersetzt werden, selten.

Kann Claude Code das Aufräumen allein erledigen?

Es kann Vorschläge machen und umsetzen, aber Tests und Prüfung durch eine Fachperson bleiben nötig.

Wie erkenne ich, dass sich das Verhalten geändert hat?

Durch Tests, den Vergleich von Ergebnissen vor und nach dem Umbau und die Prüfung der Änderungen. Auffälligkeiten klären Sie, bevor Sie weitermachen.

Wie oft sollte aufgeräumt werden?

Regelmässig in kleinen Mengen, etwa bei jeder grösseren Änderung. So bleibt das Projekt in Form und die Schritte bleiben klein.