# Claude Code nyní čte AGENTS.md: co se změnilo ve verzi 2.1.277 > Dne 18. září 2026 získal Claude Code 2.1.277 přímou podporu souboru AGENTS.md: kdy se soubor načítá, jak vybrat jeden ze 4 režimů a co dělat s importy. Source: https://ailoot.ai/blog/cs/claude-code-agents-md-support/ Canonical: https://ailoot.ai/blog/cs/claude-code-agents-md-support/ Language: cs Publisher: Ailoot (https://ailoot.ai/) Translation: guide-041 Revision: sha256-c16ace8f8c890c4ab85ef8efc3fbc44dc2a543de03ba13b540d1b89eb345cf67 Dne 18. září 2026 byla do Claude Code přidána podpora `AGENTS.md`. Pokud je tato funkce v relaci dostupná a v pracovním adresáři není v žádném z nadřazených adresářů `CLAUDE.md`, `.claude/CLAUDE.md` ani `CLAUDE.local.md`, Claude Code ve výchozím nastavení čte `AGENTS.md` bez ručního importu. Dříve se to řešilo importem `@AGENTS.md` v `CLAUDE.md` nebo symbolickým odkazem `CLAUDE.md` na `AGENTS.md`—podrobnosti najdete v článku [o jednom souboru s pokyny pro více agentů](https://ailoot.ai/blog/cs/agents-md-claude-md-one-instruction-file/). Pokud používáte Claude Code a jeden nebo dva další nástroje ve stejném repozitáři, režim Project instructions, který zvolíte, určuje, které soubory s pokyny Claude Code čte. Níže jsou uvedeny podmínky pro všechny čtyři režimy a kroky pro přechod ze starého nastavení. Další materiály o konfiguraci nástrojů najdete v [dokumentaci Ailoot](https://ailoot.ai/docs/).
[Návody Ailoot](https://ailoot.ai/docs/)
## Co se změnilo v Claude Code 2.1.277?
Hlavní poznatek Od 18. září 2026 Claude Code ve výchozím nastavení čte `AGENTS.md`, pokud v žádném z adresářů od pracovního adresáře směrem nahoru není `CLAUDE.md`, `.claude/CLAUDE.md` ani `CLAUDE.local.md`. Pokud takový soubor existuje, automatické čtení `AGENTS.md` prostřednictvím Project instructions není zapnuté. Výslovný import `@AGENTS.md` z `CLAUDE.md` nadále funguje. Uživatelský `~/.claude/CLAUDE.md`, soubory `CLAUDE.md` spravované organizací a soubory `.claude/rules/` se načítají nezávisle na volbě mezi projektovými soubory. Režim se mění pomocí `/config`. Tato funkce zatím není dostupná na Bedrocku, Vertexu ani Foundry.
Oficiální soubor projektu Claude Code CHANGELOG.md na GitHubu to popisuje takto:

Přidána podpora AGENTS.md: v projektu bez CLAUDE.md čte Claude Code místo něj AGENTS.md; změnu proveďte v části „Project instructions“ v /config (zatím není dostupné na Bedrocku, Vertexu ani Foundry)

— Anthropic, commit CHANGELOG.md claude-code, ca02e7d, https://github.com/anthropics/claude-code/commit/ca02e7deeb0707f558b0afd7e9e5d67a382e12b3
Překlad: byla přidána podpora `AGENTS.md`—v projektu bez `CLAUDE.md` nyní Claude Code čte místo něj `AGENTS.md`; lze to změnit v části „Project instructions“ v `/config` (zatím není dostupné na Bedrocku, Vertexu ani Foundry). Před touto verzí samotná nepřítomnost souborů `CLAUDE.md`, `.claude/CLAUDE.md` a `CLAUDE.local.md` v pracovním adresáři a nad ním neumožňovala čtení `AGENTS.md`. Byl potřeba výslovný import, symbolický odkaz nebo ruční hook. Nyní agent soubor načte automaticky, pokud je funkce dostupná. ## Které soubory brání automatickému čtení AGENTS.md v Claude Code?
Hlavní poznatek Ve výchozím režimu se v pracovním adresáři a nad ním kontrolují soubory `CLAUDE.md`, `.claude/CLAUDE.md` a `CLAUDE.local.md`. Osobní `~/.claude/CLAUDE.md`, soubory `CLAUDE.md` spravované organizací a soubory `.claude/rules/` nebrání čtení `AGENTS.md` a načítají se spolu s ním.
Pokud máte osobní `~/.claude/CLAUDE.md` s nastavením stylu kódování, nebude Claude Code bránit ve čtení projektového `AGENTS.md`. Automatickému čtení `AGENTS.md` ve výchozím režimu však brání jakýkoli `CLAUDE.local.md` v pracovním adresáři—i ten, který není přidán do Gitu a slouží k osobním poznámkám. Výslovný import nadále funguje; pokud chcete číst oba soubory přímo, je třeba změnit režim. Pokud je v části Project instructions vybrán režim přímého čtení (viz „4 režimy Project instructions—který vybrat“ níže) a v pracovním adresáři ani nad ním není `CLAUDE.md`, `.claude/CLAUDE.md` nebo `CLAUDE.local.md`, Claude Code při spuštění relace přečte všechny soubory `AGENTS.md` a `.claude/AGENTS.md` v těchto adresářích. V případě, kdy žádný soubor čtení neblokuje, dokumentace ukazuje podobný řádek v interaktivní relaci: ``` no CLAUDE.md found; AGENTS.md loaded: /home/you/repo/AGENTS.md ``` Soubor `AGENTS.md` v podadresáři se načte, když Claude otevře soubor v tomto adresáři pomocí nástroje Read. V režimu `claude-md-or-agents-md` k tomu dojde pouze tehdy, pokud tento podadresář nemá vlastní `CLAUDE.md`, `.claude/CLAUDE.md` ani `CLAUDE.local.md`. Pro režim `claude-md-and-agents-md` dokumentace popisuje obecné pravidlo: `CLAUDE.md` a `AGENTS.md` se čtou společně, nejprve `CLAUDE.md` a potom `AGENTS.md` v každém adresáři. Soubory `AGENTS.local.md`, `AGENTS.override.md` ani nic v adresáři `.agents/` se automaticky nečte. Materiály o konfiguraci pracovního prostoru AI agenta, včetně souborů s pokyny obsahujících kontext projektu, najdete v [dokumentaci Ailoot](https://ailoot.ai/docs/).
[Návody Ailoot](https://ailoot.ai/docs/)
## 4 režimy Project instructions—který vybrat
Hlavní poznatek V části Project instructions příkazu `/config` jsou čtyři hodnoty: `claude-md-or-agents-md` (výchozí—jeden z těchto dvou souborů), `claude-md-and-agents-md` (oba společně), `claude-md` (automaticky se čte pouze `CLAUDE.md`, i když projekt obsahuje jen `AGENTS.md`) a `managed-only` (při spuštění pouze `CLAUDE.md` spravovaný organizací a automatická paměť, bez projektových nebo osobních souborů). Změna se projeví od další odeslané zprávy a v každé nové relaci.
Chování režimů v tabulce popisuje dokumentace Anthropic. Pravý sloupec uvádí doporučení, kdy který režim zvolit: | Hodnota | Co Claude Code čte | Kdy režim použít | |----|----|----| | `claude-md-or-agents-md` | `CLAUDE.md`, nebo `AGENTS.md`, pokud v pracovním adresáři ani nad ním není `CLAUDE.md`, `.claude/CLAUDE.md` ani `CLAUDE.local.md` | Výchozí režim, pokud repozitář používá jen jeden z těchto dvou souborů a nad ním nejsou žádné blokující soubory | | `claude-md-and-agents-md` | Oba soubory společně: v každém adresáři nejprve `CLAUDE.md` a pak `AGENTS.md` | Potřebujete sdílený `AGENTS.md` pro všechny nástroje a krátký `CLAUDE.md` pouze pro Claude; nebo potřebujete číst `AGENTS.md`, když existuje `CLAUDE.local.md` | | `claude-md` | Pouze `CLAUDE.md`; automatické čtení `AGENTS.md` prostřednictvím Project instructions je vypnuté, i když je `AGENTS.md` jediným souborem (výslovný import `@AGENTS.md` z `CLAUDE.md` však nadále funguje) | `AGENTS.md` je určený pro jiný nástroj a mohl by Claude mást | | `managed-only` | Při spuštění relace pouze `CLAUDE.md` spravovaný organizací a automatická paměť; projektové, místní a uživatelské soubory `CLAUDE.md`, `.claude/rules/` a všechny soubory `AGENTS.md` jsou vyloučeny z počáteční sady. Soubory `CLAUDE.md` a `.claude/rules/` v podadresářích se však načtou později, když v nich Claude otevře soubor. Tento režim omezuje počáteční sadu a neposkytuje úplnou izolaci od projektových souborů | Pro organizace, které chtějí ovlivnit, s jakou sadou pokynů Claude Code zahájí relaci, bez ohledu na to, zda projekt obsahuje `CLAUDE.md` nebo `AGENTS.md` | Režim můžete zvolit také bez rozhraní, pomocí `settings.json`: ```json { "pluginConfigs": { "agents-md@builtin": { "options": { "instructionFiles": "claude-md-and-agents-md" } } } } ``` Claude Code tuto hodnotu ignoruje v nastavení `project` a `local`. Podle dokumentace Anthropic ji lze nastavit v `~/.claude/settings.json`, v souboru `--settings` nebo v nastavení spravovaném organizací. Pokud jste už v jednom repozitáři nastavili sdílený soubor s pokyny pro několik AI nástrojů, [pokyny pro verze před 2.1.277](https://ailoot.ai/blog/cs/agents-md-claude-md-one-instruction-file/) vysvětlují, jak funguje import `@`. Tato metoda funguje i nadále. ## Proč v /config není Project instructions
Hlavní poznatek Podle dokumentace Anthropic může část Project instructions chybět z těchto důvodů: - Claude Code je ve verzi starší než 2.1.277. - Relace nedostává příznaky funkcí od Anthropic—například při používání Bedrocku, jiného poskytovatele třetí strany nebo při vypnuté telemetrii. - Jde o první relaci bezprostředně po instalaci nebo aktualizaci ze starší verze. Pokud je to jediný důvod, funkce se objeví v další relaci. Samotný `AGENTS.md` se načte pouze při splnění podmínek vybraného režimu. - Vestavěný plugin `agents-md` je vypnutý v `/plugin`.
Nejprve zkontrolujte verzi příkazem `claude --version`. Pokud je starší než 2.1.277, aktualizujte Claude Code. Pokud je verze dostačující, ale tato část se stále nezobrazuje, zkontrolujte ostatní výše uvedené důvody. Dokud funkce není dostupná, zůstává funkční záložní možností import `@AGENTS.md` v `CLAUDE.md`. ## Co dělat se starým importem @AGENTS.md
Hlavní poznatek Import `@AGENTS.md` v `CLAUDE.md` i symbolický odkaz můžete ponechat: v žádném režimu se soubor nenačte dvakrát. Textovou žádost o „přečtení AGENTS.md“ byste měli nahradit importem, pokud si `CLAUDE.md` ponecháte. Před smazáním souboru uložte všechny potřebné pokyny a zkontrolujte podmínky vybraného režimu. Pokud přejdete na přímé čtení, odstraňte všechny hooky `SessionStart`, které ručně vypisovaly obsah `AGENTS.md`; jinak se do kontextu dostane druhá kopie souboru. Poté ověřte načtení v nové relaci; způsob ověření závisí na verzi a na tom, zda existují blokující soubory.
Další kroky závisí na původním nastavení. Nejprve se ujistěte, že je funkce ve vaší relaci dostupná, jak je popsáno v předchozí části. - **`CLAUDE.md` s importem `@AGENTS.md`.** Můžete ho ponechat tak, jak je—Claude Code soubor nenačte dvakrát při žádné hodnotě Project instructions. Smazání `CLAUDE.md` je volitelné: import už Claude zpřístupňuje obsah `AGENTS.md`. Načítání prostřednictvím importu dál kontrolujte pomocí `/memory`; přímá otázka Claudeovi na obsah pokynů je pouze slabým ověřením. - **`CLAUDE.md`, který slovně žádá o přečtení `AGENTS.md`.** Taková žádost není import a sama o sobě nezaručuje načtení souboru. Pokud si chcete `CLAUDE.md` ponechat (například kvůli nástrojům, které ho také čtou), nahraďte formulaci importem `@AGENTS.md`. Pokud se rozhodnete `CLAUDE.md` úplně smazat a máte vybraný režim `claude-md-or-agents-md`, nejprve ověřte, že `CLAUDE.md` neobsahuje žádné jedinečné pokyny a že v pracovním adresáři ani nad ním není žádný další `CLAUDE.md`, `.claude/CLAUDE.md` ani `CLAUDE.local.md`; jinak bude Claude Code dál číst zbývající soubor místo `AGENTS.md`. Po jeho smazání ověřte, že k přechodu došlo: pokud nezůstaly žádné blokující soubory, v interaktivní relaci se zobrazí řádek `AGENTS.md loaded`. Pokud `CLAUDE.md` zůstane a v režimu `claude-md-and-agents-md` se čtou oba soubory, zkontrolujte `/memory` (ve verzi 2.1.280+). Přímá otázka Claudeovi nerozliší přímé načtení od importu. - **Symbolický odkaz `CLAUDE.md` na `AGENTS.md`.** Můžete ho ponechat: v žádném režimu nedojde k duplicitnímu čtení. Před smazáním odkazu v režimu `claude-md-or-agents-md` ověřte, že jsou potřebné pokyny zachovány a že v pracovním adresáři ani nad ním není jiný `CLAUDE.md`, `.claude/CLAUDE.md` ani `CLAUDE.local.md`. Načítání ověřte stejným způsobem: řádkem `AGENTS.md loaded` při spuštění relace, pokud nejsou blokující soubory, nebo pomocí `/memory` (2.1.280+). Pokud v režimu `claude-md-and-agents-md` zůstane `CLAUDE.md`, přímá otázka Claudeovi je pouze slabým ověřením. Nepřítomnost chyby nestačí k potvrzení načtení. - **Hook `SessionStart`, který ručně vypisoval obsah `AGENTS.md`.** Při přímém čtení takový hook přidává do kontextu druhou kopii. Dokud hook běží, otázka „co obsahují vaše pokyny?“ nepotvrzuje přímé načtení: Claude může odpovědět na základě textu přidaného hookem. Přepněte v tomto pořadí: 1. Ověřte, že je funkce dostupná: verze 2.1.277 nebo vyšší, relace dostává příznaky funkcí, plugin je zapnutý a první relace po instalaci nebo aktualizaci už proběhla. Zvolte režim přímého čtení—ani `claude-md`, ani `managed-only`. U výchozího režimu navíc ověřte, že neexistují blokující soubory. 2. Odstraňte hook. 3. Ukončete relaci a otevřete novou. Hook `SessionStart` přidává svůj text při spuštění, takže v právě otevřené relaci zůstane jeho obsah v kontextu. Claudeova odpověď na otázku o obsahu pokynů v takové relaci přímé načtení nepotvrdí. 4. Ověřte načtení v nové relaci. Ve verzi 2.1.280+ je cesta k `AGENTS.md` viditelná v `/memory`. Ve verzích 2.1.277–2.1.279, pokud nejsou blokující soubory, hledejte při spuštění řádek `AGENTS.md loaded`: dokumentace ho popisuje konkrétně pro případ, kdy nebyl nalezen žádný `CLAUDE.md`. Pokud si ponecháte `CLAUDE.md` a použijete režim `claude-md-and-agents-md`, možnosti ověření jsou omezené: v těchto verzích `/memory` `AGENTS.md` nezobrazuje, dokumentace pro tento případ nepopisuje řádek o načtení a parafráze pokynů nedokáže rozlišit přímé čtení od importu `@` uvnitř `CLAUDE.md`. V takovém případě aktualizujte na verzi 2.1.280+ a zkontrolujte `/memory`. ## Jak ověřit, že se načetl AGENTS.md
Hlavní poznatek Od verze 2.1.280 se `AGENTS.md` načtený prostřednictvím Project instructions zobrazuje v `/memory` a v seznamu souborů Memory příkazu `/context`. Ve verzích 2.1.277–2.1.279 se tam nezobrazuje, přestože samotné příkazy fungují a ukazují načtené `CLAUDE.md` a další soubory paměti. V těchto verzích, pokud nejsou blokující soubory, zkontrolujte při spuštění relace řádek `AGENTS.md loaded`. Dotaz na obsah pokynů Claudeovi je pouze slabým ověřením: odpověď nerozliší přímé čtení od importu `@` a může vycházet z textu přidaného hookem `SessionStart`. Proto má smysl se ptát až v nové relaci po odstranění takového hooku.
Od běžného `CLAUDE.md` se liší ještě ve dvou ohledech: hooky `InstructionsLoaded` se pro tento typ `AGENTS.md` nespouštějí (fungují pro `AGENTS.md` importovaný syntaxí `@` z `CLAUDE.md` nebo připojený symbolickým odkazem `CLAUDE.md`); adresáře přidané příznakem `--add-dir` spolu s proměnnou `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD` načítají pouze `CLAUDE.md` z daného adresáře—jeho `AGENTS.md` zahrnut není. Pokud potřebujete zkontrolovat obsah rozsáhlého souboru s projektovými pokyny, přečtěte si samostatnou analýzu [o konfiguraci CLAUDE.md bez zbytečného nabobtnání](https://ailoot.ai/blog/cs/claude-md-template/). Zabývá se strukturou pokynů, zatímco podmínky načítání `AGENTS.md` jsou popsány výše. Pro pracovní poznámky mezi relacemi si přečtěte analýzu [o druhém mozku v Claude Code](https://ailoot.ai/blog/cs/claude-code-second-brain/)—pojednává o osobní paměti navrstvené na projektové pokyny. ## Co dál Funkce byla vydána 18. září 2026 ve verzi 2.1.277. Anthropic může podrobnosti režimů v budoucích vydáních upřesnit, proto před změnou nastavení v důležitém projektu porovnejte tento článek s aktuálním `/config` a oficiálním changelogem.
### Zdroje - [Claude Code, commit CHANGELOG.md se záznamem o verzi 2.1.277 na GitHubu (18. září 2026)](https://github.com/anthropics/claude-code/commit/ca02e7deeb0707f558b0afd7e9e5d67a382e12b3) - [Dokumentace Claude Code: Jak si Claude pamatuje váš projekt – část AGENTS.md](https://code.claude.com/docs/en/memory)
[Návody Ailoot](https://ailoot.ai/docs/)
[Přejděte na Ailoot](https://ailoot.ai/)
## Časté otázky ### Proč se AGENTS.md nenačítá, i když soubor existuje? Ve výchozím režimu soubor CLAUDE.md, .claude/CLAUDE.md nebo CLAUDE.local.md v pracovním či nadřazeném adresáři blokuje automatický výběr AGENTS.md. Ověřte také verzi Claude Code, dostupnost funkce a režim Project instructions v /config. ### Jak ověřit přímé načítání po odstranění ručního hooku? Otevřete novou relaci bez starého výstupu SessionStart. Od verze 2.1.280 zkontrolujte /memory nebo seznam Memory files v /context; ve verzích 2.1.277–2.1.279 se při absenci blokujících CLAUDE.md uplatní úvodní řádek načítání. Samotná parafráze od Claude je slabým důkazem. ## Ailoot · Společnost a její portfolio projektů Ailoot staví na dlouhodobých provozních zkušenostech, široké klientské základně, stabilních službách a průběžném sledování KPI. Společnost a její portfolio projektů: miliony zákazníků; měsíční tržby v miliardách. Ailoot využívá tyto provozní zkušenosti k poskytování přístupu přes API k funkcím AI v produktech zákazníků, agentech, aplikacích a automatizacích.