Create tasks, docs, plans, and so much more with ClickUp MCP
KI & Automatisierung

Claude-Code-Prompts: 25 kopierfertige Prompts und wie Sie Ihre eigenen erstellen

Sie bitten Claude Code, einen Checkout-Fehler zu beheben. Es ändert die richtige Datei und meldet, dass die Tests bestanden wurden. Da die Tests jedoch den abgelaufenen Gutschein, der den Fehler verursacht hat, nie abgedeckt haben, wissen Sie immer noch nicht, ob die Korrektur funktioniert.

Eine nützliche Eingabeaufforderung liefert Claude Code genügend Informationen, um diese Lücke zu schließen: das von Ihnen erwartete Verhalten, die relevanten Dateien, etwaige Limite der Änderung und Nachweise, die Sie überprüfen können. Bei einer Fehlerbehebung könnte das bedeuten, den Fehler vor der Änderung des Codes zu reproduzieren. Bei einer Frage zur Codebasis könnte es bedeuten, die Dateien und Funktionen anzugeben, die der Antwort zugrunde liegen.

Die folgenden 25 Claude-Code-Prompts decken Planung, Fehlerbehebung, Code-Review, Migrationen und andere wiederholende Aufgaben ab. Jeder Prompt bietet Ihnen einen Ausgangspunkt, den Sie an Ihr Repository anpassen können, sowie Anleitungen dazu, welche Informationen Sie bereitstellen müssen und wie Sie das Ergebnis bewerten können.

TL;DR: Geben Sie Claude Code eine klar definierte Aufgabe, den relevanten Repository-Kontext und klare Grenzen dafür, was geändert werden darf. Legen Sie bei Codeänderungen Tests oder andere Prüfungen fest; fordern Sie bei Recherche und Planung zitierte Erkenntnisse oder einen überprüfbaren Plan an. Passen Sie die 25 Vorlagen an die Anforderungen und Berechtigungen Ihres Projekts an und überprüfen Sie anschließend die Nachweise, bevor Sie die Arbeit abnehmen.

Wodurch unterscheidet sich eine Claude-Code-Anweisung von einer Chat-Anweisung?

Eine Claude-Code-Anweisung kann Arbeiten in Ihrem Repository autorisieren, anstatt lediglich eine Erklärung anzufordern. Je nach den verfügbaren Tools und Berechtigungen kann Claude Dateien überprüfen, Befehle ausführen, Code bearbeiten und die Ergebnisse kontrollieren. Ihre Anweisungen müssen daher sowohl die Aufgabe als auch die Grenzen der Arbeit definieren.

Chat-Assistenten können ebenfalls Tools nutzen und Aktionen ausführen, daher lautet die Unterscheidung nicht: „Chat-Antworten, Claude Code handelt.“ Der praktische Unterschied liegt in der Umgebung und den Zugriffsrechten, die Sie dem Assistenten gewähren. Wenn Sie in einem Chat um einen Lösungsvorschlag bitten, müssen Sie diesen selbst anwenden; wenn Sie Claude Code bitten, diese Korrektur umzusetzen, können sich Ihre Arbeitsdateien ändern.

Das verändert die Folgen einer unklaren Anfrage. „Checkout reparieren“ lässt Entscheidungen über den Umfang, das erwartete Verhalten und akzeptable Änderungen offen. Claude könnte eine plausible Umsetzung erstellen, die Sie anschließend überprüfen oder rückgängig machen müssen. Eine sinnvollere Anfrage identifiziert den Fehlerfall, was unverändert bleiben muss und ob Claude untersuchen, planen oder bearbeiten soll.

AspektChatten zur Beratung oder zum Erstellen von Code-EntwürfenClaude Code im Einsatz in einem Repository
Was die Anforderung ermöglichtEine Erläuterung oder ein Code-Vorschlag, den Sie bewerten und anwenden könnenDateiüberprüfung, Befehle und Bearbeitungen mithilfe der verfügbaren Tools und Berechtigungen
Verfügbarer KontextDie Unterhaltung, die bereitgestellten Dateien und alle Verbindungen zu den zugehörigen QuellenRepository-Dateien, entsprechende Projektanleitungen und zugehörige tools
Folgen einer unklaren AnforderungEine ungeeignete Antwort oder ein ungeeigneter ImplementierungsvorschlagÄnderungen, die möglicherweise die Anforderungen verfehlen oder nicht betroffenen Code beeinflussen
So steuern Sie die ArbeitVerfeinern Sie die Fragestellung und entscheiden Sie, was Sie verwenden möchtenLegen Sie den Umfang fest, wählen Sie eine Berechtigung aus und überprüfen Sie Pläne und Änderungen
Nützliche Belege für die BeantragungQuellen, Annahmen oder eine Erläuterung des vorgeschlagenen CodesRelevante Dateiverweise, Diffs, tatsächliche Ergebnisse und ungelöste Probleme

Die Analyse von Anthropic zu 500.000 Interaktionen im Zusammenhang mit der Programmierung verdeutlicht diesen Unterschied in der Nutzung. Anhand von Daten aus dem April 2025 stufte sie 79 % der „Claude Code“-Unterhaltungen als Automatisierung ein, verglichen mit 49 % der „Claude.ai“-Unterhaltungen. Diese Zahlen beschreiben beobachtete Nutzungsmuster und stellen keine festen Limite für eines der beiden Produkte dar.

In derselben Studie wurden 35,8 % der Interaktionen mit Claude Code als Feedbackschleifen klassifiziert, bei denen Menschen die Arbeit validierten und weitere Eingaben lieferten, beispielsweise Fehlermeldungen. Wenn Sie Claude einen relevanten Testbefehl geben, kann dies dem System helfen, Fehler direkt zu untersuchen. Sie müssen dennoch prüfen, ob diese Überprüfungen das von Ihnen gewünschte Verhalten abdecken.

Bei Claude Code sollte eine Eingabeaufforderung den beabsichtigten Handlungsumfang klar machen: den Code erklären, eine Änderung vorschlagen oder diese innerhalb eines definierten Umfangs umsetzen. Konfigurieren Sie die Berechtigungen separat und überprüfen Sie anschließend die für diese Aufgabe relevanten Belege.

Profi-Tipp: Wenn Sie noch verschiedene Programmier-Tools vergleichen, lesen Sie die Artikel „Claude Code vs. Copilot “ und „Claude vs. ChatGPT für die Programmierung“. Für browserbasierte Eingabeaufforderungen nutzen Sie den Leitfaden zu Claude-KI-Eingabeaufforderungen. Wenn Sie zunächst eine Setup-Anleitung benötigen, beginnen Sie mit der Anleitung zur Verwendung von Claude Code.

Die Struktur einer guten Claude-Code-Eingabeaufforderung

Eine aussagekräftige Claude-Code-Anweisung erläutert das gewünschte Ergebnis, den zur Erzeugung erforderlichen Kontext und die Art und Weise, wie Sie die Arbeit bewerten werden. Eine Frage zu einer einzelnen Funktion erfordert möglicherweise nur einen Dateiverweis und eine gewünschte Erläuterung. Eine Änderung, die sich über mehrere Dateien erstreckt, erfordert einen klareren Umfang und klarere Vorgaben.

Fügen Sie diese sechs Details ein, wo sie zutreffen:

  • Was: Das erwartete Verhalten, z. B. die Anzeige einer Meldung über einen ungültigen Gutschein anstelle der Rückgabe eines Checkout-Fehers
  • Wo: Die Dateien, Ordner oder Dienste, die in den Geltungsbereich fallen und mit @ referenziert werden, sofern Sie diese kennen
  • Muster: Eine bestehende Implementierung, an die sich Claude halten sollte, z. B. der API-Client Ihres Projekts oder Konventionen zur Fehlerbehandlung
  • Überprüfung: Ein Test- oder Build-Befehl für Codeänderungen oder Dateiverweise und Commit-IDs für die Recherche
  • Limits: Was muss unangetastet bleiben, z. B. öffentliche APIs, Datenbankschemata oder nicht relevante Module
  • Vorgehensweise: Ob Claude etwas erklären, einen Plan zur Überprüfung vorschlagen oder die Änderung umsetzen soll

So tragen diese Details zur Verbesserung von drei häufigen Anforderungen bei.

Beheben Sie einen bestimmten Fehler

Anstelle von: „Behebe den Checkout-Fehler.“

Kunden, die einen abgelaufenen Gutschein verwenden, erhalten beim Bezahlvorgang einen 500-Fehler. Überprüfen Sie die Datei @src/checkout/coupons.ts und die dazugehörigen Tests. Das erwartete Verhalten ist eine Meldung über einen ungültigen Gutschein, ohne dass eine Bestellung erstellt wird. Schreiben Sie einen fehlgeschlagenen Test, der den Fehler reproduziert, und beheben Sie ihn anschließend, ohne das Verhalten bei gültigen Gutscheinen zu ändern. Führen Sie den Befehl [checkout test] aus und zeigen Sie die Ergebnisse vor und nach der Änderung. Wenn Sie den Fehler nicht reproduzieren können, berichten Sie, was Sie vor der Änderung der Implementierung überprüft haben.

Kunden, die einen abgelaufenen Gutschein verwenden, erhalten beim Bezahlvorgang einen 500-Fehler. Überprüfen Sie die Datei @src/checkout/coupons.ts und die dazugehörigen Tests. Das erwartete Verhalten ist eine Meldung über einen ungültigen Gutschein, ohne dass eine Bestellung erstellt wird. Schreiben Sie einen fehlgeschlagenen Test, der den Fehler reproduziert, und beheben Sie ihn anschließend, ohne das Verhalten bei gültigen Gutscheinen zu ändern. Führen Sie den Befehl [checkout test] aus und zeigen Sie die Ergebnisse vor und nach der Änderung. Wenn Sie den Fehler nicht reproduzieren können, berichten Sie, was Sie vor der Änderung der Implementierung überprüft haben.

Fügen Sie ein Feature mithilfe eines vorhandenen Musters hinzu

Statt: „Füge eine Datumsauswahl hinzu.“

Fügen Sie eine Datumsauswahl zu [Pfad zum Buchungsformular] hinzu. Halten Sie sich dabei an die Komponenten- und Validierungskonventionen in @src/components/TimeSelect.tsx. Benutzer müssen [zulässige Daten] auswählen können, während [nicht verfügbare Daten] deaktiviert bleiben. Fügen Sie keine Bibliotheken hinzu. Führen Sie den [Befehl zum Testen der Komponente] und den [Befehl zur Typprüfung] aus und melden Sie alle Kriterien, die diese Prüfungen nicht abdecken.

Fügen Sie eine Datumsauswahl zu [Pfad zum Buchungsformular] hinzu. Halten Sie sich dabei an die Komponenten- und Validierungskonventionen in @src/components/TimeSelect.tsx. Benutzer müssen [zulässige Daten] auswählen können, während [nicht verfügbare Daten] deaktiviert bleiben. Fügen Sie keine Bibliotheken hinzu. Führen Sie den [Befehl zum Testen der Komponente] und den [Befehl zur Typprüfung] aus und melden Sie alle Kriterien, die diese Prüfungen nicht abdecken.

Refactoring ohne Änderung des Verhaltens

Anstelle von: „Bereinige diese Datei.“

Teilen Sie die Datei @src/reports/export.py in kleinere Funktionen auf, wobei Sie die Eingaben, das Format der Ausgabe und das Fehlerverhalten beibehalten. Führen Sie vor der Bearbeitung den Befehl [export test] aus und melden Sie alle vorhandenen Fehler. Führen Sie nach der Umgestaltung die Tests erneut aus und zeigen Sie beide Ergebnisse an. Ändern Sie weder die öffentliche Schnittstelle noch nicht relevante Dateien.

Teilen Sie die Datei @src/reports/export.py in kleinere Funktionen auf, wobei Sie die Eingaben, das Format der Ausgabe und das Verhalten bei Fehlern beibehalten. Führen Sie vor der Bearbeitung den Befehl [export test] aus und melden Sie alle vorhandenen Fehler. Führen Sie nach der Umgestaltung die Tests erneut aus und zeigen Sie beide Ergebnisse an. Ändern Sie weder die öffentliche Schnittstelle noch nicht relevante Dateien.

Ersetzen Sie die Beispielpfade und -Befehle durch Werte aus Ihrem Repository. Bestehene Tests liefern Belege für die von ihnen abgedeckten Fälle; überprüfen Sie den Diff und vergewissern Sie sich, dass diese Fälle den Anforderungen entsprechen.

Diese Beispiele greifen den Ansatz der „Scoped Requests“ aus den Best Practices für Claude Code von Anthropic auf. Weitere Hinweise über das Programmieren hinaus finden Sie in diesen Best Practices für Prompts für KI-Agenten.

Warum die Überprüfung wichtiger ist als der Wortlaut

Selbst eine detaillierte Vorgabe kann immer noch Code erzeugen, der das falsche Problem löst. Sie können zwar die Dateien, den Programmierstil und die gewünschte Ausgabe festlegen, dabei jedoch die Bedingung außer Acht lassen, die bestimmt, ob die Änderung sinnvoll ist. Bei einem Fehler mit einem abgelaufenen Gutschein ist „die Kassentests bestehen“ ein unvollständiger Nachweis, es sei denn, diese Tests decken den fehlerhaften Gutschein ab und bestätigen, dass keine Reihenfolge erstellt wurde.

Die Formulierung hilft Claude, die Anfrage zu verstehen. Durch die Überprüfung können Sie beurteilen, ob die Umsetzung der Anfrage den Anforderungen entspricht. Diese Unterscheidung ist wichtig, wenn Claude Dateien bearbeiten und Befehle ausführen kann: Eine überzeugende Erklärung der Änderung ist kein Beweis dafür, dass das Verhalten korrekt ist.

Der Leitfaden zu Best Practices für Claude Code von Anthropic empfiehlt, Claude die Möglichkeit zu geben, seine Arbeit durch Tests, Screenshots oder erwartete Ausgaben zu überprüfen. Die Überprüfung sollte die jeweilige Anforderung widerspiegeln. Ein Build prüft, ob das Projekt kompiliert werden kann; ein gezielter Test überprüft ein bestimmtes Verhalten; ein Screenshot-Vergleich hilft bei der Beurteilung der gerenderten Benutzeroberfläche. Jede dieser Methoden beantwortet eine andere Frage.

Boris Cherny, der Ersteller von Claude Code, beschreibt die Verwendung einer browserbasierten Feedbackschleife in seinem eigenen Workflow:

„Claude testet jede einzelne Änderung, die ich mithilfe der Claude-Chrome-Erweiterung auf claude.ai/code einstelle. Dabei wird ein Browser geöffnet, die Benutzeroberfläche getestet und der Vorgang so lange wiederholt, bis der Code funktioniert und die Benutzererfahrung stimmt. “

„Claude testet jede einzelne Änderung, die ich mithilfe der Claude-Chrome-Erweiterung auf claude.ai/code einstelle. Dabei wird ein Browser geöffnet, die Benutzeroberfläche getestet und der Vorgang so lange wiederholt, bis der Code funktioniert und die Benutzererfahrung stimmt. “

In InfoQs Bericht über Chernys Workflow wird seine Ansicht wiedergegeben, dass die Überprüfung die Qualität des Ergebnisses um den Faktor zwei bis drei verbessern kann. Dabei handelt es sich um eine geschätzte Einschätzung seines Workflows, nicht um eine kontrollierte Messung oder eine garantierte Verbesserung.

Behalten Sie die Verantwortung für Anforderungen und Abnahmekriterien

Auch wenn Sie die Umsetzung delegieren, bleiben Sie weiterhin dafür verantwortlich, zu entscheiden, was die Software leisten soll. Claude kann Tests vorschlagen, doch diese Tests müssen Ihre Geschäftsregeln widerspiegeln, einschließlich Ausnahmen, die aus dem Code möglicherweise nicht ersichtlich sind.

In seiner Untersuchung von rund 400.000 Claude-Code-Sitzungen stellte Anthropic fest, dass die Nutzer etwa 70 % der Planungsentscheidungen, aber nur etwa 20 % der Ausführungsentscheidungen trafen. Die Studie stellte zudem einen Zusammenhang zwischen höherer offensichtlicher aufgabenspezifischer Fachkompetenz und höheren verifizierten Erfolgsraten fest: etwa 15 % bei Sitzungen, die eine Bewertung „Anfänger“ erhielten, im Vergleich zu 28 % bis 33 % bei Sitzungen der Stufen „Fortgeschritten“ oder „Experte“.

Diese Zahlen bedürfen eines Kontexts. Die Fachkompetenz wurde anhand von Transkripten bewertet, und ein „nachgewiesener Erfolg“ erforderte den Nachweis des Erfolgs innerhalb der Sitzung. Anthropic hat die tatsächlichen Ergebnisse der Benutzer nicht beobachtet. Sitzungen ohne dieses Signal waren nicht zwangsläufig Fehlschläge, und die Studie belegt nicht, dass allein eine Änderung des Wortlauts der Eingabeaufforderungen die Ergebnisse verbessert.

In der Praxis bedeutet dies, das Wissen beizusteuern, das Claude nicht sicher ableiten kann. Ein Buchhalter, der Rechnungen abstimmt, muss festlegen, wie Teilzahlungen, Rückerstattungen und Rundungen behandelt werden sollen. Ein Entwickler, der das Verhalten beim Bezahlvorgang ändert, muss identifizieren, welche bestehenden Verhaltensweisen unverändert bleiben müssen. Diese Entscheidungen bestimmen, ob das Ergebnis der Tests das Richtige überprüft.

Bevor Sie eine Änderung akzeptieren, überprüfen Sie gemeinsam die Anforderung, die Umsetzung und die Nachweise. Fragen Sie, welche Fälle getestet wurden, welche Prüfungen fehlgeschlagen sind oder übersprungen wurden und was noch unklar ist. Dies gibt Ihnen eine Grundlage für die Abnahme der Arbeit, die über Claudes Aussage hinausgeht, dass sie fertig ist.

25 Claude-Code-Eingabeaufforderungen, die Sie kopieren und anpassen können

Wählen Sie je nach der zu abschließenden Aufgabe eine Vorlage aus und ersetzen Sie dann die Angaben in Klammern durch die Pfade, Anforderungen und Befehle Ihrer Repositorys. Geben Sie bei Code-Änderungen einen Test- oder Build-Befehl an. Fordern Sie bei Recherche und Planung Quellenangaben und ein klar definiertes Ergebnis an.

Diese Vorlagen beschreiben die Arbeiten, die Claude zu erledigen hat. Konfigurieren Sie die Berechtigungen für Claude Code separat; eine Anweisung wie „Dateien nicht bearbeiten“ ist kein Ersatz für Zugriffskontrollen.

Anleitungen zum Verständnis einer Codebasis

Bevor Sie unbekannten Code ändern, sollten Sie herausfinden, wo das relevante Verhalten zu finden ist und wie es funktioniert. Diese Anleitungen konzentrieren sich darauf, Dateien und den Verlauf zu lesen, ohne eine Bearbeitung vorzunehmen.

1. Verschaffen Sie sich eine Übersicht über ein unbekanntes Repository

Nutzen Sie dies, wenn Sie einem Projekt beitreten oder zum ersten Mal in einem Repository arbeiten. Beginnen Sie mit der README-Datei, der Projektkonfiguration und der Verzeichnisstruktur, anstatt Claude zu bitten, jede Datei zu lesen.

Sehen Sie sich die README-Datei, die Projektkonfiguration und die Verzeichnisstruktur auf oberster Ebene dieses Repositorys an. Folgen Sie den Verweisen nur soweit nötig, um Folgendes zu erläutern: Was die Anwendung tut, ihre Haupteinstiegspunkte und wichtigsten Komponenten, wo sich die Tests befinden und welche Befehle das Repository zu deren Ausführung definiert. Geben Sie die Dateipfade an, die Ihre Erläuterungen unterstützen. Unterscheiden Sie zwischen dokumentiertem Verhalten und Ihren eigenen Schlussfolgerungen und kennzeichnen Sie alles, was Sie nicht feststellen können. Lesen Sie keine Geheimdaten oder Umgebungsdateien aus, überprüfen Sie keine installierten Abhängigkeiten und ändern Sie keine Dateien. Schließen Sie mit den drei Dateien, die ich als Erstes lesen sollte, und begründen Sie, warum.

Sehen Sie sich die README-Datei, die Projektkonfiguration und die Verzeichnisstruktur auf oberster Ebene dieses Repositorys an. Beziehen Sie sich nur bei Bedarf auf Referenzen, um Folgendes zu erläutern: Was die Anwendung tut, ihre Haupteinstiegspunkte und wichtigsten Komponenten, wo sich die Tests befinden und welche Befehle das Repository zu deren Ausführung definiert. Geben Sie die Dateipfade an, die Ihre Erläuterungen unterstützen. Unterscheiden Sie zwischen dokumentiertem Verhalten und Ihren eigenen Schlussfolgerungen und kennzeichnen Sie alles, was Sie nicht feststellen können. Lesen Sie keine Geheimdaten oder Umgebungsdateien aus, überprüfen Sie keine installierten Abhängigkeiten und ändern Sie keine Dateien. Schließen Sie mit den drei Dateien, die ich zuerst lesen sollte, und begründen Sie, warum.

2. Verstehen, warum sich eine Implementierung geändert hat

Nutzen Sie die Git-Historie, um eine Entwurfsentscheidung zu untersuchen, bevor Sie sie ersetzen. Fordern Sie dokumentierte Belege an, anstatt davon auszugehen, dass der aktuelle Code die Absicht des ursprünglichen Verfassers widerspiegelt.

Überprüfen Sie den Git-Verlauf von [Datei, Funktion oder Klasse] und konzentrieren Sie sich dabei auf [Verhalten oder Designfrage]. Identifizieren Sie die Commits, durch die dieses Verhalten eingeführt oder wesentlich verändert wurde. Geben Sie für jeden relevanten Commit dessen Hash an, fassen Sie die Änderung zusammen und erläutern Sie etwaige Begründungen, die in der Commit-Meldung oder einer verknüpften Diskussion dokumentiert sind, auf die Sie Zugriff haben. Kennzeichnen Sie abgeleitete Gründe als „Schlussfolgerungen“. Wenn der Verlauf eine Entscheidung nicht erklärt, weisen Sie darauf hin. Ändern Sie keine Dateien oder den Git-Verlauf.

Überprüfen Sie den Git-Verlauf von [Datei, Funktion oder Klasse] und konzentrieren Sie sich dabei auf [Verhalten oder Designfrage]. Identifizieren Sie die Commits, durch die dieses Verhalten eingeführt oder wesentlich verändert wurde. Geben Sie für jeden relevanten Commit dessen Hash an, fassen Sie die Änderung zusammen und erläutern Sie etwaige Begründungen, die in der Commit-Meldung oder einer verknüpften Diskussion dokumentiert sind, auf die Sie Zugriff haben. Kennzeichnen Sie abgeleitete Gründe als „Schlussfolgerungen“. Wenn der Verlauf eine Entscheidung nicht erklärt, weisen Sie darauf hin. Ändern Sie keine Dateien oder den Git-Verlauf.

