29. März 2026

Anatomie des .claude/ Ordners: Claude Code richtig konfigurieren

Ein Blogartikel ueber die interne Struktur des .claude/ Verzeichnisses hat auf Hacker News 552 Punkte und 238 Kommentare gesammelt. Das ist ein klares Signal: Viele Entwickler nutzen Claude Code, aber die Konfigurationsmoeglichkeiten sind wenig bekannt.

Warum das relevant ist

Die meisten Nutzer interagieren mit Claude Code ueber Prompts und optimieren dort. Die eigentliche Hebelwirkung liegt aber eine Ebene tiefer: im .claude/ Verzeichnis, das Claude Code in jedem Projekt (und im Home-Verzeichnis als globale Konfiguration) anlegt. Wer dieses Verzeichnis ignoriert, verschenkt Potenzial.

Die Struktur im Ueberblick

.claude/
  CLAUDE.md          # Projektinstruktionen fuer Claude
  settings.json      # Berechtigungen, Bash-Commands, MCP-Server
  commands/          # Wiederverwendbare Slash-Commands
  memory/            # Persistente Erinnerungen ueber Sessions hinweg

CLAUDE.md -- das zentrale Steuerungselement

CLAUDE.md ist die wichtigste Datei. Hier definiert man Projektkonventionen, Regeln und Workflows, die Claude Code bei jeder Session automatisch einliest. Praktische Einsatzfelder:

Coding-Konventionen des Projekts (Namensgebung, Formatierung, verbotene Patterns)
Architektur-Entscheidungen, die Claude kennen soll
Projektspezifische Abkuerzungen oder Domain-Begriffe
Regeln fuer Commits, Tests, Deployments

Die Datei wird bei jedem Start automatisch in den Kontext geladen -- ohne dass man es erneut erklaeren muss.

settings.json -- Berechtigungen und Integrationen

In settings.json steuert man, welche Operationen Claude Code ausfuehren darf:

Erlaubte und verbotene Bash-Commands (allow/deny-Listen)
MCP-Server-Konfiguration fuer externe Tools und APIs
Sicherheitseinstellungen fuer automatisierte Workflows

commands/ -- Slash-Commands als Markdown

Das commands/ Verzeichnis nimmt Markdown-Dateien auf, die als wiederverwendbare Slash-Commands verfuegbar werden. Statt wiederholt denselben langen Prompt einzutippen, definiert man ihn einmalig als Command. Beispiel: /commit, /deploy, /review als projektspezifische Shortcuts.

memory/ -- Persistenz ueber Sessions

Claude Code kann Informationen in memory/ ablegen, die ueber einzelne Sessions hinaus erhalten bleiben. Nuetzlich fuer wiederkehrende Entscheidungen, die man nicht jedes Mal neu treffen will.

Praxis-Tipp

Wer Claude Code ernsthaft produktiv nutzen will, sollte Zeit in die .claude/ Konfiguration investieren -- nicht nur in bessere Prompts. Eine gut gepflegte CLAUDE.md ersetzt hunderte erklaerende Saetze, die man sonst bei jeder Session wiederholen muesste.

Einstiegspunkt: Bestehende Projekte durchsehen, was Claude immer wieder neu erklaert bekommt. Genau das gehoert in CLAUDE.md.

Quellen

Blogartikel: Anatomy of the .claude/ folder
Hacker News Diskussion: https://news.ycombinator.com/item?id=47543139 (552 Punkte, 238 Kommentare)
Offizielle Doku: docs.anthropic.com/en/docs/claude-code

Nach oben