CLAUDE.md nach Opus 5: Warum lange Anweisungen Claude jetzt im Weg stehen

Informationen zur Arbeit mit Ailoot finden Sie in der Dokumentation.

Was hat sich bei Claude nach der Veröffentlichung von Opus 5 geändert?#

Opus 5 erschien am 24. Juli 2026 und wurde sofort zum Standardmodell in Claude Code. Das Modell selbst – sein Preis, seine Benchmarks und seine Effort-Modi – wird ausführlich in einem separaten Leitfaden behandelt: „Sollten Sie zu Claude Opus 5 wechseln?“. In diesem Artikel geht es um etwas anderes: Mit der Veröffentlichung des Modells änderte sich auch, wie man effektiv mit ihm kommuniziert.

Anthropic veröffentlichte im Claude-Blog eine Analyse. Der zentrale Punkt lautet:

Die entscheidende Formulierung ist „zu sehr eingeschränkt“. Als Modelle noch schwächer waren, brauchten sie ein Gerüst: Tu dies, tu das nicht, hier ist ein Beispiel, wiederhole es noch einmal. Opus 5 braucht dieses Gerüst nicht mehr; schlimmer noch: Es kann anfangen, im Weg zu stehen. Anthropic formuliert das neue Prinzip ganz einfach: Lassen Sie Claude sein eigenes Urteilsvermögen nutzen.

Was bedeutet das in der Praxis für Sie?

• Ihre CLAUDE.md ist dieselbe Art von System-Prompt, aber für Ihr Projekt. Wenn Anthropic den eigenen um 80 Prozent gekürzt hat, ist Ihrer wahrscheinlich ebenfalls aufgebläht.
• Lange Regelkataloge garantieren nicht mehr, dass die Regeln befolgt werden. Im Gegenteil: Je mehr Zeilen es gibt, desto weniger genau hält sich das Modell daran (weiter unten mehr dazu, mit Zahlen aus der Dokumentation).
• Es gibt neue Mechanismen – automatisches Gedächtnis und Skills –, die einen Teil der Arbeit übernehmen, die Sie früher manuell in CLAUDE.md festhalten mussten.

Der wichtigste Teil der Arbeit geschieht vor dem Prompt – durch das, was Sie vor der ersten Anfrage in den Kontext des Modells aufnehmen. Das Opus-5-Update ist im Grunde Anthropic offizielle Bestätigung derselben Idee. Diesmal gibt es allerdings konkrete Zahlen und neue Werkzeuge dazu. Ich gehe sie der Reihe nach durch.

Warum steht eine lange CLAUDE.md jetzt im Weg?#

So funktioniert es. CLAUDE.md ist eine Datei mit Regeln, die Claude zu Beginn jeder Sitzung liest. Ein separater Leitfaden, „So richten Sie CLAUDE.md ein“, erklärt, wie Sie eine solche Datei von Grund auf erstellen; in diesem Artikel geht es um das Gegenteil: Was Sie jetzt daraus entfernen sollten. Alles, was Sie dort hineinschreiben, gelangt vor Ihrer ersten Anfrage in den Kontext und bleibt während des gesamten Gesprächs darin. Der Kontext ist nicht unendlich – und jede zusätzliche Regelzeile nimmt Platz ein, der Ihrer Aufgabe zugutekommen könnte.

Die Claude-Code-Dokumentation bringt es auf den Punkt:

Der zweite Punkt ist wichtiger als der erste: Lange Dateien verschlechtern die Befolgung von Anweisungen. Das Modell hört weniger genau zu. In diese Falle tappen fast alle Anfänger. Die Logik scheint wasserdicht: Ich möchte, dass Claude auf mich hört, also schreibe ich mehr Regeln. In der Praxis geschieht das Gegenteil. Je länger die Liste, desto stärker wird die Aufmerksamkeit des Modells zerstreut und desto öfter lässt es eine Regel aus.

So hat sich der Ansatz geändert:

Es gibt noch ein zweites Problem: Widersprüche. Je länger eine Datei wird, desto mehr Regeln häufen sich darin fast zwangsläufig an, die einander widersprechen. An einer Stelle steht „Schreibe immer Tests“, an einer anderen „Fasse den Testordner nicht an“. Die Dokumentation warnt: Wenn zwei Regeln einander widersprechen, kann Claude zufällig eine davon auswählen. Anders gesagt: Eine überladene Datei macht das Verhalten des Modells weniger vorhersehbar.

