KI-Coding

CLAUDE.md für Claude Code: prüfbare Projektregeln

Schreiben Sie kurze Regeln mit Geltungsbereich, Verboten, Prüfkommandos und sicherem Umgang mit Secrets.

BT

BetterToken

Redaktion
2 Min. Lesezeit

Eine lange Wunschliste macht Claude Code nicht vorhersehbar. Eine brauchbare Regel nennt die erlaubte Änderung, die Grenze und den Nachweis: Datei, Diff, Kommando und Exit-Code.

Kleiner Vertrag

# Project rules

Goal

  • Keep changes limited to the requested feature.

Checks

  • Run npm test and report the command, exit code, and changed files.

Forbidden

  • Do not read .env or run deploy.

Scope

  • packages/payments/CLAUDE.md wins only inside that directory.
  • Root security rules always apply.

„Schreibe guten Code“ ist nicht prüfbar. „Führe `npm test` aus und melde Exit-Code und geänderte Pfade“ ist es.

Secrets und Konflikte

Speichern Sie keine API Keys, CI-Tokens oder echten personenbezogenen Daten in CLAUDE.md. Verwenden Sie Platzhalter und übergeben Sie benötigte Werte über die Umgebung oder einen CI-Secret-Store. Allgemeine Regeln gehören in die Wurzel, Paketregeln neben das Paket. Eine lokale Ausnahme darf globale Sicherheitsregeln nicht aufheben.

Reversibler Test

  1. Lassen Sie nur eine lokale Variable in einer Testdatei umbenennen.
  2. Prüfen Sie git diff --check und git diff --stat.
  3. Führen Sie das im Vertrag genannte Testkommando aus.
  4. Lehnen Sie das Ergebnis ab, wenn weitere Dateien geändert wurden oder Kommando und Exit-Code fehlen.

Für einen separaten Claude-Code-API-Ablauf prüfen Sie Base URL und Modell in der BetterToken-Dokumentation.

Bereit, Ihren LLM-Workflow zu optimieren?

Verbinden Sie Modelle über eine API, verwalten Sie Schlüssel und behalten Sie KI-Kosten im Blick.