\n| Hauptnutzung<\/td>\n | Code-Standards, Architektur, Workflow<\/td>\n | Build-Befehle, Debug-Erkenntnisse, Pr\u00e4ferenzen<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n CLAUDE.md selbst gewann 2026 eine reichere Struktur. Vier Scopes<\/strong> werden unterst\u00fctzt: organisationsweit von IT\/DevOps verteilte managed-policy<\/strong>-Dateien (macOS unter \/Library\/Application Support\/ClaudeCode\/CLAUDE.md<\/code>, Linux unter \/etc\/claude-code\/CLAUDE.md<\/code>, Windows unter C:Program FilesClaudeCodeCLAUDE.md<\/code>); team-spezifische Projekt<\/strong>-Dateien (.\/CLAUDE.md<\/code> oder .\/.claude\/CLAUDE.md<\/code>); User<\/strong>-Dateien f\u00fcr alle Projekte des Nutzers (~\/.claude\/CLAUDE.md<\/code>); und Local<\/strong>-Dateien f\u00fcr rein projektbezogene pers\u00f6nliche Notizen, die in .gitignore<\/code> landen (.\/CLAUDE.local.md<\/code>). Spezifischere Scopes \u00fcberschreiben breitere.<\/p>\nDie Lade-Mechanik wurde ebenfalls breiter. Ausgehend vom Arbeitsverzeichnis durchl\u00e4uft Claude bis zur Filesystem-Wurzel<\/strong> jedes Verzeichnis nach CLAUDE.md<\/code> und CLAUDE.local.md<\/code>; alle Treffer flie\u00dfen in den Kontext. CLAUDE.md-Dateien in Unterverzeichnissen werden nicht beim Start geladen \u2014 sie laden on-demand<\/strong>, wenn Claude eine Datei in diesem Verzeichnis liest. Wenn Sie mit --add-dir<\/code> weitere Verzeichnisse einbringen, setzen Sie die Umgebungsvariable CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1<\/code>, damit deren CLAUDE.md-Dateien geladen werden. Nach einer Compaction (\/compact<\/code>) wird die Projekt-Root-CLAUDE.md automatisch nachgeladen; verschachtelte Dateien folgen beim n\u00e4chsten relevanten Read.<\/p>\n \n<\/span>2026 neue Features: Imports, .claude\/rules\/, AGENTS.md-Interop<\/span><\/h2>\nDamit CLAUDE.md nicht zu einer riesigen Datei aufquillt, hat Anthropic die @path\/to\/import<\/code><\/strong>-Syntax standardisiert. Sie zieht andere Markdown-Dateien in die CLAUDE.md ein; relative und absolute Pfade werden unterst\u00fctzt; Rekursion ist bis 5 Hops Tiefe<\/strong> erlaubt. Typische Anwendung:<\/p>\nSee @README for project overview and @package.json for available npm commands.\n\n# Additional Instructions\n- git workflow @docs\/git-instructions.md\n- personal preferences @~\/.claude\/my-project-instructions.md\n<\/code><\/pre>\nDas zweite gro\u00dfe Update ist der Ordner .claude\/rules\/<\/code><\/strong> mit path-scoped rules<\/strong>. Statt alles in eine CLAUDE.md zu pressen, splitten Sie Regeln in themenspezifische Markdown-Dateien mit YAML-Frontmatter, das sie nur aktiviert, wenn Claude passende Pfade ber\u00fchrt:<\/p>\n---\npaths:\n - "src\/api\/**\/*.ts"\n - "lib\/**\/*.{ts,tsx}"\n---\n\n# API Development Rules\n- All API endpoints must include input validation\n- Use the standard error response format\n- Include OpenAPI documentation comments\n<\/code><\/pre>\nRules-Dateien ohne paths<\/code>-Frontmatter laden immer; mit paths<\/code> nur bei passenden Dateien. Kritisch f\u00fcr Monorepos, in denen unterschiedliche Teams ihre eigenen Regels\u00e4tze pflegen. Mit claudeMdExcludes<\/code><\/strong> k\u00f6nnen Sie zus\u00e4tzlich CLAUDE.md-Dateien in Vorfahren-Verzeichnissen selektiv deaktivieren.<\/p>\nDrittes Add-on ist die AGENTS.md-Interoperabilit\u00e4t<\/strong>. Cursor, Codex, Aider und andere Agents lesen AGENTS.md; Claude Code liest nur CLAUDE.md. Standard-L\u00f6sung:<\/p>\n@AGENTS.md\n\n## Claude Code\nUse plan mode for changes under `src\/billing\/`.\n<\/code><\/pre>\nGleicher Anweisungssatz f\u00fcr alle Agent-Tools; der kurze Claude-spezifische Abschnitt erg\u00e4nzt die Extras. Slash-Befehle: \/init<\/code><\/strong> entwirft die Datei, \/memory<\/code><\/strong> zeigt aktuell geladene Dateien und erm\u00f6glicht das Editieren, der InstructionsLoaded<\/code>-Hook<\/strong> debuggt, was wann geladen wurde. Mit CLAUDE_CODE_NEW_INIT=1<\/code> wird \/init<\/code> zu einem interaktiven Mehrphasen-Flow: Ein Subagent inspiziert das Repo, fragt L\u00fccken ab und liefert vor dem Schreiben eine pr\u00fcfbare Vorlage.<\/p>\n \n<\/span>Karpathys Idea-File-Ansatz (April 2026)<\/span><\/h2>\nAm 3. April 2026 schlug Karpathy auf X und danach in einem GitHub-Gist ein neues Sharing-Format vor: die \u201eidea file”<\/em>. Klassisches Open Source teilt Code; eine Idea File teilt die Idee, und der Agent auf der anderen Seite baut sie f\u00fcr seine Umgebung neu<\/strong>. Die Begr\u00fcndung war einfach: 2026 \u2014 mit starken Agent-Modellen \u2014 ist es effizienter, Intention<\/strong> zu kopieren als Code pixelgenau.<\/p>\nDie konkrete Form ist eine dreischichtige Struktur. Schicht eins ist der Ordner raw\/<\/code>: Paper, Artikel, Bilder, Datens\u00e4tze landen hier. Das LLM liest, aber ver\u00e4ndert diesen Ordner nie<\/strong> \u2014 Quellen sind unver\u00e4nderlich und verifizierbar. Schicht zwei ist der Ordner wiki\/<\/code>: LLM-erzeugte Zusammenfassungs-, Konzept- und Entit\u00e4tsseiten leben hier, querverlinkt und kumulativ wachsend<\/strong> statt pro Query neu hergeleitet. Schicht drei ist die Datei CLAUDE.md<\/code> (alternativ AGENTS.md<\/code> oder OPENCODE.md<\/code>), die das Schema<\/strong> des Gesamtsystems und seiner Pflege definiert.<\/p>\nDas System l\u00e4uft auf drei Operationen. Ingest:<\/strong> Wenn eine neue Quelle in raw\/<\/code> landet, liest das LLM sie und aktualisiert simultan 10\u201315 Wiki-Seiten, h\u00e4lt einen Index und ein Aktivit\u00e4ts-Log. Query:<\/strong> Fragen laufen durch die Struktur; wertvolle Antworten werden als neue Seiten zur\u00fcckgefiled, sodass Wissen kompoundiert. Lint:<\/strong> Periodische Health-Checks bringen Widerspr\u00fcche, Waisenseiten, fehlende Konzepte und vorgeschlagene Reviews zum Vorschein. Karpathy verbindet das mit Vannevar Bushs Memex-Konzept von 1945<\/strong>; Bushs ungel\u00f6ste Frage \u201ewer pflegt das?” wird endlich durch LLMs beantwortet.<\/p>\nDiese Architektur weicht in einem Kernpunkt vom klassischen RAG (Retrieval-Augmented Generation) ab. RAG kehrt f\u00fcr jede Query zu den Quellen zur\u00fcck und synthetisiert; der Idea-File-Ansatz kompiliert Wissen einmal und h\u00e4lt es aktuell<\/strong>, statt es bei jedem Abruf neu zu derivieren. In Karpathys Worten: \u201eThe knowledge is compiled once and then kept current, not re-derived on every query.”<\/em> CLAUDE.md ist die Schema-Datei, die einen generischen Chatbot in einen disziplinierten Wiki-Pfleger<\/strong> verwandelt.<\/p>\n \n<\/span>Wie schreibt man eine effektive CLAUDE.md? (2026-Standards)<\/span><\/h2>\nAus Anthropics eigener Doku ergeben sich vier Prinzipien als Kern effektiven CLAUDE.md-Schreibens. Gr\u00f6\u00dfe:<\/strong> Datei unter 200 Zeilen halten; l\u00e4ngere verbrauchen mehr Kontext und senken Befolgungsraten. Wenn Anweisungen wachsen, via path-scoped rules oder Imports splitten. Struktur:<\/strong> Anweisungen gruppiert unter Markdown-Headings und Bullets sind weit besser scannbar als lose Abs\u00e4tze; Claude liest wie ein Mensch. Spezifit\u00e4t:<\/strong> Verifizierbare, konkrete Anweisungen. \u201eCode richtig formatieren”<\/em> \u2192 \u201e2-Space-Einr\u00fcckung verwenden”<\/em>; \u201e\u00c4nderungen testen”<\/em> \u2192 \u201eVor Commit npm test<\/code> ausf\u00fchren”<\/em>; \u201eDateien ordentlich halten”<\/em> \u2192 \u201eAPI-Handler liegen in src\/api\/handlers\/<\/code>.”<\/em> Konsistenz:<\/strong> Bei widerspr\u00fcchlichen Anweisungen w\u00e4hlt Claude eine zuf\u00e4llig; CLAUDE.md und verschachtelte Versionen periodisch reviewen.<\/p>\nWann geh\u00f6rt etwas in die CLAUDE.md? Anthropics Empfehlung ist klar: \u201eTreat CLAUDE.md as the place you write down what you’d otherwise re-explain.”<\/em> Wenn Claude denselben Fehler zweimal macht, wenn eine im Code-Review entdeckte Konvention auch Claude wissen sollte, wenn Sie dieselbe Korrektur wie letzte Sitzung erneut schreiben, oder wenn ein neuer Teammitglied diesen Kontext zum produktiven Arbeiten brauchen w\u00fcrde \u2014 alles sind CLAUDE.md-Eintr\u00e4ge. Mehrschritt-Prozeduren oder Regeln, die nur in einer Ecke des Codes gelten, geh\u00f6ren in eine Skill<\/strong> oder path-scoped rule<\/strong>, nicht in die CLAUDE.md selbst.<\/p>\nDie folgende Vorlage ist der minimal funktionale Startpunkt einer CLAUDE.md 2026. Direkt kopierbar:<\/p>\n # Project Name\n\n## What this is\nOne-paragraph summary of what the project does and why it exists.\n\n## Tech stack\n- Language: Python 3.12 \/ TypeScript 5.4\n- Framework: FastAPI \/ Next.js 15\n- DB: PostgreSQL 16\n- Tests: pytest + httpx \/ vitest\n\n## Commands\n- Install: `uv sync` \/ `pnpm install`\n- Run dev: `uv run uvicorn app.main:app --reload` \/ `pnpm dev`\n- Test: `uv run pytest -x` \/ `pnpm test`\n- Lint: `uv run ruff check .` \/ `pnpm lint`\n- Typecheck: `uv run mypy app\/` \/ `pnpm typecheck`\n\n## Conventions\n- Type hints everywhere\n- Public functions: docstrings (Google style)\n- Tests live in `tests\/` matching `app\/` structure\n- No global state \u2014 pass dependencies explicitly\n\n## Don't\n- No emoji in code or commits\n- No `print()` for debug \u2014 use `logger.debug()`\n- No new dependencies without justifying in PR description\n- Don't write code comments that just restate what code does\n\n## Common pitfalls\n- DB migrations: run `alembic upgrade head` after pulling\n- The `vendor\/` folder is git-tracked but not editable\n- `pytest` requires `.env.test` (copy from `.env.test.example`)\n\n## Architecture in 3 lines\n- Request \u2192 middleware (auth) \u2192 router \u2192 service \u2192 repository \u2192 DB\n- Async I\/O end-to-end with `asyncpg`\n- Background jobs in `app\/jobs\/` use `arq` (not Celery)\n\n## Imports\n@README.md\n@docs\/architecture.md\n@AGENTS.md\n<\/code><\/pre>\nZwei Praxistipps aus Karpathys Workflow: erstens die Analogie \u201eAI is a junior dev with infinite enthusiasm”<\/em> \u2014 der KI-Agent ist wie ein talentierter, aber ged\u00e4chtnisloser Juniorentwickler, der jeden Morgen ein Briefing braucht; CLAUDE.md ist dieses Briefing in Schriftform. Zweitens das \u201eliving memory”<\/em>-Prinzip: Die Datei soll kein einmal geschriebenes READMe sein, sondern mit jedem neuen Fehler der KI wachsen.<\/p>\n \n<\/span>CLAUDE.md vs Cursor Rules vs ChatGPT Custom Instructions<\/span><\/h2>\nDie drei f\u00fchrenden KI-Coding-Tools speichern Entwicklerkontext unterschiedlich. Stand 2026 ist das CLAUDE.md-System von Claude Code<\/strong> das reichhaltigste und hierarchischste \u2014 managed\/project\/user\/local + path-scoped rules + Auto Memory + Imports. Cursor<\/strong> bietet mit .cursor\/rules\/<\/code> eine \u00e4hnliche Struktur via Markdown + YAML-Frontmatter, hat aber keinen geteilten User-Scope. ChatGPT Custom Instructions<\/strong> ist an Ihr OpenAI-Konto gebunden, in der Cloud gespeichert, zwei Klartextfelder \u2014 kein Projekt-Kontext.<\/p>\n\n\n\n| Dimension<\/th>\n | CLAUDE.md (Claude Code)<\/th>\n | Cursor Rules<\/th>\n | ChatGPT Custom Instructions<\/th>\n<\/tr>\n<\/thead>\n | \n\n| Ort<\/td>\n | Repo + User + managed (Org)<\/td>\n | .cursor\/rules\/*.md<\/code><\/td>\n| OpenAI-Konto (Cloud)<\/td>\n<\/tr>\n | \n| Hierarchie<\/td>\n | 4 Scopes + nested + Auto Memory<\/td>\n | Nur Projekt<\/td>\n | Nur User<\/td>\n<\/tr>\n | \n| Format<\/td>\n | Markdown + YAML-Frontmatter (Rules)<\/td>\n | Markdown + YAML-Frontmatter<\/td>\n | Klartext (2 Felder)<\/td>\n<\/tr>\n | \n| Imports<\/td>\n | @path<\/code> 5-Hop rekursiv<\/td>\n| Eingeschr\u00e4nkt<\/td>\n | Keine<\/td>\n<\/tr>\n | \n| Path-scoped rules<\/td>\n | \u2705 .claude\/rules\/<\/code> + paths<\/code>-Glob<\/td>\n| Teilweise<\/td>\n | \u274c<\/td>\n<\/tr>\n | \n| Auto Memory<\/td>\n | \u2705 v2.1.59+<\/td>\n | \u274c<\/td>\n | \u274c<\/td>\n<\/tr>\n | \n| AGENTS.md-Interop<\/td>\n | \u2705 @AGENTS.md<\/code>-Import<\/td>\n| \u274c<\/td>\n | \u274c<\/td>\n<\/tr>\n | \n| Versionskontrolle<\/td>\n | Ja (in Git)<\/td>\n | Ja (in Git)<\/td>\n | Nein (cloud-only)<\/td>\n<\/tr>\n | \n| Team-Sharing<\/td>\n | Ja<\/td>\n | Ja<\/td>\n | Nein<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n Praktische Empfehlung: Wenn Sie alle Tools im selben Projekt nutzen, schreiben Sie CLAUDE.md als Master-Quelle<\/strong>, importieren Sie AGENTS.md daraus, kopieren Sie 1:1 nach .cursor\/rules\/<\/code> f\u00fcr Cursor. In ChatGPT Custom Instructions nur pers\u00f6nliche Pr\u00e4ferenzen<\/strong> (z. B. \u201eAntwort auf Deutsch, Code-Kommentare Englisch”) \u2014 Projektdetails geh\u00f6ren dort nicht hin, weil sie f\u00fcr jedes Projekt gelten.<\/p>\n \n<\/span>Praktische Tipps f\u00fcr deutschsprachige Entwickler<\/span><\/h2>\nDie Adoption von CLAUDE.md hat sich in den deutschsprachigen Entwicklergemeinschaften von Ende 2025 an schnell ausgebreitet. Sie ist regelm\u00e4\u00dfig in Open-Source-Beitr\u00e4gen aus Berlin\/Wien\/Z\u00fcrich zu sehen. Ein gemeinsames Muster ist Sprachkonsistenz<\/strong>: Code-Kommentare, Fehlermeldungen, Docstrings auf Englisch; nutzerorientierte Doku darf Deutsch sein; PR-Beschreibungen bilingual. Eine Zeile in CLAUDE.md gen\u00fcgt: \u201eCode comments, docstrings, error messages: English. Documentation in docs\/<\/code>: German. PR descriptions: bilingual.”<\/em><\/p>\nZweites Thema in deutschsprachigen Projekten: Encoding und Locale<\/strong>. UTF-8 (ohne BOM), utf8mb4_unicode_ci<\/code>-Collation, explizites de_DE.UTF-8<\/code> bei locale-empfindlichen Sortier-Tests sind Standardpraxis \u2014 sonst produziert die KI bei Umlauten Inkonsistenzen. Der dritte kritische Block sind Regulierung und lokale Gesch\u00e4ftsregeln<\/strong>: DSGVO-Konformit\u00e4t (keine personenbezogenen Daten in Logs), e-Rechnung im XRechnung\/ZUGFeRD-Format, EUR-Preisformatierung nach f\"{amount:,.2f} \u20ac\"<\/code> \u2014 Regeln, die die KI alleine nicht kennt.<\/p>\nLetzter Tipp: CLAUDE.md gemeinsam mit dem Team versionieren<\/strong>. Datei auf main<\/code> und in jedem PR reviewen. Eine Regel, die ein Entwickler einf\u00fcgt, gilt sofort f\u00fcr das gesamte Team, weil die KI immer die neueste Version liest. Das ist das Fundament der Bewegung, mit der deutschsprachige Teams technische Standards zusammen mit der KI codifizieren.<\/p>\n | | | | |
|