CLAUDE.md erstellen: Vorlage für klare Projektanweisungen

Das Problem

Claude Code arbeitet in Ihrem Projektordner und weiss zunächst nichts über Ihre Besonderheiten: Welche Programmiersprache und welche Werkzeuge werden verwendet? Wie startet man die Tests? Welche Ordner sind tabu? Welcher Stil gilt, und welche Sprache sprechen die Texte auf der Oberfläche? Ohne diese Angaben rät das Werkzeug, und oft rät es falsch.

Wer die Regeln bei jedem Auftrag wiederholt, verliert Zeit und vergisst manchmal einen wichtigen Punkt. Das Ergebnis sind Änderungen, die nicht zum Projekt passen: falscher Stil, falsche Ordner, unerwünschte Pakete, unnötig grosse Umbauten.

Für diesen Zweck gibt es die Datei CLAUDE.md. Sie liegt im Hauptordner des Projekts und wird von Claude Code zu Beginn jeder Sitzung gelesen. Sie ist so etwas wie eine Einarbeitungsmappe für eine neue Mitarbeiterin, die man nicht jeden Morgen neu erklären will. Wie genau die Datei geladen wird und welche weiteren Ebenen es gibt, kann sich ändern; prüfen Sie die aktuelle Dokumentation.

So lösen Sie es mit KI – Schritt für Schritt

1. Projekt kurz beschreiben. Zwei bis drei Sätze: Was ist das Projekt, für wen, mit welcher Technik? So versteht Claude Code den Rahmen.
2. Aufbau erklären. Nennen Sie die wichtigsten Ordner und Dateien und wofür sie da sind. Markieren Sie Bereiche, die nicht verändert werden sollen.
3. Befehle festhalten. Wie startet man das Projekt, wie führt man Tests und Stilprüfungen aus? Schreiben Sie die genauen Befehle hin. Claude Code kann sie dann selbst nutzen und prüfen.
4. Stil und Sprache festlegen. Namensregeln, Kommentare, Sprache der Oberfläche. Beispiel: Texte auf Deutsch (Schweiz) mit «ss».
5. Regeln für Sicherheit und Vorsicht. Keine Zugangsdaten lesen oder ausgeben, keine Dateien löschen ohne Rückfrage, keine neuen Pakete ohne Absprache, keine Änderungen an Datenbank und Konfiguration ohne Freigabe.
6. Arbeitsweise definieren. Erst planen, dann ändern, kleine Schritte, Tests laufen lassen, am Ende Zusammenfassung. Siehe Claude Code erst planen lassen.
7. Erzeugen lassen und überarbeiten. Claude Code kann einen ersten Entwurf der Datei erstellen, den Sie prüfen, kürzen und korrigieren. Das Werkzeug bietet dafür je nach Version einen Befehl an.
8. Testen. Geben Sie einen kleinen Auftrag und prüfen Sie, ob die Regeln eingehalten werden. Passen Sie unklare Stellen an.
9. Pflegen. Aktualisieren Sie die Datei, wenn sich Befehle oder Regeln ändern, und legen Sie fest, wer sie verantwortet. Versionieren Sie sie wie Code.

Vorlage zum Kopieren

Diese Vorlage können Sie als CLAUDE.md speichern und anpassen:

# CLAUDE.md

## Projekt
[Name]: [Zweck in 1–2 Sätzen]. Technik: [Sprache, Framework, Datenbank]. Zielgruppe: [intern/Kundschaft].

## Aufbau
- src/ – Quellcode
- tests/ – Tests
- docs/ – Dokumentation
- NICHT ÄNDERN: [z. B. generierte Dateien, vendor/, Konfiguration mit Zugangsdaten]

## Befehle
- Starten: [Befehl]
- Tests: [Befehl]
- Stilprüfung: [Befehl]

## Stil
- Namen und Kommentare: [Regeln]
- Texte für Menschen: Deutsch (Schweiz), «ss» statt «ß», Anrede «Sie».

