SSD Nodes Learn Hosting plans →
Anleitungen Matt ConnorVon Matt Connor · Aktualisiert 2026-10-26

Warum Coding-Agenten Ihre Anweisungen ignorieren

Ihre Anweisungsdatei sagt Stopp, doch der Agent arbeitet weiter. Erfahren Sie, ob die Regel fehlt, zu vage ist, widersprochen wird oder im Kontext zu weit zurückliegt.

Warum Coding-Agenten Ihre Anweisungen ignorieren

Coding-Agenten ignorieren Ihre Anweisungen aus vier Gründen. Keiner davon ist, dass Sie zu höflich waren. Die Regel befand sich nie im Kontextfenster. Die Regel war zu vage, um eine Handlung daran zu prüfen. Etwas anderes im Kontext widersprach ihr, meistens der Code, den der Agent gerade gelesen hatte. Oder die Regel ist weiterhin geladen, befindet sich aber weit hinter der aktuellen Anfrage, und der Agent arbeitet mit dem, was sich in der Nähe befindet.

Für jede Ursache gibt es eine eigene Lösung. Daher müssen Sie sie zuerst unterscheiden. Großbuchstaben und das Wort IMPORTANT sind keine Diagnose. Die folgenden Mechanismen verwenden Claude Code als Beispiel, weil sein Lade- und Komprimierungsverhalten mit Stand Oktober 2026 ausführlich dokumentiert ist. Andere Tools unterscheiden sich in den Details, funktionieren im Großen und Ganzen jedoch gleich.

Zuerst zwei Begriffe. Das Kontextfenster ist der Textblock, den das Modell in einem bestimmten Durchlauf sieht: System-Prompt, Ihre Anweisungsdateien, die Unterhaltung und jede Datei, die der Agent gelesen hat. Der Harness ist das Programm um das Modell herum, also das Programm, das Dateien vom Datenträger liest und diesen Block zusammenstellt. Fast jede Beschwerde in diesem Beitrag richtet sich in Wirklichkeit gegen den Harness und nicht gegen das Modell.

Ihre Anweisungsdatei ist eine Nachricht, keine Einstellung

Eine Anweisungsdatei ist keine Konfiguration. Zur Laufzeit liest nichts CLAUDE.md ein und setzt die Vorgabe durch. Das Harness liest die Datei von der Festplatte und fügt den Text in die Konversation ein. In Claude Code wird dieser Inhalt als User-Nachricht nach dem System-Prompt übermittelt. Das Modell sieht Ihre Regeln daher genauso wie alle anderen von Ihnen eingegebenen Inhalte.

Das hat eine unangenehme Konsequenz. Ihre Regeln stehen mit jedem anderen Text im Fenster in Konkurrenz und haben dabei denselben Stellenwert. Eine Regel ist eine Behauptung. Die Datei, die der Agent gerade geöffnet hat, ist ein Beleg. Wenn beide nicht übereinstimmen, setzt sich der Beleg häufig durch. Dabei wird kein Fehler ausgelöst, weil aus Sicht des Modells nichts schiefgelaufen ist.

Die offizielle Dokumentation sagt das ausdrücklich: Anweisungsdateien werden als Kontext behandelt, nicht als durchgesetzte Konfiguration. Um eine Aktion unabhängig von der Entscheidung des Modells zu blockieren, benötigen Sie einen Hook und keinen Satz. Merken Sie sich diese Aussage. Die meisten Lösungen am Ende dieses Beitrags wenden sie auf einen konkreten Fall an.

Welche Anweisungsdateien geladen werden und wann

Claude Code durchsucht den Verzeichnisbaum ausgehend von dem Verzeichnis, in dem Sie es gestartet haben, nach oben. Jede CLAUDE.md und CLAUDE.local.md vom Dateisystemstamm bis zu Ihrem Arbeitsverzeichnis wird beim Start vollständig geladen. Die Dateien werden in dieser Reihenfolge zusammengefügt. Die Datei, die dem Startverzeichnis am nächsten liegt, wird zuletzt gelesen. Innerhalb eines Verzeichnisses wird die .local-Datei nach der Hauptdatei angehängt.

