Claude Code lukee nyt AGENTS.md:tä: mitä muuttui versiossa 2.1.277

18. syyskuuta 2026 Claude Codeen 2.1.277 lisättiin tuki AGENTS.md:lle. Jos ominaisuus on käytettävissä istunnossa ja työhakemistossa eikä missään sen yläpuolella olevassa hakemistoketjun osassa ole tiedostoa CLAUDE.md, .claude/CLAUDE.md tai CLAUDE.local.md, Claude Code lukee oletusarvoisesti AGENTS.md:n ilman manuaalista tuontia. Aiemmin tämä tehtiin tuomalla @AGENTS.md tiedostoon CLAUDE.md tai käyttämällä CLAUDE.md:n symbolista linkkiä tiedostoon AGENTS.md—lisätietoja on artikkelissa yhdestä useille agenteille tarkoitetusta ohjetiedostosta.

Jos käytät Claude Codea ja yhtä tai kahta muuta työkalua samassa repositoriossa, valitsemasi Project instructions -tila määrää, mitä ohjetiedostoja Claude Code lukee. Alla kerrotaan kunkin neljän tilan ehdot ja vaiheet vanhasta asetuksesta siirtymiseen.

Lisää materiaalia työkalujen määrittämisestä on Ailoot-dokumentaatiossa.

Mitä versiossa 2.1.277 muuttui?#

Claude Code -projektin virallisessa GitHubin CHANGELOG.md-tiedostossa asia ilmaistaan näin:

Käännös: tuki AGENTS.md:lle on lisätty—projektissa, jossa ei ole CLAUDE.md:tä, Claude Code lukee nyt sen sijaan AGENTS.md:n; tätä voi vaihtaa kohdassa ”Project instructions” komennolla /config (ei vielä käytettävissä Bedrockissa, Vertexissä tai Foundryssa).

Ennen tätä versiota tiedostojen CLAUDE.md, .claude/CLAUDE.md ja CLAUDE.local.md puuttuminen työhakemistosta ja sen yläpuolelta ei yksinään tarkoittanut, että AGENTS.md luettaisiin. Tarvittiin nimenomainen tuonti, symbolinen linkki tai manuaalinen hook. Nyt agentti hakee tiedoston automaattisesti, kun ominaisuus on käytettävissä.

Mitkä tiedostot estävät AGENTS.md:n automaattisen lukemisen#

Jos sinulla on henkilökohtainen ~/.claude/CLAUDE.md, jossa on koodityyliä koskevia asetuksia, se ei estä Claude Codea lukemasta projektin AGENTS.md:tä. Työhakemistossa oleva CLAUDE.local.md kuitenkin estää oletustilassa AGENTS.md:n automaattisen lukemisen—myös silloin, kun sitä ei ole lisätty Gitiin ja sitä käytetään henkilökohtaisiin muistiinpanoihin. Nimenomainen tuonti toimii edelleen; jos haluat lukea molemmat tiedostot suoraan, sinun on vaihdettava tilaa.

Jos Project instructions -kohdassa on valittuna suoraan lukemiseen tarkoitettu tila (katso alla ”4 Project instructions -tilaa—mikä niistä kannattaa valita?”) eikä työhakemistossa tai sen yläpuolella ole tiedostoa CLAUDE.md, .claude/CLAUDE.md tai CLAUDE.local.md, Claude Code lukee istunnon käynnistyessä kaikki näissä hakemistoissa olevat AGENTS.md- ja .claude/AGENTS.md-tiedostot. Kun estäviä tiedostoja ei ole, dokumentaatiossa näytetään interaktiivisessa istunnossa tällainen rivi:

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

Alahakemistossa oleva AGENTS.md ladataan, kun Claude avaa siellä olevan tiedoston Read-työkalulla. Tilassa claude-md-or-agents-md näin tapahtuu vain, jos kyseisessä alahakemistossa ei ole omaa CLAUDE.md-, .claude/CLAUDE.md- tai CLAUDE.local.md-tiedostoa. Tilasta claude-md-and-agents-md dokumentaatio kuvaa yleisen säännön: CLAUDE.md ja AGENTS.md luetaan yhdessä, ensin CLAUDE.md ja sen jälkeen AGENTS.md jokaisessa hakemistossa. Tiedostoja AGENTS.local.md ja AGENTS.override.md eikä mitään .agents/-hakemistossa olevaa lueta automaattisesti.