## Sicherheit und Vorsicht
- Keine Zugangsdaten, Schlüssel oder Kundendaten lesen, schreiben oder ausgeben.
- Keine Dateien löschen und keine Pakete installieren ohne Rückfrage.
- Keine Änderungen an Datenbank, Server- oder Systemeinstellungen ohne ausdrückliche Freigabe.

## Arbeitsweise
- Bei grösseren Aufgaben zuerst einen Plan vorlegen und auf Freigabe warten.
- Kleine Schritte, danach Tests ausführen.
- Bei Unklarheit nachfragen, nicht raten.
- Am Ende: Liste der geänderten Dateien, Begründung, Testergebnis, offene Punkte.

Ersetzen Sie die Platzhalter und streichen Sie, was nicht zutrifft. Fügen Sie keine Geheimnisse in die Datei ein.

Was gehört hinein, was nicht

Worauf Sie achten müssen

• Keine Garantie. Claude Code hält sich meist an die Datei, aber nicht immer. Prüfen Sie Ergebnisse. Siehe Claude Code als zweite Prüfung.
• Kurz halten. Lange Dateien belegen Platz im Arbeitsgedächtnis des Werkzeugs und wirken weniger. Beginnen Sie mit dem Wesentlichen.
• Geheimnisse draussen. Die Datei liegt im Projekt und häufig in der Versionsverwaltung. Siehe Passwörter und Kundendaten schützen.
• Aktuell bleiben. Falsche Befehle in der Datei führen zu Fehlern oder falschen Annahmen.
• Rechte bleiben eine eigene Frage. Die Datei ersetzt keine Berechtigungseinstellungen. Siehe Claude Code fragt nach Erlaubnis.
• Andere Werkzeuge. Codex nutzt AGENTS.md, Cursor eigene Regeln. Siehe AGENTS.md für Codex.

Ein Beispiel aus der Praxis

Ein Beispiel: Ein Immobilienverwalter in Baden pflegt ein internes Programm zur Nebenkostenabrechnung. Die Entwicklerin Frau Hug nutzt Claude Code, bemerkt aber, dass es regelmässig neue Pakete einbindet und Texte mit deutscher statt Schweizer Rechtschreibung schreibt.

Vorher: Sie korrigiert dieselben Dinge in jedem Auftrag. Nachher: Sie legt eine CLAUDE.md an mit Ordnerstruktur, Testbefehl, der Regel «Keine neuen Pakete ohne Rückfrage» und der Sprachvorgabe. Nach einem Testauftrag kürzt sie die Datei auf eine Seite. Die Änderungen passen nun besser zum Projekt, und die Prüfung geht schneller.

So hilft Ihnen Alpasana

Wer lernen möchte, Claude Code mit klaren Regeln zu führen, findet bei absofort den Kurs KI für Developer mit Claude und Codex: Claude, Claude Code und Claude API als Kursgegenstände, Aufgaben delegieren und Ergebnisse verifizieren, Entwickler-Playbook mit Prompts, Review-Regeln, Tests und Datenschutzgrenzen, Praxisprojekt und verifizierbares Zertifikat.

Häufige Fragen

Muss die Datei genau so heissen?

Ja, Claude Code sucht nach diesem Namen. Prüfen Sie Schreibweise und Ort in der aktuellen Dokumentation.

Kann ich mehrere Dateien haben?

Je nach Version sind Dateien auf verschiedenen Ebenen möglich, etwa für das Projekt oder für Ihre persönlichen Vorlieben. Prüfen Sie die Dokumentation.

Wie lang darf die Datei sein?

So kurz wie möglich. Eine Seite mit klaren Regeln wirkt besser als zehn Seiten Beschreibung.

Soll das ganze Team dieselbe Datei nutzen?

Ja, die Projektdatei gehört in die Versionsverwaltung und gilt für alle. Persönliche Vorlieben gehören in eine eigene Datei.