Dateien in Unterverzeichnissen unterhalb Ihres Arbeitsverzeichnisses verhalten sich anders. Sie werden beim Start nicht geladen. Sie werden geladen, wenn der Agent eine Datei in diesem Verzeichnis liest. Dasselbe gilt für pfadbezogene Regeln in .claude/rules/ mit einem paths:-Frontmatter-Feld. Sie werden in den Kontext aufgenommen, wenn eine passende Datei gelesen wird, nicht bei jeder Runde. Seit v2.1.309 gilt für Dateien, die auf diese Weise geladen werden, außerdem eine Dateigrößenbegrenzung von 40,000 Zeichen bei einem Kontextfenster von 200K. Der Agent erhält nur den Anfang einer längeren Datei. Regeln am Ende einer großen verschachtelten Datei erreichen den Kontext daher möglicherweise nie.

Dieser eine Unterschied erklärt einen großen Teil der gemeldeten Fehler. Sie legen eine Regel in packages/api/CLAUDE.md ab, stellen eine Frage zur API, und der Agent antwortet, ohne jemals eine Datei unter packages/api/ zu öffnen. Die Regel wurde nicht ignoriert. Sie war nie vorhanden. Wenn Ihr Repository die Dokumentation auf Anweisungsdateien pro Paket in einem Monorepo verteilt, sollten Sie dies jedes Mal zuerst prüfen.

Ein weiterer Fallstrick beim Laden betrifft Repositories, die sich auf AGENTS.md standardisiert haben. Seit v2.1.277 liest Claude Code AGENTS.md standardmäßig als Projektanweisungen, jedoch nur dann, wenn sich in Ihrem Arbeitsverzeichnis oder in einem darüberliegenden Verzeichnis weder CLAUDE.md noch .claude/CLAUDE.md oder CLAUDE.local.md befindet. Ihre persönliche ~/.claude/CLAUDE.md zählt dabei nicht. Fügen Sie eine dieser Dateien hinzu, selbst eine CLAUDE.local.md für persönliche Notizen, liest Claude Code stattdessen Ihre CLAUDE.md-Dateien und lässt AGENTS.md vollständig außen vor. Um beide zu laden, setzen Sie Project instructions in /config auf claude-md-and-agents-md. Bei Versionen vor v2.1.277 oder wenn Sie eine CLAUDE.md beibehalten möchten, verwenden Sie als Brücke eine CLAUDE.md, deren erste Zeile @AGENTS.md lautet. Diese importiert die Datei beim Start; darunter können Sie Claude-spezifische Notizen ergänzen. Ein Symlink funktioniert ebenfalls, wenn Sie nichts Zusätzliches hinzufügen müssen. Welche Inhalte grundsätzlich in diese Datei gehören, ist eine separate Frage. Sie wird unter Trennung von Agentenanweisungen und menschlicher Dokumentation behandelt.

Überprüfen Sie, ob die Datei geladen wurde, bevor Sie sie neu schreiben

Ändern Sie den Wortlaut erst, wenn Sie nachgewiesen haben, dass der Agent die Datei sehen kann. Es gibt zwei Prüfungen. Beginnen Sie mit der einfachen.

Führen Sie /context innerhalb der Sitzung aus. Der Befehl zeigt das aktuelle Fenster nach Kategorien aufgeschlüsselt an. Die Liste Memory files enthält die Namen aller Anweisungsdateien, die beim Start geladen wurden. Fehlt eine Datei in dieser Liste, wurde sie beim Start nicht geladen. Dann kann nichts, was Sie darin schreiben, Wirkung haben, bis sie geladen wird. Eine verschachtelte Datei in einem Unterverzeichnis erscheint dort nie, weil sie bei Bedarf geladen wird. Beim Laden erscheint eine Zeile Loaded mit ihrem Pfad im Terminal. /memory listet die Speicherorte der Dateien auf und öffnet sie zur Bearbeitung, auch wenn sie noch nicht vorhanden sind.

Für eine genauere Prüfung können Sie die Ladevorgänge protokollieren. Das Hook-Ereignis InstructionsLoaded wird jedes Mal ausgelöst, wenn ein CLAUDE.md oder eine Regeldatei in den Kontext gelangt. Der Matcher zeigt den Grund für das Laden an: session_start, nested_traversal, path_glob_match, include oder compact. Fügen Sie dies in .claude/settings.json ein:

