Du erklärst deinem KI-Assistenten diese Woche zum dritten Mal dasselbe. Dass du auf Deutsch schreibst. Dass in diesem Ordner Unterlagen liegen, an denen ohne Rückfrage nichts geändert wird. Dass du in Tabellen kurze Überschriften willst und keine Sätze.

All das lässt sich einmal sagen und an einer Stelle festhalten, in die Claude Code zu Beginn jedes Chats schaut. Diese Datei heisst CLAUDE.md, ist reiner Text – und du wirst sie nicht von Hand schreiben. Das übernimmt Claude Code, nach einem kurzen Gespräch mit dir. Der Rest dieser Lektion ist die Prüfung, dass CLAUDE.md auch wirkt, denn dass die Datei existiert, gibt dir für sich genommen noch keine Gewissheit.

Vorher können musst du nichts. Es gibt keine Syntax zu lernen und nichts, was man falsch eintippen und damit kaputt machen könnte.

Wenn du claude.ai, ChatGPT oder Perplexity nutzt, kennst du vielleicht das Feld für Angaben über dich – «custom instructions», «Personalisierung», «über mich». CLAUDE.md funktioniert nach demselben Prinzip, sie liegt nur in deinem Ordner statt in den Einstellungen eines Dienstes. Wenn du solche Angaben schon irgendwo formuliert hast, kannst du sie einfach in CLAUDE.md kopieren, das wirkt genauso. Wir gehen hier trotzdem den Weg von null durch, weil es sich lohnt, einmal zu sehen, woher jeder Satz in dieser Datei kommt.

Wozu es diese Datei überhaupt gibt

Zu Beginn jedes Chats hat Claude Code keinerlei Daten aus früheren Gesprächen im Gedächtnis. Es weiss nicht, was ihm gestern erklärt wurde, und auch nicht, dass dieses Gespräch überhaupt stattgefunden hat. Jeder Chat beginnt bei null.

CLAUDE.md ist die Antwort auf diese Grenze. Es ist die Datei, die Claude Code als Erstes zu Beginn jedes Chats liest. Alles, was darin steht, ist im Gespräch, bevor du das erste Wort schreibst.

Eine Sache gleich vorweg, um spätere Enttäuschung zu vermeiden: das ist eine Anweisung, keine Systemeinstellung. Claude Code liest die Datei und richtet sich danach, aber es ist keine technische Sperre, die etwas verbietet. Je konkreter du etwas aufschreibst, desto zuverlässiger wird es angewendet – dazu kommen wir gleich zurück.

Dokumentation zum Gedächtnis

Lass Claude diese Datei schreiben

Öffne keinen Editor. Geh in den Ordner, in dem du arbeitest, starte claude und bitte um die Datei – zusammen mit der Bitte um ein Interview:

Lege in diesem Ordner eine Datei CLAUDE.md an. Bevor du sie schreibst, stell mir ein paar Fragen dazu, wer ich bin, was ich mache und wie ich mit dir arbeiten möchte.

Claude Code beginnt zu fragen, eine Frage nach der anderen. Antworte kurz, in normalen Sätzen – so, wie man mit einem Menschen spricht, der deine neue Assistenz werden soll und gerade seinen ersten Arbeitstag hat. Aus diesem Gespräch sollte hervorgehen:

  1. Wer du bist und was du machst – «ich führe ein kleines Treuhandbüro», «ich mache Grafiken für Kundinnen und Kunden».
  2. In welcher Sprache du arbeiten willst – wenn auf Deutsch, dann sag es ausdrücklich.
  3. Was in diesem Ordner liegt und was ohne Rückfrage nicht angefasst wird.
  4. Was du nicht kannst und auch nicht lernen willst – «ich bin keine Entwicklerin, erklär technische Dinge in einfacher Sprache» ist eines der nützlichsten Dinge, die du sagen kannst.
  5. Wie geschrieben werden soll – hier lohnt es sich, gleich zwei Angewohnheiten zu kappen, an denen man KI-Texte von Weitem erkennt: zu viele Emojis und lange Gedankenstriche mitten im Satz. «Keine Emojis» und «keine langen Gedankenstriche» genügen.

Wenn Claude etwas fragt, worauf du keine Antwort hast, sag genau das. Das ist keine Prüfung, und falsche Antworten gibt es hier nicht.

