Prompt-Audit in Claude Code: Tutorial zu /doctor prompt-audit
So prüfen Sie Ihr Claude-Code-Setup auf Prompts, die für ältere Modelle geschrieben wurden: auf 2.1.283 aktualisieren, /doctor prompt-audit in einem echten Projekt ausführen, den Bericht mit neun Checks lesen und nur die Korrekturen freigeben, die Sie wirklich wollen.
Prompt-Audit in vier Zeilen
- Der Prompt-Audit ist ein Unterbefehl des Setup-Check-ups /doctor: Führen Sie /doctor prompt-audit (oder /checkup prompt-audit) in einer Claude-Code-Session aus.
- Er durchsucht Ihre CLAUDE.md-Dateien, Skills, Agenten und Befehle nach Prompting-Mustern, die für ältere Modelle geschrieben wurden, und stellt veraltete Pfade, veraltete Befehle und widersprüchliche Anweisungsdateien an den Anfang.
- Er kam mit Claude Code 2.1.283 — aktualisieren Sie also zuerst: Ein älterer Build antwortet auf /doctor mit einem Fehler für einen unbekannten Unterbefehl statt mit einem Bericht.
- Der Check-up berichtet zuerst und fragt nach, bevor er etwas ändert; wenn Sie nur einen Lese-Durchlauf wollen, führen Sie stattdessen claude doctor im Terminal aus.
Anthropic just dropped the new Checkup command (/doctor)
Kanal:Software Engineer Meets AI2:18
Claude Code 2.1.283 — Prompt Audits & Windows Fix
Kanal:Claude Code Updates1:02
Claude Code v2.1.283 — Advanced Model Control and Auditing
Kanal:Claude Code Changelog2:10
Claude Code changelog — 2.1.283 adds /doctor prompt-audit
Docs:github.com/anthropics/claude-codeChangelog
Claude Code commands reference — /doctor, /checkup and /claude-api
Docs:code.claude.comDocs
Die Standbilder stammen aus drei Aufnahmen. Software Engineer Meets AI hat einen kompletten /doctor-Check-up auf v2.1.205 aufgezeichnet; der Unterbefehl prompt-audit und sein Umfang wurden in v2.1.283 angekündigt und nutzen dieselbe Check-up-Oberfläche. Claude Code Updates und Claude Code Changelog lieferten die Bilder zum Release 2.1.283. Jedes Bild wurde von Hand geprüft; die beiden Folien wurden beschnitten, um die eingebrannten Wortmarken der Kanäle zu entfernen.
Die Screenshots bleiben Eigentum der oben genannten Kanäle und dienen dazu, unsere eigenen schriftlichen Anleitungen zu bebildern; jeder Schritt ist mit seinem Zeitstempel verlinkt.
Den Claude-Code-Prompt-Audit Schritt für Schritt ausführen
Bevor Sie ihn ausführen
- 1
Claude Code auf 2.1.283 oder neuer aktualisieren
Führen Sie /doctor prompt-audit nur auf einem Build aus, das ihn enthält. Prüfen Sie die Version im Terminal mit claude --version und aktualisieren Sie mit claude update, wenn sie älter als 2.1.283 ist — das Release, das den Audit eingeführt hat. Innerhalb einer Session meldet die Versionsprüfung von /doctor (Check 6) die installierte Version gegen Ihren Release-Kanal.
„Prompt Audit“ steht an erster Stelle im Release 2.1.283 — ein Build ohne ihn kann den Befehl nicht beantworten.Bei 0:08 ansehen - 2
Verstehen, warum alte Prompt-Muster geprüft werden müssen
Anweisungen, die für ein früheres Modell geschrieben wurden, sammeln sich in Memory-Dateien, Skills, Agenten und Befehlen an und prägen jede Session weiter, lange nachdem das Modell verschwunden ist, auf das sie abgestimmt waren. Der Audit macht diese veralteten Muster sichtbar, damit Sie genau wissen, was Sie umschreiben müssen, statt zu raten.
Die Karte zeigt, wie sich diese Anweisungen ansammeln: Memory-Dateien, Skills, Agenten und Befehle.Bei 0:12 ansehen - 3
Den genauen Befehl und seinen Scan-Umfang kennen
Der Befehl lautet /doctor prompt-audit, und /checkup prompt-audit ist dasselbe, weil /checkup ein Alias von /doctor ist. Sein Umfang ist Ihre Claude-Code-Konfiguration: CLAUDE.md-Dateien, Skills, Agenten und Befehle. Er ist ein Unterbefehl des Setup-Check-ups, kein separates Plugin und keine Installation aus einem Marketplace.
Die Release-Folie zeigt ein einzelnes Argument an einem bestehenden Befehl — es gibt nichts zu installieren.Bei 1:02 ansehen
Den Audit in einer laufenden Session ausführen
- 4
Claude Code im zu prüfenden Projekt öffnen
Starten Sie die Session im Projektstamm. Der Audit liest die Konfiguration, die dieses Projekt tatsächlich lädt — eine in einem übergeordneten Ordner geöffnete Session prüft die falschen CLAUDE.md-Dateien. Die Kopfzeile bestätigt Verzeichnis und Modell, bevor Sie etwas eintippen.
Das Arbeitsverzeichnis in der Session-Kopfzeile ist der Umfang des Audits.Bei 1:00 ansehen - 5
Den Befehl eingeben und ihn schreibgeschützt arbeiten lassen
Tippen Sie /doctor prompt-audit in die Eingabe. Der Check-up nennt seine Methode, bevor er startet: Er führt den Health-Check zuerst schreibgeschützt aus und legt einen Bericht vor, bevor er etwas ändert. Rechnen Sie mit mehreren Runden aus Datei-Lesevorgängen und Shell-Befehlen, während er Belege sammelt — das ist normal und kein Hänger.
Das Lese-Versprechen kommt vor jedem Vorschlag — während der Analyse wird nichts geschrieben.Bei 0:30 ansehen - 6
Zusehen, wie er für jeden Check Fakten sammelt
Das Transkript zeigt, welchem Check jeder Befehl zuarbeitet: die neueste Version für Check 6, Skill-Verzeichnisse und Hook-Konfiguration für die Erweiterungs-Checks, kleine CLAUDE.md-Dateien für Check 2 und 3 sowie aktuelle Session-Transkripte für Check 1, 4 und 8. Wenn ein Hook einen Befehl blockiert, formuliert der Check-up die benötigten Fakten neu und versucht es erneut, statt zu scheitern.
Jeder ausgeführte Befehl ist einem nummerierten Check zugeordnet.Bei 0:36 ansehen
Den Bericht lesen
- 7
Die neun Checks kennen, die der Bericht abdecken kann
Check 0 ist die Setup-Gesundheit, Check 1 ungenutzte Erweiterungen, Check 2 die Bereinigung doppelter LOCAL-Memory-Einträge, Check 3 das Migrieren immer geladener Inhalte, Check 4 langsame Hooks, Check 5 kontextlastige Erweiterungen, Check 6 die Version, Check 7 der Auto-Modus als Standard-Berechtigungsmodus und Check 8 häufig abgelehnte schreibgeschützte Befehle. Bei einem Prompt-Audit zählen die Checks der Anweisungsdateien am meisten: Check 2 findet persönliche Notizen, die die eingecheckten Vorgaben des Teams doppeln oder ihnen widersprechen, und Check 3 verschiebt selten benötigte Vorgaben aus dem immer aktiven Kontext.
Die Checks 2, 3 und 5 sind die, die CLAUDE.md und andere Anweisungsdateien berühren.Bei 1:16 ansehen - 8
Zuerst den Abschnitt „Proposed actions“ lesen
„Proposed actions“ ist der Teil des Berichts, der Dateien ändern würde, und jeder Eintrag nennt die bearbeitete Datei und ob die Änderung umkehrbar ist. Ein gesunder Check wird markiert und mit „No action“ geschlossen — so sehen Sie auf einen Blick, welcher der neun Checks etwas gefunden hat und welcher nichts.
Lesen Sie den Dateipfad in jedem Vorschlag, bevor Sie entscheiden — dort landet die Änderung.Bei 0:40 ansehen - 9
Die Warnungen und die zwei Bestätigungsfragen lesen
Unter den Vorschlägen steht ein Block „Warnings (no action)“ für das, was der Audit gemessen hat, aber nicht ändern wird — langsame Hooks und kontextlastige Erweiterungen, mit den gemessenen Zahlen, damit Sie selbst urteilen können. Der Bericht endet damit, dass er Ihnen seine Bestätigungsfragen stellt, statt eine Antwort anzunehmen.
Warnungen sind Messwerte, keine Änderungen: Sie tragen Zahlen, keine Vorschläge.Bei 0:56 ansehen
Freigeben und wiederholen
- 10
Freigeben, auswählen oder ablehnen, bevor etwas geschrieben wird
Der Check-up endet mit einem Menü: „Clean up everything“ (empfohlen), „Let me pick“, „No, keep everything“, „Type something“ und „Chat about this“. Die empfohlene Option wendet jeden Vorschlag an, „Let me pick“ geht die Liste Punkt für Punkt durch, und „No, keep everything“ lässt jede Datei unberührt. Aus dem Bericht allein wird nichts angewendet.
Der Standard ist eine Frage, keine Änderung — das ist das ganze Sicherheitsmodell.Bei 0:52 ansehen - 11
Den Audit in eine monatliche Erinnerung packen
Der Audit ist günstig genug, um ihn zu wiederholen, aber nichts in Claude Code führt ihn nach Zeitplan für Sie aus: /schedule legt eine Cloud-Aufgabe an und /loop läuft nur, solange die Session lebt. Die praktische Lösung ist ein wiederkehrender Kalendereintrag, der Sie an den nächsten Lauf erinnert — monatlich oder nach einem Modell-Upgrade, das Ihre alten Muster obsolet macht.
Eine monatliche Erinnerung ist der einzige Planer, der Neustarts übersteht.Bei 2:08 ansehen
Die fünf Fehler, die Ihnen wirklich begegnen
Die meisten Meldungen über einen kaputten Prompt-Audit sind einer dieser Fälle. Prüfen Sie sie der Reihe nach, bevor Sie annehmen, der Befehl fehle.
- 1Unbekannter Befehl oder kein prompt-audit-Eintrag — Ihr Build ist älter als 2.1.283. Führen Sie claude --version aus, aktualisieren Sie mit claude update und starten Sie dann eine neue Session, damit das neue Build geladen wird.
- 2/checkup prompt-audit oder /doctor prompt-audit — das ist derselbe Befehl. /checkup ist als Alias von /doctor dokumentiert, beide Präfixe erreichen also denselben Check-up-Skill.
- 3/claude-api prompt-audit ist ein anderer Unterbefehl mit einem anderen Ziel. Er prüft die Prompts, Skills und Werkzeugbeschreibungen in Ihrem eigenen Claude-API-Anwendungscode und schlägt Korrekturen als Diff vor; er braucht Claude Code 2.1.221 oder neuer, nicht 2.1.283, und schaut nicht in Ihre CLAUDE.md-Dateien.
- 4Der Audit meldet nichts zu Ihren Anweisungsdateien — entweder sind sie wirklich schlank, oder sie wurden nie geladen. Führen Sie /context aus, um zu sehen, welche Memory-Dateien und Skills tatsächlich im Kontext sind, und prüfen Sie, ob Sie die Session im Projektstamm gestartet haben.
- 5Sie wollen einen schreibgeschützten Durchlauf ganz ohne Session — führen Sie claude doctor im Terminal aus. Es gibt Installations- und Einstellungsdiagnosen aus, ohne eine Session zu starten, während das /doctor in der Session die Variante ist, die Korrekturen vorschlagen und anwenden kann.