Was sich an den Claude Code Best Practices geändert hat
Wer Claude Code seit dem Frühjahr 2025 nutzt, hat viele Gewohnheiten aus Anthropics erstem Leitfaden übernommen. Genau diese Claude Code Best Practices hat Anthropic jetzt umgebaut. Der alte Blogbeitrag vom 18. April 2025 trägt inzwischen den Hinweis, dass er nicht mehr gepflegt wird. Maßgeblich ist stattdessen die neue Empfehlungsseite in Anthropics Doku.
Ein festes Datum der Überarbeitung nennt Anthropic nicht. Die Seite erwähnt allerdings schon Claude Fable 5.2, das laut Changelog am 9. November 2026 in Claude Code kam. Ihr Grundton ist dabei neu: Die Standards erledigen fast alles. Neue Sitzungen im Terminal und in VS Code starten im Auto-Modus, Claude verteilt Teilaufgaben selbst an Subagenten und fasst lange Sitzungen automatisch zusammen.
Einrichten lohnt sich deshalb nur noch für das, was Claude nicht aus deinem Projekt lesen kann. Laut Anthropic liegt eine schiefe Sitzung fast immer an einem von vier Punkten: Claude fehlt Wissen, es kann seine Arbeit nicht prüfen, eine harte Regel wurde nicht erzwungen, oder die Aufgabe kostete mehr Zeit und Token als nötig. Besonders deutlich wird der Wandel in einer neuen Tabelle, die alte Ratschläge ausdrücklich streicht:
Alter Ratschlag
Warum er hinfällig ist
Was stattdessen hilft
Kontextfenster streng verwalten
die meisten aktuellen Modelle haben 1M Token, Zusammenfassen läuft automatisch
/clear zwischen Aufgaben, weil das bessere Antworten bringt und weniger kostet
IMPORTANT oder GROSSBUCHSTABEN
aktuelle Modelle folgen schlichten Zeilen, Nachdruck führt zum Übertreiben
Hook oder Sperrregel, sonst die Datei kürzen
„think hard“ im Prompt
die Wörter erhöhen nichts, das steuert der Effort-Wert
/effort einstellen, ultrathink für einen einzelnen Schritt
Subagenten zum Schutz des Kontexts
der Kontext geht kaum noch aus, jeder Subagent kostet Token
Subagenten für parallele Arbeit und unabhängige Reviews
„Mach weiter, sei nicht faul“
aktuelle Modelle bringen Aufgaben in der Regel selbst zu Ende
eine Prüfung, die bestanden werden muss
Regeln für Claude Code: Prompt oder Hook?
Die wichtigste neue Unterscheidung ist eher technisch, aber sie lohnt sich auch für Nicht-Entwickler. Anthropic teilt jede Anweisung in zwei Arten. Was du in einen Prompt, in die CLAUDE.md oder in einen Skill schreibst, liest das Modell und entscheidet dann selbst. Es folgt dir meistens, garantiert ist das aber nicht.
Kurz erklärt
Nicht deterministisch: Claude liest die Anweisung und entscheidet, etwa bei Prompt, CLAUDE.md oder Skill. Deterministisch: Claude Code führt die Regel jedes Mal aus, egal was das Modell will, etwa bei einem Hook, einer Sperrregel in den Einstellungen oder der Sandbox. Hook: ein Befehl, den Claude Code an einer festen Stelle startet, zum Beispiel bevor Claude eine Aufgabe als fertig meldet.
Darf etwas wirklich nie passieren, gehört es deshalb nicht in einen Prompt. Ein Beispiel aus der Doku: Eine Sperrregel für die Datei .env greift in jedem Modus, auch im Auto-Modus. Eine Zeile „Lies nie die .env“ in der CLAUDE.md wirkt dagegen nur meistens. Zugleich warnt Anthropic vor dem Gegenteil: Wer bei vierzig Hooks und Regeln landet, hat vor allem Vorlieben festgeschrieben.
Ein Hook wirkt wie eine gestellte Weiche: Er gilt jedes Mal, unabhängig davon, was das Modell gerade vorhat.
Voraussetzungen: Was du vor der ersten Sitzung klärst
Bevor du die neuen Claude Code Best Practices umsetzt, prüf kurz drei Dinge. Dabei hilft es, ehrlich zu sein: Die Doku schreibt durchgehend für Entwickler. Die Prinzipien gelten aber genauso für Texte, Recherche und Automatisierung, das ist meine Ableitung aus der täglichen Arbeit.
- Tarif: Claude Code steckt laut Anthropics Preisseite in allen bezahlten Tarifen ab Pro, im kostenlosen Tarif dagegen nicht.
- Oberfläche: Es läuft im Terminal, in VS Code, JetBrains, in der Desktop-App und im Web unter claude.ai/code. Ohne Kommandozeile startest du also einfach in der Desktop-App.
- Projektordner: Claude Code arbeitet in einem Ordner. Für Marketing reicht ein Ordner mit Texten, Vorlagen und Notizen, ein Code-Projekt ist nicht nötig.
- Ziel: Leg fest, woran du ein fertiges Ergebnis erkennst, zum Beispiel ein Prüfskript, eine Checkliste oder eine Wortzahl.
Claude Code richtig nutzen: Schritt für Schritt
Die folgenden sechs Schritte setzen die Claude Code Best Practices in der Reihenfolge der neuen Doku um. Fang dabei mit dem Standard an und ergänze nur, wo es wirklich hakt.
Mit den Standards starten
Öffne eine neue Sitzung und gib deine Aufgabe einfach ein. Auto-Modus, Subagenten und automatisches Zusammenfassen sind bereits aktiv. Der Standard ist laut Doku Opus 5.5 mit dem Effort-Wert medium. Ändere erst etwas, wenn eine Aufgabe zu lange dauert, zu viel kostet oder zu oft nachfragt.
CLAUDE.md kürzen statt füllen
Erzeuge mit /init eine erste Fassung und streiche dann Zeilen. Hinein gehört nur, was Claude nicht aus dem Projekt lesen kann: Prüfbefehle, irreführende Stellen, Entscheidungen außerhalb des Ordners und alles, was du schon zweimal korrigieren musstest. Anthropics Memory-Doku empfiehlt unter 200 Zeilen je Datei. Mit /context all siehst du, ob die Datei geladen ist.
- Install: pnpm install
- Run one test file: pnpm vitest run path/to/file.test.ts
- Typecheck: pnpm tsc --noEmit
# Conventions
- Use the error helpers in src/lib/errors.ts, never throw raw strings
- src/legacy/ is still live but don't copy its patterns into new code
# Gotchas
- Integration tests need DATABASE_URL set, see .env.example
Konkret prompten und Lücken füllen
Nenne die Datei, beschreib das Symptom und sag, was „fertig“ heißt. Dateien hängst du mit @ an, Screenshots fügst du direkt ein. Ist noch unklar, was überhaupt entstehen soll, lass dich zuerst von Claude interviewen und die Antworten in eine Datei schreiben. Danach startest du dann eine neue Sitzung.
Wiederkehrende Abläufe als Skill ablegen
Was du immer wieder erklärst, legst du als Skill unter .claude/skills/<name>/SKILL.md ab. Hat der Ablauf Nebenwirkungen, zum Beispiel weil er etwas veröffentlicht, sorgt disable-model-invocation dafür, dass nur du ihn startest. Alte Befehle unter .claude/commands/ funktionieren weiter, Anthropic hat sie mit den Skills zusammengelegt.
name: release
description: Cut a new release. Bumps the version, writes the changelog entry, tags it and pushes the tag so CI can publish.
disable-model-invocation: true
---
Claude eine Prüfung geben
Ohne Prüfung bist du selbst der Test. Gib Claude deshalb etwas, das bestanden oder durchgefallen meldet: einen Test, ein Prüfskript, einen Screenshot. Verlange außerdem Belege, also den Befehl samt Ausgabe. Soll die Prüfung zwingend laufen, bevor Claude fertig meldet, ist das eine Aufgabe für einen Stop-Hook.
Harte Regeln erzwingen und die Sitzung steuern
Sperren gehören in die Datei .claude/settings.json, nicht in die CLAUDE.md. Beobachte zudem die erste Minute und drück Esc, sobald Claude abschweift. Nach zwei gescheiterten Korrekturen hilft laut Doku keine dritte, sondern /clear und ein besserer Prompt. Mit /rewind spulst du die Sitzung zurück.
Claude Code Tipps aus meinem Marketing-Alltag
Ich arbeite jeden Tag mit Claude Code, allerdings kaum an klassischem Code. Auch dieser Beitrag ist so entstanden: Eine Blog-Routine startet morgens um 06:30, ich wähle die Themen, und bis zu fünf Sitzungen schreiben parallel je einen Entwurf. Die Regeln dafür stehen in Skills, nicht in langen Prompts.
Die neue Unterscheidung kannte ich deshalb schon aus der Praxis, nur ohne den Namen. In meiner CLAUDE.md steht seit einigen Wochen die Regel „Cleanup-Pattern statt Klausel-Hoffen“. Was ein Modell nicht tun soll, fängt also ein Prüfskript ab. Zum Beispiel blockiert ein Test jeden Entwurf, in dem eine Zahl ohne Quelle oder ein zu langer Alt-Text steht. Die Zeile im Prompt ist nur noch ein Hinweis.
Bei der Länge war ich dagegen kein Musterschüler. Am 7. November habe ich meine CLAUDE.md von 283 auf 214 Zeilen gekürzt und Projektwissen in eigene Doku je Bereich verschoben. Das liegt immer noch über Anthropics Empfehlung, aber Claude findet seitdem schneller das Richtige. Veröffentlicht wird übrigens erst nach einer festen Prüfung, wie ich es bei den Freigaben für KI-Agenten im Marketing beschrieben habe.
Meine Einschätzung
Der größte Hebel für Marketing-Teams ist nicht der perfekte Prompt, sondern die Prüfung. Formuliere für jede wiederkehrende Aufgabe eine Checkliste, die Claude selbst abhaken muss, und lass harte Grenzen wie „nie veröffentlichen“ technisch sperren.
Wenn es hakt: Best Practices für Claude Code bei Fehlern
Die neuen Claude Code Best Practices haben zwar keinen eigenen Fehlerabschnitt mehr, die typischen Stolperstellen stehen aber verteilt in den Hinweisen. Die häufigsten im Überblick:
Symptom
Ursache
Abhilfe
Claude übersieht eine Regel immer wieder
CLAUDE.md zu lang oder die Regel ist eigentlich hart
Datei kürzen oder Hook beziehungsweise Sperrregel
„Fertig“, aber es stimmt nicht
keine Möglichkeit, die Arbeit zu prüfen
Test oder Prüfskript plus Belege verlangen
Antworten werden träge und teuer
mehrere fremde Aufgaben in einer Sitzung
/clear zwischen Aufgaben, /compact mit Fokus
Korrektur um Korrektur ohne Fortschritt
der Ausgangsprompt war unklar
nach zwei Versuchen /clear und neu formulieren
Auto-Modus fragt plötzlich wieder nach
drei Blockaden in Folge oder 20 insgesamt
unter /permissions die zuletzt blockierten Aufrufe prüfen
Ein Fallstrick betrifft außerdem das Zurückspulen: Dateien, die nur ein Shell-Befehl geändert hat, erfasst /rewind nicht. Arbeitest du mit Skripten, sichere den Ordner deshalb zusätzlich mit Git oder einer Kopie.
Fazit: Claude Code Best Practices sind jetzt kürzer
Die neuen Claude Code Best Practices räumen auf. Zauberwörter, GROSSBUCHSTABEN und ständige Kontextpflege fallen weg, dafür zählen Wissen, Prüfungen und harte Regeln. Wie du die Prompts selbst schlank hältst, steht im Beitrag zum Claude Prompting mit Fable 5.2. Dein nächster Schritt: Öffne deine CLAUDE.md und streiche jede Zeile, die Claude auch selbst im Projekt finden würde.
Häufige Fragen
Wie lang darf die CLAUDE.md sein?
Anthropics Memory-Doku empfiehlt unter 200 Zeilen je Datei. Der Grund: Claude Code lädt die Datei in jede Sitzung, jede Zeile kostet also bei jeder Aufgabe etwas Aufmerksamkeit. Rein gehören deshalb nur Dinge, die Claude nicht selbst im Projekt findet. Mit /doctor prompt-audit lässt du dir zudem veraltete oder widersprüchliche Zeilen anzeigen.
Muss ich noch „think hard“ in den Prompt schreiben?
Nein. Laut der aktuellen Doku sind solche Formulierungen normaler Prompt-Text und erhöhen nichts. Wie gründlich Claude nachdenkt, steuerst du stattdessen über den Effort-Wert mit /effort. Nur das Wort ultrathink wirkt weiterhin und fordert für einen einzelnen Schritt tieferes Nachdenken an, ohne die Einstellung zu ändern.
Wie komme ich in den Plan-Modus von Claude Code?
Mit Shift+Tab wechselst du zwischen den Berechtigungsmodi, einer davon ist der Plan-Modus. Alternativ stellst du /plan vor deinen Prompt oder startest mit claude --permission-mode plan. Im Plan-Modus erkundet Claude erst und schlägt einen Plan vor, bevor es Dateien ändert.
Kann ich Claude Code ohne Programmierkenntnisse nutzen?
Ja. Die Desktop-App und claude.ai/code kommen ohne Kommandozeile aus, nötig ist ein bezahlter Tarif ab Pro. Für Marketing-Aufgaben arbeitest du dann in einem Ordner mit Texten und Vorlagen. Die Claude Code Tipps aus der Doku gelten dabei genauso: Wissen mitgeben, eine Prüfung festlegen, harte Grenzen sperren.
Wann sollte ich /clear nutzen?
Zwischen Aufgaben, die nichts miteinander zu tun haben, und nach zwei gescheiterten Korrekturen. Jede Anfrage schickt nämlich die ganze bisherige Unterhaltung mit. Eine Sitzung mit drei alten Aufgaben liest diese bei jeder neuen Antwort erneut, das kostet Token und verwässert das Ergebnis. /clear selbst kostet laut Doku nichts.
Du willst das nicht allein umsetzen?
Ich helfe dir bei Auswahl, Einrichtung und den ersten Schritten – ohne Agentur-Overhead.
Quellen
Stand vom 21. November 2026 · Zahlen und Pläne können sich ändern – wir halten den Beitrag aktuell.