{
  "hooks": {
    "InstructionsLoaded": [
      {
        "matcher": "nested_traversal",
        "hooks": [
          {
            "type": "command",
            "command": "cat >> /tmp/instructions-loaded.log"
          }
        ]
      }
    ]
  }
}

Der Hook empfängt seine Nutzdaten als JSON über die Standardeingabe. Daher hängt cat den vollständigen Datensatz an. Überwachen Sie die Datei während der Arbeit mit tail -f /tmp/instructions-loaded.log. Der Exit-Status dieses Ereignisses wird ignoriert. Der Hook kann daher nur beobachten, aber nicht blockieren. Wenn Ihre verschachtelte Datei während einer Sitzung, in der Sie ihr Laden erwartet haben, nie in diesem Protokoll erscheint, ändern Sie den Wortlaut nicht weiter. Das Problem liegt an der Platzierung. Eine Ausnahme ist ein AGENTS.md, das Claude Code direkt liest. Dafür wird dieses Ereignis nicht ausgelöst. Suchen Sie stattdessen in /memory nach seinem Pfad. Ein AGENTS.md, das aus einem CLAUDE.md importiert wird, löst das Ereignis wie gewohnt aus.

Was eine lange Sitzung mit Ihren Regeln macht

Hier wirken zwei voneinander getrennte Effekte. Sie erfordern unterschiedliche Maßnahmen.

Entfernung. Solange keine Komprimierung ausgeführt wurde, befindet sich eine Regel aus Turn 1 auch in Turn 90 noch im Kontextfenster. Dort konkurriert sie mit 90 Textabschnitten, die aktueller und stärker auf Ihre derzeitige Aufgabe bezogen sind. Nach einer Komprimierung befindet sich eine Regel, die Sie nur in den Chat eingegeben haben, möglicherweise überhaupt nicht mehr im Kontextfenster: Die Dokumentation von Claude Code weist darauf hin, dass Anweisungen aus dem frühen Gesprächsverlauf verloren gehen können. Das ist der zweite Effekt weiter unten. Die Entfernung können Sie nicht konfigurieren, aber Sie können sie messen. Führen Sie dieselbe Aufgabe in einer neuen Sitzung aus. Wenn die Regel dort funktioniert, aber im weiteren Verlauf einer langen Sitzung nicht mehr, ist die Entfernung oder die Komprimierung die Ursache.

Komprimierung. Wenn das Kontextfenster voll ist, fasst das Harness den bisherigen Gesprächsverlauf zusammen und setzt die Sitzung auf Grundlage dieser Zusammenfassung fort. Erhalten bleibt, was der Zusammenfasser für wichtig hält. Das stimmt nicht zwangsläufig mit dem überein, was Sie für wichtig halten. Claude Code dokumentiert das Ergebnis für die einzelnen Mechanismen. Die Unterschiede sind erheblich. Die Projektstammdatei CLAUDE.md und Regeln ohne Einschränkung werden nach einer Komprimierung erneut von der Festplatte geladen. Der automatische Speicher wird ebenfalls von der Festplatte erneut geladen. Regeln mit paths:-Frontmatter gehen verloren, bis wieder eine passende Datei gelesen wird. Verschachtelte CLAUDE.md-Dateien in Unterverzeichnissen gehen verloren, bis wieder eine Datei aus diesem Unterverzeichnis gelesen wird.

Ordnen Sie Ihre Anweisungen nach dieser Tabelle. Daraus ergibt sich unmittelbar die Reihenfolge ihrer Anfälligkeit. Eine Regel, die Sie nur in den Chat eingegeben haben, ist das anfälligste Element der Sitzung. Sie bleibt nur erhalten, wenn die Zusammenfassung sie zufällig übernimmt. Eine Regel in packages/api/CLAUDE.md folgt als Nächstes, weil sie einmal geladen, bei der Zusammenfassung entfernt und erst beim nächsten Lesen in diesem Verzeichnis wieder geladen wird. Eine Regel in der Datei im Projektstamm ist am dauerhaftesten, weil sie jedes Mal erneut von der Festplatte gelesen wird.