3. Verfolgen Sie einen bestimmten Flow

Wenden Sie dies an, bevor Sie sich mit Funktionen befassen, die mehrere Komponenten betreffen, wie beispielsweise Authentifizierung, Checkout oder Benachrichtigungen.

Verfolgen Sie, was bei [Benutzeraktion oder Systemereignis] geschieht, beginnend bei [bekannter Route, Handler oder Ordner]. Verfolgen Sie die relevanten Aufrufe durch die Validierung, die Geschäftslogik sowie etwaige Datenbank-Schreibvorgänge oder externe Anfragen. Listen Sie die Dateien und Funktionen in der Ausführungsreihenfolge auf, gegebenenfalls mit Zeilenverweisen. Erläutern Sie die wichtigsten Fehlerpfade und identifizieren Sie vorhandene Tests, die den Flow abdecken. Markieren Sie alle Verbindungen, die Sie anhand des Codes nicht bestätigen können. Führen Sie den Flow nicht aus, rufen Sie keine externen Dienste auf und führen Sie keine Bearbeitung der Dateien durch.

Verfolgen Sie, was bei [Benutzeraktion oder Systemereignis] geschieht, beginnend bei [bekannter Route, Handler oder Ordner]. Verfolgen Sie die relevanten Aufrufe durch die Validierung, die Geschäftslogik sowie etwaige Datenbank-Schreibvorgänge oder externe Anfragen. Listen Sie die Dateien und Funktionen in der Ausführungsreihenfolge auf, gegebenenfalls mit Zeilenverweisen. Erläutern Sie die wichtigsten Fehlerpfade und identifizieren Sie vorhandene Tests, die den Flow abdecken. Markieren Sie alle Verbindungen, die Sie anhand des Codes nicht bestätigen können. Führen Sie den Flow nicht aus, rufen Sie keine externen Dienste auf und führen Sie keine Bearbeitung der Dateien durch.

Anleitungen für den Plan vor der Entwicklung

Bei Änderungen, die sich über mehrere Dateien erstrecken oder wichtige Anforderungen offen lassen, sollten Sie vor der Umsetzung einen Plan prüfen. Diese Leitfragen helfen Ihnen dabei, die Arbeit zu definieren, Entscheidungen zu klären und den betroffenen Code zu identifizieren.

4. Planen Sie ein Feature, bevor Sie den Code ändern

Verwenden Sie dies, wenn Sie das gewünschte Verhalten kennen, aber die Umsetzung verstehen müssen. Beginnen Sie im Plan-Modus, damit Claude das Repository überprüfen kann, bevor es Änderungen vorschlägt.

Planen Sie, wie [Feature] im [Repository-Bereich] implementiert werden soll. Das erwartete Verhalten ist [Anforderungen], und diese Bereiche müssen unverändert bleiben: [Einschränkungen]. Prüfen Sie den relevanten Code und die vorhandenen Tests. Identifizieren Sie die Dateien, die geändert werden müssen, die Reihenfolge der Implementierung sowie etwaige Kompatibilitäts- oder Datenmigrationsrisiken. Ordnen Sie jede Anforderung einem vorgeschlagenen Test oder einem anderen Schritt der Überprüfung zu. Führen Sie eine Liste mit offenen Fragen und Annahmen auf. Implementieren Sie das Feature noch nicht. Legen Sie den Plan mir zur Überprüfung vor.

Planen Sie, wie [Feature] im [Repository-Bereich] implementiert werden soll. Das erwartete Verhalten ist [Anforderungen], und diese Bereiche müssen unverändert bleiben: [Einschränkungen]. Prüfen Sie den relevanten Code und die vorhandenen Tests. Identifizieren Sie die Dateien, die geändert werden müssen, die Reihenfolge der Implementierung sowie etwaige Kompatibilitäts- oder Datenmigrationsrisiken. Ordnen Sie jede Anforderung einem vorgeschlagenen Test oder einem anderen Schritt der Überprüfung zu. Führen Sie eine Liste mit offenen Fragen und Annahmen auf. Implementieren Sie das Feature noch nicht. Legen Sie den Plan mir zur Überprüfung vor.

5. Klären Sie die Anforderungen, bevor Sie eine Spezifikation verfassen

Verwenden Sie dies, wenn die Anforderung für ein Feature Entscheidungen über Benutzerverhalten, Daten oder Randfälle offen lässt. Das Ergebnis der Spezifikation sollte einer späteren Implementierungssitzung genügend Kontext liefern, um fortfahren zu können.

Ich möchte [kurze Beschreibung] für [Benutzer und Anwendungsfall] erstellen. Lies zunächst [relevante Dateien oder Anforderungen] und nutze dann „AskUserQuestion“, um Entscheidungen zu klären, die wesentliche Auswirkungen auf die Umsetzung haben würden. Konzentriere dich auf Randfälle, den Umgang mit Daten, Berechtigungen, das erwartete Verhalten der Benutzeroberfläche und Abwägungen. Stelle keine Fragen, die der bereitgestellte Kontext bereits beantwortet. Sobald die Schlüsselentscheidungen getroffen sind, erstelle einen Spezifikationsentwurf, der Anforderungen, Abnahmekriterien, Einschränkungen und den Umfang der Arbeit abdeckt. Markiere alle verbleibenden Annahmen. Zeige mir die Spezifikation, bevor du sie unter [Spezifikationspfad] speicherst, und überschreibe keine vorhandene Datei ohne Genehmigung.

Ich möchte [kurze Beschreibung] für [Benutzer und Anwendungsfall] erstellen. Lies zunächst [relevante Dateien oder Anforderungen] und nutze dann „AskUserQuestion“, um Entscheidungen zu klären, die wesentliche Auswirkungen auf die Umsetzung haben würden. Konzentriere dich auf Randfälle, Datenverarbeitung, Berechtigungen, erwartetes UI-Verhalten und Kompromisse. Stelle keine Fragen, die der bereitgestellte Kontext bereits beantwortet. Sobald die Schlüsselentscheidungen getroffen sind, erstelle einen Spezifikationsentwurf, der Anforderungen, Abnahmekriterien, Einschränkungen und den Umfang der Arbeit abdeckt. Markiere alle verbleibenden Annahmen. Zeige mir die Spezifikation, bevor du sie unter [Spezifikationspfad] speicherst, und überschreibe keine vorhandene Datei ohne Genehmigung.

Nachdem Sie die Spezifikation überprüft und gespeichert haben, verweisen Sie in der Implementierungssitzung darauf. Geben Sie die entsprechenden Pfade zu den Repositorys an, damit Claude die Spezifikation mit dem vorhandenen Code abgleichen kann.

6. Ermitteln Sie, welche Auswirkungen eine Änderung am gemeinsam genutzten Code haben könnte

Wenden Sie dies an, bevor Sie eine gemeinsam genutzte Funktion, Komponente oder Schnittstelle ändern. Eine Auflistung der Aufrufer hilft Ihnen bei der Einschätzung des Umfangs, deckt jedoch möglicherweise keine Nutzer außerhalb des Repositorys auf.

Bewerten Sie die Auswirkungen einer Änderung von [Funktion, Komponente oder Schnittstelle] vom [aktuellen Verhalten] zum [vorgeschlagenen Verhalten]. Durchsuchen Sie [Repositorys oder Verzeichnisbereiche] nach deren Definition, direkten Aufrufern, Importen und zugehörigen Tests. Erstellen Sie eine Liste der Dateien, die wahrscheinlich geändert werden müssen, und erläutern Sie, wie jede davon betroffen sein könnte, gegebenenfalls mit Datei- und Zeilenverweisen. Markieren Sie dynamisch aufgelöste Aufrufe, externe Verbraucher oder andere Abhängigkeiten, die Sie nicht überprüfen können. Identifizieren Sie alle Kompatibilitätsfragen, die vor der Implementierung geklärt werden müssen. Nehmen Sie keine Änderungen an Dateien vor; reichen Sie die Auswirkungsanalyse ein und warten Sie auf meine Überprüfung.

Bewerten Sie die Auswirkungen einer Änderung von [Funktion, Komponente oder Schnittstelle] vom [aktuellen Verhalten] zum [vorgeschlagenen Verhalten]. Durchsuchen Sie [Repository oder Verzeichnisbereich] nach deren Definition, direkten Aufrufern, Importen und zugehörigen Tests. Erstellen Sie eine Liste der Dateien, die wahrscheinlich geändert werden müssen, und erläutern Sie, wie jede davon betroffen sein könnte, gegebenenfalls mit Datei- und Zeilenverweisen. Markieren Sie dynamisch aufgelöste Aufrufe, externe Verbraucher oder andere Abhängigkeiten, die Sie nicht überprüfen können. Identifizieren Sie alle Kompatibilitätsfragen, die vor der Implementierung geklärt werden müssen. Nehmen Sie keine Änderungen an Dateien vor; reichen Sie die Auswirkungsanalyse ein und warten Sie auf meine Überprüfung.

Anleitungen zum Erstellen von Features

Anweisungen zur Funktionsentwicklung sollten das erwartete Verhalten beschreiben und eine Verbindung zum bereits in Ihrem Projekt vorhandenen Code herstellen. Fügen Sie relevante Beispiele, Einschränkungen und Prüfungen hinzu, damit Claude die Änderung umsetzen kann, ohne dabei irrelevante Entscheidungen zu treffen.

7. Erstellen Sie ein Feature unter Verwendung eines bestehenden Musters

Verwenden Sie diese Option, wenn in Ihrem Repository bereits ein ähnliches Feature vorhanden ist. Weisen Sie Claude auf die Implementierung hin, an die es sich halten soll, einschließlich Datenzugriff, Fehlerbehandlung und Tests.

Füge [Feature] zu [Datei oder Seite] mit folgendem Verhalten hinzu: [Akzeptanzkriterien]. Überprüfe die [bestehende Implementierung] und halte dich an deren Konventionen für das Abrufen von Daten, die Fehlerbehandlung und die Organisation von Komponenten. Verwende ausschließlich Bibliotheken, die bereits im Projekt installiert sind. Halten Sie Änderungen innerhalb des [Umfangs] und bewahren Sie das [bestehende Verhalten oder die öffentliche Schnittstelle] bei. Fügen Sie Tests für die Akzeptanzkriterien hinzu oder aktualisieren Sie diese. Führen Sie den [Testbefehl] und den [Typüberprüfungs- oder Lint-Befehl] aus und melden Sie anschließend die geänderten Dateien, die Ergebnisse sowie alle Prüfungen, die Sie nicht abschließen konnten. Falls das bestehende Muster im Widerspruch zu einer Anforderung steht, erläutern Sie den Konflikt, bevor Sie fortfahren.

Füge [Feature] zu [Datei oder Seite] mit folgendem Verhalten hinzu: [Akzeptanzkriterien]. Überprüfe die [bestehende Implementierung] und halte dich an deren Konventionen für das Abrufen von Daten, die Fehlerbehandlung und die Organisation von Komponenten. Verwende ausschließlich Bibliotheken, die bereits im Projekt installiert sind. Halten Sie Änderungen innerhalb des [Umfangs] und bewahren Sie das [bestehende Verhalten oder die öffentliche Schnittstelle] bei. Fügen Sie Tests für die Akzeptanzkriterien hinzu oder aktualisieren Sie diese. Führen Sie den [Testbefehl] und den [Typüberprüfungs- oder Lint-Befehl] aus und melden Sie anschließend die geänderten Dateien, die Ergebnisse sowie alle Prüfungen, die Sie nicht abschließen konnten. Falls das bestehende Muster im Widerspruch zu einer Anforderung steht, erläutern Sie den Konflikt, bevor Sie fortfahren.

8. Schreiben Sie Tests, bevor Sie eine Funktion implementieren

Verwenden Sie dies für Verhaltensweisen, die Sie durch definierte Ein- und Ausgänge ausdrücken können. Ein anfänglicher Testfehler sollte ein fehlendes Verhalten aufzeigen und nicht auf ein fehlerhaftes Setup hindeuten.

Implementieren Sie [Funktionsname] in [Datei], um [Anforderungen] zu erfüllen. Berücksichtigen Sie dabei den [Normalfall], den [Randfall] und das [Verhalten bei ungültiger Eingabe]. Führen Sie zunächst den [entsprechenden Testbefehl] aus und melden Sie etwaige Fehler. Schreiben Sie Tests für das gewünschte Verhalten und führen Sie diese vor der Implementierung aus. Vergewissern Sie sich, dass die neuen Tests aus dem erwarteten Grund fehlschlagen. Implementieren Sie die Funktion und führen Sie die Tests erneut aus. Schwächen Sie keine Assertions ab, überspringen Sie keine Tests und ändern Sie nicht das erwartete Verhalten, nur damit die Tests bestehen. Wenn die Anforderungen im Widerspruch zu bestehenden Tests stehen, halten Sie inne und erläutern Sie den Konflikt. Zeigen Sie die Ergebnisse vor und nach der Änderung auf.

Implementieren Sie [Funktionsname] in [Datei], um [Anforderungen] zu erfüllen. Berücksichtigen Sie dabei den [Normalfall], den [Randfall] und das [Verhalten bei ungültiger Eingabe]. Führen Sie zunächst den [entsprechenden Testbefehl] aus und melden Sie etwaige Fehler. Schreiben Sie Tests für das gewünschte Verhalten und führen Sie diese vor der Implementierung aus. Vergewissern Sie sich, dass die neuen Tests aus dem erwarteten Grund fehlschlagen. Implementieren Sie die Funktion und führen Sie die Tests erneut aus. Schwächen Sie keine Assertions ab, überspringen Sie keine Tests und ändern Sie nicht das erwartete Verhalten, nur damit die Tests bestehen. Wenn die Anforderungen im Widerspruch zu bestehenden Tests stehen, halten Sie inne und erläutern Sie den Konflikt. Zeigen Sie die Ergebnisse vor und nach der Änderung auf.

9. Implementieren Sie eine Benutzeroberfläche anhand eines Referenzbildes

Verwenden Sie diese Funktion, wenn Sie einen Screenshot des Designs und eine funktionierende Methode zur Erfassung der Implementierung haben. Geben Sie die Route, den Viewport und den UI-Zustand an, damit Claude entsprechende Bildschirme vergleichen kann.

Implementieren Sie den Anhang in [Komponente oder Seite] unter Verwendung der vorhandenen Komponenten und Stile des Projekts. Behalten Sie [erforderliches Verhalten] bei und vermeiden Sie Änderungen außerhalb des [Umfangs]. Verwenden Sie [konfigurierten Browser oder Screenshot-Tool], um [lokale Route] bei [Viewport-Abmessungen] mit [Testdaten und UI-Zustand] zu erfassen. Falls das Tool oder die Anwendung nicht verfügbar ist, berichten Sie, was benötigt wird, anstatt eine visuelle Überprüfung zu behaupten. Vergleichen Sie die Aufnahme mit der Referenz und konzentrieren Sie sich dabei auf [Layout, Abstände, Typografie oder andere Abnahmekriterien]. Führen Sie bis zu [Anzahl] Korrekturdurchläufe durch und melden Sie anschließend die verbleibenden Unterschiede. Ändern Sie das Referenzbild nicht. Führen Sie [relevante Komponententests] sowie den [Typ-Check oder Build-Befehl] aus. Fügen Sie den aufgenommenen Screenshot und das tatsächliche Prüfergebnis Ihrer Zusammenfassung bei.

Implementieren Sie den Anhang in [Komponente oder Seite] unter Verwendung der vorhandenen Komponenten und Stile des Projekts. Behalten Sie [erforderliches Verhalten] bei und vermeiden Sie Änderungen außerhalb des [Umfangs]. Verwenden Sie [konfigurierten Browser oder Screenshot-Tool], um [lokale Route] bei [Viewport-Abmessungen] mit [Testdaten und UI-Zustand] zu erfassen. Falls das Tool oder die Anwendung nicht verfügbar ist, berichten Sie, was benötigt wird, anstatt eine visuelle Überprüfung zu behaupten. Vergleichen Sie die Aufnahme mit der Referenz und konzentrieren Sie sich dabei auf [Layout, Abstände, Typografie oder andere Abnahmekriterien]. Führen Sie bis zu [Anzahl] Korrekturdurchläufe durch und melden Sie anschließend die verbleibenden Unterschiede. Ändern Sie das Referenzbild nicht. Führen Sie [relevante Komponententests] sowie den [Typ-Check oder Build-Befehl] aus. Fügen Sie den aufgenommenen Screenshot und das tatsächliche Prüfergebnis Ihrer Zusammenfassung bei.

Anleitungen zum Debuggen und Beheben von Fehlern

Geben Sie Claude den beobachteten Fehler, das erwartete Verhalten und die Ihnen bereits vorliegenden Belege an. Ein reproduzierbares Beispiel hilft dabei, eine Lösung für das gemeldete Problem von einer Änderung zu unterscheiden, die lediglich die Fehlermeldung beseitigt.

10. Reproduzieren Sie einen Fehler, bevor Sie ihn beheben

Verwenden Sie diese Vorlage, wenn Sie beschreiben können, was den Auslöser für den Fehler darstellt. Fügen Sie relevante Protokolle oder Beispiel-Eingaben bei, wobei Anmeldedaten und sensible Informationen entfernt werden sollten.

Benutzer stoßen auf [Symptom], wenn [Auslöser oder Eingabe]. Das erwartete Verhalten ist [erwartetes Ergebnis]. Beginnen Sie mit der Überprüfung von [Ordner, Funktion oder Flow] und den zugehörigen Tests. Erstellen Sie einen fehlgeschlagenen Test, der das gemeldete Verhalten reproduziert. Wenn Sie es nicht reproduzieren können, erläutern Sie, was Sie überprüft haben und welche Informationen fehlen, bevor Sie die Implementierung ändern. Sobald das Verhalten reproduziert wurde, beheben Sie die Ursache, ohne [Verhalten, das unverändert bleiben muss] zu ändern. Führen Sie den neuen Test und [den zugehörigen Befehl] aus. Zeigen Sie den Fehler vor der Behebung, die Ergebnisse danach sowie etwaige verbleibende Fehler an.

Benutzer stoßen auf [Symptom], wenn [Auslöser oder Eingabe]. Das erwartete Verhalten ist [erwartetes Ergebnis]. Beginnen Sie mit der Überprüfung von [Ordner, Funktion oder Flow] und den zugehörigen Tests. Erstellen Sie einen fehlgeschlagenen Test, der das gemeldete Verhalten reproduziert. Wenn Sie es nicht reproduzieren können, erläutern Sie, was Sie überprüft haben und welche Informationen fehlen, bevor Sie die Implementierung ändern. Sobald das Verhalten reproduziert wurde, beheben Sie die Ursache, ohne [Verhalten, das unverändert bleiben muss] zu ändern. Führen Sie den neuen Test und [den zugehörigen Testbefehl] aus. Zeigen Sie den Fehler vor der Behebung, das Ergebnis danach sowie etwaige verbleibende Fehler an.

11. Diagnostizieren Sie einen fehlgeschlagenen Build, ohne Prüfungen zu umgehen

Verwenden Sie diese, wenn ein Build lokal oder in CI fehlschlägt. Geben Sie den genauen Befehl und die relevante Fehlerausgabe an, damit Claude denselben Fehler untersuchen kann.

Der [Build-Befehl] schlägt in der [lokalen oder CI-Umgebung] mit folgender Ausgabe fehl: [bereinigtes Fehlerprotokoll]. Überprüfen Sie den entsprechenden Code und die Konfiguration, um die Ursache zu ermitteln. Prüfen Sie auf Unterschiede in der Umgebung oder bei den Abhängigkeiten, falls sich der Fehler lokal nicht reproduzieren lässt. Nehmen Sie die kleinste Änderung vor, die die Ursache behebt. Deaktivieren Sie keine Prüfungen, unterdrücken Sie keine Fehler, überspringen Sie keine Tests und lockern Sie keine Compiler-Einstellungen, nur um einen erfolgreichen Build zu erhalten. Führen Sie den Build nach der Änderung erneut aus. Wenn er nach [Anzahl] Korrekturversuchen immer noch fehlschlägt, halten Sie inne und melden Sie, was Sie versucht haben, den aktuellen Fehler und den nächsten Diagnoseschritt. Fassen Sie die Ursache zusammen und fügen Sie das tatsächliche Ergebnis des Builds bei.

Der [Build-Befehl] schlägt in der [lokalen oder CI-Umgebung] mit folgender Ausgabe fehl: [bereinigtes Fehlerprotokoll]. Überprüfen Sie den entsprechenden Code und die Konfiguration, um die Ursache zu ermitteln. Prüfen Sie auf Unterschiede in der Umgebung oder bei den Abhängigkeiten, falls sich der Fehler lokal nicht reproduzieren lässt. Nehmen Sie die kleinste Änderung vor, die die Ursache behebt. Deaktivieren Sie keine Prüfungen, unterdrücken Sie keine Fehler, überspringen Sie keine Tests und lockern Sie keine Compiler-Einstellungen, nur um einen erfolgreichen Build zu erzielen. Führen Sie den Build nach der Änderung erneut aus. Wenn er nach [Nummer] Korrekturversuchen immer noch fehlschlägt, halten Sie inne und melden Sie, was Sie versucht haben, den aktuellen Fehler und den nächsten Diagnoseschritt. Fassen Sie die Ursache zusammen und fügen Sie das tatsächliche Ergebnis des Builds bei.

12. Einen Fehler durch Fragen eingrenzen

Verwenden Sie diese Methode, wenn die Symptome unklar sind oder mehrere Erklärungen plausibel erscheinen. Die Beantwortung gezielter Fragen kann dabei helfen, einen Reproduktionsfall zu ermitteln, bevor jemand die Bearbeitung des Codes durchführt. Eine ausführlichere Anleitung finden Sie unter „Fehlerbehebung mit Claude“.

Hilf mir, einen Fehler einzugrenzen, bevor du eine Lösung vorschlägst. Beobachtetes Verhalten: [was passiert] Erwartetes Verhalten: [was passieren sollte] Wann es auftritt: [Bedingungen oder Häufigkeit] Was ich bereits versucht habe: [Schritte und Ergebnisse] Stelle jeweils nur eine Frage und wähle dabei die Frage aus, mit der sich die wahrscheinlichen Ursachen am besten unterscheiden lassen. Wiederhole keine Fragen, die durch die bereitgestellten Informationen bereits beantwortet sind. Sobald genügend Anhaltspunkte vorliegen, fasse die wahrscheinlichste Erklärung zusammen, was noch unklar ist und welchen kleinsten Test man durchführen könnte, um diese zu bestätigen oder auszuschließen. Führe noch keine Bearbeitung der Dateien durch.

