Verstehen der .claude/-Ordnerstruktur für die Claude Code-Konfiguration

Projekt- und globale Konfigurationsordner

Es gibt zwei .claude-Verzeichnisse: eines im Projektstammverzeichnis für Team-Konfiguration, das in Git eingecheckt wird, und ein weiteres im Home-Verzeichnis (~/.claude/) für persönliche Einstellungen und maschinenlokale Zustände wie Sitzungsverlauf.

CLAUDE.md: Das Handbuch

CLAUDE.md wird zu Beginn jeder Sitzung in Claudes Systemaufforderung geladen und während des gesamten Gesprächs befolgt. Sie können CLAUDE.md im Projektstammverzeichnis, in ~/.claude/ für globale Einstellungen oder in Unterverzeichnissen für ordnerspezifische Regeln haben.

Effektive CLAUDE.md-Inhalte umfassen:

• Build-, Test- und Lint-Befehle (npm run test, make build, etc.)
• Wichtige Architekturentscheidungen
• Nicht offensichtliche Fallstricke
• Import-Konventionen, Namensmuster, Fehlerbehandlungsstile
• Datei- und Ordnerstruktur für Hauptmodule

Halten Sie CLAUDE.md unter 200 Zeilen. Dateien, die länger sind, beginnen zu viel Kontext zu verbrauchen, und Claudes Befolgung der Anweisungen nimmt ab.

Beispielhafte CLAUDE.md-Struktur

# Projekt: Acme API

Befehle
npm run dev # Entwicklungs-Server starten
npm run test # Tests ausführen (Jest)
npm run lint # ESLint + Prettier prüfen
npm run build # Produktions-Build

Architektur

• Express REST API, Node 20
• PostgreSQL über Prisma ORM
• Alle Handler befinden sich in src/handlers/
• Gemeinsame Typen in src/types/

Konventionen

• Verwenden Sie zod für jede Anfragevalidierung in jedem Handler
• Rückgabeform ist immer { data, error }
• Niemals Stack-Traces an den Client weitergeben
• Verwenden Sie das Logger-Modul, nicht console.log

Achtung bei

• Tests verwenden eine echte lokale DB, keine Mocks. Führen Sie zuerst npm run db:test:reset aus
• Strenges TypeScript: keine ungenutzten Imports, niemals

  Persönliche Überschreibungen mit CLAUDE.local.md

  Erstellen Sie CLAUDE.local.md in Ihrem Projektstammverzeichnis für persönliche Einstellungen, die nicht für das gesamte Team gelten. Claude liest es zusammen mit der Haupt-CLAUDE.md, und es wird automatisch von Git ignoriert, sodass persönliche Anpassungen nie im Repository landen.

  Modulare Anweisungen mit dem rules/ Ordner

  Für größere Teams bietet der rules/ Ordner modulare Anweisungen, die besser skalieren als eine einzelne große CLAUDE.md-Datei.

  📖 Source: HN AI Agents