CLAUDE.md — das Gehirn deines Projekts

Eine einzelne Markdown-Datei, die Claude dauerhaften Kontext gibt

⏱ ca. ~4 Min

01 · Lesen

Jedes Mal, wenn du eine neue Claude-Code-Session startest, fängt Claude bei null an. Es erinnert sich nicht an dein letztes Gespräch, deinen Code-Stil, eure Projektkonventionen oder welches Framework du benutzt. Du musst jedes Mal alles neu erklären.

CLAUDE.md löst genau das. Es ist eine Markdown-Datei, die Claude zu Beginn jeder Session liest — das dauerhafte Anweisungshandbuch deines Projekts.

💡 Stell dir das so vorStell dir CLAUDE.md als Onboarding-Dokument für neue Teammitglieder vor. Statt jeden Morgen die Teamkonventionen zu erklären, schreibst du sie einmal auf. CLAUDE.md ist genau dieses Dokument — Claude liest es jedes Mal, wenn es zu arbeiten anfängt.

Kernpunkte

Jede Claude-Code-Session startet bei null — keine Erinnerung an frühere Gespräche
CLAUDE.md wird zu Beginn jeder Session automatisch geladen
Es teilt Claude eure Projektregeln, Konventionen und wichtigen Kontext mit
Es ist einfach eine Markdown-Datei — du bearbeitest sie wie jede andere Datei

02 · Lesen

CLAUDE.md kann an drei Orten leben, jeder mit anderem Scope.

Projekt-Ebene — Lege CLAUDE.md in den Repo-Root (oder nach .claude/CLAUDE.md). Über git mit dem Team geteilt. Nutze sie für Projektkonventionen, Build-Befehle und Architekturmuster.

User-Ebene — Lege sie unter ~/.claude/CLAUDE.md ab. Persönlich, gilt für alle deine Projekte. Nutze sie für deine eigenen Vorlieben.

Unterverzeichnisse — CLAUDE.md-Dateien in Unterverzeichnissen werden bei Bedarf geladen, wenn Claude Dateien in diesem Verzeichnis liest. Gut für modulspezifische Anweisungen.

Kernpunkte

Projekt-Ebene (./CLAUDE.md): mit dem Team geteilt, in git committed
User-Ebene (~/.claude/CLAUDE.md): persönlich, gilt für alle deine Projekte
CLAUDE.md im Unterverzeichnis: wird modulspezifisch bei Bedarf geladen
Bei Konflikten überschreiben Projektregeln die User-Regeln

03 · Code-Beispiel

Eine gute CLAUDE.md enthält Build-Befehle, Code-Stil, Architektur und projektspezifische Konventionen. Unten ein echtes Beispiel.

Beispiel-CLAUDE.md

# Build & Test
- `npm run dev` — start frontend dev server
- `npm run build` — TypeScript check + production build
- `npm test` — run tests (Vitest)

# Code Style
- TypeScript strict mode, ES modules (import/export)
- 2-space indentation, single quotes
- Functional React components, no class components

# Architecture
- API routes in `server/src/routes/`
- Database schema in `server/src/db/schema.ts`
- Frontend components in `src/components/`

# Important
- The `--color-purple` CSS variable is actually orange (#FF6B35)
- Auth cookies use sameSite: 'none' for cross-origin

Achte darauf, was enthalten ist: Dinge, die Claude beim reinen Lesen des Codes nicht entdecken würde. Build-Befehle, ungewöhnliche Namenskonventionen, Eigenheiten zwischen Quellen. Was Claude beim Erkunden selbst herausfindet, gehört nicht hinein — konzentriere dich auf das nicht Offensichtliche.

04 · Code-Beispiel

Wenn deine CLAUDE.md größer wird, kannst du sie mit Imports und einem Rules-Verzeichnis in fokussierte Dateien aufteilen.

CLAUDE.md mit @import

# Project Overview
See @README.md for project description
See @specs/ARCHITECTURE.md for system design

# Code Style
@docs/code-style.md

Struktur des Rules-Verzeichnisses

.claude/
├── CLAUDE.md          (main instructions)
└── rules/
    ├── api-design.md  (API conventions)
    ├── testing.md     (test patterns)
    └── security.md    (security rules)

Das Präfix @ importiert den Inhalt einer anderen Datei in die CLAUDE.md. Das Verzeichnis .claude/rules/ enthält themenspezifische Regeln, die Claude automatisch lädt. So bleibt die Haupt-CLAUDE.md schlank und Claude hat trotzdem Zugriff auf detailliertes Domänenwissen.

05 · Quiz

Du hast Projektkonventionen, die jeder Entwickler im Team befolgen soll. Wohin gehört deine CLAUDE.md, damit sie mit dem Team geteilt wird?

Dein Home-Verzeichnis (~/.claude/CLAUDE.md)
Repo-Root (./CLAUDE.md), in git committed
Ein Google Doc, das im README verlinkt ist
Eine angepinnte Nachricht in einem Slack-Channel

06 · Ausfüllen

Um eine andere Datei in deine CLAUDE.md zu importieren, stellst du dem Pfad _____ voran.

Andere Lektionen aus diesem Kapitel

⚠ Das volle interaktive Erlebnis braucht JavaScript. Bitte aktiviere es und lade die Seite neu.

※ Diese Seite ist ein unabhängiges Bildungsprojekt — kein offizielles Anthropic-Produkt. Claude™ ist eine eingetragene Marke von Anthropic, PBC.