Hilf mir, einen Fehler einzugrenzen, bevor du eine Lösung vorschlägst. Beobachtetes Verhalten: [was passiert] Erwartetes Verhalten: [was passieren sollte] Wann es auftritt: [Bedingungen oder Häufigkeit] Was ich bereits versucht habe: [Schritte und Ergebnisse] Stelle jeweils nur eine Frage und wähle dabei die Frage aus, mit der sich die wahrscheinlichen Ursachen am besten unterscheiden lassen. Wiederhole keine Fragen, die durch die bereitgestellten Informationen bereits beantwortet sind. Sobald genügend Anhaltspunkte vorliegen, fasse die wahrscheinlichste Erklärung zusammen, was noch unklar ist und welchen kleinsten Test man durchführen könnte, um diese zu bestätigen oder auszuschließen. Führe noch keine Bearbeitung der Dateien durch.

Anleitungen zur Überprüfung und Überprüfung

Überprüfen Sie die Umsetzung anhand der Anforderungen, anstatt Claude zu bitten, Probleme ohne definierten Umfang zu finden. Fordern Sie Belege für jeden Befund an und unterscheiden Sie bestätigte Fehler von Fragen, die einer weiteren Untersuchung bedürfen.

13. Überprüfen Sie eine Änderung anhand des genehmigten Plans

Verwenden Sie dies nach der Implementierung, um zu überprüfen, ob der Diff die vereinbarten Anforderungen erfüllt. Legen Sie den zu vergleichenden Bereich oder die zu überprüfenden Dateien fest, damit nicht relevante Arbeiten aus der Bewertung herausgehalten werden.

Verwenden Sie einen Unteragenten, um [Diff oder Bereich im Vergleich zur Basis] anhand des [genehmigten Plans oder der Anforderungsdatei] zu überprüfen. Falls Anforderungen fehlen oder mehrdeutig sind, melden Sie dies, bevor Sie die Vollständigkeit bewerten. Prüfen Sie, ob jede Anforderung implementiert ist, relevante Randfälle getestet wurden und ob Änderungen außerhalb des vereinbarten Umfangs liegen. Untersuchen Sie bei Bedarf den umgebenden Code, um den Diff zu verstehen. Melden Sie Korrektheitsprobleme und nicht erfüllte Anforderungen mit Datei- und Zeilenverweisen, deren Auswirkungen und den Belegen, die jeden Befund unterstützen. Trennen Sie bestätigte Probleme von ungelösten Fragen. Erfinden Sie keine Befunde, um eine Quote zu erfüllen, und fügen Sie keine irrelevanten Stilvorlieben hinzu. Führen Sie keine Bearbeitung der Dateien durch.

Verwenden Sie einen Unteragenten, um [Diff oder Bereich im Vergleich zur Basis] anhand des [genehmigten Plans oder der Anforderungsdatei] zu überprüfen. Falls Anforderungen fehlen oder mehrdeutig sind, melden Sie dies, bevor Sie die Vollständigkeit bewerten. Prüfen Sie, ob jede Anforderung implementiert ist, relevante Randfälle getestet wurden und ob Änderungen außerhalb des vereinbarten Umfangs liegen. Untersuchen Sie bei Bedarf den umgebenden Code, um den Diff zu verstehen. Melden Sie Korrektheitsprobleme und nicht erfüllte Anforderungen mit Datei- und Zeilenverweisen, deren Auswirkungen und den Belegen für jeden Befund. Trennen Sie bestätigte Probleme von ungelösten Fragen. Erfinden Sie keine Befunde, um eine Quote zu erfüllen, und fügen Sie keine irrelevanten Stilvorlieben hinzu. Führen Sie keine Bearbeitungen durch.

14. Eine Änderung auf bestimmte Risiken der Sicherheit prüfen

Nutzen Sie dies für eine gezielte Überprüfung sicherheitsrelevanter Codeabschnitte, wie beispielsweise Authentifizierung, Anfragebearbeitung oder Datenbankzugriff. Dies kann eine allgemeine Codeüberprüfung ergänzen, stellt jedoch nicht sicher, dass die Anwendung sicher ist.

Überprüfen Sie [Dateien oder Diff-Dateien] auf Injektionsrisiken, fehlende Autorisierungsprüfungen, offengelegte Geheimnisse und unsicheren Umgang mit Benutzereingaben. Überprüfen Sie die relevanten Aufrufer und die Validierungslogik, bevor Sie einen Bericht über ein Problem erstellen. Identifizieren Sie für jedes Problem die betroffene Datei und die betroffenen Zeilen, die Auslöser, die wahrscheinlichen Auswirkungen sowie einen Lösungsvorschlag. Unterscheiden Sie einen bestätigten anfälligen Pfad von einem Verdachtsfall, der weiterer Tests bedarf. Geben Sie geheime Werte im Bericht nicht wieder, ändern Sie keine Dateien und führen Sie keine Tests an Live-Diensten durch. Geben Sie an, welche Bereiche Sie überprüft haben und was außerhalb des Untersuchungsumfangs liegt.

Überprüfen Sie [Dateien oder Diff-Dateien] auf Injektionsrisiken, fehlende Autorisierungsprüfungen, offengelegte Geheimnisse und unsicheren Umgang mit Benutzereingaben. Überprüfen Sie die relevanten Aufrufer und die Validierungslogik, bevor Sie einen Bericht über das Problem erstellen. Identifizieren Sie für jedes Problem die betroffene Datei und die betroffenen Zeilen, die Auslöser, die wahrscheinlichen Auswirkungen sowie einen Lösungsvorschlag. Unterscheiden Sie einen bestätigten anfälligen Pfad von einem Verdachtsfall, der weiterer Tests bedarf. Geben Sie geheime Werte im Bericht nicht wieder, ändern Sie keine Dateien und führen Sie keine Tests an Live-Diensten durch. Geben Sie an, welche Bereiche Sie überprüft haben und was außerhalb des Untersuchungsumfangs liegt.

15. Fordern Sie eine Zusammenfassung der Überprüfung an, bevor Sie eine Änderung akzeptieren

Verwenden Sie dies nach einer Code-Aufgabe, um zu sehen, was tatsächlich überprüft wurde. So lässt sich ein erfolgreicher Testlauf von einer nicht unterstützten „Erledigt“-Meldung unterscheiden.

Fassen Sie zusammen, wie Sie die fertiggestellte Änderung anhand der [Abnahmekriterien] überprüft haben. Führen Sie für jedes Kriterium die durchgeführte Prüfung, gegebenenfalls den genauen Befehl und das beobachtete Ergebnis auf. Fügen Sie relevante Ausgaben bei, wobei Geheimnisse und sensible Daten unkenntlich gemacht werden müssen. Weisen Sie bereits bestehende Fehler separat aus. Unterscheiden Sie klar zwischen Prüfungen, die bestanden wurden, solchen, die fehlgeschlagen sind, und solchen, die nicht ausgeführt wurden. Erläutern Sie alle übersprungenen Prüfungen oder Limite im Abdeckungsgrad. Beschreiben Sie die gesamte Änderung nicht als verifiziert, wenn einige Kriterien noch nicht überprüft wurden.

Fassen Sie zusammen, wie Sie die fertiggestellte Änderung anhand der [Abnahmekriterien] überprüft haben. Führen Sie für jedes Kriterium die durchgeführte Prüfung, gegebenenfalls den genauen Befehl und das beobachtete Ergebnis auf. Fügen Sie relevante Ausgaben bei, wobei Geheimnisse und sensible Daten unkenntlich gemacht werden müssen. Weisen Sie bereits zuvor bestehende Fehler separat aus. Unterscheiden Sie klar zwischen Prüfungen, die bestanden wurden, solchen, die fehlgeschlagen sind, und solchen, die nicht ausgeführt wurden. Erläutern Sie alle übersprungenen Prüfungen oder Limite in der Abdeckung. Beschreiben Sie die gesamte Änderung nicht als verifiziert, wenn einige Kriterien noch nicht überprüft wurden.

Anleitungen für Refactoring und Migrationen

Bei der Refaktorisierung sollte das bestehende Verhalten beibehalten werden, während bei Migrationen die Unterschiede zwischen der alten und der neuen Implementierung berücksichtigt werden sollten. Beginnen Sie mit einem begrenzten Umfang und legen Sie fest, welche Prüfungen unbeabsichtigte Änderungen aufdecken werden.

16. Refactoring ohne Änderung des Verhaltens

Verwenden Sie dies, wenn die Implementierung umstrukturiert werden muss, ihre Ein- und Ausgänge sowie ihre öffentliche Schnittstelle jedoch unverändert bleiben sollen.

Refactorn Sie [Datei oder Modul] mit dem Ziel [spezifisches Ziel, z. B. das Aufteilen einer großen Funktion oder das Entfernen verschachtelter Callbacks]. Behalten Sie dabei die öffentliche Schnittstelle, die Rückgabewerte, das Verhalten bei Fehlern und die Nebenwirkungen bei. Führen Sie vor der Bearbeitung den [entsprechenden Testbefehl] aus, um eine Ausgangsbasis zu schaffen. Sollte der Test fehlschlagen, dokumentieren Sie die Fehler, bevor Sie fortfahren. Identifizieren Sie jegliches Verhalten, das von den bestehenden Tests nicht abgedeckt wird, und fügen Sie bei Bedarf gezielte Tests hinzu. Führen Sie das Refactoring ohne irrelevante Änderungen oder neue Abhängigkeiten durch. Schwächen Sie bestehende Assertions nicht ab, um der Implementierung Rechnung zu tragen. Führen Sie die Tests und [Typüberprüfung oder Lint-Befehl] erneut aus. Zeigen Sie die Ergebnisse vor und nach der Änderung, fassen Sie die strukturellen Änderungen zusammen und kennzeichnen Sie jegliches Verhalten, das Sie nicht überprüfen konnten.

Refactorn Sie [Datei oder Modul] mit dem Ziel [spezifisches Ziel, z. B. das Aufteilen einer großen Funktion oder das Entfernen verschachtelter Callbacks]. Behalten Sie dabei die öffentliche Schnittstelle, die Rückgabewerte, das Verhalten bei Fehlern und die Nebenwirkungen bei. Führen Sie vor der Bearbeitung den [entsprechenden Testbefehl] aus, um eine Ausgangsbasis zu schaffen. Sollte der Test fehlschlagen, dokumentieren Sie die Fehler, bevor Sie fortfahren. Identifizieren Sie jegliches Verhalten, das von den bestehenden Tests nicht abgedeckt wird, und fügen Sie bei Bedarf gezielte Tests hinzu. Führen Sie das Refactoring ohne irrelevante Änderungen oder neue Abhängigkeiten durch. Schwächen Sie bestehende Assertions nicht ab, um der Implementierung Rechnung zu tragen. Führen Sie die Tests und [Typüberprüfung oder Lint-Befehl] erneut aus. Zeigen Sie die Ergebnisse vor und nach der Änderung, fassen Sie die strukturellen Änderungen zusammen und kennzeichnen Sie jegliches Verhalten, das Sie nicht überprüfen konnten.

17. Testen Sie eine Migration an einer kleinen Auswahl von Dateien

Wenden Sie dies an, bevor Sie eine API oder Bibliothek im gesamten Repository ersetzen. Ein kleines Pilotprojekt hilft dabei, Probleme mit der Kompatibilität aufzudecken, bevor dieselbe Änderung alle Aufrufer erreicht.

Suchen Sie nach Verwendungen von [alter API oder Bibliothek] innerhalb des [Verzeichnisbereichs], wobei generierte und Vendor-Dateien ausgeschlossen werden. Erstellen Sie eine Liste der betroffenen Dateien sowie aller gemeinsam genutzten Konfigurationen oder Abhängigkeiten, die von der Migration betroffen sein könnten. Schlagen Sie drei repräsentative Dateien für eine Pilotmigration auf die [neue API oder Version] vor, wobei Sie den [Migrationsleitfaden oder ein vorhandenes Beispiel] verwenden. Erläutern Sie, warum Sie diese ausgewählt haben, und kennzeichnen Sie alle erforderlichen Verhaltensänderungen. Warten Sie vor der Bearbeitung auf meine Genehmigung. Migrieren Sie nach der Genehmigung nur die Pilotdateien und alle ausdrücklich genehmigten gemeinsam genutzten Abhängigkeiten. Führen Sie [relevante Tests] und den [Build- oder TypüberprüfungsBefehl] aus. Weiten Sie die Migration nicht auf andere Dateien aus. Berichten Sie über die Unterschiede, Testergebnisse, Kompatibilitätsprobleme und alle erforderlichen Änderungen am Migrationsansatz. Halten Sie zur Überprüfung inne, bevor Sie mit den verbleibenden Dateien fortfahren.

Suchen Sie nach Verwendungen von [alter API oder Bibliothek] innerhalb des [Verzeichnisbereichs], wobei generierte und Vendor-Dateien ausgeschlossen werden. Erstellen Sie eine Liste der betroffenen Dateien sowie aller gemeinsam genutzten Konfigurationen oder Abhängigkeiten, die von der Migration betroffen sein könnten. Schlagen Sie drei repräsentative Dateien für eine Pilotmigration auf die [neue API oder Version] vor, wobei Sie den [Migrationsleitfaden oder ein vorhandenes Beispiel] verwenden. Erläutern Sie, warum Sie diese ausgewählt haben, und kennzeichnen Sie alle erforderlichen Verhaltensänderungen. Warten Sie vor der Bearbeitung auf meine Genehmigung. Migrieren Sie nach der Genehmigung nur die Pilotdateien und alle ausdrücklich genehmigten gemeinsam genutzten Abhängigkeiten. Führen Sie [relevante Tests] und den [Build- oder TypüberprüfungsBefehl] aus. Weiten Sie die Migration nicht auf andere Dateien aus. Berichten Sie über die Unterschiede, Ergebnisse der Tests, Probleme mit der Kompatibilität und alle erforderlichen Änderungen am Migrationsansatz. Halten Sie zur Überprüfung inne, bevor Sie mit den verbleibenden Dateien fortfahren.

Nach der Überprüfung des Pilotprojekts migrieren Sie den Rest in kontrollierten Gruppen. Der Befehl /batch von Claude Code kann genehmigte Aufgaben auf isolierte Git-Worktrees verteilen; ein Skript, das claude -p in einer Schleife ausführt, bietet diese Isolation nicht automatisch. Überprüfen Sie vor der Parallelisierung, ob sich gemeinsam genutzte Dateien geändert haben, und überprüfen und testen Sie anschließend das kombinierte Ergebnis. Weitere Informationen zur Auswahl von Aufgaben, die unabhängig voneinander ausgeführt werden können, finden Sie unter „Multi-Agent-Workflows“.

Anleitungen für Git, Pull Requests und Dokumentation

Nutzen Sie diese Vorgaben, um Änderungen für die Überprüfung vorzubereiten und zu erläutern, wie der Code verwendet werden soll. Limitieren Sie Commits auf die beabsichtigte Arbeit und stützen Sie die Dokumentation auf Befehle und Verhaltensweisen, die Sie im Repository überprüfen können.

18. Bereiten Sie einen Commit und einen Pull Request vor

Verwenden Sie dies, wenn die Implementierung zur Überprüfung bereit ist. Claude muss die beabsichtigten Änderungen von allen anderen, nicht damit zusammenhängenden Arbeiten im selben Arbeitsverzeichnis unterscheiden.

Überprüfe den aktuellen Bereich, den Git-Status und den Diff für [Feature oder Fix]. Identifiziere die zu dieser Änderung gehörenden Dateien und erstelle eine Liste nicht relevanter oder nicht verfolgter Dateien. Verfasse einen Commit-Text, der dem Format der letzten 10 Commits folgt. Erstelle eine Pull Request-Beschreibung, die die Änderungen, deren Gründe, die tatsächlich ausgeführten Tests sowie etwaige verbleibende Limite enthält. Zeige die vorgeschlagene Dateiliste, die Commit-Meldung und die PR-Beschreibung, bevor du irgendetwas stagest oder veröffentlichst. Warte auf meine Freigabe. Nach der Freigabe stagest du nur die vereinbarten Dateien, committest auf dem [Feature-Zweig], pushst auf [Remote] und eröffnest einen Pull Request für den [Basis-Zweig]. Ändere keine bestehenden Commits, führe keinen Force-Push durch und führe keine Zusammenführungen durch. Sende den Commit-Hash und den PR-Link zurück.

Überprüfe den aktuellen Branch, den Git-Status und den Diff für [Feature oder Fix]. Identifiziere die zu dieser Änderung gehörenden Dateien und liste nicht relevante oder nicht verfolgte Dateien separat auf. Verfasse einen Commit-Text im Format der letzten 10 Commits. Erstelle eine Pull Request-Beschreibung, die die Änderungen, die Gründe dafür, die tatsächlich ausgeführten Tests und etwaige verbleibende Einschränkungen enthält. Zeige die vorgeschlagene Dateiliste, die Commit-Meldung und die PR-Beschreibung, bevor du irgendetwas stagest oder veröffentlichst. Warte auf meine Freigabe. Nach der Freigabe stagest du nur die vereinbarten Dateien, führst einen Commit auf dem [Feature-Bereich] durch, pushst auf [Remote] und eröffnest einen Pull Request für den [Basis-Bereich]. Ändere keine bestehenden Commits, führe keinen Force-Push durch und führe keine Zusammenführungen durch. Sende den Commit-Hash und den PR-Link zurück.

19. Verfassen Sie eine Dokumentation für eine bestimmte Zielgruppe

Verwenden Sie dies, wenn ein Modul Setup- oder Gebrauchsanweisungen benötigt. Die Nennung des Lesers hilft Claude dabei, den richtigen Detaillierungsgrad zu wählen; der Verweis auf Projekt-Skripte hilft dabei, erfundene Befehle zu vermeiden.

Entwerfen Sie einen README-Abschnitt für [Modul], der sich an [Leser, z. B. einen Backend-Entwickler, der neu zum Projekt hinzukommt] richtet. Behandeln Sie dabei die Voraussetzungen, das Setup, die drei Befehle, die am häufigsten verwendet werden, sowie häufige Fehler, die im Code oder in der vorhandenen Dokumentation unterstützt werden. Überprüfen Sie Befehlsnamen und Optionen anhand von [Paketskripten, Makefile, CLI-Hilfe oder CI-Konfiguration]. Markieren Sie alles, was Sie nicht bestätigen können. Testen Sie sichere lokale Befehle in der [Testumgebung], sofern verfügbar. Bevor Sie Befehle ausführen, die Abhängigkeiten installieren, Dateien löschen, Daten migrieren, Deploys durchführen oder auf externe Dienste zugreifen, erklären Sie deren Auswirkungen und bitten Sie um Zustimmung. Unterscheiden Sie klar zwischen Befehlen, die Sie erfolgreich ausgeführt haben, und solchen, die lediglich anhand der Konfiguration oder Dokumentation überprüft wurden. Zeigen Sie den vorgeschlagenen README-Abschnitt vor der Bearbeitung von [Dokumentationspfad] an und behalten Sie nicht relevante Inhalte bei.

Entwerfen Sie einen README-Abschnitt für [Modul], der sich an [Leser, z. B. einen Backend-Entwickler, der neu zum Projekt stößt] richtet. Behandeln Sie dabei die Voraussetzungen, das Setup, die drei Befehle, die am häufigsten verwendet werden, sowie häufige Fehler, die im Code oder in der vorhandenen Dokumentation unterstützt werden. Überprüfen Sie Befehlsnamen und Optionen anhand von [Paketskripten, Makefile, CLI-Hilfe oder CI-Konfiguration]. Markieren Sie alles, was Sie nicht bestätigen können. Testen Sie sichere lokale Befehle in der [Testumgebung], sofern verfügbar. Bevor Sie Befehle ausführen, die Abhängigkeiten installieren, Dateien löschen, Daten migrieren, Deploys durchführen oder auf externe Dienste zugreifen, erklären Sie deren Auswirkungen und bitten Sie um Zustimmung. Unterscheiden Sie klar zwischen Befehlen, die Sie erfolgreich ausgeführt haben, und solchen, die lediglich anhand der Konfiguration oder Dokumentation überprüft wurden. Zeigen Sie den vorgeschlagenen README-Abschnitt vor der Bearbeitung von [Dokumentationspfad] an und behalten Sie nicht relevante Inhalte bei.

Anleitungen zur Konfiguration von Claude Code

Nutzen Sie diese Anleitungen, um Repository-Anweisungen zu pflegen, wiederkehrende Überprüfungen zu automatisieren und ein unbekanntes Befehlszeilentool zu bewerten. Überprüfen Sie Konfigurationsänderungen, bevor Sie sie übernehmen, insbesondere wenn sie sich darauf auswirken, welche Befehle automatisch ausgeführt werden.

20. CLAUDE.md überprüfen und vereinfachen

Verwenden Sie diese Option, wenn sich in der Anweisungsdatei doppelte Regeln, veraltete Befehle oder Hinweise angesammelt haben, die bereits aus dem Code ersichtlich sind. Behalten Sie die projektspezifischen Informationen bei, die Claude benötigt, um korrekt zu funktionieren.

Vergleiche [Pfad zu CLAUDE.md] mit der aktuellen Struktur, den Skripten und den Konventionen des Repositorys. Starte die Bearbeitung der Datei noch nicht. Identifiziere veraltete Anweisungen, Duplikate, Widersprüche und Regeln, die sich zuverlässig aus dem Code ableiten lassen. Begründe jede vorgeschlagene Streichung, anstatt Anweisungen nur zu entfernen, um die Datei zu verkürzen. Schlage fehlende Build- oder Testbefehle nur dann vor, wenn du sie in Projektskripten, einem Makefile, der CI-Konfiguration oder der vorhandenen Dokumentation überprüfen kannst. Geben Sie für jede Ergänzung die Quelle an. Liefern Sie einen vorgeschlagenen Diff, der wichtige Vorgaben des Projekts beibehält. Markieren Sie aufgabenspezifische Anweisungen, die besser in eine Skill- oder Pfad-spezifische Regel passen würden, und warten Sie auf die Genehmigung, bevor Sie Änderungen übernehmen.

Vergleiche [Pfad zu CLAUDE.md] mit der aktuellen Struktur, den Skripten und den Konventionen des Repositorys. Starte die Bearbeitung der Datei noch nicht. Identifiziere veraltete Anweisungen, Duplikate, Widersprüche und Regeln, die sich zuverlässig aus dem Code ableiten lassen. Begründe jede vorgeschlagene Streichung, anstatt Anweisungen nur zu entfernen, um die Datei zu verkürzen. Schlage fehlende Build- oder Testbefehle nur dann vor, wenn du sie in Projektskripten, einem Makefile, der CI-Konfiguration oder der vorhandenen Dokumentation überprüfen kannst. Geben Sie für jede Ergänzung die Quelle an. Liefern Sie einen vorgeschlagenen Diff, der wichtige Vorgaben des Projekts beibehält. Markieren Sie aufgabenspezifische Anweisungen, die besser in eine Skill- oder Pfad-spezifische Regel passen würden, und warten Sie auf die Genehmigung, bevor Sie Änderungen übernehmen.

