Claude Code zdaj bere AGENTS.md: kaj se je spremenilo v različici 2.1.277

Podpora za AGENTS.md je bila dodana v Claude Code 2.1.277, 18. septembra 2026. Če je funkcija na voljo v seji in delovnem imeniku ter v verigi imenikov nad njim nikjer ni datoteke CLAUDE.md, .claude/CLAUDE.md ali CLAUDE.local.md, Claude Code privzeto prebere AGENTS.md brez ročnega uvoza. Prej je bilo to mogoče z uvozom @AGENTS.md v datoteki CLAUDE.md ali s simbolno povezavo CLAUDE.md do datoteke AGENTS.md — več podrobnosti najdete v članku o eni datoteki z navodili za več agentov.

Če v istem repozitoriju uporabljate Claude Code in še eno ali dve orodji, izbrani način Project instructions določa, katere datoteke z navodili Claude Code prebere. Spodaj so pogoji za vse štiri načine in koraki za prehod s stare nastavitve.

Več gradiv o konfiguriranju orodij je na voljo v dokumentaciji Ailoot.

Kaj se je spremenilo v različici 2.1.277?#

Uradna datoteka CHANGELOG.md projekta Claude Code na GitHubu to opisuje takole:

Prevod: dodana je podpora za AGENTS.md — v projektu brez datoteke CLAUDE.md Claude Code zdaj namesto nje bere AGENTS.md; to lahko spremenite v razdelku »Project instructions« v /config (za zdaj še ni na voljo v Bedrocku, Vertexu ali Foundryju).

Pred to različico sama odsotnost datotek CLAUDE.md, .claude/CLAUDE.md in CLAUDE.local.md v delovni mapi in nad njo ni omogočila branja AGENTS.md. Potreben je bil izrecni uvoz, simbolna povezava ali ročni hook. Zdaj agent datoteko samodejno prebere, če je funkcija na voljo.

Katere datoteke preprečujejo samodejno branje AGENTS.md#

Če imate osebno datoteko ~/.claude/CLAUDE.md z nastavitvami sloga kodiranja, to Claude Codeu ne bo preprečilo branja projektne datoteke AGENTS.md. Toda katera koli datoteka CLAUDE.local.md v delovni mapi — tudi če ni dodana v Git in jo uporabljate za osebne zapiske — preprečuje samodejno branje AGENTS.md v privzetem načinu. Izrecni uvoz še naprej deluje; če želite obe datoteki brati neposredno, morate preklopiti način.

Če je v razdelku Project instructions izbran način neposrednega branja (glejte »4 načini Project instructions — katerega izbrati« spodaj) in v delovnem imeniku ali nad njim ni datoteke CLAUDE.md, .claude/CLAUDE.md ali CLAUDE.local.md, Claude Code ob začetku seje prebere vse datoteke AGENTS.md in .claude/AGENTS.md v teh imenikih. Če ni datotek, ki bi to preprečevale, dokumentacija prikazuje takšno vrstico v interaktivni seji:

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

Datoteka AGENTS.md v podimeniku se naloži, ko Claude z orodjem Read odpre datoteko v njem. V načinu claude-md-or-agents-md se to zgodi samo, če ta podimenik nima lastne datoteke CLAUDE.md, .claude/CLAUDE.md ali CLAUDE.local.md. Za način claude-md-and-agents-md dokumentacija opisuje splošno pravilo: CLAUDE.md in AGENTS.md se prebereta skupaj, v vsakem imeniku najprej CLAUDE.md, nato AGENTS.md. Datoteke AGENTS.local.md, AGENTS.override.md in vsebina imenika .agents/ se ne berejo samodejno.

Gradiva o konfiguriranju delovnega prostora agenta umetne inteligence, vključno z datotekami z navodili, ki vsebujejo kontekst projekta, so na voljo v dokumentaciji Ailoot.

4 načini Project instructions — katerega izbrati#

Delovanje načinov v tabeli je opisano v dokumentaciji Anthropic. Desni stolpec vsebuje priporočila za izbiro:

Način lahko izberete tudi brez vmesnika, prek datoteke settings.json:

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

Claude Code to vrednost prezre v nastavitvah project in local. Po dokumentaciji Anthropic jo je mogoče nastaviti v datoteki ~/.claude/settings.json, v datoteki --settings ali v organizacijsko upravljanih nastavitvah.

Če ste v enem repozitoriju že nastavili skupno datoteko z navodili za več orodij umetne inteligence, navodila za različice pred 2.1.277 pojasnjujejo, kako deluje uvoz @. Ta način deluje še danes.

Zakaj v /config ni razdelka Project instructions#

Najprej preverite različico z ukazom claude --version. Če je starejša od 2.1.277, posodobite Claude Code. Če je različica ustrezna, vendar se razdelek še vedno ne prikaže, preverite druge zgoraj navedene razloge. Dokler funkcija ni na voljo, je uvoz @AGENTS.md v CLAUDE.md še vedno delujoča rešitev.

Kaj storiti s starim uvozom @AGENTS.md#

Naslednji koraki so odvisni od stare nastavitve. Najprej se prepričajte, da je funkcija v seji na voljo, kot je opisano v prejšnjem razdelku.