Eine einfache Regel: CLAUDE.md ist eine kurze Notiz darüber, was Claude nicht selbst ableiten kann. Alles darüber hinaus beansprucht nur seine Aufmerksamkeit.

Was sollten Sie in CLAUDE.md behalten und was entfernen?#

Die Dokumentation nennt ein klares Kriterium dafür, ob eine Regel in CLAUDE.md gehört. Fügen Sie sie hinzu, wenn:

1. Claude denselben Fehler zum zweiten Mal gemacht hat.
2. Eine Code-Prüfung etwas entdeckt hat, das das Modell über dieses Projekt hätte wissen müssen.
3. Sie dieselbe Korrektur zum zweiten Mal in den Chat tippen.
4. Eine neue Person im Team denselben Kontext bräuchte, um das Projekt nicht zu beschädigen.

Das allgemeine Prinzip lautet, projektspezifische Fallstricke beizubehalten und Offensichtliches zu entfernen. Claude Code verfügt sogar über eine integrierte Prüfung namens claude doctor, die vorschlägt, eine überladene CLAUDE.md aufzuräumen. Sie entfernt Einzelheiten, die das Modell aus der Codebasis ableiten kann – Ordnerstruktur, Abhängigkeitsliste, Architekturüberblick – und behält Fallstricke, Begründungen und Konventionen bei, die von den Standardeinstellungen abweichen.

Die zweite wichtige Regel ist Spezifität. Vage Formulierungen funktionieren nicht. Vergleichen Sie:

Der Unterschied ist einfach. Das Modell kann „formatiere es richtig“ beliebig auslegen. „Verwende einen Einzug von 2 Leerzeichen“ lässt sich eindeutig überprüfen. Jede Regel in CLAUDE.md sollte etwas sein, das Sie überprüfen und feststellen können – ob sie befolgt wurde oder nicht.

Und drittens: Entfernen Sie das Offensichtliche. Wenn Sie in CLAUDE.md „Schreibe sauberen Code“ oder „Befolge Best Practices“ schreiben, ist das Störrauschen. Das Modell weiß das bereits, und die Zeile nimmt Platz ein und zerstreut seine Aufmerksamkeit. Anthropic rät ausdrücklich davon ab, Kontext für Offensichtliches zu verwenden.

Wohin sollten Sie Regeln verschieben, die nicht in CLAUDE.md passen?#

Hier kommt das am meisten unterschätzte Werkzeug ins Spiel. Früher mussten alle Anweisungen in CLAUDE.md stehen; jetzt haben lange Verfahren ein eigenes Zuhause: Skills. Ein separater Leitfaden, „So wählen Sie Claude-Code-Skills aus“, erklärt, wie Sie die passenden auswählen, ohne zu viele hinzuzufügen.

Der Unterschied ist grundlegend. CLAUDE.md wird zu Beginn jeder Sitzung vollständig geladen. Ein Skill wird es nicht. Die Dokumentation formuliert es so:

Das nennt man progressive disclosure – Informationen bei Bedarf zu laden. Die Idee ist, dem Modell im passenden Moment Kontext in Teilen bereitzustellen. Anthropic verlagerte seine ausführlichen Anweisungen – zum Beispiel für Code-Reviews – in Skills und entfernte sie aus dem System-Prompt.

Das Kriterium für die Verschiebung in einen Skill ist einfach: Ein Abschnitt von CLAUDE.md hat sich von einer Tatsache zu einem Verfahren entwickelt. Eine einzeilige Notiz wie „Builds laufen über npm run build“ ist eine Tatsache und gehört in CLAUDE.md. Zehn Schritte dazu, „wie wir das Projekt veröffentlichen“, bilden ein Verfahren und gehören in einen Skill.

Ein praktisches Prinzip: Lagern Sie alles aus, was Sie mehr als ein paar Mal tun. Erklären Sie einmal, wie man zum Beispiel einen wöchentlichen Kundenbericht erstellt, machen Sie aus der Erklärung einen Skill, und Sie müssen es nicht noch einmal erklären. Der Skill bleibt dort, ohne Kontext zu beanspruchen, und lässt sich namentlich mit einem Befehl wie /otchet aufrufen.

Diese Inhalte lassen sich gut in Skills verschieben:

• Mehrstufige Verfahren (Veröffentlichung, Berichtserstellung, Prüfungen vor der Veröffentlichung).
• Lange Anweisungen, die selten, dann aber vollständig gebraucht werden.
• Alles, was Sie zum zweiten oder dritten Mal aus einem Chat in einen anderen kopieren.

