Die meisten, die Claude Code nutzen, ignorieren die eine Datei, die die KI immer liest, bevor sie eine Aufgabe startet.
Diese Datei heißt "CLAUDE.md".
In der offiziellen Dokumentation von Anthropic heißt es klar: Wenn eine CLAUDE.md-Datei im Ordner existiert, lädt Claude Code sie immer, bevor die Arbeit beginnt – selbst wenn du es nicht explizit verlangst.
Anders gesagt: Was du hier schreibst, verändert das anfängliche Verhalten der KI zu 100 %. Während du jedes Mal Prompts neu tippen musst, funktioniert CLAUDE.md über alle Gespräche hinweg, sobald sie einmal geschrieben ist.
Der Hebel sitzt auf einer ganz anderen Ebene.
Umgekehrt: Wenn du diese Datei nicht organisierst, nützen dir noch so gute Prompts nichts. Die KI weicht jedes Mal ab. Du musst jedes Mal die Grundlagen neu erklären. Selbst bei derselben Aufgabe schwankt die Qualität von Tag zu Tag. Die Ursache ist nicht das Modell oder deine Prompt-Fähigkeit – es ist diese Datei.
Heute verrate ich dir genau, "was und wie" du in die CLAUDE.md schreiben solltest – inklusive kopierbarer Beispiele.
Für die mit schlechten Ergebnissen ist die CLAUDE.md nur ein "Notizzettel"
Um ehrlich zu sein, hatte ich anfangs auch Probleme.
Eine Weile lang gab es auf X viele Beiträge, die sagten "Ordnerinhalte sind wichtig" oder "CLAUDE.md ist wichtig." Ich sah sie und öffnete meine Ordner.
Der Inhalt war ein Chaos.
Ich wusste nicht, was wo war. Ähnliche Daten waren überall verstreut. Die KI fand das benötigte Wissen nicht, und bei jeder Ausgabe kam nicht die Antwort, die ich wollte.
Mit der CLAUDE.md war es genauso. Die Regeln dafür, wo was gespeichert wird, waren nicht festgelegt. Ich verstand nicht einmal, was CLAUDE.md überhaupt ist. Also fügte ich einfach Anweisungen von oben herab hinzu, wie sie mir einfielen.
Das Ergebnis: 300 oder 400 Zeilen. Leicht über 200 Zeilen.
Empfohlen wird, die CLAUDE.md auf maximal 200 Zeilen zu halten.
Eine zu lange CLAUDE.md wird zu einem "langen Text, bei dem die KI nicht weiß, was wichtig ist."
In diesem Zustand liest die KI die gesamte Datei jedes Mal neu und versucht zu erraten: "Welcher Teil trifft auf diese Aufgabe zu?" Wo geraten wird, folgt Inkonsistenz. Natürlich.
Die CLAUDE.md ist kein "Notizblock". Sie ist eine "Karte für die Entscheidungsfindung", auf die die KI jedes Mal zurückgreift. Dieses Verständnis zu ändern, ist die halbe Miete.
Schreibe nur diese 5 Dinge in die CLAUDE.md
Du musst es nicht überkomplizieren. Ein starkes Kommandozentrum enthält immer diese fünf Elemente:
- ① Prioritätsregeln: Die Leitaussage, die vor jeder Ausgabe befolgt werden muss
- ② Schlagwort → Ort-Routing-Tabelle: Welche Aufgabe wohin gehört
- ③ Entscheidungsbaum für Orte: Wie man Elemente bewertet, die nicht in der Tabelle stehen
- ④ Aufgabenverwaltung: Wie und wo festgehalten wird, was erledigt werden muss
- ⑤ Umgang mit vertraulichen Informationen: Die Grenze dessen, was nicht geteilt werden darf
Wenn diese fünf vorhanden sind, hört die KI auf zu "raten" und beginnt zu "referenzieren". Die Wurzel der Inkonsistenz verschwindet.
Schauen wir uns nun an, wie man jedes einzelne mit echten Beispielen schreibt.
Einstellung ①: "Prioritätsregeln" ganz oben deklarieren
Das Erste, was geschrieben wird, ist eine Erklärung, die den ersten Schritt der KI festlegt. Es ist eine Warnung: "Bevor du denkst, befolge zuerst die untenstehenden Regeln."
▼ Schreibbeispiel
Priorität: Bevor du etwas ausgibst oder speicherst, überprüfe immer zuerst die folgenden Regeln. Standorte müssen anhand der "Schlagworttabelle" und des "Entscheidungsbaums" unten bestimmt werden. Wenn du dich nicht entscheiden kannst, handle nicht eigenständig, sondern stelle eine Frage.
Allein dadurch, dass man dies an den Anfang setzt, hört die KI auf, einfach "nur ihre Hände zu bewegen". Sie beginnt, jedes Mal vor dem Handeln die Regeln zu prüfen. Das fixiert den Ausgangspunkt.
Einstellung ②: Eine "Schlagwort → Ort"-Zuordnungstabelle einfügen
Das nächstwirksamste ist eine Arbeitsverteilungstabelle. Verbinde "wenn diese Anfrage kommt, lege sie hier hin/schaue hier nach" mit Schlagwörtern.
▼ Schreibbeispiel
Schlagwort → Ort ・Blog/Artikel → Publishing/Blog/ ・Ausgaben/Belege → Accounting/Vouchers/ ・Protokolle/MTG-Notizen → Records/Minutes/
Der Trick ist, es genau in den Wörtern zu schreiben, die du normalerweise verwendest. Die KI sieht die Wörter in der Tabelle und kann den Ort ohne Zögern wählen.
Der Tipp für die Verteilungsachse ist, nach "Funktion (Aufgabe)" statt nach "Geschäftsbereich" zu schneiden. So bleibt die Tabelle auch bei neuen Geschäften oder Produkten stabil.
Einstellung ③: Einen "Entscheidungsbaum" für den Fall, dass die KI ratlos ist ← Das ist am effektivsten
Von den fünf hat dieser den größten Einfluss. Wie man mit Dingen umgeht, die nicht in der Tabelle stehen oder die mehrdeutig sind.
Sowohl Menschen als auch KI bleiben stehen, wenn sie ratlos sind. Sie weichen ab, weil sie ratlos sind. Also beseitige einfach den Raum fürs Zögern. Lass sie einen JA/NEIN-Pfad von oben nach unten durchlaufen.
▼ Schreibbeispiel
Bevor du speicherst, befolge diese Schritte der Reihe nach: F1: Ist es vertrauliche Information (API-Schlüssel/Passwörter)? → JA: In .env ablegen. Ende. F2: Sind es rohe Daten, die gerade von extern heruntergeladen wurden? → JA: Nach Assets/. F3: Zu welchem Aufgabenbereich gehört es? → Gehe zu einem von: Publishing / Sales / Accounting / Records. → Wenn am Ende kein eindeutiger Ort bestimmt werden kann, handle nicht weiter; stelle genau 2 Fragen.
Wie verändert sich das Verhalten vor und nach dem Hinzufügen eines Entscheidungsbaums? Konkret auf zwei Arten.
Veränderung 1: Es führt für dieselbe Anfrage jedes Mal die gleiche Aktion aus.
Claude Code arbeitet mit Wahrscheinlichkeiten. Es erinnert sich nicht an das vorherige Gespräch, wenn der Chat wechselt. Ohne Entscheidungsbaum schwankt es also selbst bei derselben Anfrage "speichere das Protokoll".
Ohne Entscheidungsbaum:
- 1. Mal → in Meeting/ gespeichert
- 2. Mal → Memo/Minutes/
- 3. Mal → aus irgendeinem Grund der Assets-Ordner
Mit Entscheidungsbaum:
- Jedes Mal derselbe Pfad: F1→F2→F3 → Immer derselbe Ort
Das Verhalten wechselt von "wahrscheinlichkeitsbasierter Fluktuation" zu einer "festen Prozedur". Reproduzierbarkeit bedeutet, dass man darauf aufbauen kann.
Veränderung 2: Es hört auf, bei Ratlosigkeit überheblich Fehler zu machen.
Das gruseligste KI-Verhalten ist "mit Überzeugung falsch zu liegen". Zum Beispiel eine Videoaufnahme und das daraus erstellte Protokoll an denselben Ort zu werfen.
- Durch Raten erzwingen → ❌
- Anhalten und mit 2 Fragen überprüfen → ✓
Die letzte Zeile wirkt subtil. Allein durch den Satz "Wenn du dich nicht entscheiden kannst, überstürze nichts, frage nach", reduziert man strukturell die Massenproduktion von danebenliegenden Ergebnissen.
Je intelligenter die KI, desto besser funktioniert sie mit einer "Vorlage" anstatt mit völliger Freiheit.
Einstellung ④ & ⑤: Aufgabenverwaltung und Vertraulichkeit
Die restlichen zwei können kurz sein. Aber sie müssen geschrieben werden.
④ Lege fest, "wo und wie" Aufgaben hinterlassen werden. Ohne dies verstreuen sich die zu erledigenden Dinge mit jedem Gespräch.
▼ Schreibbeispiel
Aufgabenverwaltung ・Fasse alle To-dos in einer einzigen Datei "tasks.md" zusammen. ・Wenn erledigt, nicht löschen; in "Erledigt" verschieben und ein 1-zeiliges Ergebnis hinterlassen.
⑤ Schreibe die Grenzen für vertrauliche Informationen klar. Das ist die Lebensader zur Unfallverhütung.
▼ Schreibbeispiel
Vertrauliche Informationen ・Schreibe API-Schlüssel/Passwörter nur in .env. ・Füge sie niemals in Chats, Code oder Aufzeichnungen ein.
Mit diesen beiden verstreuen sich Aufgaben nicht, und Dinge, die nicht nach außen dringen sollen, bleiben drinnen. Sie wirken als deine zwei Schutzschilde.
Halte die CLAUDE.md "unter 200 Zeilen." Wenn sie überläuft, verschiebe Inhalte in eine andere Datei.
Einige von euch haben vielleicht gemerkt: Wenn man alles in die CLAUDE.md schreibt, wird sie immer länger.
Das stimmt. Das ist wichtig. Wenn die CLAUDE.md zu lang wird, wird sie tatsächlich weniger effektiv. Da die KI sie jedes Mal von Anfang bis Ende liest, verwässert bei zu großer Länge das Gefühl dafür, "was wichtig ist".
Die Richtlinie ist unter 200 Zeilen.
Wenn es nicht hineinpasst, verschiebe detaillierte Regeln in eine separate Datei (z. B. "rules_detail.md"). Gib dann oben in der CLAUDE.md Anweisungen, "wann sie zu lesen ist".
▼ Schreibbeispiel (Füge einfach eine Zeile zur oberen Deklaration hinzu)
Priorität: Bevor du ausgibst/speicherst, befolge immer die folgenden Regeln. Lies "rules_detail.md" nur, wenn du einen Blogbeitrag schreibst.
Der Trick hier ist, eine Bedingung wie "nur wenn..." hinzuzufügen, anstatt "immer lesen". So öffnet die KI diese Datei nicht für nicht verwandte Aufgaben, sondern für notwendige Aufgaben geht sie den Weg "CLAUDE.md → rules_detail.md".
Das hält den Hauptteil schlank, während du beliebig viele detaillierte Regeln hinzufügen kannst. Der Punkt ist, ein Call-on-Demand-System zu schaffen.
Die CLAUDE.md ist der "Eingang und Kommandeur", Details sind "Abrufbare separate Dateien". Wenn du dich an diese Rollenverteilung erinnerst, brechen deine Regeln nicht zusammen, egal wie sehr sie zunehmen.
Um ehrlich zu sein, wird es nicht auf einen Schlag zu einem völlig anderen Tier
Ich werde hier ehrlich sein.
Ich habe ein Chaos von 300-400 Zeilen in 5 Blöcke umorganisiert. Danach war das erste, was ich fühlte, keine "dramatische Veränderung".
Zuerst hörte es einfach auf, sich zu verirren. Das war alles.
Die Welt verändert sich nicht auf einen Schlag. Es wirkt allmählich. Es liefert für dieselbe Anfrage dieselbe Bewegung zurück, Ergebnisse gehen daneben nehmen ab, und Wissen sammelt sich an. Bevor du es merkst, bewegt es sich wie ein völlig anderes Tier. So funktioniert es.
Wenn du auffällige Magie erwartest, wirst du enttäuscht sein. Aber Reproduzierbarkeit wird sich definitiv aufbauen.
Zusammenfassung: Für die, die alles zu tun als zu viel Aufwand empfinden
Denk nicht zu kompliziert. Was du heute tun musst, ist, deine CLAUDE.md zu öffnen (oder eine zu erstellen, falls du keine hast). Das ist alles.
Für die, die alles zu tun als zu viel Aufwand empfinden, hier die Prioritätenliste mit Zeitangaben:
- Erste 5 Min: Schreibe 3 Fragen für ③ Entscheidungsbaum (Größte Wirkung)
- +7 Min: Füge ① Prioritätsregeln und ② Routing-Tabelle hinzu
- +3 Min: Füge ④ Aufgaben und ⑤ Vertraulichkeitsgrenzen hinzu
Insgesamt 15 Minuten. Das richtet sie in der Reihenfolge ①→②→③→④→⑤ aus. Wenn es so aussieht, als würde es 200 Zeilen überschreiten, verschiebe die Details in eine separate Datei und lass sie von oben lesen. Das ist alles.
Du musst es nicht überfrachten. Strukturiere es einfach. Allein dadurch wird sich das gleiche Claude Code, das du gestern benutzt hast, anfangen zu bewegen, als wäre es etwas ganz anderes.
Leute, die die Leistung von Claude Code verbessern wollen, suchen immer nach Prompt-Techniken. Aber der wahre Hebel sitzt weiter oben. Es ist die eine Datei, die die KI jedes Mal zuerst liest.
Der Unterschied zwischen den Top 5 % und den restlichen 95 % ist nicht Talent oder Prompt-Fähigkeit. Es ist nur, ob sie eine CLAUDE.md-Datei organisiert oder einfach ignoriert haben.
Fang damit an, die 3 Entscheidungsbaum-Fragen aus diesem Artikel zu kopieren und einzufügen.
Zum Schluss
Zum Schluss möchte ich noch etwas gestehen.
Die Folien (Slides), die ich normalerweise herausbringe, werden alle von KI gemacht. Ich habe keine einzige handgemachte Folie mehr.
Und heute gebe ich die KI weg, die sie mit genau derselben Qualität erstellen kann.
Wenn du bis hierher gelesen hast, hast du wahrscheinlich schon verstanden. Alles, worüber ich in diesem Artikel gesprochen habe, läuft auf eines hinaus:
"Lass die KI nicht ratlos werden."
KI scheitert nicht, weil ihre Fähigkeit gering ist. Sie scheitert, weil sie ratlos ist.
Gib ihr Kontext. Gestalte die Anweisungen. Lass keinen Raum für die KI, um zu grübeln. Mit anderen Worten: Ziehe sie als Assistenten heran. In diesem Artikel haben wir das mit Claude Code gemacht.
Was ich gleich verteilen werde, ist ein ChatGPT GPTs. Nur zur Klarstellung: Der Haupttext handelte von Claude Code, und das hier ist ein ChatGPT GPTs. Die Werkzeuge sind unterschiedlich.
Aber die Wurzel ist dieselbe. Was gebraucht wird, ist keine Technologie. Es ist nur ein Design, das die KI nicht ratlos werden lässt.
Dieses GPTs ist ein fertiges Produkt, das diese Philosophie im einzelnen Bereich der "Folienerstellung" bis zum Äußersten treibt. Ich habe bereits die gesamte Arbeit des Kontextdesigns abgeschlossen.
Ich garantiere es. Alles, was du tust, ist, das Thema einzutippen. Danach spuckt das durchdacht gestaltete GPTs ohne Zögern Folien aus.
Der Artikel, der dieses GPTs erstmals vorstellte, erzielte 400.000 Impressionen. So viele Menschen reagierten und sagten "das ist anders".
https://x.com/masaki_aihack/status/2068646555524223366
Und für eine begrenzte Zeit verschenke ich ein Paket mit "20 Boni", einschließlich dieses GPTs.
Der Weg, es zu erhalten, ist einfach. Tritt zuerst dem untenstehenden LINE-Open-Chat bei.
Ich werde ehrlich sein: Dieses GPTs war nicht auf Anhieb fertig. Ich bin mehr als 50 Mal gescheitert. Es dauerte eine Woche, um endlich zu einem Punkt zu gelangen, an dem "es jeder nutzen kann". Ich gebe dieses Handbuch genau so weiter.
Lass es mich noch einmal sagen. Was gebraucht wird, ist keine Technologie. Es ist nur der Einfallsreichtum, die KI nicht ratlos werden zu lassen.
Warum nicht noch heute die Erschöpfung der Folienerstellung beenden?
