Claude Academy
Wird geladen

Die CLAUDE.md

Lektion 53 Min.

CLAUDE.md gibt Claude den Kontext, den ein neues Teammitglied benötigen würde, und deckt Konventionen, Befehle, Architektur und die Fehler ab, die das Team am häufigsten sieht. Wissen, das früher in den Köpfen der Mitarbeiter und in Wikis steckte, wird zu einer Datei, die der Agent am Anfang jeder Sitzung liest, die vom gesamten Team gepflegt wird und die immer dann weiterentwickelt wird, wenn ein Fehler gemacht wird.

Erste Schritte

  • Voraussetzungen: Keine.
  • Infrastruktur: Ein Repository, installiertes Claude Code und ein Entwickler, der die Codebasis gut kennt.

So setzt du es um

  1. Führe /init im Repository aus. Claude generiert eine erste CLAUDE.md basierend auf dem, was es findet.
  2. Kürze die generierte Datei auf das, was ein neues Teammitglied am ersten Tag benötigen würde. Behalte die Build-, Test- und Lint-Befehle, die wichtigen Konventionen und die Dinge, bei denen Claude immer wieder Fehler macht.
  3. Checke CLAUDE.md im Root-Verzeichnis des Repositorys in Git ein, damit das gesamte Team eine gemeinsame Version nutzt und Änderungen wie Code überprüft werden.
  4. Eine Arbeitsregel hilft hier: Wenn Claude zweimal den gleichen Fehler macht, kommt die Korrektur in die CLAUDE.md.
  5. Halte sie unter einer Seite, denn Claude liest sie vollständig am Anfang jeder Sitzung, und alles Veraltete belegt Kontext ohne jeden Nutzen.

So sieht es aus

Diese CLAUDE.md gehört zum Repository für das Kundenportal eines Versicherers. Das ältere interne System, das die Schadensfälle verwaltet, ist claims-core, und intent/ enthält die Planungsdateien für jede Änderung.

CLAUDE.md:

markdown
# Claims portal
## Commands
- Build: make build
- Test: make test (unit), make itest (integration, needs docker)
- Lint: make lint (runs in CI; fix before pushing)
- Run: make run (portal on :3000, claims-api on :8000)
## Conventions
- claims-api is Python 3.12 and FastAPI. portal is TypeScript and React.
- Every endpoint needs a test in claims-api/tests.
- Dates cross the API as ISO 8601, never as formatted text.
## Architecture
- portal/ is the customer site, claims-api/ is its backend, and
  intent/ holds the intent.md, spec.md and plan.md for each change.
- Only claims-api talks to claims-core. The portal never calls it.
- claims-core allows 50 requests a second. Cache reads; never poll it.
## Things Claude gets wrong
- Do not log request or response bodies in claims-api; they can hold PII.
- Do not bump dependency versions; the platform team owns them.

Governance-Überlegungen

CLAUDE.md wird versioniert, sodass die Anweisungen, nach denen der Agent arbeitet, überprüfbar und auditierbar sind. Teamkonventionen werden über die Datei angewendet, Änderungen daran werden in der Git-Historie protokolliert, und Code-Owner genehmigen diese Änderungen im PR-Review.

So misst du es

  • Frühindikator: Wie oft Claude einen Fehler wiederholt, den CLAUDE.md hätte abfangen sollen. Die Korrekturen oder Änderungen an der CLAUDE.md sollten in der Git-Historie nachverfolgt werden.
  • Spätindikator: Zeit bis zum ersten gemergten PR für ein neues Teammitglied, ermittelt aus der PR-Historie.