AnswersPublished18 sources
Claude Code tuo AGENTS.md-tuen – mutta vain varatiedostona
18. syyskuuta 2026 julkaistu Claude Code 2.1.277 lukee AGENTS.md tiedoston projektiohjeina, jos projektissa ei ole CLAUDE.md tiedostoa.
JulkaisijaMuokattu mallilla GPT-5.6 TerraKuvat luotu mallilla GPT Image 2
Research answer
Key takeaways
- 18. syyskuuta 2026 julkaistu Claude Code 2.1.277 lukee AGENTS.md tiedoston projektiohjeina, jos projektissa ei ole CLAUDE.md tiedostoa.
- Asetusta voi muuttaa /config komennon Project instructions kohdassa, mutta tukea ei vielä ole Bedrock , Vertex eikä Foundry ympäristöissä.
- AGENTS.md sopii koko repositorion yhteisiin sääntöihin, kun taas SKILL.md pakkaa uudelleenkäytettäviä, tarpeen mukaan ladattavia agenttitaitoja.
AI Prompt
openai.comCreate a landscape editorial hero image for this Studio Global article: What changed in Claude Code version 2.1.277, released on September 18, 2026, regarding support for the open AGENTS.md project-instructions f. Article summary: Claude Code 2.1.277 adds native, opt-in-configurable fallback support for `AGENTS.md`: a repository without `CLAUDE.md` can now supply Claude Code’s project instructions through the shared open format instead. It is a fa. Topic tags: general, general web, user generated. Style: premium digital editorial illustration, source-backed research mood, clean composition, high detail, modern web publication hero. Use reference image context only for broad subject, composition, and topical grounding; do not copy the exact image. Avoid: logos, brand marks, copyrighted characters, real person likenesses, fake screenshots, UI text, readable text, watermarks, charts with fa
Claude Code 2.1.277 tuo tuen avoimelle AGENTS.md-käytännölle projektiohjeiden varavaihtoehtona. Käytännössä Claude Code lukee AGENTS.md-tiedoston, jos projektista ei löydy CLAUDE.md-tiedostoa. Näin yhteistä agenttiohjetta käyttävä repositorio toimii Claude Coden kanssa ilman erillistä Claude-kohtaista tiedostoa. 1
Näin varakäyttö toimii
Oletustoimintalogiikka on yksinkertainen:
- Projektissa ei ole
CLAUDE.md-tiedostoa: Claude Code voi käyttääAGENTS.md-tiedostoa projektiohjeina.1
- Projektissa on
CLAUDE.md-tiedosto:CLAUDE.mdsäilyy vakiintuneena projektiohjeiden tiedostona. Julkaisutiedote ei kuvaa oletuskäytöstä, jossa molempien tiedostojen sisältö yhdistettäisiin automaattisesti.
Toiminnon voi ottaa käyttöön tai sen toimintaa voi muuttaa Claude Coden /config-komennon Project instructions -asetuksista. Anthropic kertoo, ettei tukea ole vielä Claude Coden Amazon Bedrock-, Google Vertex AI- tai Azure AI Foundry -käyttöönotuissa. 1
Mikä AGENTS.md on?
AGENTS.md on avoin Markdown-pohjainen tapa tallentaa repositoriokohtaisia ohjeita koodausagenteille. Sitä voi ajatella agentille kirjoitettuna README-tiedostona: siihen voidaan koota projektin tausta, käyttöönotto-ohjeet, rakennus- ja testikomennot, koodikäytännöt sekä osallistumisen pelisäännöt. 19
32
Muoto syntyi OpenAI Codexin, Ampin, Google Julesin, Cursorin ja Factoryn kaltaisten toimijoiden yhteistyönä. Sitä hallinnoi Linux Foundationin alainen Agentic AI Foundation. Hankkeen mukaan AGENTS.md on käytössä yli 60 000 avoimen lähdekoodin repositoriossa. 19
21
AGENTS.md-ekosysteemiin kuuluu muun muassa OpenAI Codex, Google Jules, Cursor, GitHub Copilotin koodausagentti, Gemini CLI, Aider, Zed, Warp, VS Code, Devin, JetBrains Junie, Factory, Goose ja OpenCode. Työkalujen tavat löytää ja tulkita ohjetiedostoja vaihtelevat silti edelleen, joten pelkkä tiedoston olemassaolo ei takaa täysin samanlaista toimintaa kaikissa työkaluissa. 19
Miksi muutos on kehittäjille hyödyllinen?
Aiemmin yhteiseen AGENTS.md-käytäntöön nojautuva tiimi joutui usein pitämään lisäksi erillistä CLAUDE.md-tiedostoa. Vaihtoehtoina olivat esimerkiksi symbolinen linkki AGENTS.md-tiedostoon tai kevyt CLAUDE.md, joka toi yhteiset ohjeet sisään. Nämä olivat kiertotapoja, koska Claude Code ei aiemmin lukenut AGENTS.md-tiedostoa natiivisti. 10
Uusi varakäyttö vähentää tätä ylläpitotyötä repositorioissa, jotka eivät tarvitse Claude Code -kohtaisia projektiohjeita. Yksi yhteinen tiedosto voi nyt välittää perusohjeet Claude Codelle ja muille yhteensopiville työkaluille.
Täysi yhdenmukaisuus ei silti synny automaattisesti. Tiimien kannattaa yhä tarkistaa työkalukohtaisesti, miten agentti etsii ohjetiedostoja, käsittelee alihakemistojen ohjeita ja ratkaisee mahdolliset ristiriidat.
AGENTS.md ja SKILL.md palvelevat eri tarkoitusta
AGENTS.md ja SKILL.md eivät ole toistensa korvaajia, vaan täydentävät toisiaan.
AGENTS.mdsisältää repositorion pysyvät, yleiset työskentelyohjeet: kontekstin ja säännöt, jotka koskevat kyseistä koodikantaa.19
32
SKILL.mdkuuluu Agent Skill -pakettiin eli uudelleenkäytettävään tiedostojärjestelmään pohjautuvaan taitoon. Paketti voi sisältää ohjeita, metatietoja ja muita tukiresursseja. Claude hyödyntää taitoja, kun ne ovat tehtävän kannalta olennaisia ja tuovat erikoistunutta työnkulkua tai osaamista.33
Claude Code kertoo taitojensa noudattavan työkalurajat ylittävää Agent Skills -standardia. Projektitaito sijoitetaan Claude Coden dokumentaation mukaan hakemistoon, jossa on SKILL.md-tiedosto, esimerkiksi .claude/skills/<nimi>/SKILL.md. 37
39
Mitä rajoituksia jää?
Päivitys lisää ohjetiedoston varakäytön, mutta se ei tee kaikista agenttien käytännöistä keskenään samanlaisia.
Claude Coden dokumentoitu projektitaitojen sijainti on edelleen .claude/skills/<nimi>/SKILL.md. Version 2.1.277 muutosloki käsittelee AGENTS.md-projektiohjeita, eikä siinä ilmoiteta .agents/skills/-hakemiston löytämisestä. 1
37
Myöskään CLAUDE.md- ja AGENTS.md-tiedostojen automaattista yhdistämistä ei pidä olettaa. Jos repositorio tarvitsee sekä työkalusta riippumattomia että Claude Code -kohtaisia ohjeita, niiden suhde kannattaa määritellä selvästi eikä luottaa pelkkään varakäyttöön.
Käytännöllinen rakenne nykyiseen Claude Code -projektiin
Jos projektissa käytetään jo CLAUDE.md-tiedostoa, selkeä jako voi olla seuraava:
- Kirjoita yleiset, työkaluriippumattomat repositoriosäännöt
AGENTS.md-tiedostoon. - Säilytä
CLAUDE.mdClaude Code -kohtaisille ohjeille. - Viittaa tai tuo yhteiset ohjeet tarvittaessa
CLAUDE.md-tiedostosta erikseen sen sijaan, että olettaisit molempien tiedostojen latautuvan yhdessä.
Näin yleiset projektisäännöt pysyvät siirrettävinä, mutta Claude Code -kohtaiset työnkulut erillään. Claude Code 2.1.277 on merkittävä yhteentoimivuusparannus: AGENTS.md-lähtöinen repositorio toimii nyt Claude Coden kanssa silloin, kun CLAUDE.md puuttuu. Se ei kuitenkaan vielä tarkoita, että kaikki ohje- ja taitotiedostojen löytämiskäytännöt olisivat yhtenäistyneet.
Studio Global AI
Continue your research
This page includes a source-backed answer you can continue inside Studio Global.
People also ask
What is the short answer to "Claude Code tuo AGENTS.md-tuen – mutta vain varatiedostona"?
18. syyskuuta 2026 julkaistu Claude Code 2.1.277 lukee AGENTS.md tiedoston projektiohjeina, jos projektissa ei ole CLAUDE.md tiedostoa.
What are the key points to validate first?
18. syyskuuta 2026 julkaistu Claude Code 2.1.277 lukee AGENTS.md tiedoston projektiohjeina, jos projektissa ei ole CLAUDE.md tiedostoa. Asetusta voi muuttaa /config komennon Project instructions kohdassa, mutta tukea ei vielä ole Bedrock , Vertex eikä Foundry ympäristöissä.
What should I do next in practice?
AGENTS.md sopii koko repositorion yhteisiin sääntöihin, kun taas SKILL.md pakkaa uudelleenkäytettäviä, tarpeen mukaan ladattavia agenttitaitoja.