• CLAUDE.md z uvozom @AGENTS.md. Lahko ga pustite takšnega, kot je — Claude Code datoteke ne bo prebral dvakrat pri nobeni vrednosti Project instructions. Brisanje datoteke CLAUDE.md ni obvezno: uvoz že omogoča Claudu dostop do vsebine datoteke AGENTS.md. Nalaganje prek uvoza še naprej preverjajte z ukazom /memory; neposredno vprašanje Claudu o vsebini navodil je le šibek preizkus.
• CLAUDE.md z besedilno zahtevo za branje AGENTS.md. Takšna zahteva ni uvoz in sama po sebi ne zagotavlja, da bo datoteka naložena. Če želite obdržati CLAUDE.md (na primer za orodja, ki jo prav tako berejo), besedilo zamenjajte z uvozom @AGENTS.md. Če se odločite, da boste v celoti izbrisali CLAUDE.md in je izbran način claude-md-or-agents-md, najprej preverite, da CLAUDE.md ne vsebuje edinstvenih navodil ter da v delovnem imeniku ali nad njim ni druge datoteke CLAUDE.md, .claude/CLAUDE.md ali CLAUDE.local.md; sicer bo Claude Code namesto datoteke AGENTS.md še naprej bral preostalo datoteko. Po brisanju preverite, ali je prehod uspel: ko ne ostane nobena datoteka, ki bi to preprečevala, se v interaktivni seji prikaže vrstica AGENTS.md loaded. Če datoteka CLAUDE.md ostane in se obe datoteki bereta v načinu claude-md-and-agents-md, preverite z ukazom /memory (v različici 2.1.280 ali novejši). Neposredno vprašanje Claudu ne more razlikovati med neposrednim branjem in uvozom.
• Simbolna povezava CLAUDE.md do datoteke AGENTS.md. Lahko jo obdržite: v nobenem načinu ne bo podvojenega branja. Preden povezavo izbrišete v načinu claude-md-or-agents-md, preverite, ali so potrebna navodila ohranjena in ali v delovnem imeniku ali nad njim ni druge datoteke CLAUDE.md, .claude/CLAUDE.md ali CLAUDE.local.md. Nalaganje preverite enako: z vrstico AGENTS.md loaded ob začetku seje, če ni datotek, ki bi to preprečevale, ali z ukazom /memory (2.1.280+). Če datoteka CLAUDE.md ostane v načinu claude-md-and-agents-md, je neposredno vprašanje Claudu le šibek preizkus. Odsotnost napake ni dovolj za potrditev, da je bila datoteka naložena.
• Hook SessionStart, ki je ročno izpisal vsebino datoteke AGENTS.md. Ko se datoteka bere neposredno, tak hook v kontekst doda njeno drugo kopijo. Med delovanjem hooka vprašanje »kaj piše v vaših navodilih?« ne potrjuje neposrednega branja: Claude lahko odgovori na podlagi besedila, ki ga je dodal hook. Prehod izvedite v tem vrstnem redu:
  1. Preverite, ali je funkcija na voljo: različica 2.1.277 ali novejša, seja prejema zastavice funkcij, vtičnik je omogočen in prva seja po namestitvi ali posodobitvi je končana. Izberite način neposrednega branja — ne claude-md ali managed-only. Pri privzetem načinu preverite tudi, da ni datotek, ki bi to preprečevale.
  2. Odstranite hook.
  3. Zaprite sejo in odprite novo. Hook SessionStart doda besedilo ob zagonu, zato njegova vsebina ostane v kontekstu že odprte seje. Claudeov odgovor o vsebini navodil v taki seji ne bo potrdil neposrednega branja.
  4. Preverite nalaganje v novi seji. V različici 2.1.280 ali novejši je pot do datoteke AGENTS.md vidna v ukazu /memory. V različicah 2.1.277–2.1.279, če ni datotek, ki bi to preprečevale, ob zagonu poiščite vrstico AGENTS.md loaded: dokumentacija jo opisuje posebej za primer, ko datoteka CLAUDE.md ni bila najdena. Če obdržite datoteko CLAUDE.md in uporabljate način claude-md-and-agents-md, je preverjanje omejeno: v teh različicah /memory ne prikazuje datoteke AGENTS.md, dokumentacija ne opisuje vrstice o njenem nalaganju za ta primer, parafraza navodil pa ne more razlikovati med neposrednim branjem in uvozom @ v datoteki CLAUDE.md. V tem primeru posodobite na različico 2.1.280 ali novejšo in preverite z ukazom /memory.

Kako preveriti, ali se je AGENTS.md naložil#

Od običajne datoteke CLAUDE.md se razlikujeta še dve stvari: hooki InstructionsLoaded se za tovrstno datoteko AGENTS.md ne sprožijo (delujejo pa za datoteke AGENTS.md, uvožene s sintakso @ iz datoteke CLAUDE.md ali povezane s simbolno povezavo CLAUDE.md); imeniki, dodani z zastavico --add-dir skupaj s spremenljivko CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD, naložijo samo datoteko CLAUDE.md tega imenika — njegova datoteka AGENTS.md ni vključena.

Če želite pregledati vsebino velike datoteke s projektnimi navodili, glejte ločeno analizo o tem, kako konfigurirati datoteko CLAUDE.md, ne da bi postala preobsežna. Obravnava strukturo navodil, zgoraj pa so opisani pogoji za nalaganje datoteke AGENTS.md. Za delovne zapiske med sejami glejte analizo o drugem možganu v Claude Code — o osebnem pomnilniku, dodanem projektnim navodilom.

Kaj sledi#

Funkcija je bila izdana 18. septembra 2026 v različici 2.1.277. Anthropic lahko v prihodnjih izdajah dodatno pojasni podrobnosti načinov, zato pred spreminjanjem nastavitev v pomembnem projektu ta članek primerjajte s trenutno nastavitvijo /config in uradnim dnevnikom sprememb.