21. Einen Format-Hook konfigurieren

Verwenden Sie dies, wenn ein Formatierer nach unterstützten Bearbeitungen der Dateien automatisch ausgeführt werden soll. Beschränken Sie den Hook auf relevante Dateien und testen Sie sein Verhalten, bevor Sie sich darauf verlassen.

Schlagen Sie einen Claude-Code-Befehlshook vor, der nach Änderungen mit „Edit“ oder „Write“ an [Dateimuster] den [vorhandenen Formatierungsbefehl] ausführt. Überprüfen Sie zunächst die vorhandene Konfiguration in `claude/einstellungen.json` und die Konfiguration des Formatierers. Verwenden Sie die passende „PostToolUse“-Konfiguration für die installierte Claude-Code-Version. Formatieren Sie nur die betroffene Datei, behandeln Sie Pfade sicher und schließen Sie [generierte Dateien oder andere ausgeschlossene Pfade] aus. Installieren Sie keine Abhängigkeiten und ersetzen Sie keine bestehenden Hooks. Zeigen Sie den Diff der vorgeschlagenen Einstellungen und erklären Sie, wie Fehler des Formatierers gemeldet werden. Warten Sie auf die Genehmigung, bevor Sie den Hook anwenden. Testen Sie ihn nach der Genehmigung mit einer temporären Datei im Projekt und berichten Sie über das Ergebnis. Geben Sie an, welche Bearbeitungspfade abgedeckt sind und welche nicht, einschließlich der durch Shell-Befehle vorgenommenen Änderungen.

Schlagen Sie einen Claude-Code-Befehlshook vor, der den [vorhandenen Formatierungsbefehl] ausführt, nachdem Änderungen an [Dateimuster] bearbeitet oder geschrieben wurden. Überprüfen Sie zunächst die vorhandene Konfiguration in `claude/einstellungen.json` und die Konfiguration des Formatierers. Verwenden Sie die passende „PostToolUse“-Konfiguration für die installierte Claude-Code-Version. Formatieren Sie nur die betroffene Datei, behandeln Sie Pfade sicher und schließen Sie [generierte Dateien oder andere ausgeschlossene Pfade] aus. Installieren Sie keine Abhängigkeiten und ersetzen Sie keine bestehenden Hooks. Zeigen Sie den Diff der vorgeschlagenen Einstellungen und erklären Sie, wie Fehler des Formatierers gemeldet werden. Warten Sie auf die Genehmigung, bevor Sie den Hook anwenden. Testen Sie ihn nach der Genehmigung mit einer temporären Datei im Projekt und berichten Sie über das Ergebnis. Geben Sie an, welche Bearbeitungspfade abgedeckt sind und welche nicht, einschließlich der durch Shell-Befehle vorgenommenen Änderungen.

22. Bewerten Sie eine unbekannte CLI, bevor Sie sie verwenden

Nutzen Sie diese Anleitung, wenn eine Aufgabe ein Befehlszeilentool erfordert, mit dem Sie bisher noch nicht gearbeitet haben. Durch die Überprüfung der Hilfeausgabe können Sie zwar die unterstützten Optionen ermitteln, müssen aber dennoch die Auswirkungen der vorgeschlagenen Befehle verstehen.

Sehen Sie sich [tool] –help und die Hilfe zu den für [Aufgabe] relevanten Unterbefehlen an. Installieren Sie das tool nicht, wenn es fehlt; melden Sie stattdessen diese Voraussetzung. Schlagen Sie die genauen Befehle vor, die zur Abschließung der Aufgabe erforderlich sind. Erläutern Sie deren Eingaben, Ausgaben und ob sie Dateien schreiben, Remote-Ressourcen ändern oder Anmeldedaten verwenden. Fügen Sie eine Dry-Run-Option hinzu, falls das Tool eine solche dokumentiert. Weisen Sie auf fehlende Konfigurationen oder Berechtigungen hin und bitten Sie um Klärung, anstatt Ressourcennamen oder Ziele zu erraten. Warten Sie auf die Genehmigung, bevor Sie die Befehle zur Aufgabenausführung ausführen. Führen Sie nach der Genehmigung nur die vereinbarten Befehle aus und melden Sie deren tatsächliche Ergebnisse, einschließlich etwaiger Fehler oder unvollständiger Schritte.

Sehen Sie sich [Tool] –help und die Hilfe zu den für [Aufgabe] relevanten Unterbefehlen an. Installieren Sie das Tool nicht, wenn es fehlt; melden Sie stattdessen diese Voraussetzung. Schlagen Sie die genauen Befehle vor, die zur Abschließung der Aufgabe erforderlich sind. Erläutern Sie deren Eingaben, Ausgaben und ob sie Dateien schreiben, Remote-Ressourcen ändern oder Anmeldedaten verwenden. Fügen Sie eine Dry-Run-Option hinzu, falls das tool eine solche dokumentiert. Weisen Sie auf fehlende Konfigurationen oder Berechtigungen hin und bitten Sie um Klärung, anstatt Ressourcennamen oder Ziele zu erraten. Warten Sie auf die Genehmigung, bevor Sie die Befehle zur Aufgabenausführung ausführen. Führen Sie nach der Genehmigung nur die vereinbarten Befehle aus und melden Sie deren tatsächliche Ergebnisse, einschließlich etwaiger Fehler oder unvollständiger Schritte.

Anleitungen für Menschen, die nicht beruflich Code schreiben

Claude Code kann bei der dateibasierten Analyse, bei wiederkehrenden Berichten und bei auf Quelldaten basierenden Dokumenten helfen. Geben Sie die Geschäftsregeln und Beispiele an, die zur Bewertung der Ausgabe erforderlich sind, und verwenden Sie Kopien genehmigter Daten anstelle von Produktionsdatensätzen.

23. Rechnungen und Zahlungen abgleichen

Verwenden Sie dies, wenn Zahlungen und Rechnungen keine einfache Eins-zu-Eins-Beziehung aufweisen. Legen Sie fest, wie Teilzahlungen, doppelte Datensätze und nicht zugeordnete Zahlungen behandelt werden sollen, bevor Sie die Summen vergleichen.

Vergleichen Sie [invoices.csv] und [Zahlungen.csv] anhand der [Rechnungs-ID oder des Schlüssels für den Abgleich]. Ändern Sie die Quelldateien nicht. Wenden Sie folgende Regeln an: [Währung und Rundungstoleranz], [Zuordnung von Teilzahlungen] und [Umgang mit Rückerstattungen, Guthaben und Überzahlungen]. Wenn eine Regel fehlt oder eine Übereinstimmung mehrdeutig ist, kennzeichnen Sie diese, anstatt die Zahlung automatisch zuzuordnen. Behalten Sie die IDen der Quellzeilen bei. Zeigen Sie für jede Rechnung den Rechnungsbetrag, die verrechneten Zahlungen und den Restbetrag an. Melden Sie doppelte IDs, nicht zugeordnete Rechnungen, nicht zugeordnete Zahlungen und Salden außerhalb der Toleranz. Stimmen Sie Rechnungs- und Zahlungssummen separat ab. Berücksichtigen Sie jede Quellzeile, ohne sie doppelt zu zählen; wenn sich eine Zahlung auf mehrere Rechnungen verteilt, zeigen Sie jede Zuordnung an und stellen Sie sicher, dass die Zuordnungen den Zahlungsbetrag nicht überschreiten. Schreiben Sie die Ergebnisse in [neue Ausgabepfade] und fassen Sie Ausnahmen zusammen, die einer Überprüfung bedürfen.

Vergleichen Sie [invoices.csv] und [Zahlungen.csv] anhand der [Rechnungs-ID oder des Schlüssels für den Abgleich]. Ändern Sie die Quelldateien nicht. Wenden Sie folgende Regeln an: [Währung und Rundungstoleranz], [Zuordnung von Teilzahlungen] und [Umgang mit Rückerstattungen, Guthaben und Überzahlungen]. Wenn eine Regel fehlt oder eine Übereinstimmung mehrdeutig ist, kennzeichnen Sie diese, anstatt die Zahlung automatisch zuzuordnen. Behalten Sie die IDs der Quellzeilen bei. Zeigen Sie für jede Rechnung den Rechnungsbetrag, die verrechneten Zahlungen und den Restbetrag an. Melden Sie doppelte IDs, nicht zugeordnete Rechnungen, nicht zugeordnete Zahlungen und Salden außerhalb der Toleranz. Stimmen Sie Rechnungs- und Zahlungssummen separat ab. Berücksichtigen Sie jede Quellzeile, ohne sie doppelt zu zählen; wenn sich eine Zahlung auf mehrere Rechnungen verteilt, zeigen Sie jede Zuordnung an und stellen Sie sicher, dass die Zuordnungen den Zahlungsbetrag nicht überschreiten. Schreiben Sie die Ergebnisse in [neue Ausgabepfade] und fassen Sie Ausnahmen zusammen, die einer Überprüfung bedürfen.

24. Erstellen Sie einen wöchentlichen Betriebsbericht

Verwenden Sie dies für wiederkehrende Berichte, die auf exportierten Daten basieren. Legen Sie die Einstellungen für die Berichterstellung und die Kategoriedefinitionen fest, damit das Skript jede Woche dieselben Regeln anwendet.

Schreiben Sie ein Skript, das [export.csv] für den Zeitraum von [Startdatum und -zeit, einschließlich] bis [Enddatum und -zeit, ausschließlich] unter Verwendung von [Zeitzone] und [Datumsspalten] zusammenfasst. Gruppieren Sie die Datensätze nach [Kategoreregeln] und berechnen Sie [erforderliche Metriken]. Behandeln Sie doppelte IDs und fehlende Werte gemäß [Regeln]. Ändern Sie die Eingabedatei nicht. Führen Sie das Skript auf der [genauen Eingabedatei] aus. Geben Sie die Anzahl der ein- und ausgeschlossenen Zeilen, die Kategoriesummen sowie die Datensätze an, die nicht klassifiziert werden konnten. Vergleichen Sie die Ergebnisse für [drei Kategorien] mit den unabhängig überprüften Zahlen in der [Referenzdatei]. Falls diese Zahlen nicht verfügbar sind, geben Sie an, dass die unabhängige Validierung noch aussteht. Zeigen Sie Abweichungen an und speichern Sie den Bericht unter [neuem Ausgabepfad].

Schreiben Sie ein Skript, das [export.csv] für den Zeitraum von [Startdatum und -zeit, einschließlich] bis [Enddatum und -zeit, ausschließlich] unter Verwendung von [Zeitzone] und [Datumsspalten] zusammenfasst. Gruppieren Sie die Datensätze nach [Kategoreregeln] und berechnen Sie [erforderliche Metriken]. Behandeln Sie doppelte IDs und fehlende Werte gemäß [Regeln]. Ändern Sie die Eingabedatei nicht. Führen Sie das Skript auf der [genauen Eingabedatei] aus. Geben Sie die Anzahl der einbezogenen und ausgeschlossenen Zeilen, die Kategoriesummen sowie die Datensätze an, die nicht klassifiziert werden konnten. Vergleichen Sie die Ergebnisse für [drei Kategorien] mit den unabhängig überprüften Zahlen in der [Referenzdatei]. Falls diese Zahlen nicht verfügbar sind, geben Sie an, dass die unabhängige Validierung noch aussteht. Zeigen Sie Abweichungen an und speichern Sie den Bericht unter [neuem Ausgabepfad].

25. Erstellen Sie aus Quelldateien einen Dokumententwurf

Verwenden Sie dies, wenn Sie eine Erklärung benötigen, die auf genehmigten Dokumenten oder Code basiert. Bitten Sie um Referenzen, die so konkret sind, dass ein Prüfer jede Behauptung zum Material überprüfen kann.

Lesen Sie [angegebene Dateien oder Ordner] und erstellen Sie einen Entwurf für ein [Dokumenttyp und -umfang] für [Zielgruppe], der [Fragen oder Themen] abdeckt. Unterstützen Sie jede sachliche Behauptung mit einem Dateinamen und, sofern verfügbar, einem Verweis auf eine Seite, einen Abschnitt oder eine Zeile. Unterscheiden Sie direkte Zitate von Paraphrasen und behandeln Sie einen Vorschlag oder ein veraltetes Dokument nicht als bestätigte aktuelle Entscheidung. Weisen Sie auf widersprüchliche Quellen, fehlende Informationen und Behauptungen hin, die Sie nicht überprüfen können. Füllen Sie Lücken nicht mit Annahmen und führen Sie keine Bearbeitung der Quelldateien durch. Reichen Sie den Entwurf mit den Quellenangaben und einer kurzen Liste offener Fragen für den Prüfer ein.

Lesen Sie [angegebene Dateien oder Ordner] und erstellen Sie einen Entwurf für ein [Dokumenttyp und -umfang] für [Zielgruppe], der [Fragen oder Themen] abdeckt. Unterstützen Sie jede sachliche Behauptung mit einem Dateinamen und, sofern verfügbar, einem Verweis auf eine Seite, einen Abschnitt oder eine Zeile. Unterscheiden Sie direkte Zitate von Paraphrasen und behandeln Sie einen Vorschlag oder ein veraltetes Dokument nicht als bestätigte aktuelle Entscheidung. Weisen Sie auf widersprüchliche Quellen, fehlende Informationen und Behauptungen hin, die Sie nicht überprüfen können. Füllen Sie Lücken nicht mit Annahmen und führen Sie keine Bearbeitung der Quelldateien durch. Reichen Sie den Entwurf mit seinen Quellenangaben und einer kurzen Liste offener Fragen für den Prüfer ein.

Um eine Vorlage anzupassen, ersetzen Sie deren Platzhalter durch Angaben aus Ihrem Projekt und legen Sie fest, was Claude tun soll, bevor Sie Änderungen vornehmen. Befolgen Sie diese Schritte, um die Anfrage vorzubereiten und das Ergebnis zu überprüfen.

Bei einer kleinen, klar definierten Änderung können Sie Claude bitten, diese direkt umzusetzen. Bei unbekanntem Code, Änderungen, die mehrere Dateien betreffen, oder ungeklärten Anforderungen sollten Sie zunächst einen Plan erstellen.

Drücken Sie „Umschalt+Tab“, bis der Plan-Modus angezeigt wird, oder starten Sie Claude Code mit dem Befehl „claude --permission-mode plan“. In diesem Modus kann Claude Dateien überprüfen und schreibgeschützte Befehle ausführen, ohne Ihre Code-Bearbeitung durchzuführen. Überprüfen Sie die vorgeschlagenen Dateien, Abhängigkeiten und Tests, bevor Sie die Umsetzung genehmigen. Drücken Sie „Strg+G“, um den vorgeschlagenen Plan in Ihrem Editor zu öffnen.

Geben Sie Claude die Informationen, die zum Verständnis der Aufgabe erforderlich sind: einen Dateiverweis, ein bereinigtes Fehlerprotokoll, einen Screenshot oder ein Anforderungsdokument. Verwenden Sie „@“, gefolgt von einem Dateipfad, um den Inhalt dieser Datei einzufügen.

Wählen Sie die kleinste sinnvolle Auswahl an Quellen aus. Das Einbeziehen eines gesamten Protokolls oder Verzeichnisses kann irrelevantes Material hinzufügen und den Kontext überfrachten. Entfernen Sie Anmeldedaten und sensible Informationen, bevor Sie Protokolle freigeben, und stellen Sie sicher, dass Claude über die erforderlichen Tools verfügt, um die von Ihnen angegebenen Dokumentations-URLs abzurufen.

Beispielsweise übermittelt der Befehl „cat error.log | claude -p ‚Explain this Fehler‘“ ein Protokoll mit einer nicht-interaktiven Anfrage. Verwenden Sie ihn erst, nachdem Sie den Inhalt der Datei überprüft haben. Darin liegt der praktische Wert kontextbezogener KI: dem Modell relevante Informationen für die jeweilige Aufgabe zur Verfügung zu stellen.

Wenn Sie ein neues Feature hinzufügen, identifizieren Sie eine ähnliche Komponente oder Funktion im Repository. Teilen Sie Claude mit, welche Konventionen zu befolgen sind, beispielsweise hinsichtlich des API-Clients, der Validierungslogik, der Fehlerbehandlung oder der Teststruktur.

„Verfolgen Sie, wie @src/widgets/Weather.tsx Daten abruft und zwischenspeichert“ gibt Claude einen konkreten Anhaltspunkt. Nennen Sie außerdem alle Unterschiede, die das neue Feature erfordert, damit kein Verhalten kopiert wird, das nicht mehr passt. Diese Konventionen sollten den Softwareentwicklungs-Workflow Ihres Teams widerspiegeln.

Geben Sie bei Codeänderungen den entsprechenden Test-, Build- oder Lint-Befehl sowie das zu prüfende Verhalten an. Fordern Sie für Recherchezwecke Dateireferenzen oder Commit-IDs an. Stellen Sie bei der Arbeit an der Benutzeroberfläche ein Referenzbild sowie eine konfigurierte Methode zur Verfügung, um die Implementierung im gleichen Ansichtsbereich zu erfassen.

Bitten Sie Claude, einen Bericht über das zu erstellen, was tatsächlich geprüft wurde, einschließlich Fehlern und übersprungenen Prüfungen. Überprüfen Sie, ob die Nachweise die Anforderung abdecken; ein erfolgreicher Build bedeutet nicht, dass jedes geforderte Verhalten funktioniert.

Für umfangreichere Aufgaben bietet Claude Code außerdem eine /goal-Bedingung und Stop-Hooks. Der Zielauswerter bewertet die in der Unterhaltung zutage getretenen Hinweise, anstatt Dateien eigenständig zu überprüfen oder Tests auszuführen. Ein konfigurierter Stop-Hook kann die Fertigstellung blockieren, unterliegt jedoch Limiten hinsichtlich wiederholter Blockierungen. Beides ersetzt jedoch keine angemessenen Tests und keine Überprüfung durch Menschen.

Wenn wiederholte Korrekturen ein Problem nicht beheben, halten Sie inne und ermitteln Sie, was in der ursprünglichen Anfrage unklar geblieben ist. Speichern Sie die nützlichen Erkenntnisse, den aktuellen Git-Status und die verbleibende Arbeit, bevor Sie die Unterhaltung löschen.

Der Leitfaden für Best Practices von Anthropic empfiehlt, nach zwei erfolglosen Korrekturversuchen zum selben Problem von vorne zu beginnen. Verwenden Sie den Befehl /clear und geben Sie anschließend eine überarbeitete Eingabe an, die Ihre gewonnenen Erkenntnisse berücksichtigt. Das Löschen der Unterhaltung macht Dateiänderungen nicht rückgängig.

Drücken Sie die Esc-Taste, um eine laufende Antwort zu unterbrechen. Wenn das Eingabefeld leer ist, drücken Sie zweimal die Esc-Taste, um das Rückspulen-Menü zu öffnen und auszuwählen, was wiederhergestellt werden soll. Das Rückspulen macht nicht alle externen Auswirkungen rückgängig. Verwenden Sie daher Git-Checkpoints und separate Wiederherstellungsverfahren für Änderungen an Datenbanken oder Remote-Diensten.

Speichern Sie projektweite Richtlinien in „CLAUDE.md“, wiederholbare Abläufe in „Skills“ und Anweisungen für bestimmte Dateien in pfadbezogenen Regeln. Verwenden Sie Hooks für Aktionen, die an bestimmte Ereignisse geknüpft sind, wie beispielsweise das Ausführen eines Formatierers nach einer Bearbeitung.

Wählen Sie je nachdem aus, wann die Anweisung gelten soll:

Eine Anforderung für ein Feature gehört in der Regel in die entsprechende Aufgabe oder Spezifikation und nicht in die Datei „CLAUDE.md“. Das Hinzufügen temporärer Anweisungen zu einer projektweiten Datei erschwert es, diese von Konventionen zu unterscheiden, die im gesamten Repository gelten sollten.

Speichern Sie beispielsweise den Testbefehl des Projekts in der Datei „CLAUDE.md“, legen Sie komponentenbezogene Konventionen in einer pfadbezogenen Regel fest und speichern Sie ein wiederkehrendes Überprüfungsverfahren als „Skill“. Überprüfen Sie diese Dateien bei Änderungen an Befehlen oder Konventionen, genau wie Sie es auch bei anderer Projektdokumentation tun würden.

Prompts, CLAUDE.md und Skills steuern das Verhalten von Claude; sie garantieren jedoch nicht, dass eine Anweisung befolgt wird. Hooks können bei konfigurierten Ereignissen Prüfungen durchführen, ihre Zuverlässigkeit hängt jedoch vom Hook-Typ und der Implementierung ab.

Ein Befehlshook führt ein Skript aus. Ein Prompt- oder Agent-Hook stützt sich auf die Entscheidung eines Modells. Wie im Leitfaden zu Best Practices von Anthropic erläutert wird: „Ein Prompt- oder Agent-Hook bittet ein anderes Modell um eine Entscheidung, ist also ebenfalls nicht deterministisch.“ Verwenden Sie für eine Regel, die durchgesetzt werden muss, geeignete Berechtigungskontrollen und testen Sie den entsprechenden Befehls- oder HTTP-Hook, einschließlich der Art und Weise, wie er mit Fehlern umgeht.

Benutzerdefinierte Unteragenten sind eine weitere Möglichkeit, wiederkehrende Aufgaben zu organisieren. Definieren Sie einen Spezialisten unter „in.claude/agents/“, wenn eine eigene Rolle für die Überprüfung oder ein eigener Tool-Umfang erforderlich ist, anstatt jede Spezialanweisung zur Hauptsitzung hinzuzufügen. Diese Leitfäden zum besten Claude-Modell für die Arbeit und zu den Arten von KI-Agenten bieten zusätzlichen Kontext.

Wenn Ihr Team Prompts für mehrere KI-Produkte verwaltet, sehen Sie sich diese Prompt-Engineering-Tools an, mit denen Sie Bibliotheken über Claude Code hinaus verwalten können.

Wenn eine Sitzung ein unvollständiges oder ungeeignetes Ergebnis liefert, prüfen Sie, ob in der Anforderung wichtige Entscheidungen offen geblieben sind. Diese fünf Fehler können die Diagnose und Überprüfung der Arbeit erschweren.

„Untersuche das Repository“ gibt Claude kaum Anhaltspunkte dafür, welche Dateien relevant sind oder wann es aufhören soll. Möglicherweise erhalten Sie eine allgemeine Zusammenfassung ohne Antwort auf das Problem, das Anlass für die Anfrage war.

