4 4 

5# Wie Claude sich Ihr Projekt merkt5# Wie Claude sich Ihr Projekt merkt

6 6 

7> Geben Sie Claude persistente Anweisungen mit CLAUDE.md-Dateien, und lassen Sie Claude automatisch Erkenntnisse mit Auto-Memory sammeln.7> Geben Sie Claude persistente Anweisungen mit CLAUDE.md- oder AGENTS.md-Dateien, und lassen Sie Claude automatisch Erkenntnisse mit Auto-Memory sammeln.

8 8 

9Jede Claude Code-Sitzung beginnt mit einem frischen Context Window. Zwei Mechanismen tragen Wissen über Sitzungen hinweg:9Jede Claude Code-Sitzung beginnt mit einem frischen Context Window. Zwei Mechanismen tragen Wissen über Sitzungen hinweg:

10 10 

11* **CLAUDE.md-Dateien**: Anweisungen, die Sie schreiben, um Claude persistenten Kontext zu geben11* **CLAUDE.md-Dateien**: Anweisungen, die Sie schreiben, um Claude persistenten Kontext zu geben. Claude kann auch die [`AGENTS.md`-Dateien](#agents-md) eines Repositorys lesen, eigenständig oder zusammen mit CLAUDE.md

12* **Auto-Memory**: Notizen, die Claude selbst basierend auf Ihren Korrektionen und Vorlieben schreibt12* **Auto-Memory**: Notizen, die Claude selbst basierend auf Ihren Korrektionen und Vorlieben schreibt

13 13 

14Diese Seite behandelt folgende Themen:14Diese Seite behandelt folgende Themen:

15 15 

16* [CLAUDE.md-Dateien schreiben und organisieren](#claude-md-files)16* [CLAUDE.md-Dateien schreiben und organisieren](#claude-md-files)

17* [Ein vorhandenes AGENTS.md](#agents-md) als Ihre Projektanweisungen verwenden, eigenständig oder zusammen mit CLAUDE.md

17* [Regeln auf bestimmte Dateitypen beschränken](#organize-rules-with-claude/rules/) mit `.claude/rules/`18* [Regeln auf bestimmte Dateitypen beschränken](#organize-rules-with-claude/rules/) mit `.claude/rules/`

18* [Auto-Memory konfigurieren](#auto-memory), damit Claude automatisch Notizen macht19* [Auto-Memory konfigurieren](#auto-memory), damit Claude automatisch Notizen macht

19* [Fehlerbehebung](#troubleshoot-memory-issues), wenn Anweisungen nicht befolgt werden20* [Fehlerbehebung](#troubleshoot-memory-issues), wenn Anweisungen nicht befolgt werden

40 CLAUDE.md-Dateien41 CLAUDE.md-Dateien

41</h2>42</h2>

42 43 

43CLAUDE.md-Dateien sind Markdown-Dateien, die Claude persistente Anweisungen für ein Projekt, Ihren persönlichen Workflow oder Ihre gesamte Organisation geben. Sie schreiben diese Dateien in Klartext; Claude liest sie zu Beginn jeder Sitzung.44CLAUDE.md-Dateien sind Markdown-Dateien, die Claude persistente Anweisungen für ein Projekt, Ihren persönlichen Arbeitsablauf oder Ihre gesamte Organisation geben. Sie schreiben diese Dateien in Klartext; Claude liest sie zu Beginn jeder Sitzung. Wenn Ihr Repository stattdessen `AGENTS.md` verwendet, siehe [AGENTS.md](#agents-md).

44 45 

45<h3 id="when-to-add-to-claude-md">46<h3 id="when-to-add-to-claude-md">

46 Wann sollte ich zu CLAUDE.md hinzufügen47 Wann Sie zu CLAUDE.md hinzufügen

47</h3>48</h3>

48 49 

49Behandeln Sie CLAUDE.md als den Ort, an dem Sie aufschreiben, was Sie sonst erneut erklären würden. Fügen Sie hinzu, wenn:50Behandeln Sie CLAUDE.md als den Ort, an dem Sie aufschreiben, was Sie sonst erklären würden. Fügen Sie hinzu, wenn:

50 51 

51* Claude denselben Fehler ein zweites Mal macht52* Claude denselben Fehler ein zweites Mal macht

52* Eine Code-Review etwas findet, das Claude über diese Codebasis hätte wissen sollen53* Eine Code-Überprüfung etwas findet, das Claude über diese Codebasis hätte wissen sollen

53* Sie tippen die gleiche Korrektur oder Klarstellung in den Chat, die Sie letzte Sitzung eingegeben haben54* Sie dieselbe Korrektur oder Klarstellung in den Chat eingeben, die Sie in der letzten Sitzung eingegeben haben

54* Ein neuer Teamkollege den gleichen Kontext benötigen würde, um produktiv zu sein55* Ein neues Teammitglied denselben Kontext benötigen würde, um produktiv zu sein

55 56 

56Halten Sie es bei Fakten, die Claude in jeder Sitzung behalten sollte: Build-Befehle, Konventionen, Projektlayout, „immer X machen"-Regeln. Wenn ein Eintrag ein mehrstufiges Verfahren ist oder nur für einen Teil der Codebasis wichtig ist, verschieben Sie ihn stattdessen zu einem [Skill](/docs/de/skills) oder einer [pfadgebundenen Regel](#organize-rules-with-claude/rules/). Die [Funktionsübersicht](/docs/de/features-overview#build-your-setup-over-time) behandelt, wann Sie jeden Mechanismus verwenden.57Halten Sie es bei Fakten, die Claude in jeder Sitzung behalten sollte: Build-Befehle, Konventionen, Projektlayout, „immer X tun"-Regeln. Wenn ein Eintrag ein mehrstufiges Verfahren ist oder nur für einen Teil der Codebasis relevant ist, verschieben Sie ihn zu einem [Skill](/docs/de/skills) oder einer [pfadgebundenen Regel](#organize-rules-with-claude/rules/) statt. Die [Erweiterungsübersicht](/docs/de/features-overview#build-your-setup-over-time) behandelt, wann Sie jeden Mechanismus verwenden.

57 58 

58<h3 id="choose-where-to-put-claude-md-files">59<h3 id="choose-where-to-put-claude-md-files">

59 Wählen Sie, wo Sie CLAUDE.md-Dateien ablegen60 Wählen Sie, wo Sie CLAUDE.md-Dateien ablegen

62CLAUDE.md-Dateien können sich an mehreren Orten befinden, jeder mit einem anderen Umfang. Die folgende Tabelle listet sie in Ladereihenfolge auf, vom breitesten Umfang zum spezifischsten, sodass eine Projektanweisung im Kontext nach einer Benutzeranweisung erscheint.63CLAUDE.md-Dateien können sich an mehreren Orten befinden, jeder mit einem anderen Umfang. Die folgende Tabelle listet sie in Ladereihenfolge auf, vom breitesten Umfang zum spezifischsten, sodass eine Projektanweisung im Kontext nach einer Benutzeranweisung erscheint.

63 64 

64| Umfang | Ort | Zweck | Anwendungsbeispiele | Geteilt mit |65| Umfang | Ort | Zweck | Anwendungsbeispiele | Geteilt mit |

65| ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------- | ------------------------------------------------------------------------------- | -------------------------------------- |66| ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- | ------------------------------------- |

66| **Verwaltete Richtlinie** | • macOS: `/Library/Application Support/ClaudeCode/CLAUDE.md`<br />• Linux und WSL: `/etc/claude-code/CLAUDE.md`<br />• Windows: `C:\Program Files\ClaudeCode\CLAUDE.md` | Organisationsweite Anweisungen, verwaltet von IT/DevOps | Unternehmens-Coding-Standards, Sicherheitsrichtlinien, Compliance-Anforderungen | Alle Benutzer in der Organisation |67| **Verwaltete Richtlinie** | • macOS: `/Library/Application Support/ClaudeCode/CLAUDE.md`<br />• Linux und WSL: `/etc/claude-code/CLAUDE.md`<br />• Windows: `C:\Program Files\ClaudeCode\CLAUDE.md` | Organisationsweite Anweisungen, verwaltet von IT/DevOps | Unternehmens-Codierungsstandards, Sicherheitsrichtlinien, Compliance-Anforderungen | Alle Benutzer in der Organisation |

67| **Benutzeranweisungen** | `~/.claude/CLAUDE.md` | Persönliche Vorlieben für alle Projekte | Code-Styling-Vorlieben, persönliche Tooling-Shortcuts | Nur Sie (alle Projekte) |68| **Benutzeranweisungen** | `~/.claude/CLAUDE.md` | Persönliche Voreinstellungen für alle Projekte | Code-Stilvoreinstellungen, persönliche Tooling-Verknüpfungen | Nur Sie (alle Projekte) |

68| **Projektanweisungen** | `./CLAUDE.md` oder `./.claude/CLAUDE.md` | Team-gemeinsame Anweisungen für das Projekt | Projektarchitektur, Coding-Standards, häufige Workflows | Team-Mitglieder über Versionskontrolle |69| **Projektanweisungen** | `./CLAUDE.md` oder `./.claude/CLAUDE.md`. Siehe [AGENTS.md](#agents-md) für den Fall, dass `./AGENTS.md` stattdessen oder zusammen mit ihnen geladen wird | Team-gemeinsame Anweisungen für das Projekt | Projektarchitektur, Codierungsstandards, häufige Arbeitsabläufe | Teammitglieder über Versionskontrolle |

69| **Lokale Anweisungen** | `./CLAUDE.local.md` | Persönliche projektspezifische Vorlieben; zu `.gitignore` hinzufügen | Ihre Sandbox-URLs, bevorzugte Testdaten | Nur Sie (aktuelles Projekt) |70| **Lokale Anweisungen** | `./CLAUDE.local.md` | Persönliche projektspezifische Voreinstellungen; zu `.gitignore` hinzufügen | Ihre Sandbox-URLs, bevorzugte Testdaten | Nur Sie (aktuelles Projekt) |

70 71 

71CLAUDE.md- und CLAUDE.local.md-Dateien in der Verzeichnishierarchie über dem Arbeitsverzeichnis werden beim Start vollständig geladen. Dateien in Unterverzeichnissen werden bei Bedarf geladen, wenn Claude Dateien in diesen Verzeichnissen liest. Weitere Informationen finden Sie unter [Wie CLAUDE.md-Dateien geladen werden](#how-claude-md-files-load) für die vollständige Auflösungsreihenfolge.72CLAUDE.md- und CLAUDE.local.md-Dateien in der Verzeichnishierarchie über dem Arbeitsverzeichnis werden beim Start geladen. Dateien in Unterverzeichnissen werden bei Bedarf geladen, wenn Claude Dateien in diesen Verzeichnissen liest. Siehe [Wie CLAUDE.md-Dateien geladen werden](#how-claude-md-files-load) für die vollständige Auflösungsreihenfolge.

72 73 

73Für große Projekte können Sie Anweisungen in themaspezifische Dateien aufteilen, indem Sie [Projektregeln](#organize-rules-with-claude/rules/) verwenden. Regeln ermöglichen es Ihnen, Anweisungen auf bestimmte Dateitypen oder Unterverzeichnisse zu beschränken.74Für große Projekte können Sie Anweisungen in themaspezifische Dateien aufteilen, indem Sie [Projektregeln](#organize-rules-with-claude/rules/) verwenden. Regeln ermöglichen es Ihnen, Anweisungen auf bestimmte Dateitypen oder Unterverzeichnisse zu beschränken.

74 75 

75<h3 id="set-up-a-project-claude-md">76<h3 id="set-up-a-project-claude-md">

76 Richten Sie eine Projekt-CLAUDE.md ein77 Richten Sie ein Projekt-CLAUDE.md ein

77</h3>78</h3>

78 79 

79Eine Projekt-CLAUDE.md kann entweder in `./CLAUDE.md` oder `./.claude/CLAUDE.md` gespeichert werden. Erstellen Sie diese Datei und fügen Sie Anweisungen hinzu, die für jeden gelten, der am Projekt arbeitet: Build- und Test-Befehle, Coding-Standards, architektonische Entscheidungen, Namenskonventionen und häufige Workflows. Diese Anweisungen werden über Versionskontrolle mit Ihrem Team geteilt, daher konzentrieren Sie sich auf projektweite Standards statt auf persönliche Vorlieben. Um zu bestätigen, dass die Datei geladen wurde, führen Sie `/context` in einer Sitzung aus und überprüfen Sie die Liste unter **Memory-Dateien**.80Ein Projekt-CLAUDE.md kann entweder in `./CLAUDE.md` oder `./.claude/CLAUDE.md` gespeichert werden. Erstellen Sie diese Datei und fügen Sie Anweisungen hinzu, die für jeden gelten, der am Projekt arbeitet: Build- und Test-Befehle, Codierungsstandards, architektonische Entscheidungen, Namenskonventionen und häufige Arbeitsabläufe. Diese Anweisungen werden über Versionskontrolle mit Ihrem Team geteilt, daher konzentrieren Sie sich auf projektweite Standards statt auf persönliche Voreinstellungen. Um zu bestätigen, dass die Datei geladen wurde, führen Sie `/context` in einer Sitzung aus und überprüfen Sie die Liste unter **Memory-Dateien**.

80 81 

81<Tip>82<Tip>

82 Führen Sie `/init` aus, um automatisch eine Start-CLAUDE.md zu generieren. Claude analysiert Ihre Codebasis und erstellt eine Datei mit Build-Befehlen, Test-Anweisungen und Projektkonventionen, die es entdeckt. Wenn bereits eine CLAUDE.md vorhanden ist, schlägt `/init` Verbesserungen vor, statt sie zu überschreiben. Verfeinern Sie sie von dort aus mit Anweisungen, die Claude nicht selbst entdecken würde.83 Führen Sie `/init` aus, um automatisch ein startendes CLAUDE.md zu generieren. Claude analysiert Ihre Codebasis und erstellt eine Datei mit Build-Befehlen, Test-Anweisungen und Projektkonventionen, die es entdeckt. Wenn bereits ein CLAUDE.md vorhanden ist, schlägt `/init` Verbesserungen vor, statt es zu überschreiben. Verfeinern Sie es von dort mit Anweisungen, die Claude nicht selbst entdecken würde.

83 84 

84 Setzen Sie `CLAUDE_CODE_NEW_INIT=1`, um einen interaktiven mehrstufigen Ablauf zu aktivieren. `/init` fragt, welche Artefakte eingerichtet werden sollen: CLAUDE.md-Dateien, Skills und Hooks. Es erkundet dann Ihre Codebasis mit einem Subagent, füllt Lücken durch Folgefragen aus und präsentiert einen überprüfbaren Vorschlag, bevor Dateien geschrieben werden.85 Setzen Sie `CLAUDE_CODE_NEW_INIT=1`, um einen interaktiven mehrstufigen Ablauf zu aktivieren. `/init` fragt, welche Artefakte eingerichtet werden sollen: CLAUDE.md-Dateien, Skills und Hooks. Es erkundet dann Ihre Codebasis mit einem Subagenten, füllt Lücken durch Folgefragen aus und präsentiert einen überprüfbaren Vorschlag, bevor Dateien geschrieben werden.

85</Tip>86</Tip>

86 87 

87<h3 id="write-effective-instructions">88<h3 id="write-effective-instructions">

88 Schreiben Sie effektive Anweisungen89 Schreiben Sie effektive Anweisungen

89</h3>90</h3>

90 91 

91CLAUDE.md-Dateien werden zu Beginn jeder Sitzung in das Context Window geladen und verbrauchen Token zusammen mit Ihrer Konversation. Die [Context Window-Visualisierung](/docs/de/context-window) zeigt, wo CLAUDE.md relativ zum Rest des Startup-Kontexts geladen wird. Da sie Kontext statt erzwungene Konfiguration sind, beeinflusst die Art, wie Sie Anweisungen schreiben, wie zuverlässig Claude ihnen folgt. Spezifische, prägnante, gut strukturierte Anweisungen funktionieren am besten.92CLAUDE.md-Dateien werden zu Beginn jeder Sitzung in das Kontextfenster geladen und verbrauchen Token zusammen mit Ihrer Konversation. Die [Kontextfenster-Visualisierung](/docs/de/context-window) zeigt, wo CLAUDE.md relativ zum Rest des Startkontexts geladen wird. Da es sich um Kontext statt um erzwungene Konfiguration handelt, beeinflusst die Art, wie Sie Anweisungen schreiben, wie zuverlässig Claude sie befolgt. Spezifische, prägnante, gut strukturierte Anweisungen funktionieren am besten.

92 93 

93**Größe**: Ziel unter 200 Zeilen pro CLAUDE.md-Datei. Längere Dateien verbrauchen mehr Kontext und reduzieren die Einhaltung. Wenn Ihre Anweisungen zu groß werden, verwenden Sie [pfadgebundene Regeln](#path-specific-rules), damit Anweisungen nur geladen werden, wenn Claude mit übereinstimmenden Dateien arbeitet, um Rauschen zu reduzieren und Kontextraum zu sparen. Sie können auch Inhalte in [Importe](#import-additional-files) aufteilen, um sie zu organisieren, obwohl importierte Dateien immer noch geladen werden und beim Start in das Context Window eingehen.94**Größe**: Ziel unter 200 Zeilen pro CLAUDE.md-Datei. Längere Dateien verbrauchen mehr Kontext und verringern die Einhaltung. Wenn Ihre Anweisungen zu groß werden, verwenden Sie [pfadgebundene Regeln](#path-specific-rules), damit Anweisungen nur geladen werden, wenn Claude mit übereinstimmenden Dateien arbeitet. Sie können Inhalte auch in [Importe](#import-additional-files) aufteilen, um sie zu organisieren, obwohl importierte Dateien immer noch geladen werden und beim Start in das Kontextfenster eingehen.

94 95 

95**Struktur**: Verwenden Sie Markdown-Header und Aufzählungszeichen, um verwandte Anweisungen zu gruppieren. Claude scannt die Struktur genauso wie Leser: organisierte Abschnitte sind leichter zu befolgen als dichte Absätze.96**Struktur**: Verwenden Sie Markdown-Header und Aufzählungszeichen, um verwandte Anweisungen zu gruppieren. Claude scannt die Struktur genauso wie Leser: organisierte Abschnitte sind leichter zu folgen als dichte Absätze.

96 97 

97**Spezifität**: Schreiben Sie Anweisungen, die konkret genug sind, um überprüft zu werden. Zum Beispiel:98**Spezifität**: Schreiben Sie Anweisungen, die konkret genug sind, um überprüft zu werden. Zum Beispiel:

98 99 

99* „Verwenden Sie 2-Leerzeichen-Einrückung" statt „Formatieren Sie Code ordnungsgemäß"100* „Verwenden Sie 2-Leerzeichen-Einzug" statt „Formatieren Sie Code ordnungsgemäß"

100* „Führen Sie `npm test` vor dem Commit aus" statt „Testen Sie Ihre Änderungen"101* „Führen Sie `npm test` vor dem Commit aus" statt „Testen Sie Ihre Änderungen"

101* „API-Handler befinden sich in `src/api/handlers/`" statt „Halten Sie Dateien organisiert"102* „API-Handler befinden sich in `src/api/handlers/`" statt „Halten Sie Dateien organisiert"

102 103 

106 Importieren Sie zusätzliche Dateien107 Importieren Sie zusätzliche Dateien

107</h3>108</h3>

108 109 

109CLAUDE.md-Dateien können zusätzliche Dateien mit der Syntax `@path/to/import` importieren. Importierte Dateien werden erweitert und beim Start zusammen mit der CLAUDE.md, die sie referenziert, in den Kontext geladen.110CLAUDE.md-Dateien können zusätzliche Dateien mit der Syntax `@path/to/import` importieren. Importierte Dateien werden erweitert und beim Start zusammen mit dem CLAUDE.md, das sie referenziert, in den Kontext geladen.

110 111 

111Sowohl relative als auch absolute Pfade sind zulässig. Relative Pfade werden relativ zur Datei aufgelöst, die den Import enthält, nicht zum Arbeitsverzeichnis. Importierte Dateien können rekursiv andere Dateien importieren, mit einer maximalen Tiefe von vier Hops.112Sowohl relative als auch absolute Pfade sind zulässig. Relative Pfade werden relativ zur Datei aufgelöst, die den Import enthält, nicht zum Arbeitsverzeichnis. Importierte Dateien können rekursiv andere Dateien importieren, mit einer maximalen Tiefe von vier Hops.

112 113 

113Das Parsing von Importen überspringt Markdown-Code-Spans und eingezäunte Code-Blöcke. Um einen Pfad in Ihrer CLAUDE.md zu erwähnen, ohne ihn zu importieren, wickeln Sie ihn in Backticks ein: Das Schreiben von `` `@README` `` hält den Text literal, während `@README` außerhalb von Backticks die Datei importiert.114Das Import-Parsing überspringt Markdown-Code-Spannweiten und eingezäunte Code-Blöcke. Um einen Pfad in Ihrem CLAUDE.md zu erwähnen, ohne ihn zu importieren, wickeln Sie ihn in Backticks ein: Das Schreiben von `` `@README` `` hält den Text literal, während `@README` außerhalb von Backticks die Datei importiert.

114 115 

115Um eine README, package.json und einen Workflow-Leitfaden einzubeziehen, referenzieren Sie sie mit der `@`-Syntax überall in Ihrer CLAUDE.md:116Um eine README, package.json und einen Workflow-Leitfaden einzubeziehen, referenzieren Sie sie mit `@`-Syntax überall in Ihrem CLAUDE.md:

116 117 

117```text theme={null}118```text theme={null}

118Siehe @README für Projektübersicht und @package.json für verfügbare npm-Befehle für dieses Projekt.119Siehe @README für Projektübersicht und @package.json für verfügbare npm-Befehle für dieses Projekt.

121- Git-Workflow @docs/git-instructions.md122- Git-Workflow @docs/git-instructions.md

122```123```

123 124 

124Für persönliche Vorlieben pro Projekt, die nicht in die Versionskontrolle eingecheckt werden sollten, erstellen Sie eine `CLAUDE.local.md` im Projektstammverzeichnis. Sie wird zusammen mit `CLAUDE.md` geladen und wird auf die gleiche Weise behandelt. Fügen Sie `CLAUDE.local.md` zu Ihrer `.gitignore` hinzu, damit sie nicht committed wird. Mit `CLAUDE_CODE_NEW_INIT=1` gesetzt, führt das Ausführen von `/init` und das Auswählen der persönlichen Option dies für Sie durch.125Für private projektspezifische Voreinstellungen, die nicht in die Versionskontrolle eingecheckt werden sollten, erstellen Sie ein `CLAUDE.local.md` im Projektstammverzeichnis. Es wird zusammen mit `CLAUDE.md` geladen und wird genauso behandelt. Fügen Sie `CLAUDE.local.md` zu Ihrer `.gitignore` hinzu, damit es nicht committed wird. Mit `CLAUDE_CODE_NEW_INIT=1` gesetzt, führt das Ausführen von `/init` und das Auswählen der persönlichen Option dies für Sie durch.

125 126 

126Wenn Sie über mehrere Git-Worktrees desselben Repositories arbeiten, existiert eine gitignorierte `CLAUDE.local.md` nur in dem Worktree, in dem Sie sie erstellt haben. Um persönliche Anweisungen über Worktrees hinweg zu teilen, importieren Sie stattdessen eine Datei aus Ihrem Home-Verzeichnis:127Wenn Sie über mehrere Git-Worktrees desselben Repositorys arbeiten, existiert ein gitignoriertes `CLAUDE.local.md` nur in dem Worktree, in dem Sie es erstellt haben. Um persönliche Anweisungen über Worktrees hinweg zu teilen, importieren Sie stattdessen eine Datei aus Ihrem Home-Verzeichnis:

127 128 

128```text theme={null}129```text theme={null}

129# Individuelle Vorlieben130# Individuelle Voreinstellungen

130- @~/.claude/my-project-instructions.md131- @~/.claude/my-project-instructions.md

131```132```

132 133 

133<Warning>134<Warning>

134 Ein Import in einer Projekt-Level-Memory-Datei ist extern, wenn sein Pfad außerhalb Ihres Arbeitsverzeichnisses aufgelöst wird, wie der Home-Verzeichnis-Import oben. Wenn Claude Code zum ersten Mal externe Importe in einem Projekt antrifft, zeigt es einen Genehmigungsdialog an, der die Dateien auflistet. Wenn Sie ablehnen, bleiben die Importe deaktiviert und der Dialog wird nicht erneut angezeigt.135 Ein Import in einer projektweiten Memory-Datei ist extern, wenn sein Pfad außerhalb Ihres Arbeitsverzeichnisses aufgelöst wird, wie der Home-Verzeichnis-Import oben. Wenn Claude Code zum ersten Mal externe Importe in einem Projekt antrifft, zeigt es einen Genehmigungsdialog an, der die Dateien auflistet. Wenn Sie ablehnen, bleiben die Importe deaktiviert und der Dialog wird nicht erneut angezeigt.

135 136 

136 Claude Code zeigt den Dialog, um Sie vor Dateien zu schützen, die andere Personen in ein gemeinsames Projekt committen. Benutzer-Scope-Memory-Dateien, wie `~/.claude/CLAUDE.md` und `~/.claude/rules/`, sind Dateien, die Sie selbst geschrieben haben. Außer in [Cowork](https://claude.com/product/cowork)-Sitzungen auf Ihrem Desktop lädt Claude Code ihre Importe ohne den Dialog und vertraut ihnen wie dem Rest Ihrer persönlichen Konfiguration.137 Claude Code zeigt den Dialog an, um Sie vor Dateien zu schützen, die andere Personen in ein gemeinsames Projekt committen. Benutzerbereichs-Memory-Dateien wie `~/.claude/CLAUDE.md` und `~/.claude/rules/` sind Dateien, die Sie selbst geschrieben haben. Außer in [Cowork](https://claude.com/product/cowork)-Sitzungen auf Ihrem Desktop lädt Claude Code ihre Importe ohne Dialog und vertraut ihnen wie dem Rest Ihrer persönlichen Konfiguration.

137 138 

138 In Cowork-Sitzungen auf Ihrem Desktop überspringt Claude Code jeden Import in einer Benutzer-Scope-Datei, der zu einem Pfad außerhalb des Arbeitsverzeichnisses der Sitzung aufgelöst wird, und lädt den Rest der Datei. In diesen Sitzungen überspringt es auch eine `~/.claude/CLAUDE.md`, die selbst ein Symlink oder Hard Link ist, und ein symverlinktes `~/.claude/rules/`-Verzeichnis oder eine Regeldatei, die außerhalb des Arbeitsverzeichnisses zeigt.139 In Cowork-Sitzungen auf Ihrem Desktop überspringt Claude Code jeden Import in einer Benutzerbereichs-Datei, die zu einem Pfad außerhalb des Arbeitsverzeichnisses der Sitzung aufgelöst wird, und lädt den Rest der Datei. In diesen Sitzungen überspringt es auch ein `~/.claude/CLAUDE.md`, das selbst ein Symlink oder Hard Link ist, und ein symverlinktes `~/.claude/rules/`-Verzeichnis oder eine Regeldatei, die außerhalb des Arbeitsverzeichnisses zeigt.

139</Warning>140</Warning>

140 141 

141<h3 id="agents-md">

142 AGENTS.md

143</h3>

144 

145Claude Code liest `CLAUDE.md`, nicht `AGENTS.md`. Wenn Ihr Repository bereits `AGENTS.md` für andere Coding-Agenten verwendet, erstellen Sie eine `CLAUDE.md`, die es importiert, damit beide Tools die gleichen Anweisungen lesen, ohne sie zu duplizieren. Sie können auch Claude-spezifische Anweisungen unter dem Import hinzufügen. Claude lädt die importierte Datei beim Sitzungsstart und hängt dann den Rest an:

146 

147```markdown CLAUDE.md theme={null}

148@AGENTS.md

149 

150## Claude Code

151 

152Verwenden Sie Plan Mode für Änderungen unter `src/billing/`.

153```

154 

155Ein Symlink funktioniert auch, wenn Sie keine Claude-spezifischen Inhalte hinzufügen müssen:

156 

157```bash theme={null}

158ln -s AGENTS.md CLAUDE.md

159```

160 

161Der Befehl gibt bei Erfolg keine Ausgabe aus. In Ihrer nächsten Sitzung führen Sie `/context` aus und bestätigen Sie, dass `CLAUDE.md` unter **Memory-Dateien** angezeigt wird.

162 

163Unter Windows erfordert das Erstellen eines Symlinks Administratorrechte oder Developer Mode, daher verwenden Sie stattdessen den Import `@AGENTS.md`.

164 

165Das Ausführen von [`/init`](/docs/de/commands) liest Cursor-Regeln in `.cursor/rules/` oder `.cursorrules` und Copilot-Regeln in `.github/copilot-instructions.md` und integriert die relevanten Teile in die generierte `CLAUDE.md`. Mit `CLAUDE_CODE_NEW_INIT=1` gesetzt, liest `/init` auch `AGENTS.md`, `.devin/rules/`, `.windsurf/rules/` oder `.windsurfrules` und `.clinerules`.

166 

167Sie können auch [`/import`](/docs/de/commands) ausführen, um die Konfiguration eines unterstützten Coding-Agenten in Claude Code zu bringen, was eine einmalige Kopie von Anweisungsdateien wie `AGENTS.md` an die entsprechende `CLAUDE.md` anhängt und MCP-Server, Befehle, Subagents und Skills übernimmt. Erfordert Claude Code v2.1.213 oder später.

168 

169<h3 id="how-claude-md-files-load">142<h3 id="how-claude-md-files-load">

170 Wie CLAUDE.md-Dateien geladen werden143 Wie CLAUDE.md-Dateien geladen werden

171</h3>144</h3>

172 145 

173Claude Code lädt `CLAUDE.md` und `CLAUDE.local.md` aus Ihrem aktuellen Arbeitsverzeichnis und jedem Verzeichnis darüber. Führen Sie Claude Code in `foo/bar/` aus und es lädt Anweisungen aus `foo/bar/CLAUDE.md`, `foo/CLAUDE.md` und allen `CLAUDE.local.md`-Dateien daneben.146Claude Code lädt `CLAUDE.md` und `CLAUDE.local.md` aus Ihrem aktuellen Arbeitsverzeichnis und jedem Verzeichnis darüber. Führen Sie Claude Code in `foo/bar/` aus und es lädt Anweisungen aus `foo/bar/CLAUDE.md`, `foo/CLAUDE.md` und allen `CLAUDE.local.md`-Dateien daneben.

174 147 

175Alle entdeckten Dateien werden in den Kontext verkettet, statt sich gegenseitig zu überschreiben. Über die Verzeichnisstruktur hinweg wird Inhalt vom Dateisystem-Root bis zu Ihrem Arbeitsverzeichnis geordnet. Für das Beispiel `foo/bar/` erscheint `foo/CLAUDE.md` im Kontext vor `foo/bar/CLAUDE.md`, sodass Anweisungen näher an dem Ort, an dem Sie Claude gestartet haben, zuletzt gelesen werden. Innerhalb jedes Verzeichnisses wird `CLAUDE.local.md` nach `CLAUDE.md` angehängt, sodass Ihre persönlichen Notizen das letzte sind, das Claude auf dieser Ebene liest.148Alle entdeckten Dateien werden in den Kontext verkettet, statt sich gegenseitig zu überschreiben. Über den Verzeichnisbaum hinweg wird Inhalt vom Dateisystem-Root bis zu Ihrem Arbeitsverzeichnis geordnet. Für das Beispiel `foo/bar/` erscheint `foo/CLAUDE.md` im Kontext vor `foo/bar/CLAUDE.md`, sodass Anweisungen näher an dem Ort, an dem Sie Claude gestartet haben, zuletzt gelesen werden. Innerhalb jedes Verzeichnisses wird `CLAUDE.local.md` nach `CLAUDE.md` angehängt, sodass Ihre persönlichen Notizen das Letzte sind, das Claude auf dieser Ebene liest.

176 149 

177Claude entdeckt auch `CLAUDE.md`- und `CLAUDE.local.md`-Dateien in Unterverzeichnissen unter Ihrem aktuellen Arbeitsverzeichnis. Statt sie beim Start zu laden, werden sie eingebunden, wenn Claude Dateien in diesen Unterverzeichnissen liest.150Claude entdeckt auch `CLAUDE.md`- und `CLAUDE.local.md`-Dateien in Unterverzeichnissen unter Ihrem aktuellen Arbeitsverzeichnis. Statt sie beim Start zu laden, werden sie eingebunden, wenn Claude Dateien in diesen Verzeichnissen liest.

178 151 

179Wenn Sie in einem großen Monorepo arbeiten, in dem CLAUDE.md-Dateien anderer Teams aufgegriffen werden, verwenden Sie [`claudeMdExcludes`](#exclude-specific-claude-md-files), um sie zu überspringen. Für das vollständige Layout von Root- und Pro-Verzeichnis-CLAUDE.md-Dateien und Regeln siehe [Monorepos und große Repos](/docs/de/large-codebases).152Wenn Sie in einem großen Monorepo arbeiten, in dem CLAUDE.md-Dateien anderer Teams aufgegriffen werden, verwenden Sie [`claudeMdExcludes`](#exclude-specific-claude-md-files), um sie zu überspringen. Für das vollständige Layout von Root- und Pro-Verzeichnis-CLAUDE.md-Dateien und Regeln siehe [Monorepos und große Repos](/docs/de/large-codebases).

180 153 

181Block-Level-HTML-Kommentare (`<!-- maintainer notes -->`) in CLAUDE.md-Dateien werden vor der Injektion in Claudes Kontext entfernt. Verwenden Sie sie, um Notizen für menschliche Betreuer zu hinterlassen, ohne Kontext-Token darauf zu verschwenden. Kommentare innerhalb von Code-Blöcken werden beibehalten. Wenn Sie eine CLAUDE.md-Datei direkt mit dem Read-Tool öffnen, bleiben Kommentare sichtbar.154Block-Level-HTML-Kommentare (`<!-- maintainer notes -->`) in CLAUDE.md-Dateien werden vor dem Einfügen des Inhalts in Claudes Kontext entfernt. Verwenden Sie sie, um Notizen für menschliche Betreuer zu hinterlassen, ohne Kontext-Token darauf zu verschwenden. Kommentare in Code-Blöcken werden beibehalten. Wenn Sie eine CLAUDE.md-Datei direkt mit dem Read-Tool öffnen, bleiben Kommentare sichtbar.

182 155 

183<h4 id="load-from-additional-directories">156<h4 id="load-from-additional-directories">

184 Laden aus zusätzlichen Verzeichnissen157 Laden aus zusätzlichen Verzeichnissen

198 Organisieren Sie Regeln mit `.claude/rules/`171 Organisieren Sie Regeln mit `.claude/rules/`

199</h3>172</h3>

200 173 

201Für größere Projekte können Sie Anweisungen in mehrere Dateien mit dem Verzeichnis `.claude/rules/` organisieren. Dies hält Anweisungen modular und leichter für Teams zu pflegen. Regeln können auch [auf bestimmte Dateipfade beschränkt werden](#path-specific-rules), sodass sie nur in den Kontext geladen werden, wenn Claude mit übereinstimmenden Dateien arbeitet, was Rauschen reduziert und Kontextraum spart.174Für größere Projekte können Sie Anweisungen in mehrere Dateien mit dem Verzeichnis `.claude/rules/` organisieren. Dies hält Anweisungen modular und leichter für Teams zu verwalten. Regeln können auch [auf bestimmte Dateipfade beschränkt werden](#path-specific-rules), sodass sie nur in den Kontext geladen werden, wenn Claude mit übereinstimmenden Dateien arbeitet, was Rauschen reduziert und Kontextraum spart.

202 175 

203<Note>176<Note>

204 Regeln werden in jeder Sitzung oder beim Öffnen übereinstimmender Dateien in den Kontext geladen. Für aufgabenspezifische Anweisungen, die nicht ständig im Kontext sein müssen, verwenden Sie stattdessen [Skills](/docs/de/skills), die nur geladen werden, wenn Sie sie aufrufen oder wenn Claude bestimmt, dass sie für Ihren Prompt relevant sind.177 Regeln werden in jeder Sitzung oder beim Öffnen übereinstimmender Dateien in den Kontext geladen. Für aufgabenspezifische Anweisungen, die nicht ständig im Kontext sein müssen, verwenden Sie stattdessen [Skills](/docs/de/skills), die nur geladen werden, wenn Sie sie aufrufen oder wenn Claude bestimmt, dass sie für Ihren Prompt relevant sind.

215├── .claude/188├── .claude/

216│ ├── CLAUDE.md # Hauptprojektanweisungen189│ ├── CLAUDE.md # Hauptprojektanweisungen

217│ └── rules/190│ └── rules/

218│ ├── code-style.md # Code-Style-Richtlinien191│ ├── code-style.md # Code-Stilrichtlinien

219│ ├── testing.md # Test-Konventionen192│ ├── testing.md # Test-Konventionen

220│ └── security.md # Sicherheitsanforderungen193│ └── security.md # Sicherheitsanforderungen

221```194```

222 195 

223Regeln ohne [`paths`-Frontmatter](#path-specific-rules) werden beim Start mit der gleichen Priorität wie `.claude/CLAUDE.md` geladen.196Regeln ohne [`paths`-Frontmatter](#path-specific-rules) werden beim Start mit derselben Priorität wie `.claude/CLAUDE.md` geladen.

224 197 

225Projektregeln werden übersprungen, wenn Sie `project` aus [`--setting-sources`](/docs/de/cli-reference) ausschließen. Vor v2.1.211 wurden Regeln, die bei Bedarf geladen werden, einschließlich pfadgebundener Regeln und Regeln in verschachtelten `.claude/rules/`-Verzeichnissen, auch geladen, wenn `project` ausgeschlossen wurde.198Projektregeln werden übersprungen, wenn Sie `project` aus [`--setting-sources`](/docs/de/cli-reference) ausschließen. Vor v2.1.211 wurden Regeln, die bei Bedarf geladen werden, einschließlich pfadgebundener Regeln und Regeln in verschachtelten `.claude/rules/`-Verzeichnissen, auch geladen, wenn `project` ausgeschlossen war.

226 199 

227<h4 id="path-specific-rules">200<h4 id="path-specific-rules">

228 Pfadspezifische Regeln201 Pfadspezifische Regeln

245 218 

246Regeln ohne ein `paths`-Feld werden bedingungslos geladen und gelten für alle Dateien. Pfadgebundene Regeln werden ausgelöst, wenn Claude Dateien liest, die dem Muster entsprechen, nicht bei jedem Tool-Einsatz. Ab v2.1.198 funktioniert das Matching auch, wenn Claude eine Datei über einen symverlinkten Pfad zum Projektverzeichnis erreicht, zum Beispiel in einem symverlinkten Checkout.219Regeln ohne ein `paths`-Feld werden bedingungslos geladen und gelten für alle Dateien. Pfadgebundene Regeln werden ausgelöst, wenn Claude Dateien liest, die dem Muster entsprechen, nicht bei jedem Tool-Einsatz. Ab v2.1.198 funktioniert das Matching auch, wenn Claude eine Datei über einen symverlinkten Pfad zum Projektverzeichnis erreicht, zum Beispiel in einem symverlinkten Checkout.

247 220 

248Verwenden Sie Glob-Muster im Feld `paths`, um Dateien nach Erweiterung, Verzeichnis oder einer beliebigen Kombination zu vergleichen:221Verwenden Sie Glob-Muster im Feld `paths`, um Dateien nach Erweiterung, Verzeichnis oder einer beliebigen Kombination zu entsprechen:

249 222 

250| Muster | Passt zu |223| Muster | Entspricht |

251| ---------------------- | ------------------------------------------------- |224| ---------------------- | ------------------------------------------------- |

252| `**/*.ts` | Alle TypeScript-Dateien in jedem Verzeichnis |225| `**/*.ts` | Alle TypeScript-Dateien in jedem Verzeichnis |

253| `src/**/*` | Alle Dateien unter dem Verzeichnis `src/` |226| `src/**/*` | Alle Dateien unter dem Verzeichnis `src/` |

254| `*.md` | Markdown-Dateien im Projektstamm |227| `*.md` | Markdown-Dateien im Projektstammverzeichnis |

255| `src/components/*.tsx` | React-Komponenten in einem bestimmten Verzeichnis |228| `src/components/*.tsx` | React-Komponenten in einem bestimmten Verzeichnis |

256 229 

257Sie können mehrere Muster angeben und Klammer-Expansion verwenden, um mehrere Erweiterungen in einem Muster zu vergleichen:230Sie können mehrere Muster angeben und Klammer-Erweiterung verwenden, um mehrere Erweiterungen in einem Muster zu entsprechen:

258 231 

259```markdown theme={null}232```markdown theme={null}

260---233---

265---238---

266```239```

267 240 

268Jede Klammer-Gruppe multipliziert die Anzahl der erweiterten Muster: `src/*.{ts,tsx}` wird zu zwei Mustern erweitert, und `{a,b}/{c,d}/*.{ts,tsx}` zu acht. Um die Erweiterung begrenzt zu halten, teilt sich die ganze `paths`-Liste einer Regel ein Budget von 1.000 erweiterten Mustern und 4 MiB, und Muster ohne Klammern zählen nicht dagegen.241Jede Klammer-Gruppe multipliziert die Anzahl der erweiterten Muster: `src/*.{ts,tsx}` wird zu zwei Mustern erweitert, und `{a,b}/{c,d}/*.{ts,tsx}` zu acht. Um die Erweiterung begrenzt zu halten, teilt sich die gesamte `paths`-Liste einer Regel ein Budget von 1.000 erweiterten Mustern und 4 MiB, und Muster ohne Klammern zählen nicht dagegen.

269 242 

270Claude Code verwendet jeden Muster, der das Budget unerweitert überschreiten würde, und seine literalen Klammern passen zu keinen Dateien. Vor v2.1.217 führte ein `paths`-Wert mit vielen Klammer-Gruppen zu Stalls oder Crashes der CLI beim Start.243Claude Code verwendet jedes Muster, das das Budget unerweitert überschreiten würde, und seine literalen Klammern entsprechen keinen Dateien. Vor v2.1.217 stagnierte oder stürzte eine `paths`-Wert mit vielen Klammer-Gruppen die CLI beim Start ab.

271 244 

272Glob-Syntax behandelt `[` als den Anfang eines Klammer-Ausdrucks wie `[abc]`. Ein Muster mit einem `[`, das nicht als Klammer-Ausdruck gelesen werden kann, wie `photos [2024/**`, ist ungültig: es passt zu nichts, und die anderen Muster der Regel funktionieren weiterhin. Um ein literales `[` in einem Dateinamen zu vergleichen, escapen Sie es als `photos \[2024/**`. Vor v2.1.207 führte ein ungültiges Muster dazu, dass das Read-Tool für jede Datei fehlschlug, gegen die die Regel ausgewertet wurde, statt zu nichts zu passen.245Die Glob-Syntax behandelt `[` als den Anfang eines Klammer-Ausdrucks wie `[abc]`. Ein Muster mit einem `[`, das nicht als Klammer-Ausdruck gelesen werden kann, wie `photos [2024/**`, ist ungültig: es entspricht nichts, und die anderen Muster der Regel funktionieren weiterhin. Um ein literales `[` in einem Dateinamen zu entsprechen, escapen Sie es als `photos \[2024/**`. Vor v2.1.207 machte ein ungültiges Muster das Read-Tool für jede Datei fehlschlagen, gegen die die Regel bewertet wurde, statt nichts zu entsprechen.

273 246 

274<h4 id="share-rules-across-projects-with-symlinks">247<h4 id="share-rules-across-projects-with-symlinks">

275 Teilen Sie Regeln über Projekte hinweg mit Symlinks248 Teilen Sie Regeln über Projekte mit Symlinks

276</h4>249</h4>

277 250 

278Das Verzeichnis `.claude/rules/` unterstützt Symlinks, sodass Sie einen gemeinsamen Satz von Regeln pflegen und in mehrere Projekte verlinken können. Zirkuläre Symlinks werden erkannt und elegant behandelt.251Das Verzeichnis `.claude/rules/` unterstützt Symlinks, sodass Sie einen gemeinsamen Satz von Regeln verwalten und in mehrere Projekte verlinken können. Zirkuläre Symlinks werden erkannt und elegant behandelt.

279 252 

280Claude Code behandelt einen Symlink, dessen Ziel außerhalb Ihres Arbeitsverzeichnisses liegt, wie einen [externen Import](#import-additional-files). Die verlinkten Regeln werden nicht geladen, bis Sie externe Importe für das Projekt genehmigen, und danach werden nur die ohne ein [`paths`-Feld](#path-specific-rules) geladen. Claude Code fragt nach dieser Genehmigung nur, wenn eine Projekt-Memory-Datei eine Datei außerhalb des Arbeitsverzeichnisses mit `@path` importiert, nicht für Symlinks allein. Um gemeinsame Regeln ohne diese Genehmigung zu laden, halten Sie sie in [`~/.claude/rules/`](#user-level-rules), wo sie für jedes Projekt auf Ihrem Computer gelten.253Claude Code behandelt einen Symlink, dessen Ziel außerhalb Ihres Arbeitsverzeichnisses liegt, wie einen [externen Import](#import-additional-files). Die verlinkten Regeln werden nicht geladen, bis Sie externe Importe für das Projekt genehmigen, und danach werden nur die ohne ein [`paths`-Feld](#path-specific-rules) geladen. Claude Code fragt nach dieser Genehmigung nur, wenn eine Projektmemory-Datei eine Datei außerhalb des Arbeitsverzeichnisses mit `@path` importiert, nicht für Symlinks allein. Um gemeinsame Regeln ohne diese Genehmigung zu laden, halten Sie sie in [`~/.claude/rules/`](#user-level-rules), wo sie auf jedem Projekt auf Ihrem Computer gelten.

281 254 

282Dieses Beispiel verlinkt sowohl ein gemeinsames Verzeichnis als auch eine einzelne Datei:255Dieses Beispiel verlinkt sowohl ein gemeinsames Verzeichnis als auch eine einzelne Datei:

283 256 

287```260```

288 261 

289<h4 id="user-level-rules">262<h4 id="user-level-rules">

290 Benutzerebenen-Regeln263 Benutzerweite Regeln

291</h4>264</h4>

292 265 

293Persönliche Regeln in `~/.claude/rules/` gelten für jedes Projekt auf Ihrem Computer. Verwenden Sie sie für Vorlieben, die nicht projektspezifisch sind:266Persönliche Regeln in `~/.claude/rules/` gelten für jedes Projekt auf Ihrem Computer. Verwenden Sie sie für Voreinstellungen, die nicht projektspezifisch sind:

294 267 

295```text theme={null}268```text theme={null}

296~/.claude/rules/269~/.claude/rules/

297├── preferences.md # Ihre persönlichen Coding-Vorlieben270├── preferences.md # Ihre persönlichen Codierungsvoreinstellungen

298└── workflows.md # Ihre bevorzugten Workflows271└── workflows.md # Ihre bevorzugten Arbeitsabläufe

299```272```

300 273 

301Benutzerebenen-Regeln werden vor Projektregeln geladen, was Projektregeln höhere Priorität gibt.274Benutzerweite Regeln werden vor Projektregeln geladen, was Projektregeln eine höhere Priorität gibt.

302 275 

303<h3 id="manage-claude-md-for-large-teams">276<h3 id="manage-claude-md-for-large-teams">

304 Verwalten Sie CLAUDE.md für große Teams277 Verwalten Sie CLAUDE.md für große Teams

310 Stellen Sie organisationsweite CLAUDE.md bereit283 Stellen Sie organisationsweite CLAUDE.md bereit

311</h4>284</h4>

312 285 

313Organisationen können eine zentral verwaltete CLAUDE.md bereitstellen, die für alle Benutzer auf einem Computer gilt. Diese Datei kann nicht durch individuelle Einstellungen ausgeschlossen werden.286Organisationen können ein zentral verwaltetes CLAUDE.md bereitstellen, das für alle Benutzer auf einem Computer gilt. Diese Datei kann nicht durch individuelle Einstellungen ausgeschlossen werden.

314 287 

315<Steps>288<Steps>

316 <Step title="Erstellen Sie die Datei am Ort der verwalteten Richtlinie">289 <Step title="Erstellen Sie die Datei am verwalteten Richtlinienort">

317 * macOS: `/Library/Application Support/ClaudeCode/CLAUDE.md`290 * macOS: `/Library/Application Support/ClaudeCode/CLAUDE.md`

318 * Linux und WSL: `/etc/claude-code/CLAUDE.md`291 * Linux und WSL: `/etc/claude-code/CLAUDE.md`

319 * Windows: `C:\Program Files\ClaudeCode\CLAUDE.md`292 * Windows: `C:\Program Files\ClaudeCode\CLAUDE.md`

326 299 

327Der Schlüssel `claudeMd` ermöglicht es Ihnen, verwaltete CLAUDE.md-Inhalte direkt in `managed-settings.json` zu platzieren, statt eine separate Datei bereitzustellen.300Der Schlüssel `claudeMd` ermöglicht es Ihnen, verwaltete CLAUDE.md-Inhalte direkt in `managed-settings.json` zu platzieren, statt eine separate Datei bereitzustellen.

328 301 

329**Umfang**: jede Claude Code-Sitzung auf dem Computer, in jedem Repository. Für Repository-spezifische Anleitung committen Sie stattdessen eine Projekt-CLAUDE.md.302**Umfang**: jede Claude Code-Sitzung auf dem Computer, in jedem Repository. Für repositoryspezifische Anleitung committen Sie stattdessen ein Projekt-CLAUDE.md.

330 303 

331**Vorrang**: gleich wie eine verwaltete CLAUDE.md-Datei. Wird vor Benutzer- und Projekt-CLAUDE.md geladen.304**Vorrang**: gleich wie eine verwaltete CLAUDE.md-Datei. Wird vor Benutzer- und Projekt-CLAUDE.md geladen.

332 305 

333**Wo es berücksichtigt wird**: nur verwaltete und Richtlinien-Einstellungen. Das Setzen von `claudeMd` in Benutzer-, Projekt- oder lokalen Einstellungen hat keine Auswirkung.306**Wo es berücksichtigt wird**: nur verwaltete und Richtlinieneinstellungen. Das Setzen von `claudeMd` in Benutzer-, Projekt- oder lokalen Einstellungen hat keine Auswirkung.

334 307 

335Das folgende Beispiel fügt Verhaltensanweisungen direkt in eine verwaltete Einstellungsdatei ein:308Das folgende Beispiel fügt Verhaltensanweisungen direkt in eine verwaltete Einstellungsdatei ein:

336 309 

337```json theme={null}310```json theme={null}

338{311{

339 "claudeMd": "Always run `make lint` before committing.\nNever push directly to main."312 "claudeMd": "Führen Sie immer `make lint` vor dem Commit aus.\nNiemand pusht direkt zu main."

340}313}

341```314```

342 315 

343Eine verwaltete CLAUDE.md und [verwaltete Einstellungen](/docs/de/managed-settings) dienen unterschiedlichen Zwecken. Verwenden Sie Einstellungen für technische Durchsetzung und CLAUDE.md für Verhaltensanleitung:316Ein verwaltetes CLAUDE.md und [verwaltete Einstellungen](/docs/de/managed-settings) dienen unterschiedlichen Zwecken. Verwenden Sie Einstellungen für technische Durchsetzung und CLAUDE.md für Verhaltensanleitung:

344 317 

345| Anliegen | Konfigurieren in |318| Bedenken | Konfigurieren in |

346| :------------------------------------------------------ | :---------------------------------------------------------------- |319| :------------------------------------------------------ | :---------------------------------------------------------------- |

347| Blockieren Sie bestimmte Tools, Befehle oder Dateipfade | Verwaltete Einstellungen: `permissions.deny` |320| Blockieren Sie bestimmte Tools, Befehle oder Dateipfade | Verwaltete Einstellungen: `permissions.deny` |

348| Erzwingen Sie Sandbox-Isolation | Verwaltete Einstellungen: `sandbox.enabled` |321| Erzwingen Sie Sandbox-Isolation | Verwaltete Einstellungen: `sandbox.enabled` |

349| Umgebungsvariablen und API-Provider-Routing | Verwaltete Einstellungen: `env` |322| Umgebungsvariablen und API-Provider-Routing | Verwaltete Einstellungen: `env` |

350| Authentifizierungsmethode und Organisationssperre | Verwaltete Einstellungen: `forceLoginMethod`, `forceLoginOrgUUID` |323| Anmeldemethode und Organisationsbeschränkungen | Verwaltete Einstellungen: `forceLoginMethod`, `forceLoginOrgUUID` |

351| Code-Style und Qualitätsrichtlinien | Verwaltete CLAUDE.md |324| Code-Stil und Qualitätsrichtlinien | Verwaltetes CLAUDE.md |

352| Datenbehandlung und Compliance-Erinnerungen | Verwaltete CLAUDE.md |325| Datenbehandlung und Compliance-Erinnerungen | Verwaltetes CLAUDE.md |

353| Verhaltensanweisungen für Claude | Verwaltete CLAUDE.md |326| Verhaltensanweisungen für Claude | Verwaltetes CLAUDE.md |

354 327 

355Einstellungsregeln werden vom Client unabhängig davon durchgesetzt, was Claude entscheidet zu tun. CLAUDE.md-Anweisungen prägen Claudes Verhalten, sind aber keine harte Durchsetzungsebene.328Einstellungsregeln werden vom Client unabhängig davon durchgesetzt, was Claude zu tun beschließt. CLAUDE.md-Anweisungen prägen Claudes Verhalten, sind aber keine harte Durchsetzungsebene.

356 329 

357<h4 id="exclude-specific-claude-md-files">330<h4 id="exclude-specific-claude-md-files">

358 Schließen Sie bestimmte CLAUDE.md-Dateien aus331 Schließen Sie bestimmte CLAUDE.md-Dateien aus

360 333 

361In großen Monorepos können Vorgänger-CLAUDE.md-Dateien Anweisungen enthalten, die für Ihre Arbeit nicht relevant sind. Die Einstellung `claudeMdExcludes` ermöglicht es Ihnen, bestimmte Dateien nach Pfad oder Glob-Muster zu überspringen.334In großen Monorepos können Vorgänger-CLAUDE.md-Dateien Anweisungen enthalten, die für Ihre Arbeit nicht relevant sind. Die Einstellung `claudeMdExcludes` ermöglicht es Ihnen, bestimmte Dateien nach Pfad oder Glob-Muster zu überspringen.

362 335 

363Dieses Beispiel schließt eine CLAUDE.md auf oberster Ebene und ein Regelverzeichnis aus einem übergeordneten Ordner aus. Fügen Sie es zu `.claude/settings.local.json` hinzu, damit der Ausschluss lokal auf Ihrem Computer bleibt:336Dieses Beispiel schließt ein Top-Level-CLAUDE.md und ein Regelverzeichnis aus einem übergeordneten Ordner aus. Fügen Sie es zu `.claude/settings.local.json` hinzu, damit der Ausschluss lokal auf Ihrem Computer bleibt:

364 337 

365```json theme={null}338```json theme={null}

366{339{

371}344}

372```345```

373 346 

374Muster werden mit Glob-Syntax gegen absolute Dateipfade abgeglichen. Sie können `claudeMdExcludes` auf jeder [Einstellungsebene](/docs/de/settings#where-settings-live) konfigurieren: Benutzer, Projekt, lokal oder verwaltete Richtlinie. Arrays werden über Ebenen hinweg zusammengeführt.347Muster werden gegen absolute Dateipfade mit Glob-Syntax abgeglichen. Sie können `claudeMdExcludes` auf jeder [Einstellungsebene](/docs/de/settings#where-settings-live) konfigurieren: Benutzer, Projekt, lokal oder verwaltete Richtlinie. Arrays werden über Ebenen hinweg zusammengeführt.

348 

349Um eine Regeldatei auszuschließen, die Sie über einen [Symlink](#share-rules-across-projects-with-symlinks) erreichen, ob die Datei oder ihr Verzeichnis der Link ist, schreiben Sie das Muster gegen einen der beiden Pfade: den Pfad der Datei unter `.claude/rules/` oder ihr Link-Ziel. Ein Muster, das einen der beiden Pfade entspricht, schließt die Datei aus. Vor v2.1.239 schloss nur ein Muster, das das Link-Ziel entsprach, die Datei aus.

350 

351Verwaltete Richtlinien-CLAUDE.md-Dateien können nicht ausgeschlossen werden. Dies stellt sicher, dass organisationsweite Anweisungen unabhängig von individuellen Einstellungen immer gelten.

352 

353<h2 id="agents-md">

354 AGENTS.md

355</h2>

356 

357Claude Code kann [`AGENTS.md`](/docs/de/glossary#agents-md) als Ihre Projektanweisungen lesen, daher funktioniert ein Repository, das bereits für andere Codierungs-Agenten eingerichtet ist, ohne dass Sie eine `CLAUDE.md`, einen Import oder eine Einstellung hinzufügen müssen. Diese Tabelle zeigt, was Claude standardmäßig für jede Kombination von Anweisungsdateien in Ihrem Repository liest:

358 

359| Ihr Repository hat | Claude liest |

360| :----------------------------------------------------------------------------------------------------- | :------------------------------------------------------------- |

361| Eine `AGENTS.md` und keine `CLAUDE.md` oder `CLAUDE.local.md` in Ihrem Arbeitsverzeichnis oder darüber | Ihre `AGENTS.md` |

362| Eine `AGENTS.md` und eine `CLAUDE.md` oder `CLAUDE.local.md` in Ihrem Arbeitsverzeichnis oder darüber | Nur Ihre `CLAUDE.md`-Dateien |

363| Eine `CLAUDE.md`, die bereits [`AGENTS.md` importiert](#share-one-file-with-other-coding-tools) | Ihre `CLAUDE.md`, mit `AGENTS.md` durch den Import eingebunden |

364 

365Um die Standardeinstellung zu ändern, z. B. um Claude beide Dateien lesen zu lassen, nur `CLAUDE.md` zu lesen oder nur die verwalteten Anweisungen Ihrer Organisation zu lesen, [ändern Sie die Einstellung **Projektanweisungen**](#choose-which-instruction-files-load).

366 

367<Note>

368 Das direkte Lesen von `AGENTS.md` erfordert Claude Code v2.1.277 oder später. In einigen Sitzungen, z. B. auf Amazon Bedrock oder mit deaktivierter Telemetrie, kann Claude [`AGENTS.md` nicht lesen](#when-agents-md-support-is-unavailable), daher [importieren Sie es stattdessen aus einer `CLAUDE.md`](#share-one-file-with-other-coding-tools).

369</Note>

370 

371<h3 id="when-claude-code-reads-agents-md">

372 Wann Claude Code AGENTS.md liest

373</h3>

374 

375Standardmäßig liest Claude `AGENTS.md` nur, wenn Sie keine `CLAUDE.md` in Ihrem Arbeitsverzeichnis oder darüber haben. Hier sind die Dateien, die für diese Prüfung zählen:

376 

377* **Zählen, daher liest Claude diese statt `AGENTS.md`**: eine `CLAUDE.md`, `.claude/CLAUDE.md` oder `CLAUDE.local.md` in Ihrem Arbeitsverzeichnis oder einem Verzeichnis darüber

378* **Zählen nicht und laden weiterhin neben `AGENTS.md`**: Ihre `~/.claude/CLAUDE.md`, die verwaltete `CLAUDE.md` Ihrer Organisation und `.claude/rules/`-Dateien

379 

380Wenn keine zählen, liest Claude hier, was es liest und wie Sie es erkennen können:

381 

382* **Beim Sitzungsstart**: jede `AGENTS.md` und `.claude/AGENTS.md` in Ihrem Arbeitsverzeichnis und den Verzeichnissen darüber. In einer interaktiven Sitzung sehen Sie eine Zeile wie `no CLAUDE.md found; AGENTS.md loaded: /home/you/repo/AGENTS.md` in der Konversation

383* **Wenn Claude in Unterverzeichnissen arbeitet**: eine `AGENTS.md` eines Unterverzeichnisses, wenn Claude dort eine Datei mit dem Read-Tool öffnet und dieses Unterverzeichnis keine der drei `CLAUDE.md`-Dateien selbst hat

384* **Innerhalb jeder `AGENTS.md`**: [`@path`-Importe](#import-additional-files) werden erweitert, [`claudeMdExcludes`](#exclude-specific-claude-md-files)-Muster gelten, und Subagenten, die [Projektanweisungen überspringen](/docs/de/sub-agents#what-loads-at-startup), überspringen diese Dateien auch

385* **Nicht gelesen**: `AGENTS.local.md`, `AGENTS.override.md` oder alles unter einem `.agents/`-Verzeichnis

386 

387<Note>

388 Da `CLAUDE.local.md` zählt, stoppt das Hinzufügen einer zum Speichern Ihrer eigenen nicht committeten Anweisungen in einem Projekt, das auf `AGENTS.md` angewiesen ist, Claude vom Lesen von `AGENTS.md` für Sie. Um Ihre `CLAUDE.local.md` zu behalten und Claude trotzdem `AGENTS.md` lesen zu lassen, setzen Sie **Projektanweisungen** auf [`claude-md-and-agents-md`](#choose-which-instruction-files-load).

389</Note>

390 

391<h3 id="choose-which-instruction-files-load">

392 Wählen Sie, welche Anweisungsdateien geladen werden

393</h3>

394 

395Um zu ändern, welche Dateien Claude liest, geben Sie `/config` in einer Claude Code-Sitzung ein, um das Einstellungsfenster zu öffnen, und setzen Sie dann **Projektanweisungen** auf einen dieser Werte:

396 

397| Wert | Was Claude liest |

398| :------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

399| `claude-md-or-agents-md` | Ihre `CLAUDE.md`-Dateien oder Ihre `AGENTS.md`-Dateien, wenn Sie keine `CLAUDE.md` oder `CLAUDE.local.md` in Ihrem Arbeitsverzeichnis oder darüber haben. Dies ist die Standardeinstellung |

400| `claude-md-and-agents-md` | Ihre `CLAUDE.md`- und `AGENTS.md`-Dateien zusammen, jede `CLAUDE.md`-Datei eines Verzeichnisses zuerst und seine `AGENTS.md` danach. Claude Code überspringt eine `AGENTS.md`, die es bereits geladen hat, daher wird eine, die Ihre `CLAUDE.md` importiert oder verlinkt, nicht zweimal gelesen |

401| `claude-md` | Nur Ihre `CLAUDE.md`-Dateien |

402| `managed-only` | Nur die verwaltete `CLAUDE.md` Ihrer Organisation und [automatisches Gedächtnis](#auto-memory) beim Start. Ihre Projekt-, lokalen und Benutzer-`CLAUDE.md`-Dateien, Ihre `.claude/rules/`-Dateien und jede `AGENTS.md` werden ausgelassen. Die `CLAUDE.md`- und `.claude/rules/`-Dateien eines Unterverzeichnisses und [pfadgebundene Regeln](#path-specific-rules) laden immer noch, wenn Claude eine Datei dort liest |

403 

404Sie können den Wert auch in einer Einstellungsdatei statt in `/config` setzen. Fügen Sie ihn unter der ID des integrierten `agents-md`-Plugins in [`pluginConfigs`](/docs/de/settings-reference#pluginconfigs) in `~/.claude/settings.json`, einer `--settings`-Datei oder [verwalteten Einstellungen](/docs/de/managed-settings) hinzu. Claude Code ignoriert ihn in Projekt- und lokalen Einstellungsdateien. Dieses Beispiel lässt Claude beide Dateien lesen:

405 

406```json settings.json theme={null}

407{

408 "pluginConfigs": {

409 "agents-md@builtin": {

410 "options": { "instructionFiles": "claude-md-and-agents-md" }

411 }

412 }

413}

414```

415 

416Ihre Änderung gilt ab der nächsten Nachricht, die Sie senden, und in jeder neuen Sitzung.

417 

418<h3 id="when-agents-md-support-is-unavailable">

419 Wenn AGENTS.md-Unterstützung nicht verfügbar ist

420</h3>

421 

422In diesen Sitzungen liest Claude nur `CLAUDE.md`-Dateien, und **Projektanweisungen** erscheint nicht im Einstellungsfenster `/config`:

423 

424* Sie verwenden eine Claude Code-Version vor v2.1.277

425* Ihre Sitzung [ruft keine Feature-Flags von Anthropic ab](/docs/de/env-vars#features-that-need-feature-flag-fetching), z. B. weil Sie Amazon Bedrock oder einen anderen Drittanbieter verwenden oder Telemetrie deaktiviert haben. Der verlinkte Abschnitt hat die vollständige Liste

426* Es ist Ihre [erste Sitzung nach der Installation oder dem Upgrade](/docs/de/env-vars#first-session-after-an-install-or-upgrade) auf eine Version mit `AGENTS.md`-Unterstützung. Claude liest `AGENTS.md` ab Ihrer nächsten Sitzung

427* Sie oder Ihre Organisation haben [`disableAllHooks`](/docs/de/settings-reference#disableallhooks) oder [`allowManagedHooksOnly`](/docs/de/settings-reference#allowmanagedhooksonly) gesetzt, oder Sie haben das integrierte `agents-md`-Plugin in `/plugin` deaktiviert

428 

429Um Claude Ihre `AGENTS.md` in diesen Sitzungen zu geben, [importieren Sie sie aus einer `CLAUDE.md`](#share-one-file-with-other-coding-tools).

430 

431<h3 id="where-agents-md-differs-from-claude-md">

432 Wo sich AGENTS.md von CLAUDE.md unterscheidet

433</h3>

375 434 

376Um eine Regeldatei auszuschließen, die Sie über einen [Symlink](#share-rules-across-projects-with-symlinks) erreichen, ob die Datei oder ihr Verzeichnis der Link ist, schreiben Sie das Muster gegen einen der beiden Pfade: den Pfad der Datei unter `.claude/rules/` oder ihr Link-Ziel. Ein Muster, das einen der beiden Pfade passt, schließt die Datei aus. Vor v2.1.239 schloss nur ein Muster, das das Link-Ziel passte, die Datei aus.435Eine `AGENTS.md`, die Claude durch die Einstellung **Projektanweisungen** liest, unterscheidet sich von einer `CLAUDE.md` an diesen Stellen:

377 436 

378CLAUDE.md-Dateien mit verwalteter Richtlinie können nicht ausgeschlossen werden. Dies stellt sicher, dass organisationsweite Anweisungen unabhängig von individuellen Einstellungen immer gelten.437| | `CLAUDE.md` | `AGENTS.md` gelesen durch die Einstellung |

438| :--------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

439| `/memory` und die Liste **Speicherdateien** in `/context` | Aufgelistet | Nicht aufgelistet. Um zu bestätigen, dass Claude sie gelesen hat, suchen Sie nach der [`AGENTS.md loaded`-Zeile](#when-claude-code-reads-agents-md) unter dem Standardwert oder fragen Sie Claude, was seine Projektanweisungen sagen |

440| [`InstructionsLoaded`-Hooks](/docs/de/hooks#instructionsloaded) | Werden ausgelöst | Werden nicht ausgelöst. Sie werden wie gewohnt ausgelöst für eine `AGENTS.md`, die eine `CLAUDE.md` importiert oder verlinkt |

441| Verzeichnisse, die Sie mit `--add-dir` hinzufügen, während [`CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD`](#load-from-additional-directories) gesetzt ist | Ihre `CLAUDE.md` lädt | Ihre `AGENTS.md` lädt nicht |

442| Ein `@path`-Import einer Datei außerhalb Ihres Arbeitsverzeichnisses | Claude Code fordert Sie auf, [externe Importe](#import-additional-files) zu genehmigen | Lädt nur, wenn Sie bereits externe Importe für dieses Projekt genehmigt haben, ohne Aufforderung |

443 

444<h3 id="remove-an-earlier-agents-md-workaround">

445 Entfernen Sie einen früheren AGENTS.md-Workaround

446</h3>

447 

448Wenn Sie Claude Code so eingerichtet haben, dass `AGENTS.md` gelesen wird, bevor es dies von selbst tat, hier ist, was Sie mit jedem häufigen Setup tun sollten:

449 

450* **Eine `CLAUDE.md` mit `@AGENTS.md`**: Sie können sie behalten. Das Behalten des Imports führt niemals dazu, dass Claude `AGENTS.md` zweimal liest, unabhängig davon, welchen **Projektanweisungen**-Wert Sie verwenden. Entfernen Sie die `CLAUDE.md`, wenn sie nichts anderes enthält, oder behalten Sie sie, wenn einige Ihrer Sitzungen [`AGENTS.md` nicht direkt laden können](#when-agents-md-support-is-unavailable).

451* **Eine `CLAUDE.md`, die Claude in Worten anweist, `AGENTS.md` zu lesen**: Claude sieht `AGENTS.md` nur, wenn es sich entscheidet, die Datei zu öffnen. Löschen Sie die `CLAUDE.md`, damit Claude `AGENTS.md` direkt liest, oder ersetzen Sie den Satz durch einen `@AGENTS.md`-Import.

452* **Eine `CLAUDE.md`, die mit `AGENTS.md` verlinkt ist**: nichts, oder löschen Sie den Symlink. Auf jeden Fall liest Claude den Inhalt einmal.

453* **Ein `SessionStart`-Hook, der `AGENTS.md` ausgibt**: entfernen Sie ihn. Sobald Claude `AGENTS.md` direkt liest, fügt der Hook eine zweite Kopie zum Kontext hinzu.

454 

455<h3 id="share-one-file-with-other-coding-tools">

456 Teilen Sie eine Datei mit anderen Codierungs-Tools

457</h3>

458 

459Wenn Claude Ihre `AGENTS.md` nicht direkt liest, können Sie sie trotzdem als die eine Datei behalten, die jedes Tool teilt, indem Sie einen `@AGENTS.md`-Import in eine `CLAUDE.md` neben ihr einfügen. Tun Sie dies, wenn Ihr Projekt auch eine `CLAUDE.md` hat, wenn Sie **Projektanweisungen** auf `claude-md` gesetzt haben, oder in Sitzungen, die [`AGENTS.md` nicht laden können](#when-agents-md-support-is-unavailable). Fügen Sie alle Claude-spezifischen Anweisungen unter dem Import hinzu, und Claude liest die importierte Datei zuerst, dann den Rest:

460 

461```markdown CLAUDE.md theme={null}

462@AGENTS.md

463 

464## Claude Code

465 

466Use plan mode for changes under `src/billing/`.

467```

468 

469Wenn Sie keinen Claude-spezifischen Inhalt benötigen, funktioniert auch ein Symlink:

470 

471```bash theme={null}

472ln -s AGENTS.md CLAUDE.md

473```

474 

475Der Befehl gibt bei Erfolg keine Ausgabe aus. Bevor Sie den Symlink dem Import vorziehen, überprüfen Sie diese Einschränkungen:

476 

477* **Bearbeitung**: Claude liest `CLAUDE.md` durch den Link, aber die Edit- und Write-Tools [weigern sich, durch einen Symlink zu schreiben](/docs/de/errors#refusing-after-a-symlink-changed), und die Weigerung weist Claude an, stattdessen das Ziel des Links, `AGENTS.md`, zu bearbeiten

478* **Windows**: Wenn Sie oder jemand, der das Repository klont, unter Windows arbeitet, verwenden Sie stattdessen den `@AGENTS.md`-Import. Das Erstellen eines Symlinks dort erfordert Administratorrechte oder den Entwicklermodus, und Git checkt einen committeten Symlink als Nur-Text-Datei aus, es sei denn, `core.symlinks` ist aktiviert, was diesen Klon mit einer einzeiligen `CLAUDE.md` anstelle Ihrer Anweisungen hinterlässt

479 

480Führen Sie mit beiden Ansätzen `/context` in Ihrer nächsten Sitzung aus und bestätigen Sie, dass `CLAUDE.md` unter **Speicherdateien** angezeigt wird.

481 

482<h3 id="migrate-instructions-from-other-tools">

483 Migrieren Sie Anweisungen von anderen Tools

484</h3>

485 

486Das Ausführen von [`/init`](/docs/de/commands) liest die Anweisungsdateien anderer Tools und integriert die relevanten Teile in die generierte `CLAUDE.md`:

487 

488* Cursor-Regeln in `.cursor/rules/` oder `.cursorrules`

489* Copilot-Regeln in `.github/copilot-instructions.md`

490* Mit `CLAUDE_CODE_NEW_INIT=1` gesetzt: `AGENTS.md`, `.devin/rules/`, `.windsurf/rules/` oder `.windsurfrules`, und `.clinerules`

491 

492Sie können auch [`/import`](/docs/de/commands) ausführen, um die Konfiguration eines unterstützten Codierungs-Agenten in Claude Code zu bringen, was eine einmalige Kopie von Anweisungsdateien wie `AGENTS.md` an die entsprechende `CLAUDE.md` anhängt und MCP-Server, Befehle, Subagenten und Skills überträgt. Erfordert Claude Code v2.1.213 oder später.

379 493 

380<h2 id="auto-memory">494<h2 id="auto-memory">

381 Auto-Memory495 Auto-Memory

422}536}

423```537```

424 538 

425Der Wert muss ein absoluter Pfad sein oder mit `~/` beginnen. Wenn Sie ihn in der `.claude/settings.json` oder `.claude/settings.local.json` eines Projekts festlegen, berücksichtigt Claude Code ihn unter der gleichen [Workspace-Trust-Regel wie Hooks in Einstellungsdateien](/docs/de/permissions#what-runs-before-you-trust-a-folder).539Der Wert muss ein absoluter Pfad sein oder mit `~/` beginnen.

540 

541Wenn Sie ihn in der `.claude/settings.json` oder `.claude/settings.local.json` eines Projekts festlegen, berücksichtigt Claude Code ihn unter der gleichen [Workspace-Trust-Regel wie Hooks in Einstellungsdateien](/docs/de/permissions#what-runs-before-you-trust-a-folder). Während [`permissions.blockReadsOutsideWorkingDirectories`](/docs/de/settings-reference#permissions-blockreadsoutsideworkingdirectories) aktiviert ist, lädt Claude Code kein Auto-Memory aus einem Verzeichnis, das eine [von einem Repository bereitgestellte Einstellungsdatei](/docs/de/permissions#when-your-local-settings-file-needs-trust) auswählt, und speichert keines darin, unabhängig davon, wo sich dieses Verzeichnis befindet.

426 542 

427Das Verzeichnis enthält einen `MEMORY.md`-Index und eine Themadatei pro Memory:543Das Verzeichnis enthält einen `MEMORY.md`-Index und eine Themadatei pro Memory:

428 544 

468 Anzeigen und Bearbeiten mit `/memory`584 Anzeigen und Bearbeiten mit `/memory`

469</h2>585</h2>

470 586 

471Der Befehl `/memory` listet Ihre CLAUDE.md-, CLAUDE.local.md- und andere Speicherdateien an verschiedenen Orten im Benutzer- und Projektbereich auf, einschließlich Benutzer- und Projekt-CLAUDE.md-Einträge für Dateien, die noch nicht existieren. Er ermöglicht es Ihnen auch, Auto-Memory ein- oder auszuschalten, und bietet eine Option zum Öffnen des Auto-Memory-Ordners. Wählen Sie eine beliebige Datei aus, um sie in Ihrem Editor zu öffnen. Wenn Sie eine Datei auswählen, die noch nicht existiert, wird sie zuerst erstellt. Um zu überprüfen, welche Dateien tatsächlich in die aktuelle Sitzung geladen wurden, führen Sie `/context` aus.587Der Befehl `/memory` listet Ihre CLAUDE.md, CLAUDE.local.md und andere Speicherdateien an verschiedenen Orten im Benutzer- und Projektbereich auf, einschließlich Benutzer- und Projekt-CLAUDE.md-Einträge für Dateien, die noch nicht existieren. Er ermöglicht es Ihnen auch, Auto-Memory ein- oder auszuschalten, und bietet eine Option zum Öffnen des Auto-Memory-Ordners. Wählen Sie eine beliebige Datei aus, um sie in Ihrem Editor zu öffnen; wenn Sie eine Datei auswählen, die noch nicht existiert, wird sie zuerst erstellt. Um zu überprüfen, welche `CLAUDE.md`- und Rules-Dateien in die aktuelle Sitzung geladen wurden, führen Sie `/context` aus.

472 588 

473GUI-Editoren wie VS Code öffnen die Datei in einem separaten Fenster, und Sie können die Sitzung weiterhin nutzen, während sie offen ist. Vor v2.1.216 wartete `/memory` darauf, dass Sie die Datei schließen, bevor es antwortete. Terminal-Editoren wie Vim übernehmen das Terminal, bis Sie es beenden.589GUI-Editoren wie VS Code öffnen die Datei in einem separaten Fenster, und Sie können die Sitzung weiterhin nutzen, während sie offen ist. Vor v2.1.216 wartete `/memory` darauf, dass Sie die Datei schließen, bevor es antwortete. Terminal-Editoren wie Vim übernehmen das Terminal, bis Sie es beenden.

474 590 

488 604 

489Zum Debuggen:605Zum Debuggen:

490 606 

491* Führen Sie `/context` aus und überprüfen Sie die Liste unter **Memory-Dateien**, um zu überprüfen, dass Ihre CLAUDE.md- und CLAUDE.local.md-Dateien geladen wurden. Wenn eine Datei dort fehlt, kann Claude sie nicht sehen. Verwenden Sie `/memory`, um die Dateien zu öffnen und zu bearbeiten.607* Führen Sie `/context` aus und überprüfen Sie die Liste unter **Memory-Dateien**, um zu überprüfen, dass Ihre CLAUDE.md- und CLAUDE.local.md-Dateien geladen wurden. Wenn eine `CLAUDE.md`-Datei dort fehlt, kann Claude sie nicht sehen. Eine `AGENTS.md` erscheint dort nur, wenn eine `CLAUDE.md` sie importiert, nicht wenn Claude [sie direkt liest](#where-agents-md-differs-from-claude-md). Verwenden Sie `/memory`, um die Dateien zu öffnen und zu bearbeiten.

492* Überprüfen Sie, dass die relevante CLAUDE.md an einem Ort ist, der für Ihre Sitzung geladen wird (siehe [Wählen Sie, wo Sie CLAUDE.md-Dateien ablegen](#choose-where-to-put-claude-md-files)).608* Überprüfen Sie, dass die relevante CLAUDE.md an einem Ort ist, der für Ihre Sitzung geladen wird (siehe [Wählen Sie, wo Sie CLAUDE.md-Dateien ablegen](#choose-where-to-put-claude-md-files)).

493* Machen Sie Anweisungen spezifischer. „Verwenden Sie 2-Leerzeichen-Einrückung" funktioniert besser als „formatieren Sie Code schön".609* Machen Sie Anweisungen spezifischer. „Verwenden Sie 2-Leerzeichen-Einrückung" funktioniert besser als „formatieren Sie Code schön".

494* Suchen Sie nach widersprüchlichen Anweisungen über CLAUDE.md-Dateien hinweg. Wenn zwei Dateien unterschiedliche Anleitungen für das gleiche Verhalten geben, kann Claude eine willkürlich auswählen.610* Suchen Sie nach widersprüchlichen Anweisungen über CLAUDE.md-Dateien hinweg. Wenn zwei Dateien unterschiedliche Anleitungen für das gleiche Verhalten geben, kann Claude eine willkürlich auswählen.

495 611 

496Wenn die Anweisung etwas ist, das an einem bestimmten Punkt ausgeführt werden muss, z. B. vor jedem Commit oder nach jeder Dateibearbeitung, schreiben Sie sie stattdessen als [Hook](/docs/de/hooks-guide). Hooks werden als Shell-Befehle bei festen Lebenszyklusereignissen ausgeführt und gelten unabhängig davon, was Claude entscheidet zu tun.612Wenn die Anweisung etwas ist, das an einem bestimmten Punkt ausgeführt werden muss, z. B. vor jedem Commit oder nach jeder Dateibearbeitung, schreiben Sie sie stattdessen als [Hook](/docs/de/hooks-guide). Hooks werden als Shell-Befehle bei festen Lebenszyklusereignissen ausgeführt und gelten unabhängig davon, was Claude entscheidet zu tun.

497 613 

498Für Anweisungen, die Sie auf System-Prompt-Ebene haben möchten, verwenden Sie [`--append-system-prompt`](/docs/de/cli-reference#system-prompt-flags). Sie müssen sie bei jeder Invokation übergeben, daher ist es besser für Skripte und Automatisierung als für interaktive Nutzung geeignet. Informationen zum Verhalten beim Fortsetzen einer Konversation finden Sie unter [System-Prompt-Flags in fortgesetzten Konversationen](/docs/de/cli-reference#system-prompt-flags-in-resumed-conversations).614Für Anweisungen, die Sie auf System-Prompt-Ebene haben möchten, verwenden Sie [`--append-system-prompt`](/docs/de/cli-reference#system-prompt-flags). Sie übergeben sie beim Start, daher ist es besser für Skripte und Automatisierung als für interaktive Nutzung geeignet. Informationen zum Verhalten beim Fortsetzen einer Konversation finden Sie unter [System-Prompt-Flags in fortgesetzten Konversationen](/docs/de/cli-reference#system-prompt-flags-in-resumed-conversations).

499 615 

500<Tip>616<Tip>

501 Verwenden Sie den [`InstructionsLoaded`-Hook](/docs/de/hooks#instructionsloaded), um genau zu protokollieren, welche Anweisungsdateien geladen sind, wann sie geladen werden und warum. Dies ist nützlich zum Debuggen von pfadspezifischen Regeln oder Lazy-Loading-Dateien in Unterverzeichnissen.617 Verwenden Sie den [`InstructionsLoaded`-Hook](/docs/de/hooks#instructionsloaded), um genau zu protokollieren, welche `CLAUDE.md`- und Regeldateien geladen sind, wann sie geladen werden und warum. Dies ist nützlich zum Debuggen von pfadspezifischen Regeln oder Lazy-Loading-Dateien in Unterverzeichnissen.

502</Tip>618</Tip>

503 619 

620<h3 id="my-agents-md-isn’t-loading">

621 Meine AGENTS.md wird nicht geladen

622</h3>

623 

624Wenn Ihr Repository eine `AGENTS.md` hat und Claude scheint nicht zu wissen, was sie sagt, ist die übliche Ursache eine `CLAUDE.md` irgendwo auf dem Projektpfad. Standardmäßig liest Claude `AGENTS.md` nur, wenn Sie keine `CLAUDE.md` oder `CLAUDE.local.md` in Ihrem Arbeitsverzeichnis oder darüber haben. Überprüfen Sie diese in dieser Reihenfolge:

625 

6261. Suchen Sie nach einer `CLAUDE.md`, `.claude/CLAUDE.md` oder `CLAUDE.local.md` in Ihrem Arbeitsverzeichnis oder einem Verzeichnis darüber, außer Ihrer `~/.claude/CLAUDE.md`. Wenn Sie eine finden, liest Claude sie statt `AGENTS.md`, es sei denn, Sie setzen **Projektanweisungen** auf `claude-md-and-agents-md`.

6272. Führen Sie `claude --version` aus und bestätigen Sie v2.1.277 oder später.

6283. Überprüfen Sie, ob Ihre Sitzung eine ist, die [kann `AGENTS.md` nicht laden](#when-agents-md-support-is-unavailable), wie eine Sitzung bei einem Drittanbieter oder mit deaktivierter Telemetrie.

6294. Geben Sie `/config` in Ihrer Sitzung ein, um das Einstellungsfenster zu öffnen und bestätigen Sie, dass **Projektanweisungen** nicht auf `claude-md` oder `managed-only` gesetzt ist. Wenn Sie die Einstellung dort überhaupt nicht sehen, ist Ihre Sitzung eine, die [kann `AGENTS.md` nicht laden](#when-agents-md-support-is-unavailable).

630 

631`AGENTS.md` erscheint nicht in `/memory` oder `/context`, wenn Claude sie direkt liest, also überprüfen Sie auf die Zeile `AGENTS.md loaded` oder fragen Sie Claude, was seine Projektanweisungen sagen. Wenn Sie die `CLAUDE.md` behalten möchten, die Sie gefunden haben, oder Ihre Sitzung kann `AGENTS.md` nicht laden, [fügen Sie eine `CLAUDE.md` neben Ihrer `AGENTS.md` hinzu, die sie importiert](#share-one-file-with-other-coding-tools).

632 

504<h3 id="i-don’t-know-what-auto-memory-saved">633<h3 id="i-don’t-know-what-auto-memory-saved">

505 Ich weiß nicht, was Auto-Memory gespeichert hat634 Ich weiß nicht, was Auto-Memory gespeichert hat

506</h3>635</h3>