CLAUDE.md vs AGENTS.md:který agent čte který soubor.

Co který soubor je

Oba jsou prostý Markdown, který agent načte do kontextu na začátku relace. Píšete do nich příkazy pro build a testy, styl kódu, strukturu projektu a pravidla jako „nikdy needitovat generované soubory“. Jsou to instrukce, ne vynucená nastavení: agent s nimi zachází jako s doporučením.

• CLAUDE.md je specifický pro Claude Code. Může ležet v kořeni projektu (./CLAUDE.md nebo ./.claude/CLAUDE.md), v ~/.claude/CLAUDE.md pro všechny vaše projekty i v podsložkách. CLAUDE.local.md drží soukromé poznámky k jednomu projektu.
• AGENTS.md je otevřený formát popsaný na agents.md, README pro agenty. Čtou ho Codex, Cursor, kódovací agent GitHub Copilot, Gemini CLI, Zed a mnoho dalších. V monorepu platí AGENTS.md v podsložce pro tuto část a vyhrává nejbližší soubor.

Obsah je stejného druhu. Liší se to, který nástroj soubor načte.

Co Claude Code dělá s AGENTS.md

Dokumentace Claude Code popisuje tři případy, pro verzi 2.1.277 a novější:

• Jen AGENTS.md v projektu, žádný CLAUDE.md: Claude Code čte AGENTS.md.
• Oba soubory v projektu: Claude Code čte jen soubory CLAUDE.md.
• CLAUDE.md, který importuje AGENTS.md přes @AGENTS.md: Claude čte CLAUDE.md včetně AGENTS.md.

Právě druhý případ lidi překvapuje. Pokud do repozitáře, který má AGENTS.md, přidáte CLAUDE.md, i malinký, Claude přestane AGENTS.md číst, dokud ho CLAUDE.md neimportuje. Totéž platí pro CLAUDE.local.md. Starší verze Claude Code četly jen CLAUDE.md, proto je import stále bezpečná volba. Dokumentace popisuje i nastavení Project instructions v /config, aby Claude četl oba soubory společně.

Jedna sada instrukcí

Vyberte jeden soubor jako zdroj pravdy. Zdokumentované jsou dva způsoby:

1. Importovat AGENTS.md z CLAUDE.md

   Vytvořte CLAUDE.md vedle AGENTS.md, jehož první řádek je @AGENTS.md, a pod něj přidejte instrukce jen pro Claude. Importy používají syntaxi @path, relativní cesty se řeší od souboru, který je obsahuje, a importované soubory mohou importovat další až do hloubky čtyř úrovní.

2. Udělat z CLAUDE.md symbolický odkaz na AGENTS.md

   Spusťte ln -s AGENTS.md CLAUDE.md, pokud nemáte nic specifického pro Claude. Dokumentace varuje, že editační nástroje Claude přes symbolický odkaz nezapisují a že ve Windows se může commitnutý odkaz vyexportovat jako jednořádkový textový soubor, takže pro sdílený repozitář je import bezpečnější.

Vyhněte se třetímu přístupu: CLAUDE.md, který slovy říká „přečti si AGENTS.md“. Claude soubor uvidí, jen když se ho rozhodne otevřít, kdežto import ho načte pokaždé.

Společný AGENTS.md

Do AGENTS.md dejte, co potřebuje každý agent:

# AGENTS.md

## Commands
- Install: `npm ci`
- Test: `npm test`
- Lint: `npm run lint`

## Conventions
- TypeScript, strict mode. No default exports.
- Update the tests with every change.

## Do not
- Edit files under `generated/`.
- Commit without running the tests.

Držte ho krátký a konkrétní. Dokumentace Claude Code doporučuje zůstat na jeden CLAUDE.md pod zhruba 200 řádky, protože delší soubory stojí kontext a dodržují se méně spolehlivě.

Časté chyby

• Dva soubory, které se rozejdou. Jedna kopie se aktualizuje, druhá ne. Použijte import.
• Přidání CLAUDE.md a ztráta AGENTS.md. Viz výše: importujte ho.
• Tajné údaje v kterémkoli souboru. Commitují se a načítají se do každé relace.
• Vágní pravidla. „Piš čistý kód“ nedělá nic. „Spusť npm test, než řekneš, že jsi hotový“ ano.
• Protichůdná pravidla v souboru nadřazené složky a v souboru podsložky.

Čtení a revize těchto souborů

Oba jsou obyčejný Markdown, takže DotMD otevře CLAUDE.md a AGENTS.md jako každý soubor .md, s osnovou a historií každé změny, a ukáže, co v nich agent změnil. Čtení je zdarma. Viz také Claude Code a Codex s DotMD.

Otázky k CLAUDE.md a AGENTS.md

Další otázky