Materiaalia tekoälyagentin työtilan määrittämisestä, kuten projektikontekstia sisältävistä ohjetiedostoista, on Ailoot-dokumentaatiossa.

4 Project instructions -tilaa—mikä niistä kannattaa valita?#

Taulukossa kuvattujen tilojen toiminta on esitetty Anthropicin dokumentaatiossa. Oikeanpuoleinen sarake antaa suosituksia tilan valintaan:

Voit valita tilan myös ilman käyttöliittymää settings.json-tiedoston kautta:

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

Claude Code ohittaa tämän arvon project- ja local-asetuksissa. Anthropicin dokumentaation mukaan sen voi määrittää tiedostossa ~/.claude/settings.json, --settings-tiedostossa tai organisaation hallinnoimissa asetuksissa.

Jos olet jo määrittänyt yhteisen ohjetiedoston useille tekoälytyökaluille samassa repositoriossa, versioita 2.1.277 edeltävät ohjeet selittävät, miten @-tuonti toimii. Tämä menetelmä toimii edelleen.

Miksi Project instructions ei näy komennossa /config?#

Tarkista ensin versio komennolla claude --version. Jos se on versiota 2.1.277 vanhempi, päivitä Claude Code. Jos versio on riittävän uusi mutta osiota ei silti näy, tarkista muut edellä mainitut syyt. Kun ominaisuus ei ole käytettävissä, @AGENTS.md:n tuonti tiedostossa CLAUDE.md toimii edelleen vararatkaisuna.

Mitä tehdä vanhalle @AGENTS.md-tuonnille#

Seuraavat vaiheet riippuvat vanhasta asetuksesta. Varmista ensin, että ominaisuus on käytettävissä istunnossasi, kuten edellisessä osiossa kuvataan.

