Každý, kdo AI používá pravidelně, zná ten pocit: otevřete nový chat, a znovu opisujete „jsem copywriter, pracuji pro B2B firmy, píšu česky, bez formálního tónu...". Tohle je zbytečná práce — a CLAUDE.md ji eliminuje.
Co je CLAUDE.md
CLAUDE.md je prostý markdown soubor — textový dokument s formátováním. Claude Code (ale i Cowork v Claude Desktop) ho přečte automaticky při každém spuštění, ještě než dostane vaši první zprávu.
Je to jako kdybyste kolegovi předali firemní příručku. On si ji přečte jednou — a od té chvíle ví, jak ve firmě věci fungují, co dělat a čemu se vyhýbat. Nemusíte mu to vysvětlovat pokaždé znovu.
Dvě úrovně CLAUDE.md
Existují dvě místa, kde soubor uložit — a každé slouží jinak:
- Globální (~/.claude/CLAUDE.md) — platí pro všechny projekty. Sem patří vaše obecné preference: jak chcete psát, váš styl, jazyk, co nesnášíte ve výstupech.
- Projektový (./CLAUDE.md v adresáři projektu) — platí jen pro ten konkrétní projekt. Sem patří specifika: co je to za projekt, jak je postaven, konvence, co může model měnit a co ne.
Oba soubory se při startu spojí dohromady — model vidí globální i projektový kontext naráz.
Co do CLAUDE.md patří
Sem patří vše, co byste řekli novému kolegovi při nástupním pohovoru:
- Kdo jste a co je projekt
- Technologie a stack (pro weby: HTML/CSS/JS, žádný framework, Space Grotesk font...)
- Design systém: barvy, proměnné, konvence
- Co smí model měnit a co ne
- Styl výstupů: délka, tón, formát
- Git workflow: větev, naming convention
- Specifická pravidla: „vždy aktualizuj sitemap při nové stránce"
Příklady pro různé situace
Tone: přátelský, ne korporátní. Čtenář: podnikatelé 35–55 let. Vyhýbat se: „synergie", „revoluční", „inovativní". Délka: max 800 slov pokud neuvedeno jinak. Vždy česky.
Framework: žádný, čistý HTML/CSS/JS. Barvy: --accent: #FF007F, --bg: #131313. Vždy aktualizuj sitemap.xml při nové stránce. Git branch: master, nikdy jiná větev.
Výstupy vždy v češtině. Čísla ve formátu: 1 000 Kč (mezera jako oddělovač). Data z tabulek nekopírovat jako obrázky — vždy jako text. Zdroje vždy citovat.
Stack: Make.com + OpenAI API. Citlivá data nikdy do kódu — jen jako proměnné. Komentáře v kódu česky. Každá automatizace musí mít error handling.
Jak napsat první CLAUDE.md za 10 minut
Nejjednodušší způsob: nechte to napsat Claude! Otevřete nový chat a napište:
Výsledek si přečtěte, upravte a uložte jako CLAUDE.md do kořene vašeho projektu.
5 chyb, které lidi dělají při psaní CLAUDE.md
- Příliš obecný obsah. „Buď profesionální a přátelský" — to model dělá stejně. Napište konkrétní věci jako „nepoužívej slovo 'jednoduše'".
- Příliš dlouhý soubor. CLAUDE.md se posílá v každém kole jako součást kontextu. 500–1500 slov je ideální.
- Protiřečící instrukce. „Piš stručně, ale zahrň všechny detaily" — model si nevybere dobře. Buďte konkrétní: „odpovědi max 200 slov pokud neřeknu jinak".
- Zapomínání na aktualizaci. Projekt se vyvíjí. CLAUDE.md by měl být živý dokument — aktualizujte ho, když se změní konvence nebo stack.
- Citlivé informace v souboru. CLAUDE.md se commituje do Gitu — nesmí obsahovat hesla, API klíče ani citlivá data.
Chcete AI nastavit chytře pro váš byznys?
Pomohu vám nastavit AI workflow šitý na míru — od CLAUDE.md po automatizaci procesů. Konzultace 30 minut zdarma.