Eine Zwischenlösung sind Regeln für bestimmte Ordner. Wenn eine Anweisung nur für einen Teil des Projekts gilt, können Sie sie in .claude/rules/ ablegen und mit den betreffenden Dateien verknüpfen. Dann wird sie nur geladen, wenn Claude mit diesen Dateien arbeitet, statt ständig im Kontext zu bleiben.

Was ist automatisches Gedächtnis und warum sollte man es 2026 nutzen?#

Der zweite neue Mechanismus, der CLAUDE.md entlastet, ist das automatische Gedächtnis. Die Idee ist, dass Claude sich jetzt nicht nur daran erinnert, was Sie geschrieben haben, sondern auch an das, was es selbst bemerkt hat. Ein separater Leitfaden, „Claude Memory oder CLAUDE.md?“, erklärt, worin sich die Funktionsweise von CLAUDE.md unterscheidet.

Der Unterschied zwischen den beiden Arten von Gedächtnis:

So funktioniert es: Während Claude an Ihrer Aufgabe arbeitet, bemerkt es nützliche Einzelheiten – welcher Befehl den Build ausführt, wo das Debugging ins Stocken geriet, was Sie anders haben wollten – und speichert sie in seinen Notizen. In der nächsten Sitzung greift es darauf zurück. Wichtig: Claude speichert selektiv und behält nur, was es für die Zukunft als nützlich erachtet.

Die Notizen liegen in einem separaten Ordner für jedes Projekt, mit einer Indexdatei namens MEMORY.md. Sie können sie mit dem Befehl /memory ansehen und bearbeiten. Es sind gewöhnliche Textdateien, die Sie jederzeit lesen, bearbeiten oder löschen können.

Was sich dadurch für Sie in der Praxis ändert: Claude hält jetzt einige Dinge fest, die Sie früher nach jedem Fehler selbst in CLAUDE.md eintragen mussten. Dadurch wird Ihre Regeldatei noch kürzer – und das ist gut.

Warum widerspricht Opus 5 Ihren Anweisungen?#

Das Ganze hat auch eine Kehrseite.

Ein Modell, das sein Urteilsvermögen einsetzen darf, wird definitionsgemäß manchmal einem starren Befehl widersprechen, wenn es im Kontext eine bessere Möglichkeit erkennt.

Was das für Sie bedeutet, wenn Sie auf Opus 5 aktualisiert haben und etwas schiefläuft:

1. Überprüfen Sie Ihre alten Skills und Plugins erneut. Konfigurationen für frühere Modelle können mit der neuen Logik kollidieren. Was früher wie am Schnürchen lief, sollten Sie jetzt erneut testen.
2. Entfernen Sie die starrsten Formulierungen. Modelle der fünften Generation kommen mit Befehlen wie „Tu X niemals, tu immer nur Y“ schlechter zurecht als mit flexiblen Formulierungen, die erklären, warum.
3. Achten Sie darauf, wo das Modell zu früh abbricht. Manchmal deutet dies darauf hin, dass eine Anweisung sich selbst widerspricht oder mit einer Regel in einer überladenen CLAUDE.md kollidiert.

So schreiben Sie CLAUDE.md für Opus 5 um: Schritt für Schritt#

So gehen Sie mit einer CLAUDE.md um, die Sie von früheren Modellen übernommen haben.

1. Integrierte Prüfung ausführen

   Geben Sie im Projekt claude doctor ein. Das Tool schlägt vor, was aus der überladenen Datei entfernt und was beibehalten werden sollte.

2. Offensichtliches entfernen

   Löschen Sie jede Zeile, deren Inhalt Claude aus dem Code selbst ableiten kann: Ordnerstruktur, Liste der Bibliotheken und allgemeine Aussagen wie „Schreibe sauberen Code“.

3. Widersprüche beseitigen

   Gehen Sie die Datei von oben nach unten durch und suchen Sie nach widersprüchlichen Regeln. Behalten Sie eine davon und löschen Sie die widersprechende.

4. Verfahren in Skills verschieben

   Verschieben Sie alles, was sich von einer Tatsache zu einer Schritt-für-Schritt-Anweisung entwickelt hat, in einen separaten Skill. Lassen Sie in CLAUDE.md einen einzeiligen Verweis darauf stehen.

5. Die übrigen Regeln konkret formulieren

   Formulieren Sie jede Regel so um, dass sie überprüfbar ist: Aus „formatiere es richtig“ wird „verwende einen Einzug von 2 Leerzeichen“.

6. Automatisches Gedächtnis aktivieren und Länge prüfen

   Vergewissern Sie sich, dass das automatische Gedächtnis funktioniert (/memory) und die Datei unter 200 Zeilen hat. Falls nicht, gibt es noch etwas, das verschoben werden sollte.

