Guide · Setup & Grundlagen
Bessere Regeln aus /insights
Wie du aus dem /insights-Bericht Regeln für deine CLAUDE.md baust.
- /insights
- ein Befehl in Claude Code
- bis zu 200
- neue Sitzungen pro Lauf
- 30 Tage
- dann wird der Bericht gelöscht
Worum es geht. Du tippst in Claude Code einfach /insights, und dann bekommst du einen Bericht als Webseite, wie du eigentlich mit ihm arbeitest. Das Spannende daran ist halt, dass du da ganz konkret siehst, welche Anweisungen du ihm immer wieder gibst. Und genau die schreibst du dann einmal in deine CLAUDE.md, damit du sie nicht mehr wiederholen musst.
SCHRITT 1
Den Bericht starten
Ein Befehl, danach arbeitet Claude Code allein
/insights eintippen
Du öffnest Claude Code ganz normal im Terminal, tippst /insights ins Eingabefeld und schickst es ab. Mehr musst du an der Stelle nicht machen.
Claude geht deine Sitzungen durch
Er liest bis zu 200 neue Sitzungen pro Lauf, und zwar nur die, die auf diesem Rechner gelaufen sind. Sehr kurze Sitzungen überspringt er einfach, weil da halt nichts Auswertbares drinsteht.
Den Bericht öffnen
Am Ende liegt der Bericht als Webseite auf deinem Rechner. Die Datei kannst du im Browser öffnen, auf dem Mac geht das auch direkt über das Terminal:
Bericht öffnen (Mac)
open ~/.claude/usage-data/report.htmlGut zu wissen. Der Bericht wird nach 30 Tagen automatisch gelöscht. Wenn du ihn länger behalten willst, kopierst du dir die Datei einfach in einen anderen Ordner.
SCHRITT 2
Den Bericht lesen
Der Bericht hat drei Teile, und jeder liefert dir etwas anderes
Was drinsteht
- Woran du arbeitest: Deine Projekte und Aufgaben aus den letzten Sitzungen
- Reibungspunkte: Wo er dich falsch verstanden hat und wo Code kaputtgegangen ist
- Vorschläge: Was du verbessern kannst und welche Funktionen du ausprobieren solltest
Worauf du achtest
- Woran du arbeitest: Bei welchen Projekten du am meisten mit Claude machst, da lohnt sich eine eigene CLAUDE.md am meisten
- Reibungspunkte: Was mehr als einmal vorkommt, das ist dein Kandidat für eine Regel
- Vorschläge: Welche Vorschläge zu deiner Arbeit passen und welche du gleich testen willst
Am meisten bringen die Reibungspunkte
Da siehst du nämlich, wo es zwischen dir und Claude immer wieder hakt. Wenn er zum Beispiel öfter in der falschen Sprache antwortet oder du ihm mehrfach sagen musstest, dass er erst fragen soll, dann ist das genau das, was in deine CLAUDE.md gehört.
Mach dir eine kurze Liste
Schreib dir beim Lesen einfach alles raus, was sich wiederholt. Einzelne Ausrutscher lässt du weg, weil eine Regel nur dann was bringt, wenn das Problem auch wirklich öfter auftritt.
SCHRITT 3
Regeln ableiten
Aus deiner Liste werden kurze Anweisungen, die Claude bei jeder Sitzung liest
Eine Regel pro Problem
Jede Regel ist ein ganzer Satz, der sagt, was Claude tun soll. Also nicht nur „Sprache“, sondern „Antworte immer auf Deutsch“. Je konkreter, desto besser hält er sich dran.
Claude die Vorarbeit machen lassen
Du kannst den Bericht auch direkt von Claude auswerten lassen. Dann schlägt er dir die Regeln vor, und du entscheidest, welche wirklich reinkommen. Den Prompt dafür kannst du so kopieren:
Prompt zum Kopieren
Lies den Bericht unter ~/.claude/usage-data/report.html. Such dir alle Stellen raus, an denen ich dir dieselbe Anweisung mehrfach geben musste oder du mich falsch verstanden hast. Mach daraus kurze Regeln für meine CLAUDE.md, eine Zeile pro Regel. Zeig mir die Regeln erst, bevor du etwas in die Datei einträgst.Erst lesen, dann eintragen
Geh die Vorschläge kurz durch und streich alles, was nicht zu dir passt. Danach trägt Claude die übrigen Regeln in deine CLAUDE.md ein, oder du machst das einfach selbst.
MUSTER
Beispielregeln zum Abschauen
Das sind nur Beispiele, deine eigenen Regeln kommen aus deinem Bericht
Nur ein Beispiel. Die drei Regeln unten zeigen dir, wie eine gute Regel aussieht. Sie stammen nicht aus einem echten Bericht, also übernimm sie nicht einfach, sondern schreib deine eigenen nach dem gleichen Muster.
Beispiel für einen Abschnitt in der CLAUDE.md
## Regeln aus /insights
- Antworte immer auf Deutsch, Fachbegriffe dürfen Englisch bleiben.
- Bevor du Dateien löschst oder umbenennst, fragst du mich.
- Nach jeder Code-Änderung lässt du die Tests laufen und sagst mir das Ergebnis.Warum die funktionieren
Jede Regel sagt genau, was Claude machen soll, und passt in eine Zeile. Er muss nichts interpretieren, und du siehst sofort, ob er sich dran hält.
Lieber wenige Regeln
Nimm nur das rein, was im Bericht wirklich öfter aufgetaucht ist. Eine CLAUDE.md mit zehn klaren Regeln bringt dir mehr als eine mit fünfzig, die sich teilweise widersprechen.
DIE GRENZEN
Was der Bericht nicht sieht
Damit du weißt, worauf die Auswertung beruht
Was gilt
- Andere Geräte: Nicht drin. Er liest nur die Sitzungen auf dem Rechner, auf dem du /insights startest.
- claude.ai: Nicht drin. Chats im Browser oder in der App zählen nicht mit.
- Cloud-Sitzungen: Dort läuft der Befehl nicht.
- Sehr kurze Sitzungen: Werden übersprungen.
- Menge pro Lauf: Bis zu 200 neue Sitzungen.
- Aufbewahrung: Der Bericht wird nach 30 Tagen gelöscht.
Was ich im Video nicht gesagt habe. /insights läuft auf jedem Plan, und die Auswertung verbraucht natürlich Token. Die zählen ganz normal gegen dein Limit, beziehungsweise bei der API gegen dein Guthaben. Wenn du gerade knapp am Limit bist, startest du den Bericht also lieber später.
NÄCHSTER SCHRITT
Direkt umsetzen
Am besten machst du das einmal komplett durch, das dauert nicht lange
/insights starten
Tipp /insights in Claude Code ein und öffne danach den Bericht so, wie es auf Seite 2 steht.
Wiederholungen rausschreiben
Lies vor allem die Reibungspunkte und schreib dir alles raus, was mehr als einmal vorkommt.
Regeln in die CLAUDE.md
Mach aus jeder Wiederholung eine Regel in einer Zeile, selbst oder mit dem Prompt von Seite 4, und trag sie in deine CLAUDE.md ein. In ein paar Wochen startest du /insights einfach nochmal und schaust, ob die Probleme weniger geworden sind.
Quellen: Claude-Code-Doku, Seiten „Commands“ (code.claude.com/docs/en/commands) und „Costs“ (code.claude.com/docs/en/costs). Geprüft am 22.10.2026, Stand 09.11.2026.
Wir bauen dir das fertig.
Mit dem Guide kannst du es selbst einrichten. Oder wir machen das für dich, mit deinen Daten und Zugängen, und zwar so, dass es bei dir im Alltag läuft.
Bauen lassen