• CLAUDE.md, jossa on @AGENTS.md-tuonti. Voit jättää sen ennalleen—Claude Code ei lue tiedostoa kahdesti millään Project instructions -arvolla. CLAUDE.md:n poistaminen on valinnaista: tuonti antaa Claudelle jo pääsyn AGENTS.md:n sisältöön. Jatka latautumisen tarkistamista tuonnin kautta komennolla /memory; suora kysymys Claudelle ohjeiden sisällöstä on vain heikko tarkistus.
• CLAUDE.md, jossa pyydetään sanallisesti lukemaan AGENTS.md. Tällainen pyyntö ei ole tuonti eikä yksinään takaa tiedoston latautumista. Korvaa sanamuoto @AGENTS.md-tuonnilla, jos haluat pitää CLAUDE.md:n (esimerkiksi työkaluille, jotka lukevat myös sitä). Jos päätät poistaa CLAUDE.md:n kokonaan ja valittuna on tila claude-md-or-agents-md, tarkista ensin, ettei CLAUDE.md sisällä ainutkertaisia ohjeita eikä työhakemistossa tai sen yläpuolella ole muuta tiedostoa CLAUDE.md, .claude/CLAUDE.md tai CLAUDE.local.md; muuten Claude Code lukee jäljelle jäävää tiedostoa AGENTS.md:n sijaan. Kun olet poistanut sen, varmista, että siirtymä on tapahtunut: kun estäviä tiedostoja ei enää ole, interaktiivisessa istunnossa näkyy rivi AGENTS.md loaded. Jos CLAUDE.md jää paikalleen ja molemmat tiedostot luetaan tilassa claude-md-and-agents-md, tarkista /memory (versiossa 2.1.280+). Suora kysymys Claudelle ei erota suoraan lukemista tuonnista.
• CLAUDE.md on symbolinen linkki tiedostoon AGENTS.md. Voit pitää sen: tiedostoa ei lueta kahdesti missään tilassa. Ennen linkin poistamista tilassa claude-md-or-agents-md varmista, että tarvittavat ohjeet on säilytetty ja ettei työhakemistossa tai sen yläpuolella ole muuta tiedostoa CLAUDE.md, .claude/CLAUDE.md tai CLAUDE.local.md. Tarkista latautuminen samalla tavalla: rivi AGENTS.md loaded istunnon alussa, kun estäviä tiedostoja ei ole, tai /memory (2.1.280+). Jos CLAUDE.md jää paikalleen tilassa claude-md-and-agents-md, suora kysymys Claudelle on vain heikko tarkistus. Virheen puuttuminen ei riitä vahvistamaan latautumista.
• SessionStart-hook, joka tulosti AGENTS.md:n sisällön manuaalisesti. Kun tiedosto luetaan suoraan, tällainen hook lisää kontekstiin toisen kopion. Hookin ollessa käytössä kysymys ”mitä ohjeissasi sanotaan?” ei vahvista suoraa latautumista: Claude saattaa vastata hookin lisäämän tekstin perusteella. Siirry uuteen asetukseen tässä järjestyksessä:
  1. Varmista, että ominaisuus on käytettävissä: versio 2.1.277 tai uudempi, istunto saa ominaisuusliput, laajennus on käytössä ja ensimmäinen asennuksen tai päivityksen jälkeinen istunto on päättynyt. Valitse suoraan lukemiseen tarkoitettu tila—älä claude-md- tai managed-only-tilaa. Tarkista oletustilassa myös, ettei estäviä tiedostoja ole.
  2. Poista hook.
  3. Sulje istunto ja avaa uusi. SessionStart-hook lisää tekstinsä käynnistyksen yhteydessä, joten sen sisältö pysyy jo avoimen istunnon kontekstissa. Clauden vastaus ohjeiden sisällöstä tällaisessa istunnossa ei vahvista suoraa latautumista.
  4. Tarkista latautuminen uudessa istunnossa. Versiossa 2.1.280+ AGENTS.md:n polku näkyy komennossa /memory. Versioissa 2.1.277–2.1.279 etsi, jos estäviä tiedostoja ei ole, käynnistyksen yhteydessä riviä AGENTS.md loaded: dokumentaatio kuvaa sen nimenomaan tapaukseen, jossa CLAUDE.md:tä ei löytynyt. Jos pidät CLAUDE.md:n ja käytät tilaa claude-md-and-agents-md, tarkistusmahdollisuudet ovat rajalliset: /memory ei näytä AGENTS.md:tä näissä versioissa, dokumentaatiossa ei kuvata latausriviä tätä tapausta varten, eikä ohjeiden parafraasi erota suoraa lukemista CLAUDE.md:n sisällä olevasta @-tuonnista. Päivitä siinä tapauksessa versioon 2.1.280+ ja tarkista /memory.

Näin tarkistat, että AGENTS.md latautui#

Tavalliseen CLAUDE.md:hen verrattuna on vielä kaksi eroa: InstructionsLoaded-hookit eivät käynnisty tällaisen AGENTS.md:n yhteydessä (ne toimivat kyllä, kun AGENTS.md on tuotu CLAUDE.md:stä @-syntaksilla tai siihen on yhdistetty CLAUDE.md-symbolinen linkki); --add-dir-lipulla lisätyt hakemistot yhdessä muuttujan CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD kanssa lataavat vain kyseisen hakemiston CLAUDE.md:n—sen AGENTS.md ei sisälly mukaan.

Jos sinun on tarkasteltava laajan projektin ohjetiedoston sisältöä, katso erillinen analyysi siitä, miten CLAUDE.md määritetään paisuttamatta sitä. Siinä käsitellään ohjeiden rakennetta; AGENTS.md:n lataamisen ehdot on kuvattu yllä. Istuntojen välisten työmuistiinpanojen osalta katso analyysi toisista aivoista Claude Codessa—henkilökohtaisesta muistista projektiohjeiden päällä.

Mitä seuraavaksi?#

Ominaisuus julkaistiin 18. syyskuuta 2026 versiossa 2.1.277. Anthropic saattaa selventää tilojen yksityiskohtia tulevissa julkaisuissa, joten vertaa tätä artikkelia nykyiseen /config-näkymään ja viralliseen muutoslokiin ennen asetusten muuttamista tärkeässä projektissa.