Wenn eine Anweisung während der gesamten Sitzung gelten muss, gehört sie ohne paths:-Frontmatter in die Projektstammdatei. Alle anderen Entscheidungen sind Abwägungen, die Sie bewusst treffen sollten. Verwalten der Inhalte im Kontextfenster behandelt /compact mit einem Fokusargument sowie /clear zwischen voneinander unabhängigen Aufgaben. Beide Faktoren beeinflussen, wie oft der Zusammenfasser entscheidet, welche Regeln Sie festgelegt hatten.

Warum der umgebende Code die Regel überstimmt

Das ist der Fehler, den Menschen am häufigsten beschreiben und am seltensten diagnostizieren. Ihre Datei sagt, dass der Datenbankzugriff über die Repository-Schicht erfolgt. Der Agent schreibt einen Handler, der das ORM (Object-Relational Mapper) direkt aufruft. Sie wurden nicht aus stilistischen Gründen ignoriert. Die Belege haben sich gegen Sie durchgesetzt.

Eine Regel beschreibt eine Präferenz. Der Code demonstriert eine davon. Wenn der Agent drei Dateien in dem Modul öffnet, das er bearbeiten soll, und alle drei das ORM direkt aufrufen, stehen auf der einen Seite ein abstrakter Satz und auf der anderen Seite drei konkrete, aktuelle und zur Aufgabe passende Beispiele. Das lokale Muster zu übernehmen, ist normalerweise das richtige Verhalten. Hier ist es nur deshalb falsch, weil Sie etwas wissen, das im Kontext nicht steht: Diese Dateien sind veraltet.

Schreiben Sie das daher in die Regel. Regeln, die ihre eigenen Gegenbelege benennen, bewähren sich in einem echten Repository. Regeln, die nur eine Präferenz formulieren, tun das nicht.

Neuer Datenbankzugriff erfolgt über app/repositories/. Dateien unter app/legacy/ rufen das ORM weiterhin direkt auf. Das ist alter Code und nicht das gewünschte Muster. Kopieren Sie ihn nicht.

Der zweite Satz erfüllt die eigentliche Aufgabe. Er teilt dem Agenten mit, was er gleich vorfinden wird und wie er es einordnen soll, bevor er es sieht. Die gleiche Korrektur gilt für jede Regel, der Ihr Repository sichtbar widerspricht: einen Commit-Stil, den Ihre Historie nicht verwendet, eine Teststruktur, die die Hälfte Ihrer Tests ignoriert, oder eine Import-Konvention, die nur im neuen Code gilt. Wenn der Code der Datei widerspricht, benennen Sie diesen Widerspruch in der Datei.

Eine vage Regel kann nicht geprüft und deshalb nicht befolgt werden

"Schreiben Sie sauberen Code." "Vermeiden Sie unnötige Komplexität." "Halten Sie es einfach." "Gehen Sie bei Migrationen sorgfältig vor." Keine dieser Regeln lässt sich anhand einer konkreten Aktion prüfen, weder durch den Agenten noch durch Sie. Ein Agent, der eine Regel nicht anhand seiner eigenen Ausgabe prüfen kann, rät. Sie bewerten dieses Raten nach Gefühl.

Wenden Sie auf jede Zeile Ihrer Datei den folgenden Test an. Schreiben Sie den Shell-Befehl, der mit einem Exit-Code ungleich null beendet wird, wenn die Regel verletzt ist. Wenn Sie diesen Befehl nicht schreiben können, ist die Regel nicht prüfbar. Vergleichen Sie diese Paare:

  • Nicht prüfbar: "Halten Sie Funktionen klein." Prüfbar: "Eine Funktion mit mehr als 60 Zeilen benötigt darüber einen Kommentar, der erklärt, warum sie so lang ist."
  • Nicht prüfbar: "Testen Sie Ihre Änderungen." Prüfbar: "Führen Sie npm test aus und fügen Sie die Anzahl der Fehler ein, bevor Sie eine Aufgabe als abgeschlossen markieren."
  • Nicht prüfbar: "Halten Sie die Dateien organisiert." Prüfbar: "HTTP-Handler liegen in src/api/handlers/. In diesem Verzeichnis darf sich nichts anderes befinden."
  • Nicht prüfbar: "Formatieren Sie den Code korrekt." Prüfbar: "Verwenden Sie in Dateien unter .ts eine Einrückung mit 2 Leerzeichen."

