Projects vs. CLAUDE.md — Claude Academy

	Projects	CLAUDE.md
Plattform	Claude Chat & Desktop	Claude Code (Terminal)
Format	Web-UI mit Datei-Upload	Markdown-Datei im Repository
Versionierung	Keine (Cloud-basiert)	Git — versioniert, diffbar, reviewbar
Team-Sharing	Integriert (Team/Enterprise)	Über Git-Repository
Hierarchie	Flach (ein Project)	4 Ebenen (Global, Projekt, Verzeichnis, User)
Dokument-Upload	Bis zu 200K Tokens	Kein Upload — liest Dateisystem direkt
Ideal für	Teams ohne Code, Wissensbasen, Styleguides	Code-Projekte, Entwickler-Workflows

Fazit **Projects** sind ideal für Teams und Nicht-Entwickler — Dokumente hochladen, Instructions definieren, sofort loslegen. **CLAUDE.md** ist das Werkzeug für Entwickler: versioniert im Repo, hierarchisch aufgebaut, steuerbar per Git. Beide lösen das gleiche Problem für unterschiedliche Zielgruppen.

Kurzfazit

Projects und CLAUDE.md lösen das gleiche Problem: Claude soll dauerhaften Kontext haben, ohne dass du ihn jedes Mal neu erklären musst. Projects machen das über eine Cloud-UI — Dokumente hochladen, Instructions schreiben, fertig. CLAUDE.md macht das über eine Markdown-Datei im Repository — versioniert, hierarchisch, im gleichen Git-Workflow wie der Rest des Codes.

Entscheidungshilfe

Wenn du kein Entwickler bist oder keinen Code schreibst → Projects
Wenn du Dokumente als dauerhaften Kontext bereitstellen willst → Projects
Wenn du ein Code-Projekt mit Claude Code bearbeitest → CLAUDE.md
Wenn du möchtest, dass der Kontext versioniert und diffbar ist → CLAUDE.md
Wenn du verschiedene Regeln für verschiedene Verzeichnisse brauchst → CLAUDE.md (Hierarchie)
Wenn dein Team über die Web-UI zusammenarbeitet → Projects (Team/Enterprise)
Wenn dein Team über Git zusammenarbeitet → CLAUDE.md (im Repository)

Entscheide selbst

Dein Marketing-Team will Claude mit Brand Guidelines und Styleguide füttern — niemand im Team nutzt Git.

Du willst, dass Claude Code in deinem TypeScript-Projekt immer Vitest statt Jest nutzt und Fehler mit Custom Error Classes behandelt.

Eine Anwaltskanzlei will Gesetzestexte und interne Richtlinien als dauerhaften Kontext für Claude bereitstellen.

Typische Fehlentscheidung

Ein häufiger Fehler bei Entwicklern: Projects nutzen, obwohl sie mit Claude Code arbeiten. Projects-Kontext ist für Claude Code nicht sichtbar — er lebt in der Cloud, nicht im Repository. Umgekehrt: Nicht-Entwickler versuchen, eine CLAUDE.md zu erstellen, obwohl sie gar kein Git nutzen. Das richtige Tool hängt von der Plattform ab, nicht von der Präferenz.

Empfehlung je Use Case

Marketing-Team teilt Brand Guidelines mit Claude: Projects — Styleguide hochladen, Instructions definieren, jedes Teammitglied hat den gleichen Kontext.
Entwickler will, dass Claude Code die Architektur des Projekts kennt: CLAUDE.md — im Root des Repos, wird automatisch gelesen, lebt mit dem Code.
Jurist stellt Gesetzestexte als Referenz bereit: Projects — Dokumente hochladen, Claude hat dauerhaften Zugriff.
Monorepo mit unterschiedlichen Regeln pro Paket: CLAUDE.md — eine Datei pro Verzeichnis, hierarchisch aufgebaut, jedes Paket hat eigene Regeln.

Nächster Schritt

Du weißt jetzt, wann Projects und wann CLAUDE.md das richtige Werkzeug ist. Als Nächstes: Lerne, wie du eine effektive CLAUDE.md schreibst — im Guide CLAUDE.md schreiben.

Projectsvs. CLAUDE.md

Kurzfazit

Entscheidungshilfe

Entscheide selbst

Typische Fehlentscheidung

Empfehlung je Use Case

Nächster Schritt

Verstanden?Dann trainieren.

Projects
vs. CLAUDE.md

Verstanden?
Dann trainieren.