Co je CLAUDE.md? Paměť vašeho projektu

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ěť.

A pozor, CLAUDE.md není jediná paměť. Od února 2026 si Claude vedle něj vede i vlastní auto memory, paměť, kterou si píše sám. CLAUDE.md jsou vaše pravidla, auto memory je to, co se agent naučil.

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.

CLAUDE.md · kořen projektu

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.

Claude Code · ~/projekty/mujeshop

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í, víc v průvodci Claude Code vs. Codex.

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.

22 hodin videí · 1 800+ absolventů · roční licence s aktualizacemi zdarma

Více o kurzu AI First Cena a koupě

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ý. Oba nástroje detailně srovnáváme v průvodci Claude Code vs. Codex.

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.

Co je CLAUDE.md?