CLAUDE.md Nejlepší postupy: Nastavit Claude kód pro jakýkoli projekt
CLAUDE.md je jedna nejpůsobivější konfigurace pro Claude Code. Dobře napsaná pomoc AI změní v odborné znalosti specifické pro jednotlivé projekty.
CLAUDE.md je soubor markdown na kořenu vašeho projektu. Claude Code to čte na začátku každého sezení, než něco napíšete. Dobrý důkaz. MD transformuje generické AI do nástroje, který rozumí konvencím vašeho projektu, technice stack a červené čáry.
Co byste měli zahrnout do CLAUDE.md?
Soustřeďte se na informace, které chytrý vývojář, který se připojí k vašemu týmu, bude potřebovat první den. Mějte to praktické: tech stack, příkazy, konvence, a věci, kterým se vyhnout.
Minimální šablona 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 firstJaké jsou nejčastější CLAUDE. MD chyby?
| Chyba | Proč to bolí | Opravit |
|---|---|---|
| Příliš dlouhé (500+ řádků) | Plýtvá kontextovým oknem při každé relaci | Udržujte méně než 200 řádků, podrobnosti najdete v odkazech na dokumenty |
| Příliš vágní ("zapsat čistý kód") | Nedává žádné žalovatelné vedení | @ info: whatsthis |
| Chybějící příkazy | Claude hádá, jak běžet / testovat / build | Vypsat každý příslušný skript npm |
| Žádná omezení | Claude může upravit citlivé soubory | Přidat jasnou sekci "NEDOT" |
| Duplikace README | README je pro lidi, CLAUDE.md je pro AI | Zaměření na úmluvy a pravidla, nikoli popis projektu |
Jak strukturujete CLAUDE.md pro velké projekty?
Pro velké kodebase použijte syntaxi @ import pro rozdělení konfigurace napříč adresáři. Claude Code sleduje dovoz a vytváří kompletní obraz.
# 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.mdKaždá sub- CLAUDE.md obsahuje pravidla specifická pro tento balíček. To udržuje kořenový soubor krátký a zároveň dává Claude Code hluboký kontext o každé oblasti kódu.
Jak automaticky generujete CLAUDE.md?
Claude Code může generovat startovní CLAUDE. MD analýzou vašeho projektu:
# Auto-generate CLAUDE.md
claude /init
# This creates a CLAUDE.md based on:
# - package.json scripts
# - Project structure
# - Existing config files
# - Git history patternsA co hierarchie paměti CLAUDE.MD?
Claude Code čte CLAUDE.md soubory z více míst, v pořadí podle priority:
- +Projekt kořen CLAUDE.md (každý v týmu sdílí tento)
- +Soubory s podadresářem CLAUDE.md (via @ import)
- +~ / .claude / CLAUDE.md (vaše osobní globální preference)
- +Automatická paměť (MEMORY.md, řízená povelem / pamětí)
Nastavení na úrovni projektu přepíší osobní. To znamená, že týmové konvence vždy vítězí nad individuálními preferencemi.