Průvodce Claude Code
Co je CLAUDE.md?
Nejdůležitější soubor vašeho projektu. Trvalá paměť, kterou si AI přečte na začátku každé session. Pár desítek řádků rozhoduje o tom, jak dobře vám bude Claude Code pracovat.
Autor: Jindřich Fáborský · 17 let v marketingu · 2 000+ hodin vibe codingu · 180+ projektů
Rychlá odpověď
Co je tedy CLAUDE.md?
Textový soubor s trvalými instrukcemi pro Claude Code. Agent si ho automaticky přečte na začátku každé session, takže nemusíte pořád dokola vysvětlovat, kdo jste, na čem pracujete a jaká máte pravidla. Je to nejjednodušší odpověď na otázku „proč si AI nic nepamatuje“.
Zatímco kontextové okno se po každé session vynuluje, CLAUDE.md zůstává. Krátkodobá vs. dlouhodobá paměť.
Dva soubory, dvě role
Uživatelský a projektový CLAUDE.md
Ve skutečnosti máte soubory dva a každý dělá něco jiného. Dohromady tvoří paměť, se kterou agent startuje.
Uživatelský
~/.claude/CLAUDE.md
Platí pro všechny vaše projekty. Kdo jste, s jakými nástroji a účty pracujete, vaše bezpečnostní zásady a pravidla pro git. Napíšete ho jednou a slouží všude.
Projektový
<váš-projekt>/CLAUDE.md
Platí pro jeden konkrétní projekt. Co to je, jaký má stack, jaká pravidla a kde leží hlubší dokumentace. Verzuje se v gitu, takže ho sdílí každý, kdo na projektu pracuje.
Kde uživatelský CLAUDE.md najdete
macOS
Leží v ~/.claude/CLAUDE.md. Složku možná v počítači neuvidíte, soubory s tečkou na začátku jsou skryté. Ve Finderu je zobrazíte zkratkou Cmd + Shift + .
Windows
Leží v C:\Users\<vaše-jméno>\.claude\CLAUDE.md. Skryté složky zapnete v Průzkumníku souborů: záložka Zobrazit → Zobrazit → Skryté položky (na Windows 10: Zobrazení → zaškrtnout Skryté položky).
🎁 Můj uživatelský CLAUDE.md dostávají studenti kurzu
Soubor, který reálně řídí moji každodenní práci, sdílím v kompletním znění v kurzu AI First. Tady prozradím aspoň, co v takovém souboru má být: kdo jste a s čím pracujete, bezpečnostní pravidla platná pro každý projekt, kódové standardy a pravidla pro git a nasazování.
Ukázka z praxe
Takhle vypadá projektový CLAUDE.md
Reálná struktura z mého webu aifirst.cz, provozní detaily jsem zobecnil. Klikejte na sekce souboru a uvidíte, proč tam která je.
Proč to tam je
O projektu
Pět řádků, které ušetří hodiny. Model na začátku každé session potřebuje vědět, co staví, pro koho a v jakém jazyce. Bez toho si domýšlí, a domýšlí špatně.
Klikejte na jednotlivé sekce souboru.
Univerzální kostra k vyplnění. Ještě lepší start: nechte si soubor vygenerovat příkazem /init.
Proč anglicky? Se souborem pracuje hlavně model, ne lidi. A angličtina spotřebuje výrazně méně tokenů než čeština, což se u souboru načítaného do každé session sčítá. Obsah webu a UI texty přitom klidně můžou zůstat v češtině.
Ze 180+ projektů
Co do CLAUDE.md patří. A co ne.
Nejčastější chyba: nacpat tam všechno. Dobrý CLAUDE.md je krátký a obsahuje jen to, co model sám neví. Zbytek odkazuje.
✅ Patří tam
- •Co je to za projekt, pro koho a v jakém jazyce
- •Závazná pravidla: git, bezpečnost, co agent nesmí sám
- •Tech stack v pár řádcích, ať nenavrhuje cizí řešení
- •Rozcestník na hlubší dokumentaci: kde co najít a kdy to číst
- •Zrádné technické detaily, na které se přichází až po chybě
- •Příkazy: jak se projekt spouští, builduje a testuje
❌ Nepatří tam
- •API klíče, hesla, tajemství. Nikdy. Patří do .env souborů
- •Obecné rady typu „piš čistý kód“. Model je zná
- •Obsah souborů a dlouhé výpisy. Agent si je přečte sám
- •Duplikát dokumentace. Odkazujte, nekopírujte
- •Pravidla pro jediný úkol. Ta patří do promptu nebo skillu
Pamatujte: soubor se načítá do kontextového okna každé session. Každý zbytečný řádek platíte znovu a znovu, ještě než začnete pracovat.
Začněte příkazem /init
Nemáte CLAUDE.md? Nechte si ho napsat
Pracujete na projektu, kde CLAUDE.md ještě není? Otevřete v jeho složce Claude Code, napište /init a sledujte, co se stane.
Složka bez CLAUDE.md. Agent o projektu zatím nic neví.
CLAUDE.md
zatím neexistuje
Až se projekt časem výrazně promění, pusťte /init znovu a nechte ho soubor srovnat se skutečností. A trvalé pravidlo přidáte i za běhu: stačí zpráva začínající znakem #.
Jiné nástroje mají vlastní obdobu: Codex čte soubor AGENTS.md se stejnou rolí. Převod mezi nimi je otázka jednoho zadání, podrobnosti chystáme do samostatného průvodce.
Dobrý CLAUDE.md se pozná na výsledcích
V kurzu AI First si ho postavíte pro vlastní projekt a jako bonus dostanete můj kompletní uživatelský CLAUDE.md, ten samý, se kterým denně vibe coduju.
20 hodin videí · 1 800+ absolventů · roční licence s aktualizacemi zdarma
FAQ
Časté otázky
Co je CLAUDE.md?+
CLAUDE.md je textový soubor s trvalými instrukcemi pro Claude Code. Agent si ho automaticky přečte na začátku každé session, takže nemusíte pořád dokola vysvětlovat, kdo jste, na čem pracujete a jaká máte pravidla. Pro projekt je to nejdůležitější soubor: rozhoduje, jak dobře bude AI ve vašem repozitáři pracovat.
Kde CLAUDE.md leží a kde ho najdu?+
Dva základní. Uživatelský platí pro všechny vaše projekty a leží v domovské složce: na macOS ~/.claude/CLAUDE.md (skryté soubory zobrazíte ve Finderu zkratkou Cmd+Shift+tečka), na Windows C:\Users\<jméno>\.claude\CLAUDE.md (v Průzkumníku zapněte Skryté položky). Projektový leží v kořenu repozitáře a verzuje se v gitu spolu s kódem.
Jak CLAUDE.md vytvořím?+
Nejjednodušeji příkazem /init přímo v Claude Code: agent projde repozitář, dokumentaci i konfiguraci a soubor napíše za vás. Pak ho stačí proškrtat a doplnit pravidla, na kterých vám záleží. Jak se projekt vyvíjí, /init můžete pustit znovu, ať paměť drží krok s realitou.
Co do CLAUDE.md patří a co ne?+
Patří tam jen to, co model sám neví: co je to za projekt, závazná pravidla (git, bezpečnost), příkazy, zrádné technické detaily a rozcestník na hlubší dokumentaci. Nepatří tam obecné rady typu „piš čistý kód“, dlouhé výpisy kódu ani nic, co si agent přečte sám. A nikdy tam nepatří API klíče a hesla, ty žijí v .env souborech.
Proč psát CLAUDE.md anglicky?+
Protože s ním pracuje hlavně model, ne lidi. Angličtina spotřebuje zhruba o třetinu méně tokenů než čeština a soubor se načítá do každé session, takže úspora se opakuje pořád. Obsah webu a UI texty přitom klidně můžou zůstat v češtině, jazyk instrukcí s jazykem produktu nesouvisí.
Liší se CLAUDE.md a AGENTS.md?+
Princip je stejný, jen jiný nástroj. CLAUDE.md čte Claude Code, AGENTS.md čtou Codex a někteří další agenti. Převod je snadný: agentovi řeknete, ať z jednoho souboru vytvoří druhý. Detailům se budeme věnovat v samostatném průvodci.
Načítá se CLAUDE.md pokaždé a ujídá mi z kontextu?+
Ano, uživatelský i projektový se načtou při startu každé session, a proto se vyplatí držet je stručné. Dobrý CLAUDE.md má desítky až nízké stovky řádků: každý token v něm ukrajuje z kontextového okna ještě dřív, než začnete pracovat. U velkých projektů pomáhají vnořené CLAUDE.md v podadresářích, které se načítají, jen když agent v daném místě pracuje.