"Vermeiden Sie unnötige Komplexität" geben Menschen als Erstes auf, weil die Korrektur nicht in einem kürzeren Satz besteht, sondern in einem längeren: Wenn Sie ausdrücklich festlegen, was die kleinste funktionierende Änderung bedeutet, erhält der Agent Kriterien, an denen er seinen eigenen Diff messen kann.

Größe ist dasselbe Problem unter einem anderen Namen. Die Empfehlungen von Claude Code zielen auf weniger als 200 Zeilen pro Anweisungsdatei ab und stellen direkt fest, dass längere Dateien die Befolgung verringern. Eine Datei mit 700 Zeilen enthält keine verbindlichere Anweisung. Sie enthält 700 Aussagen mit mehr Möglichkeiten für Widersprüche und wird bei jeder einzelnen Runde auf Ihr Kontextfenster angerechnet, was sich direkt in Ihrem Token-Verbrauch zeigt. Wenn Sie die Datei so strukturieren, dass jede Regel unter einer Überschrift steht, die ein Leser schnell erfassen kann, wird dies in Schreiben einer Anweisungsdatei, die ein Agent ausführen kann behandelt. Noch besser ist es, die beschreibenden Teile zu entfernen, die keine Anweisungen enthalten: Eine Übersicht der Verzeichnisse, in der die Speicherorte der Handler und Modelle beschrieben werden, ist eine Struktur, die der Agent bei Bedarf in einer geparsten Repository-Übersicht nachschlagen kann, statt sie in jeder Runde im Kontextfenster mitzuführen.

So diagnostizieren Sie das Problem in zehn Minuten

Führen Sie diese Schritte in der angegebenen Reihenfolge aus. Wer direkt zum letzten Schritt springt, endet häufig mit einer langen Datei voller großgeschriebener Regeln, die trotzdem nicht funktioniert.

  1. Prüfen Sie, ob die Datei geladen wurde. Führen Sie /context aus und lesen Sie die Liste Memory files. Bei einer verschachtelten Datei suchen Sie im Terminal nach der Zeile Loaded. Wenn die Datei nicht vorhanden ist, korrigieren Sie den Speicherort und beenden Sie die Prüfung. Die übrigen Punkte dieser Liste sind dann noch nicht relevant.
  2. Reproduzieren Sie das Problem in einer neuen Sitzung. Starten Sie eine neue Sitzung und stellen Sie die kleinste Aufgabe, die die Regel auslösen sollte. Wenn die Regel in einer neuen Sitzung eingehalten wird, in einer langen Sitzung aber nicht, deutet das auf Distanz oder Kompaktierung hin. Wenn sie auch in der neuen Sitzung nicht eingehalten wird, liegt das Problem bei der Regel selbst.
  3. Entfernen Sie konkurrierende Vorgaben. Fordern Sie dieselbe Änderung in einem Verzeichnis an, dessen vorhandener Code die Regel bereits befolgt. Wenn die Regel dann wieder eingehalten wird, hat der umgebende Code Ihre Anweisung überstimmt.
  4. Suchen Sie nach einem Konflikt. Wenn zwei Dateien für dasselbe Verhalten unterschiedliche Vorgaben enthalten, liegt ein dokumentierter Fehler vor: Das Modell kann eine der Vorgaben beliebig auswählen und teilt Ihnen nicht mit, dass es das getan hat.
  5. Formulieren Sie die Regel prüfbar und testen Sie erneut. Schreiben Sie die Regel mit einem konkreten Pfad und einer Bedingung neu. Ein deutlicher Anstieg bei der Einhaltung bedeutet, dass die Formulierung die Ursache war.

Schritt 4 besteht aus einem Befehl. Durchsuchen Sie jede Quelle mit Anweisungen nach dem Thema, nicht nur die Datei, die Sie gerade bearbeitet haben:

