Skip to main content

​
Kurzantwort

CLAUDE.md ist eine Projekt-Anweisungsdatei, die Claude Code als Kontext laden kann. Sie eignet sich für Projektstruktur, Befehle, Coding-Konventionen, Testerwartungen, Sicherheitsgrenzen und Regeln zur Zusammenarbeit. Sie ist kein Durchsetzungsmechanismus. Claude Code liest sie als Orientierung. Wenn eine Regel zu einem bestimmten Zeitpunkt ausgeführt werden muss, verwende Hooks oder eine Tool-Konfiguration, statt dich nur auf CLAUDE.md zu verlassen. Ein nützliches CLAUDE.md ist kurz, konkret und gepflegt. Verwende es für Projektfakten, die du sonst in jeder Sitzung wiederholen würdest.

​
Wann das wichtig ist

  • Claude Code fragt wiederholt nach derselben Projektstruktur oder denselben Befehlen
  • Dein Team möchte gemeinsame Test-, Stil- oder Sicherheitsregeln
  • Du möchtest wiederholten Kontext und Token-Nutzung reduzieren
  • Claude Code übersieht weiterhin Repository-spezifische Konventionen
  • Du möchtest, dass andere Agents oder Teammitglieder schneller eingearbeitet werden

​
Wichtige Konzepte

​
Empfohlene Inhalte

Schreibe CLAUDE.md als kompaktes Projekt-Handbuch:
  • Was das Projekt ist und wo wichtige Verzeichnisse liegen
  • Gängige Befehle für Build, Tests und Formatierung
  • Architekturgrenzen, die vor Bearbeitungen zu beachten sind
  • Die schnellsten vor dem Abschluss auszuführenden Prüfungen
  • Secrets, Logs oder private Konfigurationen, die nicht offengelegt werden dürfen
  • Konventionen für Dokumentation, Tests, Benennung und Fehlerbehandlung
Vermeide lange Tutorials, temporäre Pläne und einmalige Aufgabenhinweise. Wenn eine Regel nur für einen Bereich gilt, grenze sie enger ein. Wenn ein Verhalten erzwungen werden muss, verwende Hooks.

​
Häufige Fehler

  • CLAUDE.md als System-Prompt oder harte Berechtigungsschicht behandeln.
  • Es zu lang machen, wodurch Kontextkosten steigen und es schwerer zu befolgen ist.
  • Alte Deployment-Notizen, temporäre TODOs und überholte Entscheidungen dauerhaft anhängen.
  • API Keys, Tokens, Cookies oder private Konfigurationen in die Datei schreiben.
  • CLAUDE.md, AGENTS.md und Cursor Rules mit widersprüchlichen Anweisungen pflegen.

​
Über BetterToken

Wenn ein Projekt BetterToken verwendet, kann CLAUDE.md Claude Code daran erinnern, dass Claude Code die Anthropic-kompatible https://www.bettertoken.ai verwendet, während Codex und external tools die OpenAI-kompatible https://www.bettertoken.ai/v1 verwenden. Lege keine echten API Keys in CLAUDE.md ab. Speichere sie in lokalen Umgebungsvariablen, lokalen Konfigurationsdateien oder einem geschützten Secret-System.

​
Verwandte Dokumentation

​
Referenzen