CLAUDE.md-Regeln für Claude Code, die sich prüfen lassen
Ein kurzes, testbares CLAUDE.md mit klaren Grenzen, Befehlen und sicherer Secret-Behandlung.
Inhalt
CLAUDE.md-Regeln für Claude Code, die sich prüfen lassen
Eine lange Wunschliste macht einen Agenten nicht berechenbar. Eine Regel sagt, was erlaubt, verboten und per Befehl oder Diff prüfbar ist. Nutzt der Workflow eine API, öffnen Sie den aktuellen BetterToken-Claude-Code-Guide, konfigurieren den eigenen API-Key und führen einen kurzen Check aus: Im Dashboard müssen erwartetes Modell, Status und Token-Verbrauch erscheinen. Der Key bleibt in der Umgebung, nicht in CLAUDE.md.
Kleinen Vertrag beginnen
## Goal
- Keep changes limited to the requested feature.
## Checks
- Run `npm test` after code changes.
## Forbidden
- Do not read, print, or commit `.env`.„Guten Code schreiben“ ist nicht prüfbar; Testbefehl und Exit-Code sind es.
Scope und Hierarchie
Die aktuelle Claude-Code-Memory-Dokumentation beschreibt, wie Anweisungen verschiedener Bereiche gefunden werden. Im Beispiel ist „lokale Paketregeln dürfen gewöhnliche Root-Regeln überstimmen, aber keine Root-Sicherheitsregeln“ ein selbst gewählter Projektvertrag, keine universelle eingebaute Ausnahme. Prüfen Sie sichtbare Regeln und entfernen Sie Duplikate.
Ziel, Grenze, Check, Stil trennen
| Typ | Beispiel | Nachweis |
|---|---|---|
| Ziel | Profil lesen | nur Zielmodul geändert |
| Grenze | keine Migration | Diff enthält sie nicht |
| Check | npm test | Exit-Code 0 |
| Stil | bestehende Namen | kein unnötiger Refactor |
Lange Architekturbegründungen gehören mit Link nach docs/, nicht in den Vertrag.
Konkrete Regeln und Konflikte
Lesen Sie vor einer Änderung package.json, die Task-Dateien und alle lokalen Regeln. Erfinden Sie keinen Befehl, der nicht im Projekt vorhanden ist. Zeigen zwei Regeln unterschiedliche Commands, bestimmen Sie eine lokale, überprüfbare Regel und löschen die andere.
Reversibel testen
Bitten Sie Claude Code, eine lokale Variable in einer Testdatei umzubenennen. Prüfen Sie anschließend:
git diff --check
git diff --stat
npm testLehnen Sie ab, wenn andere Dateien geändert wurden oder der dokumentierte Check fehlt. So testen Sie die Regel, nicht einen großen Plan.
Geheimnisse und Wartung
In CLAUDE.md stehen nie API Keys, CI-Tokens, reale Personen- oder .env-Daten. Nutzen Sie API_KEY=your_api_key_here als Platzhalter und geben Sie echte Werte nur über Environment oder Secret Store weiter. Überprüfen Sie Regeln nach Änderungen an Tests, Paketen oder Ordnergrenzen und halten Sie den Root-Vertrag kurz.