grep -rni "migration" --include="CLAUDE.md" --include="CLAUDE.local.md" --include="AGENTS.md" .
grep -rni "migration" .claude/rules/ ~/.claude/CLAUDE.md ~/.claude/rules/ 2>/dev/null

Ein Treffer in zwei Dateien mit unterschiedlichen Vorgaben ist der Fehler. Löschen Sie eine davon. Versuchen Sie nicht, die Vorgaben mit einer stärkeren Formulierung zu priorisieren, da es keine Priorisierungslogik gibt, auf die Sie zurückgreifen können. In Claude Code v2.1.283 oder höher führt /doctor prompt-audit eine umfassendere Suche in Ihren Anweisungsdateien, Regeln und Skills aus und meldet Widersprüche mit vorgeschlagenen Änderungen, ohne etwas zu ändern, bis Sie dies anfordern.

Die Maßnahmen, nach ihrer Wirksamkeit geordnet

Jeder folgende Schritt bietet mehr Wirkung als der vorherige und verursacht höhere Einrichtungskosten. Beginnen Sie oben, wenn sich eine Regel kostengünstig umformulieren lässt. Gehen Sie nach unten, sobald eine Regel so wichtig ist, dass gelegentliche Verstöße nicht akzeptabel sind.

  1. Formulieren Sie die Regel konkret. Nennen Sie einen Pfad, einen Befehl oder eine Bedingung. Fügen Sie die Gegenbelege hinzu, die der Agent wie zuvor gezeigt im Repository findet. Das kostet nichts und behebt überraschend viele Fälle.
  2. Platzieren Sie die Regel näher an dem, was sie steuert. Verwenden Sie ein verschachteltes CLAUDE.md, eine pfadbezogene Regel in .claude/rules/ oder einen Kommentar am Anfang der Datei selbst. Die Regel wird dann beim selben Lesen wie der Code geladen, für den sie gilt. Akzeptieren Sie den Nachteil: Alles, was auf diese Weise geladen wurde, fällt bei der nächsten Komprimierung aus dem Kontext und kehrt beim nächsten passenden Lesen zurück.
  3. Verlagern Sie die Durchsetzung in einen Hook. Prosa bittet. Ein Hook entscheidet. Hooks werden als Code bei festgelegten Ereignissen im Lebenszyklus ausgeführt und gelten unabhängig davon, zu welchem Schluss das Modell kommt.
  4. Übergeben Sie die Regel einem deterministischen Tool und löschen Sie die Prosa. Formatierung, Reihenfolge von Imports, Zeilenlänge, verbotene Imports, das Format von Commit-Nachrichten. ruff format, prettier --write, eslint, ein pre-commit-Hook. Der Formatter ist jedes Mal korrekt und kostet keine Tokens. Der Satz ist meistens korrekt und kostet bei jedem Durchlauf Tokens.

Schritt 3 im Detail. Angenommen, der Agent darf Migrationsdateien niemals bearbeiten. Tragen Sie Folgendes in .claude/settings.json ein:

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "${CLAUDE_PROJECT_DIR}/.claude/hooks/guard-migrations.sh"
          }
        ]
      }
    ]
  }
}

Und Folgendes in .claude/hooks/guard-migrations.sh:

#!/usr/bin/env bash
set -euo pipefail

path=$(jq -r '.tool_input.file_path // empty')

