Claude Code teraz číta AGENTS.md: čo sa zmenilo vo verzii 2.1.277

Dňa 18. septembra 2026 bola do Claude Code 2.1.277 pridaná podpora pre AGENTS.md. Ak je táto funkcia dostupná v relácii aj v pracovnom adresári a nikde v reťazci nadradených adresárov nie je súbor CLAUDE.md, .claude/CLAUDE.md ani CLAUDE.local.md, Claude Code štandardne číta AGENTS.md bez manuálneho importu. Predtým sa to robilo importom @AGENTS.md v súbore CLAUDE.md alebo symbolickým odkazom CLAUDE.md na AGENTS.md — ďalšie podrobnosti nájdete v článku o jednom súbore s pokynmi pre viacero agentov.

Ak v tom istom repozitári používate Claude Code a jeden či dva ďalšie nástroje, režim Project instructions, ktorý si vyberiete, určuje, ktoré súbory s pokynmi Claude Code číta. Nižšie sú uvedené podmienky pre každý zo štyroch režimov a kroky na prechod zo starého nastavenia.

Ďalšie materiály o konfigurácii nástrojov sú k dispozícii v dokumentácii Ailoot.

Čo sa zmenilo vo verzii 2.1.277?#

Oficiálny súbor CHANGELOG.md projektu Claude Code na GitHube to uvádza takto:

Preklad: bola pridaná podpora pre AGENTS.md — v projekte bez súboru CLAUDE.md teraz Claude Code číta namiesto neho súbor AGENTS.md; možno to zmeniť v časti „Project instructions“ v príkaze /config (zatiaľ nie je dostupné v Bedrock, Vertex ani Foundry).

Pred touto verziou samotná absencia súborov CLAUDE.md, .claude/CLAUDE.md a CLAUDE.local.md v pracovnom priečinku a jeho nadradených adresároch nestačila na povolenie čítania súboru AGENTS.md. Bol potrebný explicitný import, symbolický odkaz alebo manuálny hook. Teraz, keď je táto funkcia dostupná, agent súbor načíta automaticky.

Ktoré súbory bránia automatickému čítaniu AGENTS.md#

Ak máte osobný súbor ~/.claude/CLAUDE.md s nastaveniami štýlu kódu, nezabráni Claude Code čítať projektový súbor AGENTS.md. Každý súbor CLAUDE.local.md v pracovnom priečinku — aj taký, ktorý nie je pridaný do Gitu a slúži na osobné poznámky — však v predvolenom režime bráni automatickému čítaniu súboru AGENTS.md. Explicitný import naďalej funguje; ak chcete oba súbory čítať priamo, musíte zmeniť režim.

Ak je v časti Project instructions vybraný režim priameho čítania (pozrite si nižšie časť „4 režimy Project instructions — ktorý si vybrať“) a v pracovnom adresári ani jeho nadradených adresároch nie je súbor CLAUDE.md, .claude/CLAUDE.md ani CLAUDE.local.md, Claude Code pri spustení relácie číta každý súbor AGENTS.md a .claude/AGENTS.md v týchto adresároch. Pre prípad, keď neexistujú blokujúce súbory, dokumentácia v interaktívnej relácii uvádza riadok podobný tomuto:

no CLAUDE.md found; AGENTS.md loaded: /home/you/repo/AGENTS.md

Súbor AGENTS.md v podadresári sa načíta, keď Claude pomocou nástroja Read otvorí súbor v danom adresári. V režime claude-md-or-agents-md sa to stane iba vtedy, keď daný podadresár nemá vlastný súbor CLAUDE.md, .claude/CLAUDE.md ani CLAUDE.local.md. Pre režim claude-md-and-agents-md dokumentácia opisuje všeobecné pravidlo: súbory CLAUDE.md a AGENTS.md sa čítajú spolu, najprv CLAUDE.md a potom AGENTS.md v každom adresári. Súbory AGENTS.local.md, AGENTS.override.md a čokoľvek v adresári .agents/ sa nenačítavajú automaticky.