Wenn Claude Code mit den Fragen fertig ist, schreibt es die Datei selbst und sagt dir, dass sie bereit ist. Format, Reihenfolge, Überschriften – das ist seine Sache. Es schreibt eine Datei, die es selbst täglich liest, also legt es sie in der Form an, die ihm am besten passt.

Schau hinein, das ist reiner Text

Jetzt der wichtigste Teil dieser Lektion: überzeug dich davon, dass daran nichts Magisches ist.

Öffne die Datei in einem einfachen Texteditor – Notepad unter Windows, TextEdit unter macOS. Du siehst normale Sätze, ungefähr so:

# Über mich und diese Arbeit

- Ich heisse Anna und führe ein kleines Treuhandbüro.
- Sprechen wir Deutsch.
- In diesem Ordner liegen Briefvorlagen und Dokumentmuster.
- Ich bin keine Entwicklerin. Erklär technische Dinge in einfacher Sprache.

CLAUDE.md ist nichts Verschlüsseltes, nichts, was man nicht lesen könnte. Du kannst sie durchlesen, wann immer dir danach ist – sie gehört dir.

Die Datei muss genau CLAUDE.md heissen: Grossbuchstaben, mit der Endung md. Etwas anderes liest Claude Code nicht. Pass deshalb beim Speichern in Notepad auf, denn das hängt gern seine eigene Endung an und macht CLAUDE.md.txt daraus – die Datei bleibt dann auf der Festplatte, aber Claude Code findet sie nicht. Im Gespräch selbst braucht es diese Genauigkeit nicht: schreib «überarbeite claude md» und Claude versteht, was gemeint ist.

Achte darauf, was nicht in der Datei steht: eine Liste der Dateien, die Claude Code ohnehin selbst sieht, sobald es in den Ordner schaut. Hinein gehört, was sich nicht aus dem Ordnerinhalt ablesen lässt – deine Vorlieben, dein Kontext, deine Grenzen. Die Ordnerstruktur ist die nützliche Ausnahme: wenn die Ordner 01_laufend und 02_vorlagen heissen, erspart ein Satz darüber, was wo liegt, der KI das Raten.

Kurz schlägt lang. Die Dokumentation empfiehlt, unter zweihundert Zeilen zu bleiben, und das ist nicht willkürlich: je länger die Datei, desto mehr Platz nimmt sie im Gedächtnis des Gesprächs ein und desto schlechter hält sich Claude Code daran.

Die Datei liegt direkt im Projektordner, und dabei belassen wir es heute. Es gibt auch eine persönliche Fassung, ~/.claude/CLAUDE.md, die für alle deine Projekte zugleich gilt – fang aber mit einem Projekt an, damit du die Wirkung an etwas Kleinem siehst.

Dokumentation zum Gedächtnis

Ergänze eine Anweisung, eine konkrete

Jetzt der wichtigste Teil der Übung. Ergänze in der Datei eine Anweisung, an die sich Claude Code immer halten soll – formuliert so, dass sich prüfen lässt, ob sie angewendet wurde.

Eine gute Anweisung unterscheidet sich von einer schlechten durch ihre Genauigkeit:

  • Schwach: «schreib ordentlich», «achte auf Qualität», «sei gründlich».
  • Gut: «schreib Daten immer im Format DD.MM.JJJJ», «antworte in höchstens fünf Sätzen, ausser ich bitte um mehr».

Eine Anweisung aus der ersten Gruppe sagt der KI nicht, was sie konkret anders machen soll. Eine aus der zweiten sagt es – und du siehst mit blossem Auge, ob sie gewirkt hat.

Vermeide dabei Anweisungen über ein Verbot. «Schau nie in den Ordner Archiv» klingt bestimmt, wirkt aber umgekehrt zu dem, wie es sich liest: der Satz bringt diesen Ordner überhaupt erst ins Gespräch, und Claude muss ihn die ganze Zeit im Blick behalten, um ihn zu meiden. Versuch einen Moment lang, nicht an einen rosa Elefanten zu denken – dann weisst du, worin das Problem besteht. Schreib, was Claude Code tun soll, statt was es nicht tun soll: «arbeite ausschliesslich mit Dateien aus dem Ordner laufend».

Nimm für diese Lektion etwas gut Sichtbares. Ein Datumsformat eignet sich hervorragend. Schreib im Chat im Terminal:

Ergänze in CLAUDE.md die Anweisung: schreib Daten immer im Format DD.MM.JJJJ.

Prüf nach, ob Claude Code sie wirklich sieht