case "$path" in
  */migrations/*)
    echo "Files under migrations/ are written by hand. Stop and ask first." >&2
    exit 2
    ;;
esac

exit 0

Führen Sie chmod +x .claude/hooks/guard-migrations.sh aus. Starten Sie anschließend eine neue Sitzung und fordern Sie den Agenten auf, eine Datei unter migrations/ zu bearbeiten. Die Bearbeitung wird abgelehnt, und Ihre Nachricht wird als Begründung zurückgegeben. Der Exit-Status 2 bei PreToolUse blockiert den Tool-Aufruf vor seiner Ausführung. Ihr stderr-Text wird dem Modell als blockierende Nachricht übergeben. ${CLAUDE_PROJECT_DIR} wird in das Projektverzeichnis aufgelöst, sodass der Hook unabhängig davon funktioniert, in welchem Verzeichnis sich der Agent befindet. Der Agent muss der Regel nicht zustimmen, sich nicht an sie erinnern und sie nicht mehr im Kontext haben. Die Bearbeitung findet nicht statt.

Für ein pauschales Verbot ohne eigene Logik erledigt permissions.deny in Ihren Einstellungen dieselbe Aufgabe, ohne dass Sie ein Skript pflegen müssen. Die Berechtigungsmodi legen fest, was ohne Ihre vorherige Zustimmung ausgeführt wird. Wenn eine Anweisung tatsächlich auf der Ebene der Systemaufforderung statt in einer Benutzernachricht stehen muss, platziert --append-system-prompt sie dort. Es handelt sich jedoch um ein Start-Flag, das bei jeder neuen Sitzung erneut übergeben werden muss. Das eignet sich besser für Skripte als für die interaktive Arbeit.

Was Sie nicht wegweisen können

Machen Sie klar, welcher Teil in Ihrer Verantwortung liegt. Platzierung, Formulierung, Konflikte zwischen Dateien und Dateigröße sind Probleme des Autors und lassen sich vom Autor beheben. Der Rest ist Modellverhalten. Eine bessere Formulierung wird es nicht beseitigen.

Zustimmung ist keine Befolgung. Ein Agent wird eine Regel bestätigen, sie korrekt wiederholen und sie zwei Tool-Aufrufe später brechen. Die Bestätigung kostet nichts und sagt nichts voraus. Betrachten Sie sie nicht als Behebung und zählen Sie sie nicht als Test.

Manche Gewohnheiten bleiben bestehen. Kommentare hinzufügen, defensive Fehlerbehandlung ergänzen, eine abschließende Zusammenfassung schreiben, den naheliegenden nächsten Befehl ausführen. Diese Verhaltensweisen treten unter einer Regel, die sie verbietet, weiterhin auf, nur seltener statt gar nicht. Sie können Ihre eigene Rate messen: Führen Sie dieselbe Aufgabe zehnmal in frischen Sitzungen aus und zählen Sie die Verstöße. Wenn diese Zahl 0 sein muss, gehört die Regel nicht in den Prompt. Eine Aufgabe als abgeschlossen zu bezeichnen, obwohl ein Teil noch unerledigt ist, hat dieselbe Ursache. Die Behebung ist strukturell und nicht sprachlich: Das unlazy skill ersetzt den Satz durch einen Depth Tree und Gate-Dateien, die der Agent abarbeiten muss, bevor er die Aufgabe als abgeschlossen bezeichnen darf.

Ihre eigene Sitzung wird zu einem Beispiel. Wenn der Agent in Turn 12 gegen die Regel verstößt und Sie das zulassen, befindet sich dieser Verstoß nun als Demonstration im Kontext und ist deutlich aktueller als die Regel. Korrigieren Sie einen Verstoß sofort, sobald Sie ihn sehen. Ein unkorrigierter Verstoß beeinflusst den restlichen Verlauf der Sitzung.

Eine Anweisungsdatei ist keine Sicherheitsgrenze. Sie beeinflusst das Verhalten, setzt es aber nicht durch. Alles, bei dem ein Fehler kostspielig ist, etwa Zugangsdaten oder destruktive Befehle, gehört in Berechtigungen oder einen Hook. Halten Sie Geheimnisse außerhalb der Reichweite eines Agenten wendet dasselbe Prinzip auf Daten an: Bitten Sie einen Agenten nicht, eine Datei nicht zu lesen. Sorgen Sie dafür, dass die Datei nicht lesbar ist.

Die Kurzfassung: Beweisen Sie, dass die Datei geladen wurde, machen Sie die Regel überprüfbar, verschieben Sie sie neben das, was sie steuert, und entfernen Sie sie aus dem Fließtext, wenn die Fehlerquote weiterhin relevant ist. Eine Regel, die ein Agent nicht ignorieren kann, wurde nie vom Agenten verlangt.

FAQ

Warum ignoriert Claude Code meine CLAUDE.md?

Prüfen Sie zunächst, ob die Datei geladen wurde, bevor Sie annehmen, dass sie ignoriert wurde. Führen Sie /context aus und sehen Sie in der Liste Memory files nach. Eine dort nicht aufgeführte Datei wurde beim Start nicht geladen. Anweisungsdateien werden nach der Systemaufforderung als User-Nachricht übermittelt und als Kontext behandelt, nicht als durchgesetzte Konfiguration. Daher gibt es keine strikte Compliance-Garantie. In der Praxis liegt meist einer von vier Fällen vor: Die Datei befindet sich in einem Unterverzeichnis, aus dem der Agent nie gelesen hat, zwei Dateien widersprechen sich und das Modell hat willkürlich eine ausgewählt, die Regel ist zu vage, um eine Aktion daran zu prüfen, oder der umgebende Code zeigt das Gegenteil der Regel.

Ändert das Bearbeiten der Anweisungsdatei während einer Sitzung etwas?

Nicht für die Kopie, die sich bereits in der Unterhaltung befindet. Dateien oberhalb Ihres Arbeitsverzeichnisses werden beim Start vollständig geladen. Der vom Modell gehaltene Text stammt daher vom Zeitpunkt des Starts. Um eine Änderung zu übernehmen, starten Sie eine neue Sitzung oder bitten Sie den Agenten, die Datei mit seinen normalen Dateiverwaltungswerkzeugen zu lesen. Dadurch wird die aktuelle Version als neue Nachricht in die Unterhaltung aufgenommen. Nach einer Komprimierung wird die Datei im Projektstamm erneut von der Festplatte gelesen. Dadurch steht die neue Version auch zu diesem Zeitpunkt zur Verfügung.

Welche Datei hat Vorrang, wenn eine CLAUDE.md im Stammverzeichnis und eine verschachtelte Datei widersprüchliche Regeln enthalten?

Keine von beiden zuverlässig. Erkannte Dateien werden in den Kontext verkettet, statt sich gegenseitig zu überschreiben. Die Reihenfolge verläuft vom Dateisystemstamm bis zu Ihrem Arbeitsverzeichnis. Die nächstgelegene Datei wird daher lediglich zuletzt gelesen. Es gibt keine Prioritätslogik, die Widersprüche auflöst. Die Dokumentation von Claude Code weist darauf hin, dass widersprüchliche Regeln willkürlich aufgelöst werden können. Schreiben Sie verschachtelte Dateien als Ergänzungen, die den von ihnen geregelten Pfad nennen. Entfernen Sie den Widerspruch, statt zu versuchen, ihn durch eine höhere Priorität zu überstimmen.

Überstehen meine Anweisungen /compact?

Das hängt davon ab, wie sie geladen wurden. Die Datei im Projektstamm CLAUDE.md, Regeln ohne Geltungsbereich und der automatische Speicher werden nach einer Komprimierung erneut von der Festplatte eingefügt. Regeln mit paths:-Frontmatter und verschachtelte CLAUDE.md-Dateien in Unterverzeichnissen gehen verloren, bis wieder eine passende Datei gelesen wird. Inhalte, die Sie nur in den Chat eingegeben haben, bleiben nur erhalten, wenn der Zusammenfasser sie zufällig übernommen hat. Wenn eine Regel während der gesamten Sitzung gelten muss, legen Sie sie ohne paths:-Frontmatter in der Datei im Projektstamm ab.

Wann sollte eine Regel zu einem Hook statt zu Prosa werden?

Wenn die Prüfung deterministisch ist und die Kosten eines übersehenen Falls höher sind als der Aufwand für ein kleines Skript. Einschränkungen für Dateipfade, erforderliche Befehle vor einem Commit und verbotene Tool-Aufrufe fallen darunter. Ein PreToolUse-Hook, der mit Status 2 beendet wird, blockiert den Tool-Aufruf unmittelbar und übergibt den stderr-Text als Begründung an das Modell. Dadurch gilt die Regel unabhängig davon, ob sie noch im Kontext vorhanden ist. Alles, was ein Formatter oder Linter entscheiden kann, sollte von diesem Tool verwaltet und vollständig aus der Anweisungsdatei entfernt werden.

War dieser Artikel hilfreich?