Benennen Sie das Verhalten oder die Entscheidung, die Sie verstehen müssen, legen Sie einen Startpunkt fest und definieren Sie die erwartete Ausgabe. Beispiel: „Verfolgen Sie nach, wie dieser Endpunkt Berechtigungen prüft, und nennen Sie die entsprechenden Funktionen.“ Wenn Sie Unteragenten einsetzen, geben Sie jedem einzelnen eine abgegrenzte Frage vor, anstatt dieselbe uneingeschränkte Suche zu delegieren.

Der Wechsel zwischen einem Feature, einem nicht damit zusammenhängenden Fehler und einer Dokumentationsanfrage führt dazu, dass die Unterhaltung einen Kontext enthält, der möglicherweise nicht auf die aktuelle Aufgabe zutrifft. Verweise wie „diese Datei“ oder „der frühere Ansatz“ werden dadurch mehrdeutig.

Verwenden Sie separate Sitzungen für nicht miteinander in Zusammenhang stehende Aufgaben. Wenn mehrere Sitzungen das Repository bearbeiten, verwenden Sie separate Git-Worktrees, damit nicht dasselbe Arbeitsverzeichnis geändert wird. Eine kurze Nebenbemerkung: Der Befehl /btw von Claude Code hält den Austausch aus dem Hauptverlauf der Unterhaltung heraus.

Ein Build kann erfolgreich sein, obwohl sich ein Feature falsch verhält. Eine Testsuite kann erfolgreich sein, weil sie die fehlerhafte Eingabe nie getestet hat. Wenn man Claude auffordert, „die Tests auszuführen“, wird dadurch nicht festgestellt, welche Anforderung diese Tests überprüfen.

Ordnen Sie die Akzeptanzkriterien bestimmten Prüfungen zu. Fordern Sie bei einer Fehlerbehebung den Nachweis an, dass der Reproduktionstest vor der Änderung fehlgeschlagen ist und danach erfolgreich war. Halten Sie ungetestete Kriterien in Sichtbarkeit, anstatt einen erfolgreichen Befehl als Überprüfung für die gesamte Änderung zu betrachten.

Eine ständig wachsende CLAUDE.md-Datei kann veraltete Befehle, doppelte Regeln und Anweisungen enthalten, die im Widerspruch zu aufgabenspezifischen Anforderungen stehen. Eine strengere Formulierung löst diese Konflikte nicht.

Überprüfen Sie die Datei anhand des aktuellen Repositorys. Entfernen Sie veraltete Anleitungen, klären Sie widersprüchliche Regeln und verschieben Sie nur in engen Anwendungsfällen gültige Anweisungen in Regeln oder Fähigkeiten, die auf den Pfad beschränkt sind. Wenn eine Anforderung durchgesetzt werden muss, konfigurieren und testen Sie die entsprechenden Kontrollen, anstatt sich auf wiederholte Erinnerungen zu verlassen.

Eine Überprüfung kann echte Fehler, unklare Probleme und optionale Refactoring-Vorschläge gleichzeitig aufzeigen. Die Umsetzung aller Vorschläge kann den Änderungsumfang vergrößern, ohne das gewünschte Verhalten zu verbessern.

Fragen Sie nach den Belegen und den Auswirkungen hinter jedem Befund. Priorisieren Sie Korrektheitsprobleme und nicht erfüllte Anforderungen, untersuchen Sie unklare Behauptungen und halten Sie nicht relevante Verbesserungen aus dem aktuellen Diff heraus. Ein Prüfer sollte in der Lage sein, keine umsetzbaren Befunde zu melden, wenn die Belege diese Schlussfolgerung unterstützen.

Um eine Vorlage anzupassen, ersetzen Sie deren Platzhalter durch Angaben aus Ihrem Projekt und legen Sie fest, was Claude tun soll, bevor Sie Änderungen vornehmen. Befolgen Sie diese Schritte, um die Anfrage vorzubereiten und das Ergebnis zu überprüfen.

Bei einer kleinen, klar definierten Änderung können Sie Claude bitten, diese direkt umzusetzen. Bei unbekanntem Code, Änderungen, die mehrere Dateien betreffen, oder ungeklärten Anforderungen sollten Sie zunächst einen Plan erstellen.

Drücken Sie „Umschalt+Tab“, bis der Plan-Modus angezeigt wird, oder starten Sie Claude Code mit dem Befehl „claude --permission-mode plan“. In diesem Modus kann Claude Dateien überprüfen und schreibgeschützte Befehle ausführen, ohne Ihre Code-Bearbeitung durchzuführen. Überprüfen Sie die vorgeschlagenen Dateien, Abhängigkeiten und Tests, bevor Sie die Umsetzung genehmigen. Drücken Sie „Strg+G“, um den vorgeschlagenen Plan in Ihrem Editor zu öffnen.

Geben Sie Claude die Informationen, die zum Verständnis der Aufgabe erforderlich sind: einen Dateiverweis, ein bereinigtes Fehlerprotokoll, einen Screenshot oder ein Anforderungsdokument. Verwenden Sie „@“, gefolgt von einem Dateipfad, um den Inhalt dieser Datei einzufügen.

Wählen Sie die kleinste sinnvolle Auswahl an Quellen aus. Das Einbeziehen eines gesamten Protokolls oder Verzeichnisses kann irrelevantes Material hinzufügen und den Kontext überfrachten. Entfernen Sie Anmeldedaten und sensible Informationen, bevor Sie Protokolle freigeben, und stellen Sie sicher, dass Claude über die erforderlichen Tools verfügt, um die von Ihnen angegebenen Dokumentations-URLs abzurufen.

Beispielsweise übermittelt der Befehl „cat error.log | claude -p ‚Explain this Fehler‘“ ein Protokoll mit einer nicht-interaktiven Anfrage. Verwenden Sie ihn erst, nachdem Sie den Inhalt der Datei überprüft haben. Darin liegt der praktische Wert kontextbezogener KI: dem Modell relevante Informationen für die jeweilige Aufgabe zur Verfügung zu stellen.

Wenn Sie ein neues Feature hinzufügen, identifizieren Sie eine ähnliche Komponente oder Funktion im Repository. Teilen Sie Claude mit, welche Konventionen zu befolgen sind, beispielsweise hinsichtlich des API-Clients, der Validierungslogik, der Fehlerbehandlung oder der Teststruktur.

„Verfolgen Sie, wie @src/widgets/Weather.tsx Daten abruft und zwischenspeichert“ gibt Claude einen konkreten Anhaltspunkt. Nennen Sie außerdem alle Unterschiede, die das neue Feature erfordert, damit kein Verhalten kopiert wird, das nicht mehr passt. Diese Konventionen sollten den Softwareentwicklungs-Workflow Ihres Teams widerspiegeln.

Geben Sie bei Codeänderungen den entsprechenden Test-, Build- oder Lint-Befehl sowie das zu prüfende Verhalten an. Fordern Sie für Recherchezwecke Dateireferenzen oder Commit-IDs an. Stellen Sie bei der Arbeit an der Benutzeroberfläche ein Referenzbild sowie eine konfigurierte Methode bereit, um die Implementierung im gleichen Ansichtsbereich zu erfassen.

Bitten Sie Claude, einen Bericht über das zu erstellen, was tatsächlich geprüft wurde, einschließlich Fehlern und übersprungenen Prüfungen. Überprüfen Sie, ob die Nachweise die Anforderung abdecken; ein erfolgreicher Build bedeutet nicht, dass jedes geforderte Verhalten funktioniert.

Für umfangreichere Aufgaben bietet Claude Code außerdem eine /goal-Bedingung und Stop-Hooks. Der Zielauswerter bewertet die in der Unterhaltung zutage getretenen Hinweise, anstatt Dateien eigenständig zu überprüfen oder Tests auszuführen. Ein konfigurierter Stop-Hook kann die Fertigstellung blockieren, unterliegt jedoch Limiten hinsichtlich wiederholter Blockierungen. Beides ersetzt jedoch keine angemessenen Tests und keine Überprüfung durch Menschen.

Wenn wiederholte Korrekturen ein Problem nicht beheben, halten Sie inne und ermitteln Sie, was in der ursprünglichen Anfrage unklar geblieben ist. Speichern Sie die nützlichen Erkenntnisse, den aktuellen Git-Status und die verbleibende Arbeit, bevor Sie die Unterhaltung löschen.

Der Leitfaden für Best Practices von Anthropic empfiehlt, nach zwei erfolglosen Korrekturversuchen zum selben Problem von vorne zu beginnen. Verwenden Sie den Befehl /clear und geben Sie anschließend eine überarbeitete Eingabe an, die Ihre gewonnenen Erkenntnisse berücksichtigt. Das Löschen der Unterhaltung macht Dateiänderungen nicht rückgängig.

Drücken Sie die Esc-Taste, um eine laufende Antwort zu unterbrechen. Wenn das Eingabefeld leer ist, drücken Sie zweimal die Esc-Taste, um das Rückspulen-Menü zu öffnen und auszuwählen, was wiederhergestellt werden soll. Das Rückspulen macht nicht alle externen Auswirkungen rückgängig. Verwenden Sie daher Git-Checkpoints und separate Wiederherstellungsverfahren für Änderungen an Datenbanken oder Remote-Diensten.

Speichern Sie projektweite Richtlinien in „CLAUDE.md“, wiederholbare Abläufe in „Skills“ und Anweisungen für bestimmte Dateien in pfadbezogenen Regeln. Verwenden Sie Hooks für Aktionen, die an bestimmte Ereignisse geknüpft sind, wie beispielsweise das Ausführen eines Formatierers nach einer Bearbeitung.

Wählen Sie je nachdem aus, wann die Anweisung gelten soll:

Eine Anforderung für ein Feature gehört in der Regel in die entsprechende Aufgabe oder Spezifikation und nicht in die Datei „CLAUDE.md“. Das Hinzufügen temporärer Anweisungen zu einer projektweiten Datei erschwert es, diese von Konventionen zu unterscheiden, die im gesamten Repository gelten sollten.

Speichern Sie beispielsweise den Testbefehl des Projekts in der Datei „CLAUDE.md“, legen Sie komponentenbezogene Konventionen in einer pfadbezogenen Regel fest und speichern Sie ein wiederkehrendes Überprüfungsverfahren als „Skill“. Überprüfen Sie diese Dateien bei Änderungen an Befehlen oder Konventionen, genau wie Sie es auch bei anderer Projektdokumentation tun würden.

Prompts, CLAUDE.md und Skills steuern das Verhalten von Claude; sie garantieren jedoch nicht, dass eine Anweisung befolgt wird. Hooks können bei konfigurierten Ereignissen Prüfungen durchführen, ihre Zuverlässigkeit hängt jedoch vom Hook-Typ und der Implementierung ab.

Ein Befehlshook führt ein Skript aus. Ein Prompt- oder Agent-Hook stützt sich auf die Entscheidung eines Modells. Wie im Leitfaden zu Best Practices von Anthropic erläutert wird: „Ein Prompt- oder Agent-Hook bittet ein anderes Modell um eine Entscheidung, ist also ebenfalls nicht deterministisch.“ Verwenden Sie für eine Regel, die durchgesetzt werden muss, geeignete Berechtigungskontrollen und testen Sie den entsprechenden Befehls- oder HTTP-Hook, einschließlich der Art und Weise, wie er mit Fehlern umgeht.

Benutzerdefinierte Unteragenten sind eine weitere Möglichkeit, wiederkehrende Aufgaben zu organisieren. Definieren Sie einen Spezialisten unter „in.claude/agents/“, wenn eine bestimmte Rolle oder ein bestimmter Tool-Umfang erforderlich ist, anstatt jede Spezialistenanweisung zur Hauptsitzung hinzuzufügen. Diese Leitfäden zum besten Claude-Modell für die Arbeit und zu den Arten von KI-Agenten bieten zusätzlichen Kontext.

Wenn Ihr Team Prompts für mehrere KI-Produkte verwaltet, sehen Sie sich diese Prompt-Engineering-Tools an, mit denen Sie Bibliotheken über Claude Code hinaus verwalten können.

Wenn eine Sitzung ein unvollständiges oder ungeeignetes Ergebnis liefert, prüfen Sie, ob in der Anforderung wichtige Entscheidungen offen geblieben sind. Diese fünf Fehler können die Diagnose und Überprüfung der Arbeit erschweren.

„Untersuche das Repository“ gibt Claude kaum Anhaltspunkte dafür, welche Dateien relevant sind oder wann es aufhören soll. Möglicherweise erhalten Sie eine allgemeine Zusammenfassung ohne Antwort auf das Problem, das Anlass für die Anfrage war.

Benennen Sie das Verhalten oder die Entscheidung, die Sie verstehen müssen, legen Sie einen Startpunkt fest und definieren Sie die erwartete Ausgabe. Beispiel: „Verfolgen Sie nach, wie dieser Endpunkt Berechtigungen prüft, und nennen Sie die entsprechenden Funktionen.“ Wenn Sie Unteragenten einsetzen, geben Sie jedem einzelnen eine abgegrenzte Frage vor, anstatt dieselbe uneingeschränkte Suche zu delegieren.

Der Wechsel zwischen einem Feature, einem nicht damit zusammenhängenden Fehler und einer Dokumentationsanfrage führt dazu, dass die Unterhaltung einen Kontext enthält, der möglicherweise nicht auf die aktuelle Aufgabe zutrifft. Verweise wie „diese Datei“ oder „der frühere Ansatz“ werden dadurch mehrdeutig.

Verwenden Sie separate Sitzungen für nicht miteinander in Zusammenhang stehende Aufgaben. Wenn mehrere Sitzungen das Repository bearbeiten, verwenden Sie separate Git-Worktrees, damit nicht dasselbe Arbeitsverzeichnis geändert wird. Eine kurze Nebenbemerkung: Der Befehl /btw von Claude Code hält den Austausch aus dem Hauptverlauf der Unterhaltung heraus.

Ein Build kann erfolgreich sein, obwohl sich ein Feature falsch verhält. Eine Testsuite kann erfolgreich sein, weil sie die fehlerhafte Eingabe nie getestet hat. Wenn man Claude auffordert, „die Tests auszuführen“, wird dadurch nicht festgestellt, welche Anforderung diese Tests überprüfen.

Ordnen Sie die Akzeptanzkriterien bestimmten Prüfungen zu. Fordern Sie bei einer Fehlerbehebung den Nachweis an, dass der Reproduktionstest vor der Änderung fehlgeschlagen ist und danach erfolgreich war. Halten Sie ungetestete Kriterien in Sicht, anstatt einen erfolgreichen Befehl als Überprüfung für die gesamte Änderung zu betrachten.

Eine ständig wachsende CLAUDE.md-Datei kann veraltete Befehle, doppelte Regeln und Anweisungen enthalten, die im Widerspruch zu aufgabenspezifischen Anforderungen stehen. Eine strengere Formulierung löst diese Konflikte nicht.

Überprüfen Sie die Datei anhand des aktuellen Repositorys. Entfernen Sie veraltete Anleitungen, klären Sie widersprüchliche Regeln und verschieben Sie nur in engen Anwendungsfällen gültige Anweisungen in Regeln oder Fähigkeiten, die auf den Pfad beschränkt sind. Wenn eine Anforderung durchgesetzt werden muss, konfigurieren und testen Sie die entsprechenden Kontrollen, anstatt sich auf wiederholte Erinnerungen zu verlassen.

Eine Überprüfung kann echte Fehler, unklare Probleme und optionale Refactoring-Vorschläge gleichzeitig aufzeigen. Die Umsetzung aller Vorschläge kann den Änderungsumfang vergrößern, ohne das gewünschte Verhalten zu verbessern.

Fragen Sie nach den Belegen und den Auswirkungen hinter jedem Befund. Priorisieren Sie Korrektheitsprobleme und nicht erfüllte Anforderungen, untersuchen Sie unklare Behauptungen und halten Sie nicht relevante Verbesserungen aus dem aktuellen Diff heraus. Ein Prüfer sollte in der Lage sein, keine umsetzbaren Befunde zu melden, wenn die Belege diese Schlussfolgerung unterstützen.

Um eine Vorlage anzupassen, ersetzen Sie deren Platzhalter durch Angaben aus Ihrem Projekt und legen Sie fest, was Claude tun soll, bevor Sie Änderungen vornehmen. Befolgen Sie diese Schritte, um die Anfrage vorzubereiten und das Ergebnis zu überprüfen.

Bei einer kleinen, klar definierten Änderung können Sie Claude bitten, diese direkt umzusetzen. Bei unbekanntem Code, Änderungen, die mehrere Dateien betreffen, oder ungeklärten Anforderungen sollten Sie zunächst einen Plan erstellen.

Drücken Sie „Umschalt+Tab“, bis der Plan-Modus angezeigt wird, oder starten Sie Claude Code mit dem Befehl „claude --permission-mode plan“. In diesem Modus kann Claude Dateien überprüfen und schreibgeschützte Befehle ausführen, ohne Ihre Code-Bearbeitung durchzuführen. Überprüfen Sie die vorgeschlagenen Dateien, Abhängigkeiten und Tests, bevor Sie die Umsetzung genehmigen. Drücken Sie „Strg+G“, um den vorgeschlagenen Plan in Ihrem Editor zu öffnen.

Geben Sie Claude die Informationen, die zum Verständnis der Aufgabe erforderlich sind: einen Dateiverweis, ein bereinigtes Fehlerprotokoll, einen Screenshot oder ein Anforderungsdokument. Verwenden Sie „@“ gefolgt von einem Dateipfad, um den Inhalt dieser Datei einzubinden.

Wählen Sie die kleinste sinnvolle Auswahl an Quellen. Das Einbeziehen eines gesamten Protokolls oder Verzeichnisses kann irrelevantes Material hinzufügen und den Kontext überfrachten. Entfernen Sie Anmeldedaten und sensible Informationen, bevor Sie Protokolle freigeben, und stellen Sie sicher, dass Claude über die erforderlichen Tools verfügt, um die von Ihnen angegebenen Dokumentations-URLs abzurufen.

Beispielsweise übermittelt der Befehl „cat Fehler.log | claude -p ‚Explain this Fehler‘“ ein Protokoll mit einer nicht-interaktiven Anfrage. Verwenden Sie ihn erst, nachdem Sie den Inhalt der Datei überprüft haben. Darin liegt der praktische Wert kontextbezogener KI: dem Modell relevante Informationen für die jeweilige Aufgabe zur Verfügung zu stellen.

Wenn Sie ein neues Feature hinzufügen, identifizieren Sie eine ähnliche Komponente oder Funktion im Repository. Teilen Sie Claude mit, welche Konventionen zu befolgen sind, beispielsweise hinsichtlich des API-Clients, der Validierungslogik, der Fehlerbehandlung oder der Teststruktur.

„Verfolgen Sie, wie @src/widgets/Weather.tsx Daten abruft und zwischenspeichert“ gibt Claude einen konkreten Anhaltspunkt. Nennen Sie außerdem alle Unterschiede, die das neue Feature erfordert, damit kein Verhalten kopiert wird, das nicht mehr passt. Diese Konventionen sollten den Softwareentwicklungs-Workflow Ihres Teams widerspiegeln.

Geben Sie bei Codeänderungen den entsprechenden Test-, Build- oder Lint-Befehl sowie das zu prüfende Verhalten an. Fordern Sie für Recherchezwecke Dateireferenzen oder Commit-IDs an. Stellen Sie bei der Arbeit an der Benutzeroberfläche ein Referenzbild sowie eine konfigurierte Methode bereit, um die Implementierung im gleichen Ansichtsbereich zu erfassen.

Bitten Sie Claude, einen Bericht über das zu erstellen, was tatsächlich geprüft wurde, einschließlich Fehlern und übersprungenen Prüfungen. Überprüfen Sie, ob die Nachweise die Anforderung abdecken; ein erfolgreicher Build bedeutet nicht, dass jedes geforderte Verhalten funktioniert.

Für umfangreichere Aufgaben bietet Claude Code außerdem eine /goal-Bedingung und Stop-Hooks. Der Zielauswerter bewertet die in der Unterhaltung zutage getretenen Hinweise, anstatt Dateien eigenständig zu überprüfen oder Tests auszuführen. Ein konfigurierter Stop-Hook kann die Fertigstellung blockieren, unterliegt jedoch Limiten hinsichtlich wiederholter Blockierungen. Beides ersetzt jedoch keine angemessenen Tests und keine Überprüfung durch Menschen.

Wenn wiederholte Korrekturen ein Problem nicht beheben, halten Sie inne und ermitteln Sie, was in der ursprünglichen Anfrage unklar geblieben ist. Speichern Sie die nützlichen Erkenntnisse, den aktuellen Git-Status und die verbleibende Arbeit, bevor Sie die Unterhaltung löschen.

Der Leitfaden für Best Practices von Anthropic empfiehlt, nach zwei erfolglosen Korrekturversuchen zum selben Problem von vorne zu beginnen. Verwenden Sie den Befehl /clear und geben Sie anschließend eine überarbeitete Eingabe an, die Ihre gewonnenen Erkenntnisse berücksichtigt. Das Löschen der Unterhaltung macht Dateiänderungen nicht rückgängig.

Drücken Sie die Esc-Taste, um eine laufende Antwort zu unterbrechen. Wenn das Eingabefeld leer ist, drücken Sie zweimal die Esc-Taste, um das Rückspulen-Menü zu öffnen und auszuwählen, was wiederhergestellt werden soll. Das Rückspulen macht nicht alle externen Auswirkungen rückgängig. Verwenden Sie daher Git-Checkpoints und separate Wiederherstellungsverfahren für Änderungen an Datenbanken oder Remote-Diensten.

Speichern Sie projektweite Richtlinien in „CLAUDE.md“, wiederholbare Abläufe in „Skills“ und Anweisungen für bestimmte Dateien in pfadbezogenen Regeln. Verwenden Sie Hooks für Aktionen, die an bestimmte Ereignisse geknüpft sind, wie beispielsweise das Ausführen eines Formatierers nach einer Bearbeitung.

Wählen Sie je nachdem aus, wann die Anweisung gelten soll:

Eine Anforderung für ein Feature gehört in der Regel in die entsprechende Aufgabe oder Spezifikation und nicht in die Datei „CLAUDE.md“. Das Hinzufügen temporärer Anweisungen zu einer projektweiten Datei erschwert es, diese von Konventionen zu unterscheiden, die im gesamten Repository gelten sollten.

Speichern Sie beispielsweise den Testbefehl des Projekts in der Datei „CLAUDE.md“, legen Sie komponentenbezogene Konventionen in einer pfadbezogenen Regel fest und speichern Sie ein wiederkehrendes Überprüfungsverfahren als „Skill“. Überprüfen Sie diese Dateien bei Änderungen an Befehlen oder Konventionen, genau wie Sie es auch bei anderer Projektdokumentation tun würden.

