7 CLAUDE.md-Vorlagen für Claude Code, die du in echte Projekte kopieren kannst

Viele CLAUDE.md-Artikel enden bei “Beschreibe deinen Stack”. Das ist nicht falsch, reicht aber nicht aus, sobald Claude Code an echter Arbeit mitwirkt.

Die nützliche Frage ist nicht “Brauche ich eine CLAUDE.md?” Die nützliche Frage ist: Was muss darin stehen, damit Claude Code in diesem Repo nicht immer wieder dieselben Fehler macht?

Dieser Beitrag schließt die Lücke zwischen dem Einsteigerleitfaden und CLAUDE.md Best Practices mit sieben kopierbaren Vorlagen.

Kurzfassung:

1. Halte das kostenlose Claude Code Quick Reference Cheatsheet bereit.
2. Kopiere die Vorlage, die deinem Repo am nächsten kommt.
3. Ergänze zuerst drei Do Not-Regeln.
4. Wenn du mehr Template-, Hook- und Permissions-Beispiele willst, nutze The Complete Claude Code Setup & Configuration Guide.
5. Wenn du das für ein Team standardisieren willst, nutze die consultation page.

Was ein gutes CLAUDE.md wirklich leistet

Es sollte drei Probleme reduzieren:

• Claude Code bearbeitet die richtige Stelle, missachtet aber lokale Konventionen.
• Die Aufgabe wird gelöst, aber die entscheidende Verifikation fehlt.
• Das Repo wird zu breit erkundet, weil Grenzen unklar sind.

Darum gehören typischerweise hinein:

• Stack und Befehle
• Verzeichnisstruktur
• projektspezifische Regeln
• empfohlene Arbeitsreihenfolge
• Verbote

Vor allem die letzten beiden Punkte verändern das Verhalten deutlich.

Vorlage 1: Solo-Web-App

# Project Overview

Customer-facing Astro site with a small Node API.

## Tech Stack

- Frontend: Astro 5 + TypeScript
- Styling: Tailwind CSS
- Backend: Node.js 22
- Tests: Vitest

## Key Directories

- `site/src/pages/` route entrypoints
- `site/src/components/` reusable UI
- `site/src/content/` blog and docs content
- `scripts/` operational scripts

## Common Commands

- Build: `cd site && npm run build`
- Test: `npm run test`
- Search content: `rg "keyword" site/src/content`

## Working Rules

- Prefer minimal diffs over wide refactors
- Keep copy changes aligned with existing brand tone
- When editing UI, verify mobile width before calling the task done

## Do Not

- Do not rename routes unless required
- Do not delete analytics or SEO fields
- Do not claim deploy success without checking the public URL

Entscheidend ist hier nicht der Stack, sondern dass mobile Prüfung und öffentliche URL als Erfolgskriterium festgelegt werden.

Weitere sinnvolle Vorlagen

Nutze die gleiche Struktur auch für:

• eine Content-Site mit PDF-, Gumroad- und Beratungs-CTA
• ein Backend-API-Repo mit strenger Validierung
• ein Team-Repo mit review-freundlichen Patches
• ein Legacy-Repo, in dem Kompatibilität wichtiger als Eleganz ist
• ein Automatisierungs-Repo mit Seiteneffekten
• ein Monorepo mit klaren Paketgrenzen

Wichtige Regeln in fast allen Fällen:

• kleinste sichere Änderung bevorzugen
• Verifikation explizit anordnen
• gefährliche Aktionen verbieten
• Deploy, Secrets und externe Schreibvorgänge absichern

Fehler, die du vermeiden solltest

• CLAUDE.md wie ein Firmenwiki schreiben
• nur Befehle auflisten, aber keinen Ablauf definieren
• keine Verbotsregeln aufnehmen
• die Datei nie aktualisieren

Wenn Claude Code denselben Fehler mehrfach wiederholt, ist die Datei meist zu ungenau.

Welche Vorlage passt?

• Produkt- oder UI-Arbeit: Solo-App
• mehrsprachige Artikel, PDF und Gumroad: Content-Site
• Datenkorrektheit und Validierung: API
• Koordination und Grenzen: Team oder Monorepo
• hoher Fehlerschaden: Legacy oder Automatisierung

Du musst nicht alle sieben Vorlagen kombinieren. Starte mit einer und ergänze nur Regeln, die das Verhalten wirklich ändern.

Nächster Schritt

1. Kopiere eine Vorlage nach CLAUDE.md
2. Ergänze drei projektbezogene Do Not-Regeln
3. Schreibe die genaue Verifikation auf, die “fertig” bedeutet

Für eine schnelle tägliche Referenz nimm zuerst das Claude Code Quick Reference Cheatsheet. Für vollständigere CLAUDE.md-Beispiele, Setup-, Hook-, Permissions- und Workflow-Muster nutze The Complete Claude Code Setup & Configuration Guide. Wenn du daraus ein Team-Betriebsmodell machen willst, nutze die consultation page.