Damit Sie den ersten Durchgang nicht von Hand erledigen müssen, lassen Sie Claude die Arbeit machen. Hier ist ein Prompt, mit dem Sie anfangen können – kopieren Sie ihn und fügen Sie ihn in eine Sitzung ein, die in Ihrem Projekt geöffnet ist:

Lies meine CLAUDE.md und meinen Code. Deine Aufgabe ist es, CLAUDE.md für ein Modell der fünften Generation kürzer und nützlicher zu machen.

Gehe die Datei durch und teile alle Regeln in drei Gruppen ein:

BEIBEHALTEN – projektspezifische Fallstricke und Konventionen, die du nicht selbst aus dem Code ableiten kannst.

LÖSCHEN – offensichtliche Dinge, die du bereits weißt, und alles, was sich aus dem Code ableiten lässt.

IN EINEN SKILL VERSCHIEBEN – mehrstufige Verfahren, die derzeit als Text in CLAUDE.md stehen.

Formuliere für Gruppe 1 vage Regeln so um, dass sie konkret und überprüfbar sind.
Finde Regeln, die einander widersprechen, und führe sie separat auf.
Gib eine neue Version von CLAUDE.md mit weniger als 200 Zeilen sowie eine Liste der Elemente zurück, die du in Skills verschieben möchtest.
Ändere keine Dateien, bevor ich zustimme.

Beachten Sie die letzte Zeile: „Ändere nichts, bevor ich zustimme.“ Bei einem Modell, das nun sein Urteilsvermögen einsetzt, ist das wichtig: Lassen Sie sich erst einen Plan zeigen und überlassen Sie die Entscheidung dann Ihnen.

Warum ist der Kontext wichtiger als der Prompt?#

Wenn man die Einzelheiten zu Opus 5 beiseitelässt und das Gesamtbild betrachtet, dreht sich diese ganze Analyse um eine Idee: Der Kontext ist wichtiger als der Prompt. Der wichtigste Teil der Arbeit findet vor der Anfrage statt – wenn Sie die Umgebung zusammenstellen, in der das Modell arbeiten wird.

CLAUDE.md, Skills und automatisches Gedächtnis sind alles Teile ein und derselben Sache: dem, was Claude vor Ihrer ersten Nachricht sieht. Sie können die Formulierung Ihrer Anfrage endlos anpassen, aber wenn der Kontext schlecht zusammengestellt ist – eine überladene CLAUDE.md, widersprüchliche Regeln, keine Struktur –, bleiben die Ergebnisse inkonsistent.

Hier ist eine einfache Prüfung: Ohne ein First Brain hilft ein Second Brain nicht. Mit „Second Brain“ meint dieser Artikel die Wissensstruktur eines Projekts, die das Modell mit jeder Anfrage liest. Sie funktioniert aber nur, wenn sie durch Ihr klares Verständnis der Aufgabe gestützt wird. Ein Werkzeug verstärkt Ihr Denken – dort endet seine Rolle.

Das Opus-5-Update hat diese Logik geschärft. Anthropic hat mit der eigenen Arbeit gezeigt, dass zusätzliche Regeln nur schaden, wenn das Modell intelligent genug ist, und dass diejenigen im Vorteil sind, die den Kontext sorgfältig zusammengestellt haben. Diese Fähigkeit begleitet Sie bei jedem künftigen Modell, ob Opus 6 oder einem anderen.

Wo sollten Sie jetzt anfangen?#

Schieben Sie es nicht auf „irgendwann“ auf. Der einfachste erste Schritt: Öffnen Sie jetzt Ihre CLAUDE.md und fragen Sie sich bei jeder Zeile ehrlich: Ist das ein Fallstrick, den Claude nicht ableiten kann, oder etwas Offensichtliches, das ich vorsichtshalber hinzugefügt habe? Alles aus der zweiten Gruppe kommt zum Löschen infrage.

Lassen Sie als Nächstes die Datei mit dem Prompt aus dem obigen Abschnitt prüfen, verschieben Sie lange Verfahren in Skills und überprüfen Sie, ob das automatische Gedächtnis aktiviert ist. Eine Abend Arbeit – und Ihr Kontext wird zu einer prägnanten, präzisen Grundlage für das Modell.

Sie können das an einem eigenen realen Projekt anwenden: CLAUDE.md, ein Second Brain und Skills für Ihre Aufgaben.

Lernen Sie Ailoot kennen.