Materiály o konfigurácii pracovného priestoru agenta AI vrátane súborov s pokynmi obsahujúcimi kontext projektu sú k dispozícii v dokumentácii Ailoot.

4 režimy Project instructions — ktorý si vybrať#

Správanie režimov v tabuľke je opísané v dokumentácii Anthropic. Pravý stĺpec obsahuje odporúčania, ktorý režim si vybrať:

Režim môžete vybrať aj bez rozhrania, prostredníctvom súboru settings.json:

{
  "pluginConfigs": {
    "agents-md@builtin": {
      "options": {
        "instructionFiles": "claude-md-and-agents-md"
      }
    }
  }
}

Claude Code túto hodnotu ignoruje v nastaveniach project a local. Podľa dokumentácie Anthropic ju možno nastaviť v súbore ~/.claude/settings.json, v súbore --settings alebo v nastaveniach spravovaných organizáciou.

Ak ste už v repozitári nastavili spoločný súbor s pokynmi pre viacero nástrojov AI, pokyny pre verzie pred 2.1.277 vysvetľujú, ako funguje import @. Táto metóda funguje aj naďalej.

Prečo v /config chýba Project instructions#

Najprv skontrolujte verziu príkazom claude --version. Ak je staršia než 2.1.277, aktualizujte Claude Code. Ak je verzia vhodná, ale táto časť sa stále nezobrazuje, skontrolujte ostatné vyššie uvedené dôvody. Kým funkcia nie je dostupná, import @AGENTS.md v súbore CLAUDE.md zostáva funkčnou náhradou.

Čo robiť so starým importom @AGENTS.md#

Ďalšie kroky závisia od starého nastavenia. Najprv sa uistite, že je funkcia dostupná vo vašej relácii, ako je opísané v predchádzajúcej časti.

