Claude Code začal číst AGENTS.md, v projektu s CLAUDE.md ho ale přeskočí

Anthropic zapnul v Claude Code čtení souboru AGENTS.md. V poznámkách k vydání je to jediná řádka u verze 2.1.277: v projektu bez CLAUDE.md přečte Claude Code místo něj AGENTS.md, přepíná se to v /config pod položkou Project instructions a na Bedrocku, Vertexu ani Foundry to zatím není. Podle záznamu v registru npm ta verze vyšla 18. září 2026.

Jedna věta v poznámkách, ale stránka dokumentace o paměti k tomu má vlastní oddíl s tabulkou, čtyřmi výjimkami a návodem, jak zrušit dosavadní obcházení. Rozdíl mezi obojím je celé téma.

Vlastní soubor má přednost, cizí formát je náhradník

Výchozí pravidlo je jednoduché: AGENTS.md se čte jen tehdy, když v pracovním adresáři ani v žádném adresáři nad ním neleží CLAUDE.md, .claude/CLAUDE.md ani CLAUDE.local.md. Stačí jeden takový soubor kdekoli po cestě nahoru a Claude Code čte dál jen jeho.

Do téhle zkoušky se ale nepočítá všechno, co se jmenuje CLAUDE.md. Osobní ~/.claude/CLAUDE.md, organizační soubor nastavený správcem a pravidla v .claude/rules/ se načítají vedle AGENTS.md a jeho čtení neblokují. Když se AGENTS.md opravdu použije, vezme se každý takový soubor v pracovním adresáři a nad ním, plus varianta v .claude/; v podadresáři se jeho AGENTS.md načte, až když tam Claude sáhne na nějaký soubor. Interaktivní sezení to podle dokumentace oznámí řádkou „no CLAUDE.md found; AGENTS.md loaded“ s cestou k souboru.

Kdo chce obojí naráz, musí sáhnout do nastavení. Dokumentace ukazuje zápis v settings.json s hodnotou claude-md-and-agents-md, a to pod klíčem pluginConfigs → agents-md@builtin. V projektových a místních souborech nastavení se ta volba ignoruje; platí jen z uživatelského, ze souboru předaného přepínačem --settings nebo ze správcovského.

Podpora visí na vestavěném pluginu a na příznaku ze serveru

Ten klíč agents-md@builtin prozrazuje, jak je to udělané: ne jako součást jádra, ale jako vestavěný plugin. Z toho plyne většina výjimek, které dokumentace vypisuje.

Podpora se neobjeví ve verzi starší než 2.1.277 a nenaběhne ani v sezení, které si od Anthropicu nestahuje příznaky funkcí. To je podle dokumentace případ Amazon Bedrocku, jiného poskytovatele třetí strany i vypnuté telemetrie. Vypne ji také nastavení disableAllHooks nebo allowManagedHooksOnly a ruční vypnutí toho pluginu v /plugin. A první sezení po instalaci nebo aktualizaci soubor ještě nepřečte, čte se až od dalšího.

V těch případech Claude Code čte jen soubory CLAUDE.md a položka Project instructions se v nastavení vůbec neukáže. Řešení zůstává to, co si lidé vymysleli dřív: vložit AGENTS.md do CLAUDE.md importem. Anthropic k tomu píše, že takový import může zůstat i po aktualizaci, protože při žádném nastavení nevede k dvojímu načtení téhož textu.

Načtený soubor se v přehledu paměti neobjeví

Druhá půlka rozdílu je v tom, co se s přečteným souborem děje dál. Dokumentace to má jako tabulku a ani jedna položka nevyznívá ve prospěch AGENTS.md.

Příkaz /memory a seznam souborů paměti v /context vypíšou CLAUDE.md, kdežto AGENTS.md načtený přes nastavení v nich není; že se použil, se pozná jen z té úvodní řádky sezení, nebo když se na obsah pokynů člověk zeptá přímo. Hooky typu InstructionsLoaded se u něj nespustí, na rozdíl od souboru, který je do CLAUDE.md vtažený importem nebo symbolickým odkazem. Adresáře přidané přepínačem --add-dir vydají svůj CLAUDE.md, svůj AGENTS.md ne.

Jeden rozdíl je přitom spíš pro bezpečnost než proti ní. Když CLAUDE.md importuje soubor mimo pracovní adresář, Claude Code se na svolení zeptá. U AGENTS.md čteného přes nastavení se takový import provede jen tehdy, když uživatel externí importy v tomhle projektu už dřív schválil; sám se Claude Code nezeptá.

Formát má vlastní organizaci a Claude Code v jeho seznamu chybí

Samotný AGENTS.md není novinka. Web agents.md ho popisuje jako otevřený formát pokynů pro programovací agenty – README pro stroj, kam patří příkazy k sestavení, spuštění testů a konvence kódu, které by v README pro lidi překážely. Podle vlastního tvrzení webu ho používá přes 60 tisíc otevřených projektů; nezávislé měření toho čísla nikdo nezveřejnil.

Repozitář formátu vznikl 19. srpna 2025 a dodnes na něj vede adresa github.com/openai/agents.md, která se přesměrovává na dnešní agentsmd/agents.md. Je pod licencí MIT a má 24 517 hvězd. Původ u OpenAI tedy zůstal v adrese, správa je samostatná.

Na seznamu nástrojů, se kterými je formát podle svého webu slučitelný, stojí Gemini CLI a Jules od Googlu, Junie od JetBrains, Factory, Warp, Amp, RooCode, opencode a další. Claude Code mezi nimi ke 21. září není – hledání slova „Claude“ na té stránce nevrátí jediný výskyt.

Pro vývojáře, který střídá víc agentních nástrojů nad týmž repozitářem, je to praktický posun: jeden soubor pokynů místo dvou. Kdo má ale v projektu CLAUDE.md, nepozná ze změny nic – a kdo jede přes Bedrock nebo s vypnutou telemetrií, zůstává u importu, který si musel napsat sám.

Zdroje

• Poznámky k vydání Claude Code – jediná věta o podpoře AGENTS.md u verze 2.1.277
• Dokumentace Claude Code: How Claude remembers your project, staženo 21. 9. 2026 – kdy se soubor čte, nastavení, výjimky a tabulka rozdílů
• Seznam verzí balíčku @anthropic-ai/claude-code na npm – pořadí vydání; přesný čas u verze 2.1.277 dává záznam registru
• agents.md – popis formátu, údaj o 60 tisících projektů a seznam slučitelných nástrojů
• Repozitář agentsmd/agents.md – datum založení, licence a počet hvězd podle rozhraní GitHubu