CLAUDE.md Ημερομηνία γέννησης: Βέλτιστες πρακτικές: Configure κώδικα Claude για οποιοδήποτε έργο
Το CLAUDE.md είναι η πιο αντικρουόμενη διαμόρφωση για τον κώδικα Claude. Ένα καλογραμμένο μετατρέπει τη γενική βοήθεια AI σε ειδική εμπειρογνωμοσύνη για το έργο.
Το CLAUDE.md είναι ένα αρχείο markdown στη ρίζα του έργου σας. Ο Κώδικας Κλωντ το διαβάζει στην αρχή κάθε συνεδρίας πριν πληκτρολογήσεις οτιδήποτε. Μια καλή CLAUDE. Το md μετατρέπει την γενική AI σε ένα εργαλείο που κατανοεί τις συμβάσεις του έργου σας, την τεχνική στοίβα και τις κόκκινες γραμμές.
Τι πρέπει να συμπεριλάβετε στο CLAUDE.md?
Επικεντρωθείτε στις πληροφορίες που ένας έξυπνος προγραμματιστής θα χρειαζόταν την πρώτη μέρα. Κρατήστε το πρακτικό: τεχνική στοίβα, εντολές, συμβάσεις, και τα πράγματα για να αποφευχθεί.
Ελάχιστο πρότυπο CLAUDE.md
# Project Context
Next.js 14 app with TypeScript, Tailwind CSS, and Prisma.
Database: PostgreSQL. Auth: NextAuth.js.
## Commands
- `npm run dev` — start dev server (port 3000)
- `npm run test` — run Jest tests
- `npm run lint` — run ESLint
- `npm run db:migrate` — run Prisma migrations
## Architecture
- Server components by default, client components in /components/client/
- API routes in /app/api/ with Zod validation
- Database queries in /lib/db/ (never in components)
## Conventions
- TypeScript strict mode, never use `any`
- Tailwind for styling, no CSS modules
- Conventional commits: feat:, fix:, chore:
## Do NOT
- Modify files in /legacy/ or /vendor/
- Change auth configuration without explicit approval
- Add new dependencies without asking firstΠοια είναι η πιο κοινή CLAUDE. Λάθος της ιατρικής?
| Λάθος | Γιατί πονάει | Διόρθωση |
|---|---|---|
| Πολύ μεγάλο (500+ γραμμές) | Απορρίμματα παραθύρων σε κάθε συνεδρία | Διατήρηση κάτω από 200 γραμμές, σύνδεση με έγγραφα για λεπτομέρειες |
| Πολύ ασαφής (" γράψτε καθαρό κώδικα") | Δεν δίνει καμία αποτελεσματική καθοδήγηση | Να είστε συγκεκριμένοι: " Χρησιμοποιήστε τα συστατικά του εξυπηρετητή εξ ορισμού" |
| Έλλειψη εντολών | Claude μαντεύει πώς να τρέξει / δοκιμή / κατασκευή | Λίστα κάθε σχετικού σεναρίου npm |
| Χωρίς περιορισμούς | Ο Claude μπορεί να τροποποιήσει τα ευαίσθητα αρχεία | Προσθήκη ενός διαυγούς τμήματος " Μην το κάνετε" |
| Αντίγραφο του README | README είναι για τους ανθρώπους, CLAUDE.md είναι για AI | Εστίαση σε συμβάσεις και κανόνες, όχι περιγραφή έργου |
Πώς δομείτε το CLAUDE.md για μεγάλα έργα?
Για μεγάλες βάσεις κώδικα, χρησιμοποιήστε τη σύνταξη του @import για να διαχωρίσετε τις ρυθμίσεις σε καταλόγους. Ο κώδικας Claude ακολουθεί τις εισαγωγές και κατασκευάζει μια ολοκληρωμένη εικόνα.
# Root CLAUDE.md
## Global conventions
- TypeScript strict, no `any`
- All API routes validate input with Zod
@import packages/api/CLAUDE.md
@import packages/web/CLAUDE.md
@import packages/shared/CLAUDE.mdΚάθε υπο-CLAUDE.md περιέχει ειδικούς κανόνες για το εν λόγω πακέτο. Αυτό κρατά το αρχείο root σύντομο, ενώ δίνει Claude Code βαθύ πλαίσιο για κάθε περιοχή της βάσης κώδικα.
Πώς δημιουργείτε το CLAUDE.md αυτόματα?
Ο κώδικας Claude μπορεί να δημιουργήσει ένα αρχικό CLAUDE. md αναλύοντας το έργο σας:
# Auto-generate CLAUDE.md
claude /init
# This creates a CLAUDE.md based on:
# - package.json scripts
# - Project structure
# - Existing config files
# - Git history patternsΤι γίνεται με την ιεραρχία μνήμης CLAUDE.md?
Ο κώδικας Claude διαβάζει αρχεία CLAUDE.md από πολλαπλές τοποθεσίες, κατά σειρά προτεραιότητας:
- +Root του έργου CLAUDE.md (όλοι στην ομάδα μοιράζονται αυτό)
- +Αρχεία υποκαταλόγου CLAUDE.md (μέσω @ import)
- +~/.claude/CLAUDE.md (τις προσωπικές σας παγκόσμιες προτιμήσεις)
- +Αυτόματη μνήμη (MEMORY.md, διαχείριση από /memory εντολή)
Οι ρυθμίσεις επιπέδου έργου υπερισχύουν των προσωπικών. Αυτό σημαίνει ότι οι ομαδικές συμβάσεις κερδίζουν πάντα τις ατομικές προτιμήσεις.