• CLAUDE.md s importom @AGENTS.md. Môžete ho ponechať tak, ako je — Claude Code súbor nenačíta dvakrát pri žiadnej hodnote Project instructions. Odstránenie súboru CLAUDE.md je voliteľné: import už Claude sprístupňuje obsah súboru AGENTS.md. Naďalej kontrolujte načítanie prostredníctvom importu pomocou /memory; priama otázka Claudeovi na obsah pokynov je len slabou kontrolou.
• CLAUDE.md, ktorý slovami žiada prečítať AGENTS.md. Takáto požiadavka nie je importom a sama osebe nezaručuje načítanie súboru. Ak si chcete ponechať CLAUDE.md (napríklad pre nástroje, ktoré ho tiež čítajú), nahraďte túto formuláciu importom @AGENTS.md. Ak sa rozhodnete úplne odstrániť CLAUDE.md a je vybraný režim claude-md-or-agents-md, najprv skontrolujte, že CLAUDE.md neobsahuje jedinečné pokyny a že v pracovnom adresári ani jeho nadradených adresároch nie je ďalší súbor CLAUDE.md, .claude/CLAUDE.md ani CLAUDE.local.md; inak bude Claude Code naďalej čítať zostávajúci súbor namiesto AGENTS.md. Po odstránení sa uistite, že prechod prebehol: keď nezostanú žiadne blokujúce súbory, v interaktívnej relácii sa zobrazí riadok AGENTS.md loaded. Ak súbor CLAUDE.md zostane a v režime claude-md-and-agents-md sa čítajú oba súbory, skontrolujte /memory (vo verzii 2.1.280+). Priama otázka Claudeovi nedokáže odlíšiť priame načítanie od importu.
• Symbolický odkaz CLAUDE.md na AGENTS.md. Môžete si ho ponechať: v žiadnom režime nedôjde k duplicitnému čítaniu. Pred odstránením odkazu v režime claude-md-or-agents-md skontrolujte, či sú potrebné pokyny zachované a či v pracovnom adresári ani jeho nadradených adresároch nie je ďalší súbor CLAUDE.md, .claude/CLAUDE.md ani CLAUDE.local.md. Načítanie skontrolujte rovnakým spôsobom: riadkom AGENTS.md loaded pri spustení relácie, ak neexistujú blokujúce súbory, alebo pomocou /memory (2.1.280+). Ak súbor CLAUDE.md zostane v režime claude-md-and-agents-md, priama otázka Claudeovi je len slabou kontrolou. Neprítomnosť chyby nestačí na potvrdenie načítania.
• Hook SessionStart, ktorý manuálne vypisoval obsah súboru AGENTS.md. Keď sa súbor číta priamo, taký hook pridá do kontextu druhú kópiu. Kým hook beží, otázka „čo obsahujú tvoje pokyny?“ nepotvrdzuje priame načítanie: Claude môže odpovedať na základe textu pridaného hookom. Prejdite na nové nastavenie v tomto poradí:
  1. Skontrolujte, či je funkcia dostupná: verzia 2.1.277 alebo novšia, relácia dostáva príznaky dostupných funkcií, doplnok je povolený a prvá relácia po inštalácii alebo aktualizácii sa skončila. Vyberte režim priameho čítania — ani claude-md, ani managed-only. Pri predvolenom režime skontrolujte tiež, či neexistujú blokujúce súbory.
  2. Odstráňte hook.
  3. Zatvorte reláciu a otvorte novú. Hook SessionStart pridáva svoj text pri spustení, preto jeho obsah zostáva v kontexte už otvorenej relácie. Claudeova odpoveď o obsahu pokynov v takej relácii nepotvrdí priame načítanie.
  4. Skontrolujte načítanie v novej relácii. Vo verzii 2.1.280+ je cesta k súboru AGENTS.md viditeľná v /memory. Vo verziách 2.1.277–2.1.279, ak neexistujú blokujúce súbory, hľadajte pri spustení riadok AGENTS.md loaded: dokumentácia ho uvádza konkrétne pre prípad, keď sa nenašiel súbor CLAUDE.md. Ak si ponecháte CLAUDE.md a použijete režim claude-md-and-agents-md, možnosti kontroly sú obmedzené: /memory v týchto verziách nezobrazuje AGENTS.md, dokumentácia neuvádza riadok o načítaní pre tento prípad a parafráza pokynov nedokáže odlíšiť priame čítanie od importu @ v súbore CLAUDE.md. V takom prípade aktualizujte na verziu 2.1.280+ a skontrolujte /memory.

Ako skontrolovať, či sa AGENTS.md načítal#

Od bežného súboru CLAUDE.md sa líši ešte v dvoch veciach: hooky InstructionsLoaded sa pri tomto type súboru AGENTS.md nespúšťajú (fungujú pri súbore AGENTS.md importovanom pomocou syntaxe @ zo súboru CLAUDE.md alebo pripojenom symbolickým odkazom CLAUDE.md); adresáre pridané pomocou príznaku --add-dir spolu s premennou CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD načítajú iba súbor CLAUDE.md daného adresára — jeho AGENTS.md sa nezahrnie.

Ak potrebujete skontrolovať obsah veľkého súboru s pokynmi projektu, pozrite si samostatnú analýzu ako nakonfigurovať CLAUDE.md bez zbytočného rozširovania. Zaoberá sa štruktúrou pokynov, zatiaľ čo vyššie sú opísané podmienky načítania súboru AGENTS.md. Pracovné poznámky medzi reláciami nájdete v analýze druhého mozgu v Claude Code — o osobnej pamäti navrstvenej na pokyny projektu.

Čo ďalej#

Funkcia bola vydaná 18. septembra 2026 vo verzii 2.1.277. Anthropic môže v budúcich vydaniach objasniť podrobnosti režimov, preto pred zmenou nastavení v dôležitom projekte porovnajte tento článok s aktuálnym príkazom /config a oficiálnym zoznamom zmien.