Home / Glossary / CLAUDE.md

Definition

CLAUDE.md

CLAUDE.md ist eine Markdown-Konfigurationsdatei, die im Stammverzeichnis Ihres Projekts platziert wird und Claude Code persistente, projektspezifische Anweisungen gibt. Sie informiert den Agenten ueber Ihre Coding-Konventionen, Architektur, gaengige Befehle und Regeln – als eine Form von Langzeitgedaechtnis, das fuer jede Sitzung in diesem Projekt gilt.

Wie CLAUDE.md funktioniert

Wenn Claude Code eine Sitzung startet, liest es automatisch die CLAUDE.md-Datei in Ihrem Projektstamm (sowie alle CLAUDE.md-Dateien in uebergeordneten oder Unterverzeichnissen). Der Inhalt wird Teil des System-Kontexts des Agenten, sodass er Ihren Anweisungen folgt, ohne in jeder Sitzung daran erinnert werden zu muessen. Das sorgt dafuer, dass sich der Agent konsistent mit den Konventionen Ihres Teams verhaelt.

Was in CLAUDE.md enthalten sein sollte

  • +Projektarchitektur-Uebersicht und wichtige Dateispeicherorte
  • +Coding-Konventionen (Benennung, Formatierung, zu verwendende oder zu vermeidende Muster)
  • +Gaengige Befehle fuer Tests, Builds und Deployments
  • +Regeln wie "Schreibe immer Tests fuer neue Funktionen" oder "Aendere nie direkt das Auth-Modul"
  • +Details zum Technologie-Stack, die der Agent kennen sollte
markdown
# CLAUDE.md

## Project
Next.js 14 app with App Router, TypeScript, Tailwind CSS.

## Commands
- `npm run dev` — start dev server
- `npm test` — run Jest tests
- `npm run lint` — ESLint check

## Conventions
- Use server components by default
- Client components go in `components/client/`
- All API routes must validate input with Zod
- Write tests for every new utility function

## Do NOT
- Modify files in `lib/core/` without explicit approval
- Use `any` type in TypeScript
- Add new dependencies without justification

Halten Sie CLAUDE.md praegnant. Der Agent liest es bei jeder Sitzung, also fuegen Sie nur Informationen ein, die ueber mehrere Aufgaben hinweg relevant sind. Aufgabenspezifische Details gehoeren in Ihre Prompts.

Wo sollte ich die CLAUDE.md-Datei platzieren?+
Platzieren Sie sie im Stammverzeichnis Ihres Projekts. Claude Code unterstuetzt auch CLAUDE.md-Dateien in Unterverzeichnissen fuer modulspezifische Anweisungen und in uebergeordneten Verzeichnissen fuer organisationsweite Regeln. Alle zutreffenden Dateien werden zusammengefuegt.
Funktioniert CLAUDE.md mit anderen KI-Tools?+
CLAUDE.md ist spezifisch fuer Claude Code. Einige andere Tools haben jedoch aehnliche Konzepte uebernommen. Cursor verwendet .cursorrules, und andere Agenten lesen moeglicherweise benutzerdefinierte Konfigurationsdateien. Das Konzept projektbezogener KI-Anweisungen wird zu einem gaengigen Muster.
Wie lang sollte CLAUDE.md sein?+
Halten Sie sie unter 500 Zeilen. Konzentrieren Sie sich auf die wichtigsten Konventionen und Regeln. Der Agent kann jederzeit einzelne Dateien fuer Details lesen – CLAUDE.md sollte den uebergeordneten Kontext liefern, der fuer alle Aufgaben gilt.

Related terms

Agentic CodingClaude CodePrompt Engineering fuer Code

Master Claude Code in days, not months

37 hands-on lessons from beginner to CI/CD automation. Module 1 is free.

START FREE →
← ALL TERMS