Prompts, CLAUDE.md und Skills steuern das Verhalten von Claude; sie garantieren jedoch nicht, dass eine Anweisung befolgt wird. Hooks können bei konfigurierten Ereignissen Prüfungen durchführen, ihre Zuverlässigkeit hängt jedoch vom Hook-Typ und der Implementierung ab.

Ein Befehlshook führt ein Skript aus. Ein Prompt- oder Agent-Hook stützt sich auf die Entscheidung eines Modells. Wie im Leitfaden zu Best Practices von Anthropic erläutert wird: „Ein Prompt- oder Agent-Hook bittet ein anderes Modell um eine Entscheidung, ist also ebenfalls nicht deterministisch.“ Verwenden Sie für eine Regel, die durchgesetzt werden muss, geeignete Berechtigungskontrollen und testen Sie den entsprechenden Befehls- oder HTTP-Hook, einschließlich der Art und Weise, wie er mit Fehlern umgeht.

Benutzerdefinierte Unteragenten sind eine weitere Möglichkeit, wiederkehrende Aufgaben zu organisieren. Definieren Sie einen Spezialisten unter „in.claude/agents/“, wenn eine spezifische Überprüfungsrolle oder ein bestimmter Tool-Umfang erforderlich ist, anstatt jede Spezialistenanweisung zur Hauptsitzung hinzuzufügen. Diese Leitfäden zum besten Claude-Modell für die Arbeit und zu den Arten von KI-Agenten bieten zusätzlichen Kontext.

Wenn Ihr Team Prompts für mehrere KI-Produkte verwaltet, sehen Sie sich diese Prompt-Engineering-Tools an, mit denen Sie Bibliotheken über Claude Code hinaus verwalten können.

Wenn eine Sitzung ein unvollständiges oder ungeeignetes Ergebnis liefert, prüfen Sie, ob in der Anforderung wichtige Entscheidungen offen geblieben sind. Diese fünf Fehler können die Diagnose und Überprüfung der Arbeit erschweren.

„Untersuche das Repository“ gibt Claude kaum Anhaltspunkte dafür, welche Dateien relevant sind oder wann es aufhören soll. Möglicherweise erhalten Sie eine allgemeine Zusammenfassung ohne Antwort auf das Problem, das Anlass für die Anfrage war.

Benennen Sie das Verhalten oder die Entscheidung, die Sie verstehen müssen, legen Sie einen Startpunkt fest und definieren Sie die erwartete Ausgabe. Beispiel: „Verfolgen Sie nach, wie dieser Endpunkt Berechtigungen prüft, und nennen Sie die entsprechenden Funktionen.“ Wenn Sie Unteragenten einsetzen, geben Sie jedem einzelnen eine abgegrenzte Frage vor, anstatt dieselbe uneingeschränkte Suche zu delegieren.

Der Wechsel zwischen einem Feature, einem nicht damit zusammenhängenden Fehler und einer Dokumentationsanfrage führt dazu, dass die Unterhaltung einen Kontext enthält, der möglicherweise nicht auf die aktuelle Aufgabe zutrifft. Verweise wie „diese Datei“ oder „der frühere Ansatz“ werden dadurch mehrdeutig.

Verwenden Sie separate Sitzungen für nicht miteinander in Zusammenhang stehende Aufgaben. Wenn mehrere Sitzungen das Repository bearbeiten, verwenden Sie separate Git-Worktrees, damit nicht dasselbe Arbeitsverzeichnis geändert wird. Eine kurze Nebenbemerkung: Der Befehl /btw von Claude Code hält den Austausch aus dem Hauptverlauf der Unterhaltung heraus.

Ein Build kann erfolgreich sein, obwohl sich ein Feature fehlerhaft verhält. Eine Testsuite kann erfolgreich sein, weil sie die fehlerhafte Eingabe nie getestet hat. Wenn man Claude auffordert, „die Tests auszuführen“, wird dadurch nicht klar, welche Anforderung diese Tests überprüfen.

Ordnen Sie die Akzeptanzkriterien bestimmten Prüfungen zu. Fordern Sie bei einer Fehlerbehebung den Nachweis an, dass der Reproduktionstest vor der Änderung fehlgeschlagen ist und danach erfolgreich war. Halten Sie ungetestete Kriterien in Sichtbarkeit, anstatt einen erfolgreichen Befehl als Überprüfung für die gesamte Änderung zu betrachten.

Eine ständig wachsende CLAUDE.md-Datei kann veraltete Befehle, doppelte Regeln und Anweisungen enthalten, die im Widerspruch zu aufgabenspezifischen Anforderungen stehen. Eine strengere Formulierung löst diese Konflikte nicht.

Überprüfen Sie die Datei anhand des aktuellen Repositorys. Entfernen Sie veraltete Anleitungen, klären Sie widersprüchliche Regeln und verschieben Sie nur in engen Anwendungsfällen gültige Anweisungen in Regeln oder Fähigkeiten, die auf den Pfad beschränkt sind. Wenn eine Anforderung durchgesetzt werden muss, konfigurieren und testen Sie die entsprechenden Kontrollen, anstatt sich auf wiederholte Erinnerungen zu verlassen.

Eine Überprüfung kann echte Fehler, unklare Probleme und optionale Refactoring-Vorschläge gleichzeitig aufzeigen. Die Umsetzung aller Vorschläge kann den Änderungsumfang vergrößern, ohne das gewünschte Verhalten zu verbessern.

Fragen Sie nach den Belegen und den Auswirkungen hinter jedem Befund. Priorisieren Sie Korrektheitsprobleme und nicht erfüllte Anforderungen, untersuchen Sie unklare Behauptungen und halten Sie nicht relevante Verbesserungen aus dem aktuellen Diff heraus. Ein Prüfer sollte in der Lage sein, keine umsetzbaren Befunde zu melden, wenn die Belege diese Schlussfolgerung unterstützen.

Um eine Vorlage anzupassen, ersetzen Sie deren Platzhalter durch Angaben aus Ihrem Projekt und legen Sie fest, was Claude zu erledigen hat, bevor Sie Änderungen vornehmen. Befolgen Sie diese Schritte, um die Anfrage vorzubereiten und das Ergebnis zu überprüfen.

Bei einer kleinen, klar definierten Änderung können Sie Claude bitten, diese direkt umzusetzen. Bei unbekanntem Code, Änderungen, die mehrere Dateien betreffen, oder ungeklärten Anforderungen sollten Sie zunächst einen Plan erstellen.

Drücken Sie „Umschalt+Tab“, bis der Plan-Modus angezeigt wird, oder starten Sie Claude Code mit dem Befehl „claude --permission-mode plan“. In diesem Modus kann Claude Dateien überprüfen und schreibgeschützte Befehle ausführen, ohne Ihre Code-Bearbeitung durchzuführen. Überprüfen Sie die vorgeschlagenen Dateien, Abhängigkeiten und Tests, bevor Sie die Umsetzung genehmigen. Drücken Sie „Strg+G“, um den vorgeschlagenen Plan in Ihrem Editor zu öffnen.

Geben Sie Claude die Informationen, die zum Verständnis der Aufgabe erforderlich sind: einen Dateiverweis, ein bereinigtes Fehlerprotokoll, einen Screenshot oder ein Anforderungsdokument. Verwenden Sie „@“, gefolgt von einem Dateipfad, um den Inhalt dieser Datei einzufügen.

Wählen Sie die kleinste sinnvolle Auswahl an Quellen aus. Das Einbeziehen eines gesamten Protokolls oder Verzeichnisses kann irrelevantes Material hinzufügen und den Kontext überfrachten. Entfernen Sie Anmeldedaten und sensible Informationen, bevor Sie Protokolle freigeben, und stellen Sie sicher, dass Claude über die erforderlichen Tools verfügt, um die von Ihnen angegebenen Dokumentations-URLs abzurufen.

Beispielsweise übermittelt der Befehl „cat Fehler.log | claude -p ‚Explain this Fehler‘“ ein Protokoll mit einer nicht-interaktiven Anfrage. Verwenden Sie ihn erst, nachdem Sie den Inhalt der Datei überprüft haben. Darin liegt der praktische Wert kontextbezogener KI: dem Modell relevante Informationen für die jeweilige Aufgabe zur Verfügung zu stellen.

Wenn Sie ein neues Feature hinzufügen, identifizieren Sie eine ähnliche Komponente oder Funktion im Repository. Teilen Sie Claude mit, welche Konventionen zu befolgen sind, beispielsweise hinsichtlich des API-Clients, der Validierungslogik, der Fehlerbehandlung oder der Teststruktur.

„Verfolgen Sie, wie @src/widgets/Weather.tsx Daten abruft und zwischenspeichert“ gibt Claude einen konkreten Anhaltspunkt. Nennen Sie außerdem alle Unterschiede, die das neue Feature erfordert, damit kein Verhalten kopiert wird, das nicht mehr passt. Diese Konventionen sollten den Softwareentwicklungs-Workflow Ihres Teams widerspiegeln.

Geben Sie bei Codeänderungen den entsprechenden Test-, Build- oder Lint-Befehl sowie das zu prüfende Verhalten an. Fordern Sie für Recherchezwecke Dateireferenzen oder Commit-IDs an. Stellen Sie bei der Arbeit an der Benutzeroberfläche ein Referenzbild sowie eine konfigurierte Methode bereit, um die Implementierung im gleichen Ansichtsbereich zu erfassen.

Bitten Sie Claude, einen Bericht über das zu erstellen, was tatsächlich geprüft wurde, einschließlich Fehlern und übersprungenen Prüfungen. Überprüfen Sie, ob die Nachweise die Anforderung abdecken; ein erfolgreicher Build bedeutet nicht, dass jedes geforderte Verhalten funktioniert.

Für umfangreichere Aufgaben bietet Claude Code außerdem eine /goal-Bedingung und Stop-Hooks. Der Zielauswerter bewertet die während der Unterhaltung zutage getretenen Hinweise, anstatt Dateien eigenständig zu überprüfen oder Tests auszuführen. Ein konfigurierter Stop-Hook kann die Fertigstellung blockieren, unterliegt jedoch Limiten hinsichtlich wiederholter Blockierungen. Beides ersetzt jedoch keine angemessenen Tests und keine Überprüfung durch Menschen.

Wenn wiederholte Korrekturen ein Problem nicht beheben, halten Sie inne und ermitteln Sie, was in der ursprünglichen Anfrage unklar geblieben ist. Speichern Sie die nützlichen Erkenntnisse, den aktuellen Git-Status und die verbleibenden Arbeiten, bevor Sie die Unterhaltung löschen.

Der Leitfaden für Best Practices von Anthropic empfiehlt, nach zwei erfolglosen Korrekturversuchen zum selben Problem von vorne zu beginnen. Verwenden Sie den Befehl /clear und geben Sie anschließend eine überarbeitete Eingabe an, die Ihre gewonnenen Erkenntnisse berücksichtigt. Das Löschen der Unterhaltung macht Dateiänderungen nicht rückgängig.

Drücken Sie die Esc-Taste, um eine laufende Antwort zu unterbrechen. Wenn das Eingabefeld leer ist, drücken Sie zweimal die Esc-Taste, um das Rückspulen-Menü zu öffnen und auszuwählen, was wiederhergestellt werden soll. Das Rückspulen macht nicht alle externen Auswirkungen rückgängig. Verwenden Sie daher Git-Checkpoints und separate Wiederherstellungsverfahren für Änderungen an Datenbanken oder Remote-Diensten.

Speichern Sie projektweite Richtlinien in „CLAUDE.md“, wiederholbare Abläufe in „Skills“ und Anweisungen für bestimmte Dateien in pfadbezogenen Regeln. Verwenden Sie Hooks für Aktionen, die an bestimmte Ereignisse geknüpft sind, wie beispielsweise das Ausführen eines Formatierers nach einer Bearbeitung.

Wählen Sie je nachdem aus, wann die Anweisung gelten soll:

Eine Anforderung für ein Feature gehört in der Regel in die entsprechende Aufgabe oder Spezifikation und nicht in die Datei „CLAUDE.md“. Das Hinzufügen temporärer Anweisungen zu einer projektweiten Datei erschwert es, diese von Konventionen zu unterscheiden, die im gesamten Repository gelten sollten.

Beispiel: Speichern Sie den Testbefehl des Projekts in der Datei „CLAUDE.md“, legen Sie komponentenbezogene Konventionen in einer pfadbezogenen Regel fest und speichern Sie ein wiederkehrendes Überprüfungsverfahren als „Skill“. Überprüfen Sie diese Dateien bei Änderungen an Befehlen oder Konventionen, genau wie Sie es auch bei anderer Projektdokumentation tun würden.

Prompts, CLAUDE.md und Skills steuern das Verhalten von Claude; sie garantieren jedoch nicht, dass eine Anweisung befolgt wird. Hooks können bei konfigurierten Ereignissen Prüfungen durchführen, ihre Zuverlässigkeit hängt jedoch vom Hook-Typ und der Implementierung ab.

Ein Befehlshook führt ein Skript aus. Ein Prompt- oder Agent-Hook stützt sich auf die Entscheidung eines Modells. Wie im Leitfaden zu Best Practices von Anthropic erläutert wird: „Ein Prompt- oder Agent-Hook bittet ein anderes Modell um eine Entscheidung, ist also ebenfalls nicht deterministisch.“ Verwenden Sie für eine Regel, die durchgesetzt werden muss, geeignete Berechtigungskontrollen und testen Sie den entsprechenden Befehls- oder HTTP-Hook, einschließlich der Art und Weise, wie er mit Fehlern umgeht.

Benutzerdefinierte Unteragenten sind eine weitere Möglichkeit, wiederkehrende Aufgaben zu organisieren. Definieren Sie einen Spezialisten unter „in.claude/agents/“, wenn eine spezifische Überprüfungsrolle oder ein bestimmter Tool-Umfang erforderlich ist, anstatt jede Spezialistenanweisung zur Hauptsitzung hinzuzufügen. Diese Leitfäden zum besten Claude-Modell für die Arbeit und zu den Arten von KI-Agenten bieten zusätzlichen Kontext.

Wenn Ihr Team Prompts für mehrere KI-Produkte verwaltet, sehen Sie sich diese Prompt-Engineering-Tools an, mit denen Sie Bibliotheken über Claude Code hinaus verwalten können.

Wenn eine Sitzung ein unvollständiges oder ungeeignetes Ergebnis liefert, prüfen Sie, ob in der Anforderung wichtige Entscheidungen offen geblieben sind. Diese fünf Fehler können die Diagnose und Überprüfung der Arbeit erschweren.

„Untersuche das Repository“ gibt Claude kaum Anhaltspunkte dafür, welche Dateien relevant sind oder wann es aufhören soll. Möglicherweise erhalten Sie eine allgemeine Zusammenfassung ohne Antwort auf das Problem, das Anlass für die Anfrage war.

Benennen Sie das Verhalten oder die Entscheidung, die Sie verstehen müssen, legen Sie einen Startpunkt fest und definieren Sie die erwartete Ausgabe. Beispiel: „Verfolgen Sie nach, wie dieser Endpunkt Berechtigungen prüft, und nennen Sie die entsprechenden Funktionen.“ Wenn Sie Unteragenten einsetzen, geben Sie jedem einzelnen eine abgegrenzte Frage vor, anstatt dieselbe uneingeschränkte Suche zu delegieren.

Der Wechsel zwischen einem Feature, einem nicht damit zusammenhängenden Fehler und einer Dokumentationsanfrage führt dazu, dass die Unterhaltung einen Kontext enthält, der möglicherweise nicht auf die aktuelle Aufgabe zutrifft. Verweise wie „diese Datei“ oder „der frühere Ansatz“ werden dadurch mehrdeutig.

Verwenden Sie separate Sitzungen für nicht miteinander in Zusammenhang stehende Aufgaben. Wenn mehrere Sitzungen das Repository bearbeiten, verwenden Sie separate Git-Worktrees, damit nicht dasselbe Arbeitsverzeichnis geändert wird. Eine kurze Nebenbemerkung: Der Befehl /btw von Claude Code hält den Austausch aus dem Hauptverlauf der Unterhaltung heraus.

Ein Build kann erfolgreich sein, obwohl sich ein Feature falsch verhält. Eine Testsuite kann erfolgreich sein, weil sie die fehlerhafte Eingabe nie getestet hat. Wenn man Claude auffordert, „die Tests auszuführen“, wird dadurch nicht festgestellt, welche Anforderung diese Tests überprüfen.

Ordnen Sie die Akzeptanzkriterien bestimmten Prüfungen zu. Fordern Sie bei einer Fehlerbehebung den Nachweis an, dass der Reproduktionstest vor der Änderung fehlgeschlagen ist und danach erfolgreich war. Halten Sie ungetestete Kriterien in Sichtbarkeit, anstatt einen erfolgreichen Befehl als Überprüfung für die gesamte Änderung zu betrachten.

Eine ständig wachsende CLAUDE.md-Datei kann veraltete Befehle, doppelte Regeln und Anweisungen enthalten, die im Widerspruch zu aufgabenspezifischen Anforderungen stehen. Eine strengere Formulierung löst diese Konflikte nicht.

Überprüfen Sie die Datei anhand des aktuellen Repositorys. Entfernen Sie veraltete Anleitungen, klären Sie widersprüchliche Regeln und verschieben Sie nur in engen Anwendungsfällen gültige Anweisungen in Regeln oder Fähigkeiten mit Pfadgültigkeit. Wenn eine Anforderung durchgesetzt werden muss, konfigurieren und testen Sie die entsprechenden Kontrollen, anstatt sich auf wiederholte Erinnerungen zu verlassen.

Eine Überprüfung kann echte Fehler, unklare Probleme und optionale Refactoring-Vorschläge gleichzeitig aufzeigen. Die Umsetzung aller Vorschläge kann den Änderungsumfang vergrößern, ohne das gewünschte Verhalten zu verbessern.

Fragen Sie nach den Belegen und den Auswirkungen hinter jedem Befund. Priorisieren Sie Korrektheitsprobleme und nicht erfüllte Anforderungen, untersuchen Sie unklare Behauptungen und halten Sie nicht relevante Verbesserungen aus dem aktuellen Diff heraus. Ein Prüfer sollte in der Lage sein, keine umsetzbaren Befunde zu melden, wenn die Belege diese Schlussfolgerung unterstützen.

Um eine Vorlage anzupassen, ersetzen Sie deren Platzhalter durch Angaben aus Ihrem Projekt und legen Sie fest, was Claude tun soll, bevor Sie Änderungen vornehmen. Befolgen Sie diese Schritte, um die Anfrage vorzubereiten und das Ergebnis zu überprüfen.

Bei einer kleinen, klar definierten Änderung können Sie Claude bitten, diese direkt umzusetzen. Bei unbekanntem Code, Änderungen, die mehrere Dateien betreffen, oder ungeklärten Anforderungen sollten Sie zunächst einen Plan erstellen.

Drücken Sie „Umschalt+Tab“, bis der Plan-Modus angezeigt wird, oder starten Sie Claude Code mit dem Befehl „claude --permission-mode plan“. In diesem Modus kann Claude Dateien überprüfen und schreibgeschützte Befehle ausführen, ohne Ihre Code-Bearbeitung durchzuführen. Überprüfen Sie die vorgeschlagenen Dateien, Abhängigkeiten und Tests, bevor Sie die Umsetzung genehmigen. Drücken Sie „Strg+G“, um den vorgeschlagenen Plan in Ihrem Editor zu öffnen.

Geben Sie Claude die Informationen, die zum Verständnis der Aufgabe erforderlich sind: einen Dateiverweis, ein bereinigtes Fehlerprotokoll, einen Screenshot oder ein Anforderungsdokument. Verwenden Sie „@“, gefolgt von einem Dateipfad, um den Inhalt dieser Datei einzufügen.

Wählen Sie die kleinste sinnvolle Auswahl an Quellen aus. Das Einbeziehen eines gesamten Protokolls oder Verzeichnisses kann irrelevantes Material hinzufügen und den Kontext überfrachten. Entfernen Sie Anmeldedaten und sensible Informationen, bevor Sie Protokolle freigeben, und stellen Sie sicher, dass Claude über die erforderlichen Tools verfügt, um die von Ihnen angegebenen Dokumentations-URLs abzurufen.

Beispielsweise übermittelt der Befehl „cat error.log | claude -p ‚Explain this Fehler‘“ ein Protokoll mit einer nicht-interaktiven Anfrage. Verwenden Sie ihn erst, nachdem Sie den Inhalt der Datei überprüft haben. Darin liegt der praktische Wert kontextbezogener KI: dem Modell relevante Informationen für die jeweilige Aufgabe zur Verfügung zu stellen.

Wenn Sie ein neues Feature hinzufügen, identifizieren Sie eine ähnliche Komponente oder Funktion im Repository. Teilen Sie Claude mit, welche Konventionen zu befolgen sind, beispielsweise hinsichtlich des API-Clients, der Validierungslogik, der Fehlerbehandlung oder der Teststruktur.

„Verfolgen Sie, wie @src/widgets/Weather.tsx Daten abruft und zwischenspeichert“ gibt Claude einen konkreten Anhaltspunkt. Nennen Sie außerdem alle Unterschiede, die das neue Feature erfordert, damit kein Verhalten kopiert wird, das nicht mehr passt. Diese Konventionen sollten den Softwareentwicklungs-Workflow Ihres Teams widerspiegeln.

Geben Sie bei Codeänderungen den entsprechenden Test-, Build- oder Lint-Befehl sowie das zu prüfende Verhalten an. Fordern Sie für Recherchezwecke Dateireferenzen oder Commit-IDs an. Stellen Sie bei der Arbeit an der Benutzeroberfläche ein Referenzbild sowie eine konfigurierte Methode zur Verfügung, um die Implementierung im gleichen Ansichtsbereich zu erfassen.

Bitten Sie Claude, einen Bericht über das zu erstellen, was tatsächlich geprüft wurde, einschließlich Fehlern und übersprungenen Prüfungen. Überprüfen Sie, ob die Nachweise die Anforderung abdecken; ein erfolgreicher Build bedeutet nicht, dass jedes geforderte Verhalten funktioniert.

Für umfangreichere Aufgaben bietet Claude Code außerdem eine /goal-Bedingung und Stop-Hooks. Der Zielauswerter bewertet die während der Unterhaltung zutage getretenen Hinweise, anstatt Dateien eigenständig zu überprüfen oder Tests auszuführen. Ein konfigurierter Stop-Hook kann die Fertigstellung blockieren, unterliegt jedoch Limiten hinsichtlich wiederholter Blockierungen. Beides ersetzt jedoch keine angemessenen Tests und keine Überprüfung durch Menschen.

Wenn wiederholte Korrekturen ein Problem nicht beheben, halten Sie inne und ermitteln Sie, was in der ursprünglichen Anfrage unklar geblieben ist. Speichern Sie die nützlichen Erkenntnisse, den aktuellen Git-Status und die verbleibende Arbeit, bevor Sie die Unterhaltung löschen.

