CLAUDE.md Legjobb gyakorlatok: Claude kód beállítása minden projekthez
A CLAUDE.md a Claude Code egyetlen leghatásosabb konfigurációja. A jól megírt mesterséges intelligencia projektspecifikus szakértelmet jelent.
A CLAUDE.md egy Marklown fájl a projekt gyökerénél. Claude Code minden ülés elején elolvassa, mielőtt bármit gépelne. Egy jó claude. Az md generikus MI-t olyan eszközzé alakítja, amely megérti a projekt konvencióit, a tech stack-jét és a piros vonalakat.
Mit kell belefoglalni a CLAUDE.Md-be?
Koncentrálj arra az információra, amire egy okos fejlesztőnek szüksége van a csapatodhoz az első napon. Tartsa praktikus: tech stack, parancsok, egyezmények, és dolgok, hogy elkerüljék.
Minimális CLAUDE.md sablon
# 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 firstMi a leggyakoribb CLAUDE. Hibák?
| Hiba | Miért fáj | Javítás |
|---|---|---|
| Túl hosszú (500 + vonal) | Wastes context window on every session | Tartsuk 200 vonal alatt, linket docs részletek |
| Túl homályos ("írj tiszta kódot") | Nem ad használható útmutatást | Konkrétabban: "Alapértelmezés szerint használja a szerver komponenseit" |
| Hiányzó parancsok | Claude kitalálja, hogyan kell futtatni / tesztelni / építeni | Minden vonatkozó npm szkript felsorolása |
| Nincs korlátozás | Claude módosíthatja az érzékeny fájlokat | Adjunk hozzá egy tiszta "NE" részt |
| A README másolata | README az embereknek, CLAUDE.md az MI-nek | Konventekre és szabályokra összpontosítva, nem a projekt leírására |
Hogyan épül fel a CLAUDE.md a nagy projektekhez?
A nagy kodebázisok, használja a @ import szintaxis, hogy ossza konfiguráció könyvtárak. Claude Code követi a behozatalt, és teljes képet készít.
# 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.mdMinden egyes subCLAUDE.md az adott csomagra vonatkozó szabályokat tartalmaz. Ez rövidre zárja a root fájlt, miközben Claude Code-ot mély kontextusba helyezi a kódolás minden területén.
Hogyan generál CLAUDE.md automatikusan?
Claude Kód képes létrehozni egy kezdő CLAUDE. md a projekt elemzésével:
# Auto-generate CLAUDE.md
claude /init
# This creates a CLAUDE.md based on:
# - package.json scripts
# - Project structure
# - Existing config files
# - Git history patternsMi van a CLAUDE.Md memória hierarchiával?
Claude CLAUDE.md fájlokat olvas több helyről, prioritásként:
- +Projekt root CLAUDE.md (mindenki a csapatban osztja ezt)
- +Subdirectory CLAUDE.md fájlok (via @ import)
- +~ / .claude / CLAUDE.md (személyes globális preferenciáid)
- +Automatikus memória (MEMORY.md, által kezelt / memória parancs)
Projektszintű beállítások felülbírálják a személyeseket. Ez azt jelenti, hogy a csapatkonvenciók mindig megnyerik az egyéni preferenciákat.