CLAUDE.md prüfen mit /doctor prompt-audit: So geht's
Amir TahassoriViel Spaß damit! 👋
CLAUDE.md prüfen mit /doctor prompt-audit
Neue Claude-Modelle nehmen alte Regeln in deiner CLAUDE.md sehr genau. Ein Satz, der früher geholfen hat, kann Claude heute bei einfachen Aufgaben ausbremsen. Mit dem Befehl /doctor prompt-audit prüfst du deine CLAUDE.md, Skills und Agenten auf veraltete Anweisungen. Hier ist die Anleitung mit Sicherung vorab.
Stand: 12.11.2026
Warum alte Regeln Claude bremsen
Die CLAUDE.md ist die Datei, in der deine Regeln für Claude stehen. Viele davon wurden für ältere Modelle geschrieben, die mehr Leitplanken brauchten. Anthropic schreibt dazu im eigenen Blog-Artikel The new rules of context engineering (24.07.2026): Man habe über 80 % des System-Prompts von Claude Code für Modelle wie Claude Opus 5 und Claude Fable 5 entfernt, ohne messbaren Verlust in den eigenen Coding-Tests. Und: Man habe Claude Code überreguliert, auch über CLAUDE.md-Dateien und Skills.
Ein Beispiel: Steht in deiner CLAUDE.md „Sei so gründlich wie möglich“, kann Claude auch bei einer kleinen Änderung immer weiter suchen und Dinge einbauen, um die du nie gebeten hast. Das kostet Zeit und Limit.
Meine Erfahrung
Ich arbeite selbst mit einer sehr langen CLAUDE.md, in der über Monate viele Regeln dazugekommen sind. Genau deshalb ist dieser Befehl für mich spannend: Er zeigt, welche Sätze für die neuen Modelle nicht mehr passen.
Was ist /doctor prompt-audit?
Laut Changelog von Claude Code (Version 2.1.283) prüft /doctor prompt-audit deine CLAUDE.md-Dateien, Skills, Agenten und Befehle auf Anweisungen, die für ältere Modelle geschrieben wurden. Derselbe Befehl geht auch als /checkup prompt-audit. Laut derselben Version stehen veraltete Pfade, veraltete Befehle und sich widersprechende Anweisungs-Dateien ganz oben im Bericht.
Anleitung in 5 Schritten
1. Claude Code aktualisieren
Der Befehl braucht eine aktuelle Version. Im Terminal:
claude update
Mit claude --version siehst du danach deine Version. Sie muss 2.1.283 oder neuer sein.
2. Sicherung anlegen
Bevor du etwas änderst, kopierst du deine CLAUDE.md. Gib Claude Code diesen Auftrag:
Leg von jeder CLAUDE.md in diesem Projekt und von ~/.claude/CLAUDE.md eine Sicherungskopie mit der Endung .bak im selben Ordner an. Ändere sonst nichts. Zeig mir am Ende die Liste der Kopien.
3. Prüfung starten
Öffne Claude Code in deinem Projektordner und gib ein:
/doctor prompt-audit
4. Jeden Vorschlag einzeln ansehen
Der Befehl zeigt dir, welche Sätze er für veraltet hält. Übernimm nichts blind. Stell dir bei jedem Vorschlag drei Fragen:
- Steht die Regel da, weil Claude früher einen Fehler gemacht hat, der heute noch passieren kann?
- Ist es eine Regel, die nur für dein Projekt gilt und die Claude nicht selbst sehen kann?
- Widerspricht die Regel einer anderen Datei?
Bei Ja zu Frage 1 oder 2 bleibt die Regel meist. Widersprüche räumst du auf.
5. Testen
Gib Claude danach eine kleine, typische Aufgabe aus deinem Alltag. Arbeitet Claude genauso gut, nur schlanker, passt es. Fehlt etwas Wichtiges, holst du die Regel aus der .bak-Datei zurück.
So sieht eine gute CLAUDE.md aus
Laut Anthropic-Artikel soll die CLAUDE.md leicht bleiben: kurz beschreiben, wofür das Projekt da ist, und vor allem die Stolperfallen nennen, die Claude nicht selbst sehen kann. Dinge, die Claude aus den Dateien sowieso erkennt, gehören nicht hinein. Längere Anleitungen, zum Beispiel wie du deine Arbeit prüfst, legst du besser als eigenen Skill an und verweist in der CLAUDE.md nur darauf.
Lies meine CLAUDE.md. Markiere jede Regel, die (a) etwas Offensichtliches sagt, das du aus den Dateien selbst siehst, (b) einer anderen Regel widerspricht oder (c) eine lange Anleitung ist, die besser ein eigener Skill wäre. Ändere nichts, zeig mir nur die Liste mit Begründung.
3 Fehler, die du vermeiden solltest
- Ohne Sicherung aufräumen: Manche Regel fällt dir erst nach Tagen wieder ein.
- Alles löschen, was der Bericht zeigt: Der Befehl kennt deine Geschichte nicht. Regeln aus echten Fehlern bleiben.
- Nur die CLAUDE.md prüfen: Auch Skills und Agenten können sich widersprechen. Der Befehl schaut deshalb auf alle.
Weiterlesen
Eine kurze, kostenlose Regel-Datei zum Start zeige ich dir in CLAUDE.md: Eine Datei macht Claude schlauer. Wie du mit zwei Zeilen Limit sparst, steht in Claude-Limit sparen. Und die Grundeinrichtung findest du in der Checkliste Claude richtig einrichten.
Häufige Fragen
Kostet der Befehl extra?
Nein, er ist Teil von Claude Code. Die Prüfung läuft aber wie jede Anfrage über dein normales Claude-Limit.
Ändert der Befehl meine Dateien?
/doctor kann laut Changelog Probleme nicht nur finden, sondern auch beheben. Darum: vorher sichern und jeden Vorschlag selbst ansehen, bevor du ihn übernimmst.
Gilt das auch für Claude im Browser?
Der Befehl gehört zu Claude Code. Die Idee dahinter gilt aber überall: weniger, klarere Anweisungen.
Wie oft sollte ich prüfen?
Am besten nach jedem großen Modell-Wechsel und immer dann, wenn Claude bei einfachen Aufgaben plötzlich übertreibt.