Der Leitfaden für Best Practices von Anthropic empfiehlt, nach zwei erfolglosen Korrekturversuchen zum selben Problem von vorne zu beginnen. Verwenden Sie den Befehl /clear und geben Sie anschließend eine überarbeitete Eingabe an, die Ihre gewonnenen Erkenntnisse berücksichtigt. Das Löschen der Unterhaltung macht Dateiänderungen nicht rückgängig.

Drücken Sie die Esc-Taste, um eine laufende Antwort zu unterbrechen. Wenn das Eingabefeld leer ist, drücken Sie zweimal die Esc-Taste, um das Rückspulen-Menü zu öffnen und auszuwählen, was wiederhergestellt werden soll. Das Rückspulen macht nicht alle externen Auswirkungen rückgängig. Verwenden Sie daher Git-Checkpoints und separate Wiederherstellungsverfahren für Änderungen an Datenbanken oder Remote-Diensten.

Speichern Sie projektweite Richtlinien in „CLAUDE.md“, wiederholbare Abläufe in „Skills“ und Anweisungen für bestimmte Dateien in pfadbezogenen Regeln. Verwenden Sie Hooks für Aktionen, die an bestimmte Ereignisse geknüpft sind, wie beispielsweise das Ausführen eines Formatierers nach einer Bearbeitung.

Wählen Sie je nachdem aus, wann die Anweisung gelten soll:

Eine Anforderung für ein Feature gehört in der Regel in die entsprechende Aufgabe oder Spezifikation und nicht in die Datei „CLAUDE.md“. Das Hinzufügen temporärer Anweisungen zu einer projektweiten Datei erschwert es, diese von Konventionen zu unterscheiden, die im gesamten Repository gelten sollten.

Speichern Sie beispielsweise den Testbefehl des Projekts in der Datei „CLAUDE.md“, legen Sie komponentenbezogene Konventionen in einer pfadbezogenen Regel fest und speichern Sie ein wiederkehrendes Überprüfungsverfahren als „Skill“. Überprüfen Sie diese Dateien bei Änderungen an Befehlen oder Konventionen, genau wie Sie es auch bei anderer Projektdokumentation tun würden.

Prompts, CLAUDE.md und Skills steuern das Verhalten von Claude; sie garantieren jedoch nicht, dass eine Anweisung befolgt wird. Hooks können bei konfigurierten Ereignissen Prüfungen durchführen, ihre Zuverlässigkeit hängt jedoch vom Hook-Typ und der Implementierung ab.

Ein Befehlshook führt ein Skript aus. Ein Prompt- oder Agent-Hook stützt sich auf die Entscheidung eines Modells. Wie im Leitfaden zu Best Practices von Anthropic erläutert wird: „Ein Prompt- oder Agent-Hook bittet ein anderes Modell um eine Entscheidung, ist also ebenfalls nicht deterministisch.“ Verwenden Sie für eine Regel, die durchgesetzt werden muss, geeignete Berechtigungskontrollen und testen Sie den entsprechenden Befehls- oder HTTP-Hook, einschließlich der Art und Weise, wie er mit Fehlern umgeht.

Benutzerdefinierte Unteragenten sind eine weitere Möglichkeit, wiederkehrende Aufgaben zu organisieren. Definieren Sie einen Spezialisten unter „in.claude/agents/“, wenn eine eigene Überprüfungsrolle oder ein eigener Tool-Umfang erforderlich ist, anstatt jede Spezialistenanweisung zur Hauptsitzung hinzuzufügen. Diese Leitfäden zum besten Claude-Modell für die Arbeit und zu den Arten von KI-Agenten bieten zusätzlichen Kontext.

Wenn Ihr Team Prompts für mehrere KI-Produkte verwaltet, sehen Sie sich diese Prompt-Engineering-Tools an, mit denen Sie Bibliotheken über Claude Code hinaus verwalten können.

Wenn eine Sitzung ein unvollständiges oder ungeeignetes Ergebnis liefert, prüfen Sie, ob in der Anforderung wichtige Entscheidungen offen geblieben sind. Diese fünf Fehler können die Diagnose und Überprüfung der Arbeit erschweren.

„Untersuche das Repository“ gibt Claude kaum Anhaltspunkte dafür, welche Dateien relevant sind oder wann es aufhören soll. Möglicherweise erhalten Sie eine allgemeine Zusammenfassung ohne Antwort auf das Problem, das Anlass für die Anfrage war.

Benennen Sie das Verhalten oder die Entscheidung, die Sie verstehen müssen, legen Sie einen Startpunkt fest und definieren Sie die erwartete Ausgabe. Beispiel: „Verfolgen Sie nach, wie dieser Endpunkt Berechtigungen prüft, und nennen Sie die entsprechenden Funktionen.“ Wenn Sie Unteragenten einsetzen, geben Sie jedem einzelnen eine abgegrenzte Frage vor, anstatt dieselbe uneingeschränkte Suche zu delegieren.

Der Wechsel zwischen einem Feature, einem nicht damit zusammenhängenden Fehler und einer Dokumentationsanfrage führt dazu, dass die Unterhaltung einen Kontext enthält, der möglicherweise nicht auf die aktuelle Aufgabe zutrifft. Verweise wie „diese Datei“ oder „der frühere Ansatz“ werden dadurch mehrdeutig.

Verwenden Sie separate Sitzungen für nicht miteinander in Zusammenhang stehende Aufgaben. Wenn mehrere Sitzungen das Repository bearbeiten, verwenden Sie separate Git-Worktrees, damit nicht dasselbe Arbeitsverzeichnis geändert wird. Eine kurze Nebenbemerkung: Der Befehl /btw von Claude Code hält den Austausch aus dem Hauptverlauf der Unterhaltung heraus.

Ein Build kann erfolgreich sein, obwohl sich ein Feature fehlerhaft verhält. Eine Testsuite kann erfolgreich sein, weil sie die fehlerhafte Eingabe nie getestet hat. Wenn man Claude auffordert, „die Tests auszuführen“, wird dadurch nicht klar, welche Anforderung diese Tests überprüfen.

Ordnen Sie die Akzeptanzkriterien bestimmten Prüfungen zu. Fordern Sie bei einer Fehlerbehebung den Nachweis an, dass der Reproduktionstest vor der Änderung fehlgeschlagen ist und danach erfolgreich war. Behalten Sie ungetestete Kriterien im Blick, anstatt einen erfolgreichen Befehl als Überprüfung für die gesamte Änderung zu betrachten.

Eine ständig wachsende CLAUDE.md-Datei kann veraltete Befehle, doppelte Regeln und Anweisungen enthalten, die im Widerspruch zu aufgabenspezifischen Anforderungen stehen. Eine strengere Formulierung löst diese Konflikte nicht.

Überprüfen Sie die Datei anhand des aktuellen Repositorys. Entfernen Sie veraltete Anleitungen, klären Sie widersprüchliche Regeln und verschieben Sie nur in engen Anwendungsfällen gültige Anweisungen in Regeln oder Fähigkeiten, die auf den Pfad beschränkt sind. Wenn eine Anforderung durchgesetzt werden muss, konfigurieren und testen Sie die entsprechenden Kontrollen, anstatt sich auf wiederholte Erinnerungen zu verlassen.

Eine Überprüfung kann echte Fehler, unklare Probleme und optionale Refactoring-Vorschläge gleichzeitig aufzeigen. Die Umsetzung aller Vorschläge kann den Änderungsumfang vergrößern, ohne das gewünschte Verhalten zu verbessern.

Fragen Sie nach den Belegen und den Auswirkungen hinter jedem Befund. Priorisieren Sie Korrektheitsprobleme und nicht erfüllte Anforderungen, untersuchen Sie unklare Behauptungen und halten Sie nicht relevante Verbesserungen aus dem aktuellen Diff heraus. Ein Prüfer sollte in der Lage sein, keine umsetzbaren Befunde zu melden, wenn die Belege diese Schlussfolgerung unterstützen.

So verfassen Sie eine Claude-Code-Anweisung in fünf Schritten

Um eine Vorlage anzupassen, ersetzen Sie deren Platzhalter durch Angaben aus Ihrem Projekt und legen Sie fest, was Claude zu erledigen hat, bevor Sie Änderungen vornehmen. Befolgen Sie diese Schritte, um die Anfrage vorzubereiten und das Ergebnis zu überprüfen.

Bei einer kleinen, klar definierten Änderung können Sie Claude bitten, diese direkt umzusetzen. Bei unbekanntem Code, Änderungen, die mehrere Dateien betreffen, oder ungeklärten Anforderungen sollten Sie zunächst einen Plan erstellen.

Drücken Sie „Umschalt+Tab“, bis der Plan-Modus angezeigt wird, oder starten Sie Claude Code mit dem Befehl „claude --permission-mode plan“. In diesem Modus kann Claude Dateien überprüfen und schreibgeschützte Befehle ausführen, ohne Ihre Code-Bearbeitung durchzuführen. Überprüfen Sie die vorgeschlagenen Dateien, Abhängigkeiten und Tests, bevor Sie die Umsetzung genehmigen. Drücken Sie „Strg+G“, um den vorgeschlagenen Plan in Ihrem Editor zu öffnen.

Geben Sie Claude die Informationen, die zum Verständnis der Aufgabe erforderlich sind: einen Dateiverweis, ein bereinigtes Fehlerprotokoll, einen Screenshot oder ein Anforderungsdokument. Verwenden Sie „@“, gefolgt von einem Dateipfad, um den Inhalt dieser Datei einzufügen.

Wählen Sie die kleinste sinnvolle Auswahl an Quellen aus. Das Einbeziehen eines gesamten Protokolls oder Verzeichnisses kann irrelevantes Material hinzufügen und den Kontext überfrachten. Entfernen Sie Anmeldedaten und sensible Informationen, bevor Sie Protokolle freigeben, und stellen Sie sicher, dass Claude über die erforderlichen tools verfügt, um die von Ihnen angegebenen Dokumentations-URLs abzurufen.

Beispielsweise übermittelt der Befehl „cat error.log | claude -p ‚Explain this Fehler‘“ ein Protokoll mit einer nicht-interaktiven Anfrage. Verwenden Sie ihn erst, nachdem Sie den Inhalt der Datei überprüft haben. Darin liegt der praktische Wert kontextbezogener KI: dem Modell relevante Informationen für die jeweilige Aufgabe zur Verfügung zu stellen.

Wenn Sie ein neues Feature hinzufügen, identifizieren Sie eine ähnliche Komponente oder Funktion im Repository. Teilen Sie Claude mit, welche Konventionen zu befolgen sind, beispielsweise hinsichtlich des API-Clients, der Validierungslogik, der Fehlerbehandlung oder der Teststruktur.

„Verfolgen Sie, wie @src/widgets/Weather.tsx Daten abruft und zwischenspeichert“ gibt Claude einen konkreten Anhaltspunkt. Nennen Sie außerdem alle Unterschiede, die das neue Feature erfordert, damit kein Verhalten kopiert wird, das nicht mehr passt. Diese Konventionen sollten den Softwareentwicklungs-Workflow Ihres Teams widerspiegeln.

Geben Sie bei Codeänderungen den entsprechenden Test-, Build- oder Lint-Befehl sowie das zu prüfende Verhalten an. Fordern Sie für Recherchezwecke Dateireferenzen oder Commit-IDs an. Stellen Sie bei der Arbeit an der Benutzeroberfläche ein Referenzbild sowie eine konfigurierte Methode zur Verfügung, um die Implementierung im gleichen Ansichtsbereich zu erfassen.

Bitten Sie Claude, einen Bericht über das zu erstellen, was tatsächlich geprüft wurde, einschließlich Fehlern und übersprungenen Prüfungen. Überprüfen Sie, ob die Nachweise die Anforderung abdecken; ein erfolgreicher Build bedeutet nicht, dass jedes geforderte Verhalten funktioniert.

Für umfangreichere Aufgaben bietet Claude Code außerdem eine /goal-Bedingung und Stop-Hooks. Der Zielauswerter bewertet die in der Unterhaltung zutage getretenen Hinweise, anstatt Dateien eigenständig zu überprüfen oder Tests auszuführen. Ein konfigurierter Stop-Hook kann die Fertigstellung blockieren, unterliegt jedoch Limiten hinsichtlich wiederholter Blockierungen. Beides ersetzt jedoch keine angemessenen Tests und keine Überprüfung durch Menschen.

Wenn wiederholte Korrekturen ein Problem nicht beheben, halten Sie inne und ermitteln Sie, was in der ursprünglichen Anfrage unklar geblieben ist. Speichern Sie die nützlichen Erkenntnisse, den aktuellen Git-Status und die verbleibende Arbeit, bevor Sie die Unterhaltung löschen.

Der Leitfaden für Best Practices von Anthropic empfiehlt, nach zwei erfolglosen Korrekturversuchen zum selben Problem von vorne zu beginnen. Verwenden Sie den Befehl /clear und geben Sie anschließend eine überarbeitete Eingabe an, die Ihre gewonnenen Erkenntnisse berücksichtigt. Das Löschen der Unterhaltung macht Dateiänderungen nicht rückgängig.

Drücken Sie die Esc-Taste, um eine laufende Antwort zu unterbrechen. Wenn das Eingabefeld leer ist, drücken Sie zweimal die Esc-Taste, um das Rückspulmenü zu öffnen und auszuwählen, was wiederhergestellt werden soll. Das Zurückspulen macht nicht alle externen Auswirkungen rückgängig. Verwenden Sie daher Git-Checkpoints und separate Wiederherstellungsverfahren für Änderungen an Datenbanken oder Remote-Diensten.

Speichern Sie projektweite Richtlinien in „CLAUDE.md“, wiederholbare Abläufe in „Skills“ und Anweisungen für bestimmte Dateien in pfadbezogenen Regeln. Verwenden Sie Hooks für Aktionen, die an bestimmte Ereignisse geknüpft sind, wie beispielsweise das Ausführen eines Formatierers nach einer Bearbeitung.

Wählen Sie je nachdem aus, wann die Anweisung gelten soll:

Eine Anforderung für ein Feature gehört in der Regel in die entsprechende Aufgabe oder Spezifikation und nicht in die Datei „CLAUDE.md“. Das Hinzufügen temporärer Anweisungen zu einer projektweiten Datei erschwert es, diese von Konventionen zu unterscheiden, die im gesamten Repository gelten sollten.

Speichern Sie beispielsweise den Testbefehl des Projekts in der Datei „CLAUDE.md“, legen Sie komponentenbezogene Konventionen in einer pfadbezogenen Regel fest und speichern Sie ein wiederkehrendes Überprüfungsverfahren als „Skill“. Überprüfen Sie diese Dateien bei Änderungen an Befehlen oder Konventionen, genau wie Sie es auch bei anderer Projektdokumentation tun würden.

Prompts, CLAUDE.md und Skills steuern das Verhalten von Claude; sie garantieren jedoch nicht, dass eine Anweisung befolgt wird. Hooks können bei konfigurierten Ereignissen Prüfungen durchführen, ihre Zuverlässigkeit hängt jedoch vom Hook-Typ und der Implementierung ab.

Ein Befehlshook führt ein Skript aus. Ein Prompt- oder Agent-Hook stützt sich auf die Entscheidung eines Modells. Wie im Leitfaden zu Best Practices von Anthropic erläutert wird: „Ein Prompt- oder Agent-Hook bittet ein anderes Modell um eine Entscheidung, ist also ebenfalls nicht deterministisch.“ Verwenden Sie für eine Regel, die durchgesetzt werden muss, geeignete Berechtigungskontrollen und testen Sie den entsprechenden Befehls- oder HTTP-Hook, einschließlich der Art und Weise, wie er mit Fehlern umgeht.

Benutzerdefinierte Unteragenten sind eine weitere Möglichkeit, wiederkehrende Aufgaben zu organisieren. Definieren Sie einen Spezialisten unter „in.claude/agents/“, wenn eine spezifische Überprüfungsrolle oder ein bestimmter Tool-Umfang erforderlich ist, anstatt jede Spezialistenanweisung zur Hauptsitzung hinzuzufügen. Diese Leitfäden zum besten Claude-Modell für die Arbeit und zu den Arten von KI-Agenten bieten zusätzlichen Kontext.

Wenn Ihr Team Prompts für mehrere KI-Produkte verwaltet, sehen Sie sich diese Prompt-Engineering-Tools an, mit denen Sie Bibliotheken über Claude Code hinaus verwalten können.

Wenn eine Sitzung ein unvollständiges oder ungeeignetes Ergebnis liefert, prüfen Sie, ob in der Anforderung wichtige Entscheidungen offen geblieben sind. Diese fünf Fehler können die Diagnose und Überprüfung der Arbeit erschweren.

„Untersuche das Repository“ gibt Claude kaum Anhaltspunkte dafür, welche Dateien relevant sind oder wann es aufhören soll. Möglicherweise erhalten Sie eine allgemeine Zusammenfassung ohne Antwort auf das Problem, das Anlass für die Anfrage war.

Benennen Sie das Verhalten oder die Entscheidung, die Sie verstehen müssen, legen Sie einen Startpunkt fest und definieren Sie die erwartete Ausgabe. Beispiel: „Verfolgen Sie nach, wie dieser Endpunkt Berechtigungen überprüft, und nennen Sie die entsprechenden Funktionen.“ Wenn Sie Unteragenten einsetzen, geben Sie jedem einzelnen eine abgegrenzte Frage vor, anstatt dieselbe uneingeschränkte Suche zu delegieren.

Der Wechsel zwischen einem Feature, einem nicht damit zusammenhängenden Fehler und einer Dokumentationsanfrage führt dazu, dass die Unterhaltung einen Kontext enthält, der möglicherweise nicht auf die aktuelle Aufgabe zutrifft. Verweise wie „diese Datei“ oder „der frühere Ansatz“ werden dadurch mehrdeutig.

Verwenden Sie separate Sitzungen für nicht miteinander in Zusammenhang stehende Aufgaben. Wenn mehrere Sitzungen das Repository bearbeiten, verwenden Sie separate Git-Worktrees, damit nicht dasselbe Arbeitsverzeichnis geändert wird. Eine kurze Nebenbemerkung: Der Befehl /btw von Claude Code hält den Austausch aus dem Hauptverlauf der Unterhaltung heraus.

Ein Build kann erfolgreich sein, obwohl sich ein Feature falsch verhält. Eine Testsuite kann erfolgreich sein, weil sie die fehlerhafte Eingabe nie getestet hat. Wenn man Claude auffordert, „die Tests auszuführen“, wird dadurch nicht festgestellt, welche Anforderung diese Tests überprüfen.

Ordnen Sie die Akzeptanzkriterien bestimmten Prüfungen zu. Fordern Sie bei einer Fehlerbehebung den Nachweis an, dass der Reproduktionstest vor der Änderung fehlgeschlagen ist und danach erfolgreich war. Behalten Sie ungetestete Kriterien im Blick, anstatt einen erfolgreichen Befehl als Überprüfung für die gesamte Änderung zu betrachten.

Eine ständig wachsende CLAUDE.md-Datei kann veraltete Befehle, doppelte Regeln und Anweisungen enthalten, die im Widerspruch zu aufgabenspezifischen Anforderungen stehen. Eine strengere Formulierung löst diese Konflikte nicht.

Überprüfen Sie die Datei anhand des aktuellen Repositorys. Entfernen Sie veraltete Anleitungen, klären Sie widersprüchliche Regeln und verschieben Sie nur in engen Anwendungsfällen gültige Anweisungen in Regeln oder Fähigkeiten, die auf den Pfad beschränkt sind. Wenn eine Anforderung durchgesetzt werden muss, konfigurieren und testen Sie die entsprechenden Kontrollen, anstatt sich auf wiederholte Erinnerungen zu verlassen.

Eine Überprüfung kann echte Fehler, unklare Probleme und optionale Refactoring-Vorschläge gleichzeitig aufzeigen. Die Umsetzung aller Vorschläge kann den Änderungsumfang vergrößern, ohne das gewünschte Verhalten zu verbessern.

Fragen Sie nach den Belegen und den Auswirkungen hinter jedem Befund. Priorisieren Sie Korrektheitsprobleme und nicht erfüllte Anforderungen, untersuchen Sie unklare Behauptungen und halten Sie nicht relevante Verbesserungen aus dem aktuellen Diff heraus. Ein Prüfer sollte in der Lage sein, keine umsetzbaren Befunde zu melden, wenn die Belege diese Schlussfolgerung unterstützen.

Um eine Vorlage anzupassen, ersetzen Sie deren Platzhalter durch Angaben aus Ihrem Projekt und legen Sie fest, was Claude tun soll, bevor Sie Änderungen vornehmen. Befolgen Sie diese Schritte, um die Anfrage vorzubereiten und das Ergebnis zu überprüfen.

Schritt 1: Entscheiden Sie, ob für die Aufgabe ein Plan erforderlich ist

Bei einer kleinen, klar definierten Änderung können Sie Claude bitten, diese direkt umzusetzen. Bei unbekanntem Code, Änderungen, die mehrere Dateien betreffen, oder ungeklärten Anforderungen sollten Sie zunächst einen Plan erstellen.

Drücken Sie „Umschalt+Tab“, bis der Plan-Modus angezeigt wird, oder starten Sie Claude Code mit dem Befehl „claude --permission-mode plan“. In diesem Modus kann Claude Dateien überprüfen und schreibgeschützte Befehle ausführen, ohne Ihren Quellcode zu bearbeiten. Überprüfen Sie die vorgeschlagenen Dateien, Abhängigkeiten und Tests, bevor Sie die Umsetzung genehmigen. Drücken Sie „Strg+G“, um den vorgeschlagenen Plan in Ihrem Editor zu öffnen.

Schritt 2: Stellen Sie das relevante Ausgangsmaterial bereit

Geben Sie Claude die Informationen, die zum Verständnis der Aufgabe erforderlich sind: einen Dateiverweis, ein bereinigtes Fehlerprotokoll, einen Screenshot oder ein Anforderungsdokument. Verwenden Sie „@“, gefolgt von einem Dateipfad, um den Inhalt dieser Datei einzufügen.

Wählen Sie die kleinste sinnvolle Auswahl an Quellen aus. Das Einbeziehen eines gesamten Protokolls oder Verzeichnisses kann irrelevantes Material hinzufügen und den Kontext überfrachten. Entfernen Sie Anmeldedaten und sensible Informationen, bevor Sie Protokolle freigeben, und stellen Sie sicher, dass Claude über die erforderlichen tools verfügt, um die von Ihnen angegebenen Dokumentations-URLs abzurufen.

Beispielsweise übermittelt der Befehl „cat Fehler.log | claude -p ‚Explain this Fehler‘“ ein Protokoll mit einer nicht-interaktiven Anfrage. Verwenden Sie ihn erst, nachdem Sie den Inhalt der Datei überprüft haben. Darin liegt der praktische Wert kontextbezogener KI: dem Modell relevante Informationen für die jeweilige Aufgabe zur Verfügung zu stellen.

