Claude Code nyní čte AGENTS.md: co se změnilo ve verzi 2.1.277

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ů.

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.

Co se změnilo v Claude Code 2.1.277?#

Oficiální soubor projektu Claude Code CHANGELOG.md na GitHubu to popisuje takto:

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?#

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.

4 režimy Project instructions—který vybrat#

Chování režimů v tabulce popisuje dokumentace Anthropic. Pravý sloupec uvádí doporučení, kdy který režim zvolit:

Režim můžete zvolit také bez rozhraní, pomocí settings.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 vysvětlují, jak funguje import @. Tato metoda funguje i nadále.

Proč v /config není Project instructions#

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#

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#

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í. 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—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.