Refactoring mit Claude Code: Plan, kleine Schritte und grüne Tests

Was Claude Code für Refactoring erledigt

• Arbeitet einen Refactoring-Backlog in kleinen Schritten ab, jeder als eigener Pull Request.
• Führt die Tests vor und nach jedem Schritt aus und hört auf, wenn sie fehlschlagen.
• Erledigt den mechanischen Teil von Migrationen: Umbenennungen in der ganzen Codebasis, API-Upgrades, den Umstieg auf eine neue Library.
• Entfernt toten Code und doppelte Logik und begründet jede Entfernung.

Funktionen von Claude Code für Refactoring

So richtest du Claude Code für Refactoring ein

1. Verbinde die Tools

   Es gibt nichts zu verbinden. Sicher wird ein Refactoring durch einen Testbefehl, den Claude ausführen kann, und eine Obergrenze für die Größe jedes Schritts. Schreib beides in die CLAUDE.md und starte in einem Worktree.

   # Das Refactoring in einem eigenen Worktree starten
   claude --worktree billing-async
   
   # Den Plan vor jedem Edit abstimmen
   /plan Move the billing module from callbacks to async/await

2. Schreib die Regeln in die CLAUDE.md

   Claude Code liest die CLAUDE.md zu Beginn jeder Session, auch bei Läufen mit claude -p. Schreib die Regeln der Aufgabe dort hinein oder, wenn sie lang sind, in einen Skill unter .claude/skills/. Siehe den CLAUDE.md-Leitfaden.

   ## Refactoring-Regeln
   - Keine Verhaltensänderungen. Muss ein Test geändert werden, hör auf
     und frag.
   - Führ `npm test` aus, bevor du anfängst, und nach jedem Schritt.
   - Ein Schritt pro Pull Request, unter 400 geänderten Zeilen.
   - Halte REFACTOR.md aktuell: Hak ab, was erledigt ist, und ergänze,
     was du gefunden hast.
   - Fass migrations/, generierte Dateien oder öffentliche APIs nicht an,
     ohne zu fragen.

3. Führ es ohne die interaktive Oberfläche aus

   claude -p führt eine Aufgabe aus und beendet sich, sodass cron, CI oder ein anderes Tool es starten kann. Mit --allowedTools oder --permission-mode legst du fest, was es ohne Nachfrage tun darf; --output-format json liefert das Ergebnis samt Kosten.

   # Ein Schritt pro Tag aus dem Backlog in REFACTOR.md
   claude -p "Erledige den nächsten offenen Punkt in REFACTOR.md und halte die Tests grün" \
     --allowedTools "Bash(npm test),Read,Edit"

4. Bring es in einen Zeitplan

   Leg mit /schedule eine geplante Aufgabe in der Cloud an (Pro, Max, Ultra, Team und Enterprise), nutze eine geplante Desktop-Aufgabe oder /loop, solange eine Session offen bleibt. Siehe Claude Code proaktiv machen.

Quelle: Dokumentation von Claude Code (Englisch)

Grenzen und Sicherheit

• Ohne Tests kann es ein Refactoring nicht von einer Verhaltensänderung unterscheiden. Schreib zuerst Tests für den Bereich.
• Ein großer Umbau in einem Durchgang ist schwer zu reviewen. Kleine Schritte, die jeweils gemergt werden, sind sicherer und am Ende schneller.
• Es weiß nicht, welcher seltsame Code Absicht ist. Markiere diese Stellen mit einem Kommentar oder in den Regeln.
• Seit Claude Code v2.1.302 startet claude -p im Manual-Modus: Eine Aktion, die eine Freigabe braucht, wird abgelehnt, sofern keine Regel sie erlaubt. Erlaube nur die Tools, die die Aufgabe braucht.

Claude Code oder Codex für Refactoring?

Die Regeln lassen sich mitnehmen. Schreib sie einmal in die AGENTS.md und setz @AGENTS.md in die CLAUDE.md, dann lesen beide Agenten dieselbe Datei.

Schritt für Schritt für den anderen Agenten: Refactoring mit Codex.

Mach Refactoring zur festen Aufgabe

Befehle laufen, wenn jemand daran denkt, sie auszuführen. Crewmark macht aus deinem eigenen Claude Code einen KI-Mitarbeiter mit Rolle, einem Ziel in Zahlen, Arbeitszeiten und einem Heartbeat, damit die Arbeit nach Zeitplan passiert und auf einem Board sichtbar wird.

1. Fang mit der Rolle an

   Der KI-Softwareentwickler, mit diesen Regeln in seiner Rollenbeschreibung.

2. Bring die Arbeit auf sein Board

   Leg die Aufgabe als wiederkehrendes Issue an. Der Mitarbeiter wacht per Heartbeat auf, erledigt sie und berichtet in einem Kommentar.

3. Mehr dazu

   Code-Review prüft jeden Schritt vor dem Merge.

FAQ