Das Nachprüfen ist der Schritt, den die meisten überspringen – und ohne ihn weisst du nicht, ob überhaupt etwas wirkt.

Fang mit einem neuen Chat an: schliess Claude Code und starte claude noch einmal. Das ist keine Formsache, und zwar aus zwei Gründen. Im vorherigen Gespräch kannte Claude Code den Inhalt der Datei, weil es sie gerade selbst geschrieben hatte – das ist kein Beleg dafür, dass sie gelesen wird. Und CLAUDE.md wird nur zu Beginn eines Chats gelesen: kehrst du in ein früher geöffnetes Gespräch zurück, gilt dort weiterhin die alte Fassung, auch wenn die neue längst gespeichert ist.

Stell im neuen Chat eine Frage, die deine Anweisung erzwingt:

Schreib einen Satz mit dem heutigen Datum.

Kommt das Datum im Format DD.MM.JJJJ, wirkt die Datei. Du kannst auch direkt fragen:

Was weisst du aus der Datei CLAUDE.md über mich?

Und jetzt der beste Beleg dafür, dass wirklich diese Datei die Antworten steuert: ändere darin das Datumsformat auf JJJJ-MM-TT, öffne einen weiteren neuen Chat und stell dieselbe Frage nach dem Datum. Das Format sollte sich ändern. Wenn ja, weisst du, dass die Datei jedes Mal neu gelesen wird und nicht ein für alle Mal gemerkt.

Wenn eine Anweisung ignoriert wird

Dass eine Anweisung übergangen wird, kommt vor, und es heisst nicht, dass auf deiner Seite etwas schiefgelaufen ist.

Bevor du etwas korrigierst, mach das, was sich in jedem Gespräch mit KI lohnt, nicht nur bei dieser Datei: frag nach, warum es so vorgegangen ist.

Warum hast du das Datum in diesem Format geschrieben, obwohl in CLAUDE.md ein anderes steht?

Sich über die KI zu ärgern bringt nichts, diese Frage dagegen führt meist direkt zur Ursache – und die liegt am häufigsten darin, wie die Anweisung formuliert war. Du bekommst dann etwas Konkretes zurück: dass die Datei nicht in dem Ordner lag, aus dem das Gespräch gestartet wurde, dass zwei Anweisungen Verschiedenes sagen, oder dass sich diese eine anders lesen liess, als sie gemeint war.

Zwei Ursachen kommen in dieser Antwort am häufigsten vor:

  1. Die Anweisung ist nicht konkret – «fass dich kurz» ist ein Wunsch, «höchstens fünf Sätze» ist eine Anweisung, denn nur bei der zweiten siehst du mit blossem Auge, ob sie angewendet wurde.
  2. Zwei Anweisungen widersprechen sich – enthält die Datei gegenläufige Vorgaben, wendet Claude Code eine davon an, und du weisst nicht, welche.

Korrigier die Datei, öffne einen neuen Chat und prüf noch einmal nach. Das ist der normale Arbeitszyklus mit dieser Datei und kein Zeichen von Scheitern: auch bei uns ist die erste Fassung fast nie die letzte.

Dokumentation zum Gedächtnis

Eine Sache bleibt noch, die es zu kennen lohnt, auch wenn du sie heute nicht brauchst: der Befehl /init. Damit geht Claude Code den Ordnerinhalt durch und schreibt CLAUDE.md selbst, auf Basis dessen, was es dort findet – ohne dich etwas zu fragen. Das hilft, wenn im Ordner schon viel Material liegt und Claude Code es beschreiben soll. Eine eigene Lektion führt durch diesen Weg.

Heute ist diese Datei aus einem Gespräch entstanden, und das war eine bewusste Entscheidung: alles, was darin steht, kam von dir, und Claude Code hat ihm nur eine Form gegeben.

Aufgaben

Hak ab, was erledigt ist. Der Stand wird im Browser gemerkt, du kannst also morgen zu dieser Liste zurückkommen.

  • Claude Code hat das Interview geführt und CLAUDE.md geschrieben
  • Dateiinhalt in einem einfachen Texteditor angeschaut
  • Eine konkrete Anweisung ergänzt, die sich prüfen lässt
  • Neuen Chat geöffnet, Kontrollfrage gestellt
  • Datumsformat geändert und in einem weiteren Chat geprüft
  • Ich weiss, dass ich direkt nach dem Grund einer falschen Antwort fragen kann