Guide · Setup & Grundlagen
Claude Code Checkup: CLAUDE.md und Skills aufräumen
Mit /doctor prompt-audit findest du Regeln, die für ältere Modelle geschrieben wurden
- 1 Befehl
- /doctor prompt-audit prüft alles auf einmal
- 4 Orte
- CLAUDE.md, Skills, Agenten und Befehle
- 2.1.283
- ab dieser Version von Claude Code, seit 25.09.2026
Worum es geht. Viele Anweisungen in deiner CLAUDE.md oder in deinen Skills wurden für ältere Modelle geschrieben. Was damals geholfen hat, bremst ein neues Modell eher aus. Claude Code kann das jetzt selbst prüfen.
DER BEFEHL
So startest du die Prüfung
In Claude Code, im Ordner deines Projekts
In Claude Code eintippen
/doctor prompt-auditGeht genauso
/checkup prompt-auditWas er durchsucht
Laut Changelog prüft er deine CLAUDE.md-Dateien, deine Skills, deine Agenten und deine Befehle auf Formulierungen, die für ältere Modelle geschrieben wurden.
Was du vorher brauchst
Claude Code ab Version 2.1.283. Wenn der Befehl bei dir nicht erscheint, aktualisiere Claude Code zuerst.
DER BERICHT
Was ganz oben im Bericht steht
Die wichtigsten Funde kommen zuerst
Was das bedeutet
- Veraltete Pfade: In deinen Anweisungen steht ein Ordner oder eine Datei, die es im Projekt nicht mehr gibt.
- Veraltete Befehle: Du verweist auf einen Befehl, der nicht mehr existiert oder anders heißt.
- Widersprüche: Zwei Anweisungsdateien sagen das Gegenteil, zum Beispiel „antworte kurz“ und „antworte sehr ausführlich“.
- Formulierungen für ältere Modelle: Zeilen, die ein altes Modell antreiben sollten und heute eher stören.
Was er bewusst stehen lässt. Denk-Schlüsselwörter, die Claude Code selbst dokumentiert, bleiben laut Changelog erhalten. Du musst also nicht alles löschen, was nach einem Trick aussieht.
Zu große Dateien
Seit Version 2.1.282 zählt der Hinweis beim Start alle Anweisungsdateien zusammen. So fallen auch viele mittelgroße Dateien und Importe auf.
AUFRÄUMEN
Was du streichst und was bleibt
So gehst du mit den Funden um
Erst die Fehler
Korrigiere veraltete Pfade und Befehle oder lösch die Zeile, wenn es die Sache nicht mehr gibt.
Dann die Widersprüche
Entscheide dich für eine der beiden Regeln und streich die andere.
Zum Schluss die alten Tricks
Zeilen in Großbuchstaben, mehrfache Ausrufezeichen und Sätze wie „Denke Schritt für Schritt“ kannst du meist ersatzlos löschen. Das sind Beispiele dafür, wie solche Zeilen aussehen.
Was du behältst. Alles, was nur du wissen kannst: wie dein Projekt aufgebaut ist, welche Befehle es gibt, wie du schreibst und was nicht angefasst werden darf.
NÄCHSTER SCHRITT
Direkt umsetzen
Einmal durchlaufen lassen, dann ist Ruhe
Claude Code aktualisieren
Du brauchst mindestens Version 2.1.283.
Befehl starten
Tipp /doctor prompt-audit in deinem Projektordner ein.
Bericht von oben abarbeiten
Pfade, Befehle, Widersprüche, dann die alten Formulierungen.
Noch einmal laufen lassen
Wenn der Bericht leer bleibt, hat Claude wieder eine saubere Grundlage.
Quelle: Claude-Code-Changelog, Versionen 2.1.282 und 2.1.283 (code.claude.com/docs/en/changelog). Die gezeigten Beispielzeilen dienen der Veranschaulichung. Stand 30.09.2026.
Wir bauen dir das fertig.
Mit dem Guide kannst du es selbst einrichten. Oder wir machen das für dich, mit deinen Daten und Zugängen, und zwar so, dass es bei dir im Alltag läuft.
Bauen lassen