Karpathy-Leitfaden: Mit einer CLAUDE.md Claude Code erst vorsichtig machen, bevor es Code ändert

Für wen

Wenn du vor allem in Claude Code Repositories änderst und weniger typische LLM-Coding-Fallen willst, passt dieses Material besser. Es ist eine CLAUDE.md, die das Verhalten von Claude Code verbessern soll, basierend auf Andrej Karpathys Beobachtungen zu LLM-Coding-Fallen:

https://x.com/karpathy/status/2015883857489522876

Die Seite schreibt: Die vier Prinzipien stehen in derselben Datei und bilden diese Probleme direkt ab. Der verfügbare Seitentext nennt weder die Namen noch den Wortlaut dieser vier Prinzipien. Erfinde deshalb keine Namen und keine Slogan-Sammlung. Du brauchst Leute, die Claude Code schon nutzen und die Installation eines Plugins akzeptieren. Wer nur den Beitrag lesen und die lokale Claude-Code-Konfiguration nicht ändern will, braucht nur den Link oben.

Erster Versuch in 3 Minuten

Die offiziell empfohlene Installation sind zwei Schritte hintereinander; fehlt einer, ist sie nicht fertig. Führe zuerst in Claude Code aus:

/plugin marketplace add forrestchang/andrej-karpathy-skills

Installiere das Plugin danach sofort:

/plugin install andrej-karpathy-skills@karpathy-skills

Das ändert die Plugin-Konfiguration von Claude Code; es ist kein reiner Lesezugriff. Bestätige vorher, dass du genau in der Claude-Code-Umgebung bist, in die du schreiben willst, und dass beide Schritte fertig werden. Füge nicht nur den Marketplace hinzu und überspringe install.

Nach der Installation zuerst gegenprüfen, nicht sofort das Repository groß umbauen. Wähle eine nicht triviale Änderungsabsicht, lass Claude Code zuerst erklären, wie es ändern und welche Dateien es anfassen will, und erlaube das Schreiben von Code erst nach deinem OK. Das Erfolgssignal: Es zeigt „Vorsicht vor Tempo“, erklärt zuerst und handelt dann, statt sofort einen großen Patch auszubreiten. Wenn es unbeteiligte Module refactort, halte zuerst an.

Anwendungsfälle

Fall 1: Eine nicht triviale Coding-Aufgabe. Der Leitfaden existiert, um das Verhalten von Claude Code bei LLM-Coding-Fallen zu verbessern. Begrenze die Aufgabe auf „zuerst CLAUDE.md gegenlesen, dann ändern“. Der verfügbare Seitentext gibt keine Titel für diese vier Prinzipien; du kannst es also nicht nach einem selbst erfundenen Prinzipnamen arbeiten lassen. Du kannst verlangen: diese eine Datei lesen, dann den Änderungsrahmen nennen. Abnahme in zwei Punkten: Es hat diesen Leitfaden gelesen, und es hat den Rahmen genannt, bevor es Dateien geändert hat.

Fall 2: Entscheiden, ob der volle strenge Ablauf nötig ist. Die Seite sagt klar, dass diese Leitlinien Vorsicht statt Tempo bevorzugen. Bei trivialen Aufgaben (einfacher Tippfehler, offensichtliche Einzeiler) entscheidest du selbst; nicht jedes Mal den vollen Satz fahren. Wenn du nur einen offensichtlichen Tippfehler korrigierst, sag klar: „Das ist eine triviale Änderung, breite den Ablauf nicht aus.“ Es definiert keine automatische Regel für „offensichtlich“ und nennt keine Dateitypen als Ausnahme. Die Grenze bestimmst du vor Ort; macht der Agent aus der Tippfehlerkorrektur ein Refactoring, hat er diesen Fall verlassen.

Grenzen

Das ist eine CLAUDE.md für Claude Code, kein allgemeines Regelpaket für Editoren. Die Seite beschreibt keine Schritte, um sie für andere Produkte umzubenennen. Die vier Prinzipien stehen in derselben Datei, aber der verfügbare Seitentext bleibt bei „es gibt vier, und sie bilden diese Probleme ab“; eine Prinzipienliste fehlt. Ergänze keine Namen und tue nicht so, als hättest du Originalsätze aus der Datei zitiert.

Die empfohlene Installation ist das marketplace add oben, danach plugin install. Beide Schritte sind nötig. Stelle keinen zweiten Installer daneben. Die Beobachtungen stehen in Karpathys Beitrag; der Leitfaden selbst ist eine abgeleitete Nutzung und ersetzt den Kontext jenes Beitrags nicht.

Der erste Halt ist „zuerst erklären, dann ändern“. Jedes Refactoring über die aktuelle Aufgabe hinaus, jedes Massen-Umsortieren oder jede neue Abstraktion muss zuerst die zu ändernden Dateien und Gründe nennen; du bestätigst, dann geht es weiter. Bei trivialen Änderungen stufe den Ablauf selbst herunter, damit ein Tippfehler nicht den vollen Satz durchläuft.