/doctor prompt-audit in Claude Code ist ein Befehl, der Claude Ihre Anweisungsdateien (CLAUDE.md, AGENTS.md, Skills, Befehle usw.) lesen lässt, dort nach veralteten oder einander widersprechenden Anweisungen sucht und Korrekturen vorschlägt. Sie erhalten nur einen Bericht und vorgeschlagene Diffs: Kein einziges Zeichen in Ihren Dateien ändert sich, bevor Sie Claude bitten, etwas anzuwenden. Wenn Sie /checkup prompt-audit eingeben, läuft genau dieselbe Prüfung.
Dieser Artikel erklärt, was der Prompt-Audit prüft, wie Sie ihn starten und wie Sie mit den Ergebnissen umgehen. Grundlage sind der Originaltext der offiziellen Claude-Code-Dokumentation (der Abschnitt „Audit your instruction files“ in How Claude remembers your project sowie Commands und Skills), das CHANGELOG und der Prüfleitfaden, der mit Claude Code ausgeliefert wird. Alle Angaben zur Spezifikation haben wir am 3. Oktober 2026 in diesen Originalen geprüft. In den Abschnitten 7 und 8 zeigen wir außerdem, was passiert ist, als wir ihn auf die Anweisungsdateien dieser Website angewendet haben (9 Befunde, 7 übernommen), und welche Einschränkungen uns aufgefallen sind.
Kurz gesagt: /doctor prompt-audit auf einen Blick
Quelle: Claude-Code-Dokumentation, „How Claude remembers your project“ und „Commands“ (geprüft am 3. Oktober 2026)
WAS ER TUT
Prüft Ihre Anweisungsdateien
Sucht nach Formulierungen für ältere Modelle, Verweisen auf Dateien oder Befehle, die es nicht mehr gibt, und widersprüchlichen Anweisungen.
ERGEBNIS
Ein Bericht und vorgeschlagene Diffs
Nichts ändert sich, bevor Sie darum bitten. Sie entscheiden Befund für Befund, was übernommen wird.
UMFANG
CLAUDE.md, Skills und mehr
Auch AGENTS.md, Regeln, Befehle und Subagents. Mit einem Pfad prüfen Sie nur eine Stelle.
VERSION
Ab v2.1.283
Wird in einer Sitzung eingegeben. Nicht dasselbe wie claude doctor im Terminal.
Inhalt
- 1. Was ist /doctor prompt-audit? Eine Prüfung auf veraltete und widersprüchliche Anweisungen
- 2. Verwendung: einfach eingeben, mit einem Pfad den Umfang eingrenzen
- 3. Was die Prüfung als „veraltet“ einstuft
- 4. Was nicht gelöscht wird: keine Prüfung zum „Kürzen“
- 5. Ergebnisse lesen: der Bericht und die vorgeschlagenen Diffs
- 6. Unterschiede zu /doctor, /claude-api prompt-audit und claude doctor
- 7. Selbst getestet: CLAUDE.md und AGENTS.md dieser Website im Audit
- 8. Nachteile und Hinweise
- 9. Wann sich ein Prompt-Audit lohnt
- FAQ
1. Was ist /doctor prompt-audit? Eine Prüfung auf veraltete und widersprüchliche Anweisungen
Claude Code lädt CLAUDE.md und Ihre übrigen Anweisungsdateien bei jedem Start. Diese Dateien wachsen mit der Zeit und sammeln übertrieben nachdrückliche Formulierungen für ältere Modelle, Namen von Dateien und Befehlen, die es nicht mehr gibt, und Regeln, die einer anderen Datei widersprechen. /doctor prompt-audit ist der Befehl, mit dem Claude genau danach sucht.
Die offizielle Dokumentation lässt sich so zusammenfassen:
- Wonach er sucht: Anweisungen, die für ältere Modelle geschrieben wurden, Verweise auf Dateien oder Befehle, die nicht existieren, und Dateien, die sich gegenseitig widersprechen.
- Was er zurückgibt: einen Bericht über die gefundenen Probleme und Korrekturvorschläge als Diffs. In Ihren Dateien ändert sich nichts, bevor Sie Claude bitten, sie anzuwenden.
- Funktionsweise: Er läuft über den mitgelieferten Skill
/claude-apivon Claude Code. Haben Sie diesen Skill in Ihren Einstellungen abgeschaltet (perskillOverridesdeaktiviert oderdisableBundledSkillsaktiviert), steht der Audit nicht zur Verfügung. - Version: Claude Code ab v2.1.283.
/checkup prompt-auditist derselbe Befehl.
Der Eintrag zu v2.1.283 im CHANGELOG führt /doctor prompt-audit (und /checkup prompt-audit) ein, um CLAUDE.md, Skills, Agents und Befehle auf Prompt-Muster zu prüfen, die für ältere Modelle geschrieben wurden. Mit derselben Version wurde der Audit außerdem so geändert, dass er veraltete Pfade, veraltete Befehle und widersprüchliche Anweisungsdateien an den Anfang des Berichts stellt und Schlüsselwörter für die Denktiefe wie „think“, die Claude Code offiziell unterstützt, stehen lässt.
Warum sind veraltete Anweisungen ein Problem? Der mitgelieferte Prüfleitfaden erklärt es so: Aktuelle Modelle befolgen Anweisungen genauer und wörtlicher als ältere. Die gehäuften „CRITICAL“ und „MUST“, die man einfügte, damit ältere Modelle eine Regel nicht übersehen, wirken heute zu stark: Die Regel wird auch dort angewendet, wo sie nicht nötig ist, und das Modell wird starr. Der Leitfaden stellt klar, dass das Ziel nicht ist, Anweisungen zu kürzen, sondern Anweisungen zu finden, die nicht mehr zum aktuellen Modell, zum aktuellen Projekt oder zu Ihren anderen Anweisungen passen.
2. Verwendung: einfach eingeben, mit einem Pfad den Umfang eingrenzen
Geben Sie in einer Claude-Code-Sitzung einfach Folgendes ein:
/doctor prompt-auditOhne Argument prüft der Audit laut offizieller Dokumentation diese Dateien:
| Art | Was dazugehört |
|---|---|
| Anweisungsdateien | CLAUDE.md, CLAUDE.local.md, AGENTS.md |
Unter .claude/ und ~/.claude/ | Regeln (rules), Skills, Befehle, Subagents, Ausgabestile (output styles) |
Wenn Sie nur eine Datei oder einen Ordner prüfen möchten, übergeben Sie einen Pfad. Das Beispiel aus der offiziellen Dokumentation:
/doctor prompt-audit .claude/skills/deployLaut dem mitgelieferten Leitfaden ist der Audit darauf ausgelegt, bis zum Ende durchzulaufen, ohne zwischendurch Rückfragen zu stellen. Den Umfang und das Modell, an dem gemessen wird, leitet er aus Ihrer Anfrage und den Dateien selbst ab und nennt diese Annahmen am Anfang des Berichts. Stimmt eine Annahme nicht, starten Sie ihn mit einem engeren Pfad erneut. Bei Anweisungsdateien ist der Maßstab in der Regel das Modell, das den Audit ausführt (oder, falls ein Skill oder Subagent ein eigenes Modell festlegt, dieses Modell).
Der Leitfaden legt außerdem fest, dass der Audit weder die Einstellungsdateien von Claude Code (.claude/settings*.json) noch die MCP-Konfiguration (.mcp.json) liest, weil darin Geheimnisse stehen können. Probleme mit Berechtigungen oder Hooks liegen daher außerhalb dieses Audits; dafür ist das einfache /doctor zuständig (siehe Abschnitt 6).
3. Was die Prüfung als „veraltet“ einstuft
Was der Audit prüft, steht im Leitfaden, der mit Claude Code ausgeliefert wird (die prompt-audit-Anweisungen im Skill /claude-api). Als wir die mit v2.1.286 ausgelieferten Dateien gelesen haben, ließen sich die Prüfungen in vier Gruppen einteilen. Bei Anweisungsdateien leisten die ersten beiden den Großteil der Arbeit.
| Gruppe | Wichtigste Prüfungen | Beispiele |
|---|---|---|
| 1. Veralteter Prompt-Stil | Zu starke Formulierungen, überflüssig gewordene Denkanweisungen, zu kleinteilig vorgegebene Schritte, zurückgebliebene Workarounds für Fehler alter Modelle | „CRITICAL: you MUST...“ immer wieder, „Think step by step“, ein „STEP 1... STEP 2...“, das Arbeit mit Ermessensspielraum in ein Schema zwängt |
| 2. Anfällige Konfigurationsdateien | Pfade und Befehle, die nicht existieren, Dateien, die sich widersprechen, in die Datei geschriebene Vorfallshistorien, einmalige Ausrutscher, die zur Dauerregel wurden, an ein Datum gebundene Bedingungen | Der Name eines gelöschten Skripts, gegensätzliche Regeln in zwei Dateien, „Weil das am [Datum] schiefging...“ |
| 3. Tool-Beschreibungen | Beschreibungen, die Sie beim Definieren von Tools in der API schreiben (zu kurze Beschreibungen werden mit dem Hinweis markiert, mehr Details zu ergänzen) | Einzeilige Beschreibungen, „always use this tool“ in einer Beschreibung |
| 4. Einstellungen der API-Aufrufe | Parameter, die bei aktuellen Modellen inzwischen einen Fehler auslösen oder veraltet sind, Reihenfolgen, die das Caching zerstören, und Ähnliches | Nur wenn Anwendungscode vorhanden ist (für ein Projekt mit reinen Anweisungsdateien nicht relevant) |
Innerhalb von Gruppe 2 behandelt der Leitfaden „Pfade und Befehle, die nicht existieren“ besonders streng. Der Audit prüft, ob jeder Pfad in Ihren Anweisungsdateien im Projekt tatsächlich vorhanden ist und ob Befehle und Optionen in Ihren Skripten oder Ihrer Konfiguration definiert sind – und zwar durch Lesen der Dateien, ohne einen einzigen Befehl auszuführen. Alles, was dem tatsächlichen Stand des Projekts widerspricht, wird zu einem Befund mit hoher Konfidenz.
Widersprechen sich zwei Dateien, entscheidet der Audit mit git blame (dem Protokoll, wer welche Zeile wann geschrieben hat), welche neuer ist, und schlägt vor, die ältere anzugleichen. Ist eine Seite jedoch ein Verbot oder eine Sicherheitsregel, die durch die Korrektur aufgeweicht würde, oder lässt sich aus der Historie nicht ablesen, welche neuer ist, soll laut Leitfaden keine Korrektur vorgeschlagen werden; der Fall wird dann nur als Entscheidung gemeldet, die beim Nutzer liegt.
4. Was nicht gelöscht wird: keine Prüfung zum „Kürzen“
Am meisten hat uns an diesem Audit gefallen, dass der Leitfaden ausdrücklich festhält, was nicht gelöscht werden darf. Er warnt, dass ein Audit, der alles streicht, gerade diejenigen bestraft, die sorgfältige Anweisungen geschrieben haben, und verlangt, Folgendes zu behalten, auch wenn die Formulierung einem Muster entspricht:
- Kontext, den nur der Autor kennt: Fakten über Zielgruppe, Produkt und Umgebung, Qualitätsmaßstäbe, Einschränkungen und die Gründe dafür. Der Leitfaden sagt unmissverständlich, dass Kontext nie verschwendet ist.
- Länge an sich: Nichts wird nur deshalb gekürzt, weil es lang ist. Schaden richten veraltete Anweisungen an, nicht der Umfang.
- Exakte Schritte für heikle Vorgänge: Arbeiten mit nur einem sicheren Ablauf, etwa Löschbefehle oder Authentifizierungsabläufe, dürfen vollständig ausformuliert bleiben.
- Verbote gegen Fehler, die immer noch vorkommen: Tritt der Fehler auch mit aktuellen Modellen noch auf, bleibt die Regel.
- Doppelungen, die funktionieren: Derselbe Inhalt an zwei Stellen ist eine Frage der Ordnungsvorlieben und kein Fall für den Audit, solange sich die beiden Fassungen nicht widersprechen.
Es geht auch in die andere Richtung. Würden aktuelle Modelle von einer zusätzlichen Anweisung profitieren, schlägt der Audit diese vor. Und wenn nichts auftaucht, ist laut Leitfaden nichts zu ändern das richtige Ergebnis.
5. Ergebnisse lesen: der Bericht und die vorgeschlagenen Diffs
Sie erhalten zweierlei: einen Prüfbericht und Korrekturvorschläge als Diffs. Jeder Befund im Bericht hat sechs Felder:
| Feld | Inhalt |
|---|---|
| Fundstelle | Dateiname und Zeilennummer |
| Beleg | Der betroffene Text, wörtlich zitiert |
| Muster | Welchem Muster aus Abschnitt 3 er entspricht |
| Warum veraltet | Womit er kollidiert: mit dem Verhalten aktueller Modelle oder mit dem tatsächlichen Stand des Projekts |
| Konfidenz | Hoch (widerspricht der offiziellen Dokumentation oder dem Projekt selbst), mittel (breit beobachtetes Verhalten), niedrig (aus der Formulierung abgeleitet) |
| Maßnahme | Löschen, umschreiben (mit neuem Text), verschieben (mit Ziel), ergänzen oder nur markieren |
In die vorgeschlagenen Diffs gelangen nur Befunde mit hoher und mittlerer Konfidenz. Befunde mit niedriger Konfidenz stehen nur im Bericht. Die Diffs sind in einen Abschnitt pro Befund aufgeteilt, sodass Sie nur die auswählen können, die Sie wollen.
Zum Anwenden bitten Sie Claude zum Beispiel: „Wende 1, 3 und 4 an.“ Der Leitfaden legt außerdem fest, dass Widersprüche zwischen Dateien und das Umschreiben von Text, der nicht zum Projekt passt, bei einer Pauschalanfrage nicht angewendet werden, etwa bei „räum alles auf“. Jeder mit Schreibzugriff auf das Repository kann sowohl den neueren Text als auch das Projekt selbst verändert haben; deshalb geht das Konzept davon aus, dass ein Mensch jeden dieser Punkte prüft.
6. Unterschiede zu /doctor, /claude-api prompt-audit und claude doctor
Es gibt vier Dinge mit ähnlichen Namen. Ein Vergleich dessen, was die offizielle Dokumentation (Commands und Skills) und das CHANGELOG sagen:
| Befehl | Was er tut | Ändert Dateien? | Version |
|---|---|---|---|
/doctor prompt-audit | Prüft Anweisungsdateien (CLAUDE.md, Skills usw.) auf veraltete und widersprüchliche Anweisungen | Nur Bericht und Vorschläge (wendet auf Anfrage an) | Ab v2.1.283 |
/doctor (Alias /checkup) | Ein Gesundheitscheck Ihrer Umgebung (doppelte Installationen, PATH, defekte Einstellungen, ungenutzte Skills und MCP-Server, langsame Hooks, verfügbare Updates) plus Vorschläge, CLAUDE.md-Inhalte zu streichen, die sich schon aus dem Code ergeben, und ständig geladene Anweisungen in Skills oder verschachtelte CLAUDE.md-Dateien zu verschieben | Berichtet zuerst, korrigiert nach Ihrer Bestätigung | (Kürzungsvorschläge für CLAUDE.md: ab v2.1.206) |
/claude-api prompt-audit | Prüft Prompts und Tool-Beschreibungen von Anwendungen, die auf der Claude API aufbauen, auf Muster, die für ältere Modelle geschrieben wurden | Schlägt Diffs vor | Ab v2.1.221 |
claude doctor (Terminal) | Zeigt den Zustand Ihrer Installation an, ohne eine Sitzung zu starten | Nein (nur lesend) | — |
Verwirrend ist, dass sich auch /doctor selbst mit CLAUDE.md befasst. Der Unterschied liegt im Ziel. /doctor will verringern, was ständig geladen wird (Doppelungen entfernen, streichen, was Claude ohnehin aus dem Code erfährt, Inhalte an Orte verschieben, die nur bei Bedarf geladen werden). /doctor prompt-audit prüft, ob der Inhalt veraltet ist oder sich widerspricht. Das claude doctor im Terminal führt keinen Prompt-Audit aus.
Wenn Claude Ihre Anweisungen nicht befolgt, weil sie gar nicht erst geladen werden, hilft dieser Audit nicht. Wie Sie prüfen, was geladen wird, beschreiben wir in „Warum KI .md-Regeln ignoriert: Laden, Geltungsbereich und Ergebnisse prüfen“, und wie Sie messen, wie viel Ihres Kontexts die Anweisungsdateien belegen, in „Claude Code: Was frisst eigentlich Ihren Kontext?“.
7. Selbst getestet: CLAUDE.md und AGENTS.md dieser Website im Audit
Am 3. Oktober 2026 haben wir /doctor prompt-audit auf die Anweisungsdateien angewendet, mit denen wir diese Website entwickeln. Ausgeführt haben wir ihn in der Desktop-App von Claude Code (mitgeliefertes Claude Code 2.1.286, Modell Opus 5.5). Unsere Anweisungsdateien sind AGENTS.md (die Hauptregeln, die Claude Code und Codex gemeinsam nutzen) und CLAUDE.md (die AGENTS.md importiert und Hinweise speziell für Claude Code ergänzt), zusammen etwa 10.700 Zeichen. Unter .claude/ haben wir keine Regeln, Skills oder Befehle.
Ergebnis eines Durchlaufs
Quelle: eigener Test (3. Oktober 2026, /doctor prompt-audit auf CLAUDE.md und AGENTS.md)
Befunde
9
Geprüft und übernommen
7
Ausgelassen (niedrige Konfidenz)
2
Die erste Überraschung: Der Audit fand kaum Formulierungen, die für ältere Modelle geschrieben waren. Kein einziges „think step by step“ und kein Schritt-für-Schritt-Skript. Die meisten Befunde gehörten zu Gruppe 2 aus Abschnitt 3 (anfällige Konfigurationsdateien).
| Konfidenz | Anzahl | Was er fand | Was wir getan haben |
|---|---|---|---|
| Hoch | 1 | Wir hatten an diesem Tag zwei Prüfwerkzeuge hinzugefügt, aber eine Anmerkung in Klammern sprach noch von „beiden“ und passte nicht mehr zu den Beschreibungen der zwei neuen Werkzeuge | Übernommen (Anmerkung so umgeschrieben, dass sie die hinzugefügten Werkzeuge getrennt abdeckt) |
| Mittel | 5 | Vorfallsprotokolle mit Daten und Häufigkeiten, die in den Anweisungsdateien stehen geblieben waren (im Widerspruch zu einer Regel in derselben Datei: keine Vorfallsprotokolle in den Einstiegsdateien anhäufen) | Übernommen (aber in eine eigene Protokolldatei verschoben statt gelöscht) |
| Mittel | 1 | Ein „(CRITICAL)“ in einer Überschrift ohne Begründung | Übernommen (entfernt) |
| Niedrig | 2 | Eine Liste von Befehlen, die lokal nicht laufen, und eine Überschrift mit Datum | Ausgelassen (beide haben einen Grund, und auch der Leitfaden behandelt „niedrig“ als „nur markieren“) |
Der einzige Befund mit hoher Konfidenz war eine echte Abweichung. Beim Hinzufügen der Prüfwerkzeuge hatten wir ihre Namen in die Liste aufgenommen, aber vergessen, die Erklärung direkt daneben umzuschreiben. Bei jedem Laden der Datei hätte Claude missverstehen können, worauf sich „beide“ bezieht, und uns war das beim Durchsehen entgangen.
Der Bericht hielt außerdem fest, dass er jeden Pfad, jeden Werkzeugnamen und jede referenzierte Notiz in den Anweisungsdateien auf ihr Vorhandensein geprüft hatte. Er glich sogar die PHP-Version (passend zur Docker-Konfiguration) und die Zahl der Schritte in einem Ablauf (passend zu einer Liste in einer anderen Datei) ab.
Die von Claude vorgeschlagenen Diffs haben wir nicht unbesehen übernommen, sondern erst angewendet, nachdem wir jeden einzelnen an den Originaldateien geprüft hatten. Am meisten Abwägung verlangten die fünf mittleren Befunde. Vorgeschlagen war, die Vorfallsprotokolle zu löschen; diese Protokolle sind aber genau der Beleg, der verhindert, dass sich dieselben Fehler wiederholen. Deshalb haben wir sie verschoben statt gelöscht. Wo Daten und Häufigkeiten bereits in einer anderen Datei standen, haben wir sie nur aus den Anweisungsdateien entfernt; die zwei, die nirgendwo sonst festgehalten waren, haben wir in die Protokolldatei übertragen. Am Ende waren die Anweisungsdateien von etwa 10.700 Zeichen nur um etwa 40 Zeichen kürzer. Der Umfang hat sich kaum verändert; nur die Widersprüche sind verschwunden.
Bedenken Sie, dass dies ein Durchlauf bei einem Projekt war. Den Audit schreibt das Modell, deshalb kann ein erneuter Durchlauf mit denselben Dateien eine andere Zahl von Befunden oder andere Formulierungen ergeben. Ein Projekt mit vielen Skills und Befehlen unter .claude/ wird wahrscheinlich ganz andere Befunde erhalten.
8. Nachteile und Hinweise
Aus der Nutzung und der Lektüre der offiziellen Dokumentation und des Leitfadens ergeben sich fünf Punkte, die Sie beachten sollten:
- Er verbraucht Ihr Nutzungskontingent: Claude liest und prüft Ihre Anweisungsdateien in der Sitzung, das zählt also wie jede andere Arbeit gegen Ihre Nutzung. Eine gesonderte Abrechnung erwähnt die offizielle Dokumentation nicht.
- Befunde nicht blind übernehmen: Claude weiß womöglich nicht, warum eine Regel geschrieben wurde. Hätten wir den Vorschlag „Vorfallsprotokolle löschen“ unverändert übernommen, wäre der Beleg verloren gegangen, der Wiederholungsfehler verhindert.
- Ergebnisse schwanken von Durchlauf zu Durchlauf: Ein Modell schreibt den Audit, daher können sich Anzahl und Formulierung jedes Mal ändern. Werten Sie einen Durchlauf ohne Befund nicht als Beweis, dass eine Datei fehlerfrei ist.
- Einstellungsdateien bleiben außen vor:
settings.jsonund.mcp.jsonwerden nicht gelesen, Probleme mit Berechtigungen, Hooks und MCP tauchen also nicht auf. Dafür nutzen Sie/doctor. - Keine Garantie, dass Ihr Inhalt stimmt: Fehlende Pfade und Widersprüche findet er, aber er beurteilt nicht, ob Ihre Vorgehensweise die richtige ist. Diese Entscheidung liegt bei Ihnen.
Der Leitfaden selbst behandelt Löschungen als Hypothesen, nicht als Schlussfolgerungen. Haben Sie eine Anweisung entfernt, sollen Sie in der echten Arbeit prüfen, dass das Verhalten, das sie sichergestellt hat, nicht kaputtgegangen ist.
9. Wann sich ein Prompt-Audit lohnt
Der Leitfaden beschreibt Prompts als Artefakte eines bestimmten Modells, in denen Zeilen, die eine Generation brauchte, in der nächsten zu Ballast werden, und empfiehlt, bei jedem neuen Modell erneut zu prüfen. Unserer Einschätzung nach passen diese drei Situationen gut:
- Wenn Sie auf eine neuere Modellgeneration wechseln: nach starken Formulierungen und Workarounds suchen, die von älteren Modellen übrig sind
- Nach einer größeren Überarbeitung Ihrer Anweisungsdateien: Wie bei unserem Durchlauf driften neue Regeln und alte Erklärungen leicht auseinander
- Wenn Sie Anweisungsdateien über mehrere Werkzeuge wie Claude Code und Codex hinweg teilen: Widersprüche zwischen AGENTS.md und CLAUDE.md lassen sich leichter erkennen
Sind Ihre Anweisungsdateien dagegen kurz und ändern sich selten, eilt es nicht. Auch der Leitfaden sagt, dass es ein korrektes Ergebnis ist, nichts zu finden.
Fazit
/doctor prompt-audit ist ein Befehl, der Ihre Anweisungsdateien (CLAUDE.md, AGENTS.md, Skills und mehr) nach Formulierungen für ältere Modelle, nicht existierenden Pfaden und Befehlen sowie widersprüchlichen Regeln durchsucht und dann einen Bericht und vorgeschlagene Diffs zurückgibt. Er steht in Claude Code ab v2.1.283 zur Verfügung, und nichts ändert sich, bevor Sie darum bitten.
Der Prüfleitfaden schützt Kontext, Begründungen und Verbote gegen Fehler, die immer noch vorkommen, als Dinge, die nicht gelöscht werden, damit daraus keine Prüfung zum „Kürzen“ wird. Bei den Anweisungsdateien dieser Website fand er kaum veraltete Prompt-Formulierungen, wohl aber eine Erklärung, die wir nach dem Hinzufügen einer Regel umzuschreiben vergessen hatten – eine echte Abweichung.
Sicher ist es, jeden Befund an der Originaldatei zu prüfen und Text, der einen Grund hat, zu verschieben statt zu löschen. Ein Durchlauf nach einem Modellwechsel oder einer Überarbeitung Ihrer Anweisungsdateien kann Widersprüche aufdecken, die beim Durchsehen übersehen wurden.
FAQ
F. Schreibt /doctor prompt-audit meine CLAUDE.md eigenmächtig um?
A. Nein. Laut offizieller Dokumentation gibt er einen Bericht und Korrekturvorschläge zurück, und in Ihren Dateien ändert sich nichts, bevor Sie Claude bitten, sie anzuwenden. Selbst dann können Sie Vorschlag für Vorschlag wählen.
F. Was ist der Unterschied zwischen /doctor prompt-audit und /checkup prompt-audit?
A. Es gibt keinen. /checkup ist ein Alias für /doctor, und der Eintrag zu v2.1.283 im CHANGELOG nennt /doctor prompt-audit zusammen mit /checkup prompt-audit.
F. Prüft er auch die AGENTS.md für Codex?
A. Ja. Die offizielle Dokumentation führt AGENTS.md neben CLAUDE.md und CLAUDE.local.md unter den Dateien auf, die ohne Argument geprüft werden. Wenn Sie beide Dateien gemeinsam nutzen, eignet er sich auch gut, um Widersprüche zwischen ihnen zu finden.
F. Ich habe ihn eingegeben, aber der Audit startet nicht.
A. Prüfen Sie zuerst Ihre Version: /doctor prompt-audit benötigt v2.1.283 oder neuer. Ist Ihre Version aktuell genug und er läuft trotzdem nicht, prüfen Sie, ob Sie den mitgelieferten Skill /claude-api in Ihren Einstellungen abgeschaltet haben (skillOverrides oder disableBundledSkills). Beachten Sie außerdem, dass claude doctor im Terminal nur Ihre Installation diagnostiziert und diesen Audit nicht ausführt.
F. Kann er den System-Prompt einer App prüfen, die ich auf der API gebaut habe?
A. Ja, verwenden Sie dafür aber /claude-api prompt-audit (ab v2.1.221). Er prüft Ihre Prompts, Tool-Beschreibungen und den Code, der die API aufruft, auf Muster, die für ältere Modelle geschrieben wurden, und schlägt Diffs vor.
Quellen
- Claude-Code-Dokumentation: How Claude remembers your project (Abschnitt „Audit your instruction files“)
- Claude-Code-Dokumentation: Commands (die Zeilen zu
/doctorund/claude-api) - Claude-Code-Dokumentation: Skills (Unterbefehle des mitgelieferten Skills
/claude-apiund erforderliche Versionen) - Claude Code: CHANGELOG (v2.1.283)
- Der prompt-audit-Leitfaden im Skill
/claude-api, der mit Claude Code v2.1.286 ausgeliefert wird (auf unserem eigenen Rechner geprüft)
Alle Quellen wurden am 3. Oktober 2026 im Original geprüft. Der mitgelieferte Leitfaden wird mit jeder Claude-Code-Version aktualisiert, daher kann sich der Prüfumfang von Version zu Version ändern.