Schritt 3: Verweisen Sie auf eine bestehende Implementierung

Wenn Sie ein neues Feature hinzufügen, identifizieren Sie eine ähnliche Komponente oder Funktion im Repository. Teilen Sie Claude mit, welche Konventionen zu befolgen sind, beispielsweise hinsichtlich des API-Clients, der Validierungslogik, der Fehlerbehandlung oder der Teststruktur.

„Verfolgen Sie, wie @src/widgets/Weather.tsx Daten abruft und zwischenspeichert“ gibt Claude einen konkreten Anhaltspunkt. Nennen Sie außerdem alle Unterschiede, die das neue Feature erfordert, damit kein Verhalten kopiert wird, das nicht mehr passt. Diese Konventionen sollten den Softwareentwicklungs-Workflow Ihres Teams widerspiegeln.

Schritt 4: Legen Sie fest, welche Nachweise Sie benötigen

Geben Sie bei Codeänderungen den entsprechenden Test-, Build- oder Lint-Befehl sowie das zu prüfende Verhalten an. Fordern Sie für Forschungszwecke Dateireferenzen oder Commit-IDs an. Stellen Sie für UI-Arbeiten ein Referenzbild und eine konfigurierte Methode bereit, um die Implementierung im gleichen Ansichtsbereich zu erfassen.

Bitten Sie Claude, einen Bericht über das zu erstellen, was tatsächlich geprüft wurde, einschließlich Fehlern und übersprungenen Prüfungen. Überprüfen Sie, ob die Nachweise die Anforderung abdecken; ein erfolgreicher Build bedeutet nicht, dass jedes geforderte Verhalten funktioniert.

Für umfangreichere Aufgaben bietet Claude Code außerdem eine /goal-Bedingung und Stop-Hooks. Der Zielauswerter bewertet die in der Unterhaltung zutage getretenen Hinweise, anstatt Dateien eigenständig zu überprüfen oder Tests auszuführen. Ein konfigurierter Stop-Hook kann die Fertigstellung blockieren, unterliegt jedoch Limiten hinsichtlich wiederholter Blockierungen. Beides ersetzt jedoch keine angemessenen Tests und keine Überprüfung durch Menschen.

Schritt 5: Eine Sitzung zurücksetzen, in der immer wieder derselbe Fehler auftritt

Wenn wiederholte Korrekturen ein Problem nicht beheben, halten Sie inne und ermitteln Sie, was in der ursprünglichen Anfrage unklar geblieben ist. Speichern Sie die nützlichen Erkenntnisse, den aktuellen Git-Status und die noch ausstehende Arbeit, bevor Sie die Unterhaltung löschen.

Der Leitfaden für Best Practices von Anthropic empfiehlt, nach zwei erfolglosen Korrekturversuchen zum gleichen Problem von vorne zu beginnen. Verwenden Sie den Befehl /clear und geben Sie anschließend eine überarbeitete Eingabe an, die Ihre gewonnenen Erkenntnisse berücksichtigt. Das Löschen der Unterhaltung macht Dateiänderungen nicht rückgängig.

Drücken Sie die Esc-Taste, um eine laufende Antwort zu unterbrechen. Wenn das Eingabefeld leer ist, drücken Sie zweimal die Esc-Taste, um das Rückspulen-Menü zu öffnen und auszuwählen, was wiederhergestellt werden soll. Das Rückspulen macht nicht alle externen Auswirkungen rückgängig. Verwenden Sie daher Git-Checkpoints und separate Wiederherstellungsverfahren für Änderungen an Datenbanken oder Remote-Diensten.

Wo sollten Sie wiederverwendbare Claude-Code-Anweisungen speichern?

Speichern Sie projektweite Richtlinien in „CLAUDE.md“, wiederholbare Abläufe in „Skills“ und Anweisungen für bestimmte Dateien in pfadbezogenen Regeln. Verwenden Sie Hooks für Aktionen, die an bestimmte Ereignisse geknüpft sind, wie beispielsweise das Ausführen eines Formatierers nach einer Bearbeitung.

Wählen Sie je nachdem aus, wann die Anweisung gelten soll:

  • Eine Vorlage: Verwenden Sie diese für die aktuelle Aufgabe, einschließlich der Anforderungen, des Umfangs und der Abnahmekriterien.
  • CLAUDE.md: Verwenden Sie diese Datei für projektweite Informationen wie Build-Befehle, Repository-Konventionen und Einschränkungen, die Claude nicht zuverlässig ableiten kann.
  • Regeln mit Pfadgültigkeit: Verwenden Sie diese für Konventionen, die für bestimmte Dateien oder Verzeichnisse gelten, wie z. B. Frontend-Komponenten oder Datenbank-Code.
  • Eine Fertigkeit: Verwenden Sie diese für wiederholbare Abläufe, wie z. B. die Untersuchung eines Problems oder die Erstellung einer Release-Zusammenfassung.
  • Ein Hook: Wird für eine ereignisgesteuerte Aktion oder Überprüfung verwendet, z. B. zum Formatieren einer Datei nach der Bearbeitung oder zum Überprüfen eines Tool-Aufrufs, bevor dieser ausgeführt wird.
  • Ein benutzerdefinierter Subagent: Verwenden Sie diesen für eine spezielle Aufgabe, die von eigenen Anweisungen, Zugriff auf Tools und einem separaten Kontext profitiert, wie beispielsweise eine gezielte Codeüberprüfung.

Halten Sie Projektanleitungen von Anweisungen für Aufgaben getrennt

Eine Anforderung für ein Feature gehört in der Regel in die entsprechende Aufgabe oder Spezifikation und nicht in die Datei „CLAUDE.md“. Das Hinzufügen temporärer Anweisungen zu einer projektweiten Datei erschwert es, diese von Konventionen zu unterscheiden, die im gesamten Repository gelten sollten.

Als Beispiel speichern Sie den Testbefehl des Projekts in der Datei „CLAUDE.md“, legen Sie komponentenbezogene Konventionen in einer pfadbezogenen Regel fest und speichern Sie ein wiederkehrendes Überprüfungsverfahren als „Skill“. Überprüfen Sie diese Dateien bei Änderungen an Befehlen oder Konventionen, genau wie Sie es auch bei anderer Projektdokumentation tun würden.

Unterscheiden Sie zwischen Leitlinien und verbindlichen Vorgaben

Prompts, CLAUDE.md und Skills steuern das Verhalten von Claude; sie garantieren jedoch nicht, dass eine Anweisung befolgt wird. Hooks können bei konfigurierten Ereignissen Überprüfungen durchführen, ihre Zuverlässigkeit hängt jedoch vom Hook-Typ und der Implementierung ab.

Ein Befehlshook führt ein Skript aus. Ein Prompt- oder Agent-Hook stützt sich auf die Entscheidung eines Modells. Wie im Leitfaden zu Best Practices von Anthropic erläutert wird: „Ein Prompt- oder Agent-Hook bittet ein anderes Modell um eine Entscheidung, ist also ebenfalls nicht deterministisch.“ Verwenden Sie für eine Regel, die durchgesetzt werden muss, geeignete Berechtigungskontrollen und testen Sie den entsprechenden Befehls- oder HTTP-Hook, einschließlich der Art und Weise, wie er mit Fehlern umgeht.

Benutzerdefinierte Unteragenten sind eine weitere Möglichkeit, wiederkehrende Aufgaben zu organisieren. Definieren Sie einen Spezialisten unter „in.claude/agents/“, wenn eine spezifische Rolle für die Überprüfung oder ein bestimmter Tool-Umfang erforderlich ist, anstatt jede Spezialanweisung zur Hauptsitzung hinzuzufügen. Diese Leitfäden zum besten Claude-Modell für die Arbeit und zu den verschiedenen Arten von KI-Agenten bieten zusätzlichen Kontext.

Wenn Ihr Team Prompts für mehrere KI-Produkte verwaltet, sehen Sie sich diese Prompt-Engineering-Tools an, mit denen Sie Bibliotheken über Claude Code hinaus verwalten können.

Häufige Fehler bei Claude-Code-Prompts

Wenn eine Sitzung ein unvollständiges oder ungeeignetes Ergebnis liefert, prüfen Sie, ob in der Anforderung wichtige Entscheidungen offen geblieben sind. Diese fünf Fehler können die Diagnose und Überprüfung der Arbeit erschweren.

1. Eine Untersuchung anfordern, ohne eine klare Frage zu stellen

„Untersuche das Repository“ gibt Claude kaum Anhaltspunkte dafür, welche Dateien relevant sind oder wann es aufhören soll. Möglicherweise erhalten Sie eine allgemeine Zusammenfassung ohne Antwort auf das Problem, das Anlass für die Anfrage war.

Benennen Sie das Verhalten oder die Entscheidung, die Sie verstehen müssen, legen Sie einen Startpunkt fest und definieren Sie die erwartete Ausgabe. Beispiel: „Verfolgen Sie nach, wie dieser Endpunkt Berechtigungen prüft, und nennen Sie die entsprechenden Funktionen.“ Wenn Sie Unteragenten einsetzen, geben Sie jedem einzelnen eine abgegrenzte Frage vor, anstatt dieselbe uneingeschränkte Suche zu delegieren.

2. Vermischung nicht zusammenhängender Aufgaben in einer Sitzung

Der Wechsel zwischen einem Feature, einem nicht damit zusammenhängenden Fehler und einer Dokumentationsanfrage führt dazu, dass die Unterhaltung einen Kontext enthält, der möglicherweise nicht auf die aktuelle Aufgabe zutrifft. Verweise wie „diese Datei“ oder „der frühere Ansatz“ werden dadurch mehrdeutig.

Verwenden Sie separate Sitzungen für nicht miteinander in Zusammenhang stehende Arbeiten. Wenn mehrere Sitzungen das Repository bearbeiten, verwenden Sie separate Git-Worktrees, damit nicht dasselbe Arbeitsverzeichnis geändert wird. Eine kurze Nebenbemerkung: Der Befehl /btw von Claude Code hält den Austausch aus dem Hauptverlauf der Unterhaltung heraus.

3. Akzeptieren einer bestandenen Prüfung, die die Anforderung nicht abdeckt

Ein Build kann erfolgreich sein, obwohl sich ein Feature falsch verhält. Eine Testsuite kann erfolgreich sein, weil sie die fehlerhafte Eingabe nie getestet hat. Wenn man Claude auffordert, „die Tests auszuführen“, wird dadurch nicht festgestellt, welche Anforderung diese Tests überprüfen.

Ordnen Sie die Akzeptanzkriterien bestimmten Prüfungen zu. Fordern Sie bei einer Fehlerbehebung den Nachweis an, dass der Reproduktionstest vor der Änderung fehlgeschlagen ist und danach erfolgreich war. Halten Sie ungetestete Kriterien in Sichtbarkeit, anstatt einen erfolgreichen Befehl als Überprüfung für die gesamte Änderung zu betrachten.

4. Hinzufügen weiterer Anweisungen ohne Konflikte zu lösen

Eine ständig wachsende CLAUDE.md-Datei kann veraltete Befehle, doppelte Regeln und Anweisungen enthalten, die im Widerspruch zu aufgabenspezifischen Anforderungen stehen. Eine strengere Formulierung löst diese Konflikte nicht.

Überprüfen Sie die Datei anhand des aktuellen Repositorys. Entfernen Sie veraltete Anleitungen, klären Sie widersprüchliche Regeln und verlagern Sie nur in engen Anwendungsfällen gültige Anweisungen in Regeln oder Fähigkeiten, die auf den Pfad beschränkt sind. Wenn eine Anforderung durchgesetzt werden muss, konfigurieren und testen Sie die entsprechenden Kontrollen, anstatt sich auf wiederholte Erinnerungen zu verlassen.

5. Jede bei der Codeüberprüfung festgestellte Unstimmigkeit als bestätigten Fehler behandeln

Eine Überprüfung kann echte Fehler, unklare Probleme und optionale Refactoring-Vorschläge gleichzeitig aufzeigen. Die Umsetzung aller Vorschläge kann den Änderungsumfang vergrößern, ohne das gewünschte Verhalten zu verbessern.

Fragen Sie nach den Belegen und den Auswirkungen hinter jedem Befund. Priorisieren Sie Korrektheitsprobleme und nicht erfüllte Anforderungen, untersuchen Sie unklare Behauptungen und halten Sie nicht relevante Verbesserungen aus dem aktuellen Diff heraus. Ein Prüfer sollte in der Lage sein, keine umsetzbaren Befunde zu melden, wenn die Belege diese Schlussfolgerung unterstützen.

So verwenden Sie ClickUp-Aufgaben als Claude-Code-Briefings

Wenn für ein Feature in ClickUp bereits vereinbarte Anforderungen vorliegen, nutzen Sie diese Aufgabe als Briefing für Claude Code. Halten Sie das erwartete Verhalten, die Einschränkungen und die Akzeptanzkriterien an einem Ort fest, damit die Umsetzung anhand derselben Anforderung überprüft werden kann.

Es gibt zwei Möglichkeiten, diese Vorgabe mit der Entwicklungsarbeit zu verbinden: Sie können sie über ClickUp MCP aus einer Claude-Code-Sitzung einlesen oder sie einem ClickUp-Cloud-Agent zuweisen. Dabei handelt es sich um separate Workflows.

Übertragen Sie Aufgabenanforderungen mit ClickUp MCP in Claude Code

Claude-Oberfläche mit einer Genehmigungsanfrage zur Erstellung einer ClickUp-Aufgabe für „Web-UI“ und den Optionen „Ablehnen“, „Immer zulassen“ und „Einmal zulassen“.
Überprüfen Sie eine vorgeschlagene ClickUp Aufgabe, bevor Sie Claude erlauben, diese über MCP zu erstellen.

Der ClickUp-MCP-Server ermöglicht Claude Code den Zugriff auf unterstützte ClickUp-Tools unter Verwendung der Berechtigungen Ihres Kontos. Sie können Aufgabendetails und relevante Kontextinformationen abrufen und anschließend die Repository-Tools von Claude Code nutzen, um Dateien zu überprüfen, Änderungen vorzunehmen und Tests durchzuführen. MCP bietet Zugriff auf ClickUp; die lokale Programmierarbeit wird nicht von MCP selbst durchgeführt.

Befolgen Sie die Anweisungen im Hilfecenter, durchführen Sie die Authentifizierung Ihres Kontos und öffnen Sie das richtige Repository in Claude Code. Überprüfen Sie vor der Implementierung, ob die Aufgabe das beabsichtigte Verhalten, relevante Einschränkungen und Akzeptanzkriterien identifiziert. Unser Anthropic MCP-Leitfaden erklärt, wie die Verbindung funktioniert.

Beispielsweise könnte eine Aufgabe beim Bezahlvorgang vorsehen, dass abgelaufene Gutscheine einen Fehler anzeigen, ohne dass eine Bestellung erstellt wird, während gültige Gutscheine weiterhin funktionieren. Eine anschauliche Anweisung könnte wie folgt lauten:

  • Verwenden Sie ClickUp MCP, um [Aufgaben-ID oder URL] zu lesen und die Anforderungen, Einschränkungen und Abnahmekriterien zusammenzufassen. Vergewissern Sie sich, dass das Repository und der Bereich in dieser Sitzung mit der Aufgabe übereinstimmen.
  • Prüfen Sie den entsprechenden Code und schlagen Sie einen Plan vor, der jedes Akzeptanzkriterium einem Implementierungsschritt und einem Test zuordnet. Markieren Sie fehlende oder widersprüchliche Anforderungen und warten Sie auf die Freigabe, bevor Sie die Bearbeitung vornehmen.
  • Führen Sie nach der Freigabe die vereinbarten Änderungen durch und führen Sie den [Testbefehl] aus. Berichten Sie über die tatsächlich abgeschlossenen Prüfungen, deren Ergebnisse und alles, was noch nicht überprüft wurde.
  • Verfassen Sie einen Kommentar zur Aufgabe, in dem Sie die Änderungen, die Ergebnisse für jedes einzelne Kriterium und gegebenenfalls den PR-Link zusammenfassen. Zeigen Sie mir diesen vor der Veröffentlichung. Führen Sie nicht die Zusammenführung der Änderungen durch.

Überprüfen Sie den Diff und die Testnachweise, bevor Sie die Implementierung akzeptieren. Fügen Sie nach der Freigabe die Ergebnisse und den PR-Link zur Aufgabe hinzu, damit die Prüfer die Arbeit von der ursprünglichen Anfrage bis zur vorgeschlagenen Änderung nachvollziehen können.

Weisen Sie einem ClickUp Cloud Agent definierte Arbeiten zu

ClickUp Aufgabe im Bereich „Code-Review“, die dem Code-Agent zugewiesen ist, zusammen mit einer Unterhaltung, in der der Code-Agent anbietet, eine Sitzung zu starten und einen Pull Request zurückzusenden.
Weisen Sie einem ClickUp Cloud-Agenten Aufgaben zu und verfolgen Sie deren Fortschritt im Aufgabenthread.

ClickUp Cloud Agents bieten eine separate Möglichkeit, an einer Aufgabe zu arbeiten, ohne eine lokale Claude-Code-Sitzung auszuführen. Verbinden Sie GitHub, wählen Sie das Repository aus oder bestätigen Sie es und weisen Sie die Aufgabe zu. Der Agent liest die Aufgabenbeschreibung, arbeitet in der Cloud und sendet einen Pull Request im Aufgabenthread zurück.

Wenden Sie bei jeder Aufgabe denselben Qualitätsmaßstab an: Erläutern Sie das erwartete Verhalten, identifizieren Sie Einschränkungen und gestalten Sie die Akzeptanzkriterien so, dass sie überprüft werden können. Vor der Genehmigung des Zusammenführens überprüft eine Person weiterhin den Diff und führt eine Kontrolle durch. Ein zurückgesendeter PR ist ein Vorschlag zur Überprüfung, kein Nachweis dafür, dass alle Anforderungen erfüllt wurden.

Wählen Sie den Workflow, der zu Ihrer Art der Arbeitsüberwachung passt. Mit MCP können Sie den ClickUp-Kontext in Ihre Claude-Code-Sitzung einbinden; mit Cloud Agents können Sie Aufgaben über ClickUp delegieren und die zurückgegebenen Ergebnisse dort überprüfen. Beides erspart Ihnen jedoch nicht die Notwendigkeit, unklare Vorgaben zu klären.

Erstellen Sie eine Prompt-Bibliothek auf der Grundlage der von Ihnen überprüften Arbeiten

Die oben genannten 25 Leitfragen dienen als Ausgangspunkt. Behalten Sie bei der Anwendung diejenigen Versionen bei, die zu Ihrem Repository passen, und notieren Sie, was Sie klären mussten: eine fehlende Geschäftsregel, eine unerwartete Abhängigkeit oder einen Test, der die Anforderung nicht abgedeckt hat.

Diese Korrekturen machen eine wiederverwendbare Eingabeaufforderung für Ihr Team nützlicher. Aktualisieren Sie sie, wenn sich der Code oder der Workflow ändert, und machen Sie ungelöste Limite sichtbar, damit die nächste Person weiß, wo noch eine Überprüfung erforderlich ist.

Wenn die Arbeit in ClickUp beginnt, fügen Sie die Anforderungen, Entscheidungen und Ergebnisse der Aufgabe als Anhang bei. So erhält der nächste Entwickler oder Bearbeiter einen Überblick darüber, was angefordert wurde, was sich geändert hat und was noch offen ist.

Häufig gestellte Fragen zu Claude-Code-Eingabeaufforderungen

Was ist der Plan-Modus in Claude Code?

Im Planungsmodus kann Claude Dateien überprüfen und schreibgeschützte Befehle ausführen, um einen Implementierungsplan zu erstellen, ohne Ihren Code zu bearbeiten. Drücken Sie „Umschalt+Tab“, bis der Planungsmodus angezeigt wird, oder starten Sie eine Sitzung mit dem Befehl „claude --permission-mode plan“. Überprüfen Sie den vorgeschlagenen Ansatz, bevor Sie die Implementierung genehmigen; mit „Strg+G“ öffnen Sie den vorgeschlagenen Plan in Ihrem Editor.

Wie füge ich eine neue Zeile in eine Claude-Code-Eingabeaufforderung ein?

Drücken Sie Strg+J oder geben Sie einen Backslash (\) gefolgt von der Eingabetaste ein. Beide Methoden funktionieren in allen Terminals ohne zusätzliches Setup. In unterstützten Terminals funktioniert auch Umschalt+Eingabetaste; bei einigen integrierten Terminals muss zuvor der Befehl /terminal-setup ausgeführt werden. Lesen Sie die Anleitung zur Terminalkonfiguration für Ihre Umgebung.

Wie behebe ich die Fehlermeldung „Prompt ist zu lang“ in Claude Code?

Reduzieren Sie die Menge der im Gespräch gesendeten Inhalte. Bei einer Sitzung, die ihr Limit für den Kontext erreicht hat, fasst der Befehl /compact den Verlauf zusammen, während der Befehl /clear eine neue Unterhaltung startet. Wenn eine einzelne übergroße Nachricht nicht komprimiert werden kann, kürzen Sie sie oder geben Sie eine Auswahl an Auszüge an. Bei großen Dateien bitten Sie Claude, bestimmte Abschnitte zu prüfen, anstatt den gesamten Inhalt zu laden. Das Löschen der Unterhaltung macht Dateiänderungen nicht rückgängig.

Kann ich die Systemaufforderung von Claude Code ändern?

Ja. Das CLI-Flag „--append-system-prompt“ fügt Anweisungen zur Standard-Systemeingabeaufforderung hinzu, während „--system-prompt“ diese vollständig ersetzt. Beim Anhängen bleiben die Standardanweisungen erhalten; das Ersetzen erfordert mehr Sorgfalt, da diese Anweisungen dann nicht mehr enthalten sind. Für wiederkehrende Repository-Konventionen ist „CLAUDE.md“ in der Regel die praktischere Wahl. Keiner der beiden Ansätze ersetzt konfigurierte Berechtigungen. Unterstützte Optionen finden Sie in der CLI-Referenz.

Können auch Personen, die nicht programmieren, Claude-Code-Prompts verwenden?

Ja. Claude Code kann bei Aufgaben wie dem Abgleich von Dateien, der Berichterstellung und dem Verfassen von Dokumenten auf der Grundlage lokaler Quellen helfen. Sie müssen jedoch weiterhin die Geschäftsregeln definieren und die Ausgabe überprüfen. Beginnen Sie mit Kopien genehmigter Daten und einem Ergebnis, das Sie eigenständig überprüfen können. Wenn die Aufgabe Code erzeugt, den Sie nicht beurteilen können, ziehen Sie einen qualifizierten Prüfer hinzu, bevor Sie ihn mit Produktionsdaten oder -systemen verwenden.