# Claude Code lukee nyt AGENTS.md:tä: mitä muuttui versiossa 2.1.277
> 18. syyskuuta 2026 Claude Code 2.1.277 sai suoran tuen AGENTS.md:lle: milloin tiedosto ladataan, miten valitaan yksi neljästä tilasta ja mitä tuonneille pitää tehdä.
Source: https://ailoot.ai/blog/fi/claude-code-agents-md-support/
Canonical: https://ailoot.ai/blog/fi/claude-code-agents-md-support/
Language: fi
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-041
Revision: sha256-631d0ed483aeed6756e0f2b265d5b787f16dbcc88f0188fb548b4c91c72a6ef4
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](https://ailoot.ai/blog/fi/agents-md-claude-md-one-instruction-file/).
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](https://ailoot.ai/docs/).
[Ailoot Guides](https://ailoot.ai/docs/)
## Mitä versiossa 2.1.277 muuttui?
Keskeinen huomio
18. syyskuuta 2026 alkaen Claude Code lukee oletusarvoisesti `AGENTS.md`:n, jos työhakemistosta ylöspäin kulkevassa hakemistoketjussa ei ole tiedostoa `CLAUDE.md`, `.claude/CLAUDE.md` tai `CLAUDE.local.md`. Jos jokin tällainen tiedosto on olemassa, `AGENTS.md`:n automaattinen lukeminen Project instructions -asetuksen kautta ei ole käytössä. Nimenomainen `@AGENTS.md`-tuonti tiedostosta `CLAUDE.md` toimii edelleen. Käyttäjätason `~/.claude/CLAUDE.md`, organisaation hallinnoima `CLAUDE.md` ja `.claude/rules/` ladataan riippumatta siitä, kumpi projektitiedostoista valitaan. Tila vaihdetaan komennolla `/config`. Ominaisuus ei ole vielä käytettävissä Bedrockissa, Vertexissä tai Foundryssa.
Claude Code -projektin virallisessa GitHubin CHANGELOG.md-tiedostossa asia ilmaistaan näin:
Lisätty AGENTS.md-tuki: projektissa, jossa ei ole CLAUDE.md:tä, Claude Code lukee sen sijaan AGENTS.md:n; muuta tätä kohdassa "Project instructions" komennolla /config (ei vielä käytettävissä Bedrockissa, Vertexissä tai Foundryssa)
— Anthropic, claude-code CHANGELOG.md -sitoumus, ca02e7d, https://github.com/anthropics/claude-code/commit/ca02e7deeb0707f558b0afd7e9e5d67a382e12b3
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
Keskeinen huomio
Oletustilassa työhakemistosta ja sen yläpuolelta tarkistetaan tiedostot `CLAUDE.md`, `.claude/CLAUDE.md` ja `CLAUDE.local.md`. Henkilökohtainen `~/.claude/CLAUDE.md`, organisaation hallinnoimat `CLAUDE.md`-tiedostot ja `.claude/rules/`-tiedostot eivät estä `AGENTS.md`:n lukemista, vaan ne ladataan sen rinnalla.
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](https://ailoot.ai/docs/).
[Ailoot Guides](https://ailoot.ai/docs/)
## 4 Project instructions -tilaa—mikä niistä kannattaa valita?
Keskeinen huomio
Komennon `/config` Project instructions -osiossa on neljä arvoa: `claude-md-or-agents-md` (oletus—jompikumpi tiedostoista), `claude-md-and-agents-md` (molemmat yhdessä), `claude-md` (vain `CLAUDE.md` luetaan automaattisesti, vaikka projektissa olisi vain `AGENTS.md`) ja `managed-only` (käynnistyksessä vain organisaation hallinnoima `CLAUDE.md` ja automaattinen muisti; ei projekti- tai henkilökohtaisia tiedostoja). Muutos tulee voimaan seuraavasta lähetetystä viestistä alkaen ja jokaisessa uudessa istunnossa.
Taulukossa kuvattujen tilojen toiminta on esitetty Anthropicin dokumentaatiossa. Oikeanpuoleinen sarake antaa suosituksia tilan valintaan:
| Arvo | Mitä Claude Code lukee | Milloin käyttää |
|----|----|----|
| `claude-md-or-agents-md` | `CLAUDE.md` tai `AGENTS.md`, jos työhakemistossa tai sen yläpuolella ei ole tiedostoa `CLAUDE.md`, `.claude/CLAUDE.md` tai `CLAUDE.local.md` | Oletus, jos repositoriossa käytetään vain jompaakumpaa näistä tiedostoista eikä sen yläpuolella ole estäviä tiedostoja |
| `claude-md-and-agents-md` | Molemmat tiedostot yhdessä: jokaisessa hakemistossa ensin `CLAUDE.md` ja sitten `AGENTS.md` | Tarvitset kaikille työkaluille yhteisen `AGENTS.md`:n ja lisäksi lyhyen, vain Claudelle tarkoitetun `CLAUDE.md`:n; tai sinun on luettava `AGENTS.md`, vaikka `CLAUDE.local.md` olisi olemassa |
| `claude-md` | Vain `CLAUDE.md`; `AGENTS.md`:n automaattinen lukeminen Project instructions -asetuksen kautta on poistettu käytöstä, vaikka `AGENTS.md` olisi ainoa tiedosto (nimenomainen `@AGENTS.md`-tuonti tiedostosta `CLAUDE.md` toimii silti) | `AGENTS.md` on kirjoitettu toista työkalua varten ja saattaa hämmentää Claudea |
| `managed-only` | Istunnon alussa vain organisaation hallinnoima `CLAUDE.md` ja automaattinen muisti; projektin, paikalliset ja käyttäjän `CLAUDE.md`-tiedostot, `.claude/rules/` sekä kaikki `AGENTS.md`-tiedostot jätetään pois alkujoukosta. Alahakemistojen `CLAUDE.md`- ja `.claude/rules/`-tiedostot ladataan kuitenkin myöhemmin, kun Claude avaa siellä olevan tiedoston. Tila rajoittaa alkujoukkoa, mutta ei eristä projektitiedostoista täysin | Organisaatioille, joita kiinnostaa, minkä ohjejoukon kanssa Claude Code aloittaa istunnon, riippumatta siitä, sisältääkö projekti itse `CLAUDE.md`- tai `AGENTS.md`-tiedoston |
Voit valita tilan myös ilman käyttöliittymää `settings.json`-tiedoston kautta:
```json
{
"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](https://ailoot.ai/blog/fi/agents-md-claude-md-one-instruction-file/) selittävät, miten `@`-tuonti toimii. Tämä menetelmä toimii edelleen.
## Miksi Project instructions ei näy komennossa /config?
Keskeinen huomio
Anthropicin dokumentaation mukaan Project instructions -osio voi puuttua seuraavista syistä:
- Claude Code on versiota 2.1.277 vanhempi.
- Istunto ei saa ominaisuuslippuja Anthropicilta—esimerkiksi Bedrockia tai muuta kolmannen osapuolen palveluntarjoajaa käytettäessä tai telemetrian ollessa pois käytöstä.
- Kyseessä on ensimmäinen istunto heti asennuksen tai vanhemmasta versiosta päivittämisen jälkeen. Jos tämä on ainoa syy, ominaisuus tulee näkyviin seuraavassa istunnossa. `AGENTS.md` ladataan vain, jos valitun tilan ehdot täyttyvät.
- Sisäänrakennettu `agents-md`-laajennus on poistettu käytöstä komennossa `/plugin`.
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
Keskeinen huomio
Voit pitää `@AGENTS.md`-tuonnin tiedostossa `CLAUDE.md` ja symbolisen linkin: tiedostoa ei lueta kahdesti missään tilassa. Sanallinen pyyntö ”lue AGENTS.md” kannattaa korvata tuonnilla, jos pidät `CLAUDE.md`:n. Ennen tiedoston poistamista tallenna kaikki tarvittavat ohjeet ja tarkista valitun tilan ehdot. Jos siirryt suoraan lukemiseen, poista kaikki `SessionStart`-hookit, jotka tulostivat `AGENTS.md`:n sisällön manuaalisesti; muuten tiedoston toinen kopio päätyy kontekstiin. Tarkista sitten latautuminen uudessa istunnossa; tarkistustapa riippuu versiosta ja siitä, onko estäviä tiedostoja olemassa.
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
Keskeinen huomio
Versiosta 2.1.280 alkaen Project instructions -asetuksen kautta ladattu `AGENTS.md` näkyy komennossa `/memory` ja komennon `/context` Memory files -luettelossa. Versioissa 2.1.277–2.1.279 se ei näy siellä, vaikka komennot toimivat ja näyttävät ladatut `CLAUDE.md`- ja muut muistiasiakirjat. Näissä versioissa tarkista istunnon käynnistyessä rivi `AGENTS.md loaded`, jos estäviä tiedostoja ei ole. Claudea koskeva kysymys ohjeiden sisällöstä on vain heikko tarkistus: vastaus ei erota suoraa lukemista `@`-tuonnista, ja se voi perustua `SessionStart`-hookin lisäämään tekstiin. Siksi kysyminen kannattaa tehdä vasta uudessa istunnossa, kun tällainen hook on poistettu.
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ä](https://ailoot.ai/blog/fi/claude-md-template/). 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](https://ailoot.ai/blog/fi/claude-code-second-brain/)—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.
### Lähteet
- [Claude Code, CHANGELOG.md-sitoumus, jossa on versioon 2.1.277 liittyvä merkintä GitHubissa (18. syyskuuta 2026)](https://github.com/anthropics/claude-code/commit/ca02e7deeb0707f558b0afd7e9e5d67a382e12b3)
- [Claude Code Docs: How Claude remembers your project - AGENTS.md-osio](https://code.claude.com/docs/en/memory)
[Ailoot Guides](https://ailoot.ai/docs/)
[Siirry Ailootiin](https://ailoot.ai/)
## Kysymyksiä tästä oppaasta: Claude Code lukee nyt AGENTS.md:tä: mitä muuttui versiossa 2.1.277
### Miksi AGENTS.md ei lataudu, vaikka tiedosto on olemassa?
Oletustilassa työhakemistossa tai sen ylemmässä hakemistossa oleva CLAUDE.md, .claude/CLAUDE.md tai CLAUDE.local.md estää automaattisen AGENTS.md-valinnan. Tarkista myös Claude Coden versio, ominaisuuden saatavuus ja /config-valikon Project instructions -tila.
### Miten varmistan suoran latauksen manuaalisen hookin poistamisen jälkeen?
Avaa uusi istunto, jotta vanha SessionStart-tuloste puuttuu. Tarkista versiossa 2.1.280 tai uudemmassa /memory tai /context-komennon Memory files -lista. Versioissa 2.1.277–2.1.279 käynnistyksen latausrivi pätee, kun estäviä CLAUDE.md-tiedostoja ei ole. Pelkkä Clauden omin sanoin kertoma tieto on heikko todiste.
## Ailoot · Yritys ja sen projektisalkku
Ailoot perustuu kertyneeseen toimintakokemukseen, laajaan asiakaskuntaan, vakaaseen palveluun ja jatkuvaan KPI-seurantaan.
Yritys ja sen projektisalkku: miljoonia asiakkaita; kuukausittainen myynti miljardiluokassa.
Ailoot hyödyntää tätä toimintakokemusta tarjotessaan API-yhteyden tekoälytoimintoihin asiakkaiden tuotteissa, agenteissa, sovelluksissa ja automaatioissa.