Definition

CLAUDE.md

CLAUDE.md je konfigurační soubor ve formátu Markdown umístěný v kořeni projektu, který poskytuje Claude Code trvalé, projektově specifické instrukce. Říká agentovi o vašich konvencích kódování, architektuře, běžných příkazech a pravidlech — funguje jako forma dlouhodobé paměti, která se vztahuje na každou relaci v daném projektu.

Jak CLAUDE.md funguje

Když Claude Code spustí relaci, automaticky přečte soubor CLAUDE.md v kořeni projektu (a případné soubory CLAUDE.md v nadřazených adresářích nebo podadresářích). Obsah se stává součástí systémového kontextu agenta, takže dodržuje vaše instrukce, aniž by bylo třeba mu je v každé relaci připomínat. To zajišťuje, že agent se chová konzistentně s konvencemi vašeho týmu.

Co zahrnout do CLAUDE.md

+Přehled architektury projektu a umístění klíčových souborů
+Konvence kódování (pojmenování, formátování, vzory k použití nebo vyhnutí)
+Běžné příkazy pro testování, sestavování a nasazování
+Pravidla jako „vždy pište testy pro nové funkce" nebo „nikdy neupravujte auth modul přímo"
+Detaily technologického stacku, o nichž by agent měl vědět

markdown

# CLAUDE.md

## Projekt
Aplikace Next.js 14 s App Routerem, TypeScriptem, Tailwind CSS.

## Příkazy
- `npm run dev` — spuštění dev serveru
- `npm test` — spuštění Jest testů
- `npm run lint` — kontrola ESLint

## Konvence
- Výchozí jsou server komponenty
- Klientské komponenty jdou do `components/client/`
- Všechny API routes musí validovat vstup pomocí Zod
- Pište testy pro každou novou utility funkci

## Nedělat
- Upravovat soubory v `lib/core/` bez výslovného schválení
- Používat typ `any` v TypeScriptu
- Přidávat nové závislosti bez odůvodnění

Udržujte CLAUDE.md stručný. Agent ho čte v každé relaci, proto zahrnujte pouze informace relevantní napříč více úkoly. Detaily specifické pro úkoly přesuňte do svých promptů.

Kam mám soubor CLAUDE.md umístit?+

Umístěte ho do kořenového adresáře projektu. Claude Code také podporuje soubory CLAUDE.md v podadresářích pro instrukce specifické pro modul a v nadřazených adresářích pro pravidla platná pro celou organizaci. Všechny příslušné soubory jsou sloučeny dohromady.

Funguje CLAUDE.md s jinými AI nástroji?+

CLAUDE.md je specifický pro Claude Code. Nicméně některé jiné nástroje přijaly podobné koncepty. Cursor používá .cursorrules a jiní agenti mohou číst vlastní konfigurační soubory. Koncept instrukcí AI na úrovni projektu se stává běžným vzorem.

Jak dlouhý by měl CLAUDE.md být?+

Udržujte ho pod 500 řádky. Zaměřte se na nejdůležitější konvence a pravidla. Agent může vždy číst jednotlivé soubory pro detaily — CLAUDE.md by měl poskytovat vysokoúrovňový kontext platný napříč úkoly.

Master Claude Code in days, not months

37 hands-on lessons from beginner to CI/CD automation. Module 1 is free.

START FREE →

← ALL TERMS

Jak CLAUDE.md funguje

Co zahrnout do CLAUDE.md

Related terms