Claude Code leser nå AGENTS.md: dette ble endret i 2.1.277
Markdown18. september 2026 fikk Claude Code 2.1.277 direkte støtte for AGENTS.md: når filen lastes inn, hvordan du velger én av 4 moduser, og hva du skal gjøre med importer.
Les hele artikkelen
- september 2026 ble støtte for
AGENTS.mdlagt til i Claude Code 2.1.277. Hvis funksjonen er tilgjengelig i økten og i arbeidskatalogen, og det ikke finnes noenCLAUDE.md,.claude/CLAUDE.mdellerCLAUDE.local.mdnoe sted i katalogkjeden over den, leser Claude CodeAGENTS.mdsom standard uten manuell import. Tidligere ble dette gjort gjennom en@AGENTS.md-import iCLAUDE.mdeller via en symbolsk lenke fraCLAUDE.mdtilAGENTS.md– se artikkelen om én instruksjonsfil for flere agenter for mer informasjon.
Hvis du bruker Claude Code og ett eller to andre verktøy i samme repository, avgjør modusen Project instructions du velger hvilke instruksjonsfiler Claude Code leser. Nedenfor finner du vilkårene for hver av de fire modusene og fremgangsmåten for å gå over fra det gamle oppsettet.
Du finner mer materiale om konfigurering av verktøy i Ailoot-dokumentasjonen.
Hva ble endret i versjon 2.1.277?
Viktigste poeng
Fra og med 18. september 2026 leser Claude Code AGENTS.md som standard hvis det ikke finnes noen CLAUDE.md, .claude/CLAUDE.md eller CLAUDE.local.md noe sted i katalogkjeden fra arbeidskatalogen og oppover. Hvis en slik fil finnes, er automatisk lesing av AGENTS.md via Project instructions ikke aktivert. En eksplisitt @AGENTS.md-import fra CLAUDE.md fungerer fortsatt. Brukerens ~/.claude/CLAUDE.md, organisasjonsadministrerte CLAUDE.md og .claude/rules/ lastes inn uavhengig av valget mellom prosjektfiler. Modusen endres via /config. Funksjonen er ennå ikke tilgjengelig på Bedrock, Vertex eller Foundry.
Den offisielle Claude Code-prosjektets CHANGELOG.md på GitHub beskriver det slik:
Added AGENTS.md support: in a project with no CLAUDE.md, Claude Code reads AGENTS.md instead; change it under "Project instructions" in
/config(not yet on Bedrock, Vertex or Foundry)
Oversettelse: støtte for AGENTS.md er lagt til – i et prosjekt uten CLAUDE.md leser Claude Code nå AGENTS.md i stedet; dette kan endres under «Project instructions» i /config (ennå ikke tilgjengelig på Bedrock, Vertex eller Foundry).
Før denne versjonen førte ikke fraværet av CLAUDE.md, .claude/CLAUDE.md og CLAUDE.local.md i arbeidskatalogen og over den, i seg selv, til at AGENTS.md ble lest. Det krevde en eksplisitt import, en symbolsk lenke eller en manuell hook. Nå henter agenten inn filen automatisk når funksjonen er tilgjengelig.
Hvilke filer blokkerer automatisk lesing av AGENTS.md
Viktigste poeng
I standardmodusen sjekkes CLAUDE.md, .claude/CLAUDE.md og CLAUDE.local.md i arbeidskatalogen og over den. Personlig ~/.claude/CLAUDE.md, organisasjonsadministrert CLAUDE.md og filer i .claude/rules/ blokkerer ikke lesing av AGENTS.md; de lastes inn i tillegg.
Hvis du har en personlig ~/.claude/CLAUDE.md med innstillinger for kodestil, hindrer den ikke Claude Code i å lese prosjektets AGENTS.md. Men enhver CLAUDE.local.md i arbeidskatalogen – selv en som ikke er lagt til i Git og brukes til personlige notater – blokkerer automatisk lesing av AGENTS.md i standardmodusen. En eksplisitt import fungerer fortsatt; hvis du vil lese begge filene direkte, må du bytte modus.
Hvis en modus for direkte lesing er valgt under Project instructions (se «4 Project instructions-moduser – hvilken bør du velge?» nedenfor), og det ikke finnes noen CLAUDE.md, .claude/CLAUDE.md eller CLAUDE.local.md i arbeidskatalogen eller over den, leser Claude Code alle AGENTS.md- og .claude/AGENTS.md-filene i disse katalogene når økten starter. For tilfeller uten blokkerende filer viser dokumentasjonen en linje som denne i en interaktiv økt:
no CLAUDE.md found; AGENTS.md loaded: /home/you/repo/AGENTS.md
En AGENTS.md-fil i en underkatalog lastes inn når Claude åpner en fil der med Read-verktøyet. I claude-md-or-agents-md-modus skjer dette bare hvis underkatalogen ikke har sin egen CLAUDE.md, .claude/CLAUDE.md eller CLAUDE.local.md. For claude-md-and-agents-md beskriver dokumentasjonen den generelle regelen: CLAUDE.md og AGENTS.md leses sammen, med CLAUDE.md først og deretter AGENTS.md i hver katalog. AGENTS.local.md, AGENTS.override.md og alt i .agents/-katalogen leses ikke automatisk.
Du finner materiale om konfigurering av en AI-agents arbeidsområde, inkludert instruksjonsfiler med prosjektkontekst, i Ailoot-dokumentasjonen.
4 Project instructions-moduser – hvilken bør du velge?
Viktigste poeng
I Project instructions-delen av kommandoen /config finnes det fire verdier: claude-md-or-agents-md (standard – én av de to filene), claude-md-and-agents-md (begge sammen), claude-md (bare CLAUDE.md leses automatisk, selv om prosjektet bare har AGENTS.md) og managed-only (ved oppstart bare organisasjonsadministrert CLAUDE.md og automatisk minne, uten prosjekt- eller personlige filer). Endringen trer i kraft med neste sendte melding og i hver nye økt.
Atferden til modusene i tabellen er beskrevet i Anthropics dokumentasjon. Høyre kolonne gir anbefalinger for valg av modus:
| Verdi | Hva Claude Code leser | Når den bør brukes |
|---|---|---|
claude-md-or-agents-md | CLAUDE.md, eller AGENTS.md hvis det ikke finnes noen CLAUDE.md, .claude/CLAUDE.md eller CLAUDE.local.md i arbeidskatalogen eller over den | Standard hvis repositoryet bare bruker én av de to filene, og det ikke finnes blokkerende filer over den |
claude-md-and-agents-md | Begge filene sammen: først CLAUDE.md, deretter AGENTS.md i hver katalog | Du trenger en felles AGENTS.md for alle verktøy, pluss en kort CLAUDE.md bare for Claude; eller du må lese AGENTS.md når CLAUDE.local.md finnes |
claude-md | Bare CLAUDE.md; automatisk lesing av AGENTS.md via Project instructions er deaktivert, selv om AGENTS.md er den eneste filen (en eksplisitt @AGENTS.md-import fra CLAUDE.md fungerer fortsatt) | AGENTS.md er skrevet for et annet verktøy og kan forvirre Claude |
managed-only | Ved øktstart leses bare den organisasjonsadministrerte CLAUDE.md og automatisk minne; prosjektets, lokale og brukerens CLAUDE.md, .claude/rules/ og alle AGENTS.md-filer utelates fra det første settet. CLAUDE.md- og .claude/rules/-filer i underkataloger lastes likevel inn senere når Claude åpner en fil der. Modusen begrenser det første settet, men gir ikke full isolasjon fra prosjektfiler | For organisasjoner som vil styre hvilket instruksjonssett Claude Code starter en økt med, uavhengig av om prosjektet selv inneholder CLAUDE.md eller AGENTS.md |
Du kan også velge modus uten grensesnittet, via settings.json:
{
"pluginConfigs": {
"agents-md@builtin": {
"options": {
"instructionFiles": "claude-md-and-agents-md"
}
}
}
}
Claude Code ignorerer denne verdien i project- og local-innstillinger. Ifølge Anthropics dokumentasjon kan den settes i ~/.claude/settings.json, i en --settings-fil eller i organisasjonsadministrerte innstillinger.
Hvis du allerede har konfigurert en delt instruksjonsfil for flere AI-verktøy i ett repository, forklarer instruksjonene for versjoner før 2.1.277 hvordan @-importen fungerer. Denne metoden fungerer fortsatt.
Hvorfor finnes ikke Project instructions i /config?
Viktigste poeng
Ifølge Anthropics dokumentasjon kan Project instructions-delen mangle av følgende grunner:
- Claude Code er eldre enn versjon 2.1.277.
- Økten mottar ikke funksjonsflagg fra Anthropic – for eksempel ved bruk av Bedrock, en annen tredjepartsleverandør eller når telemetri er deaktivert.
- Dette er den første økten rett etter installasjon eller oppdatering fra en eldre versjon. Hvis dette er den eneste årsaken, vises funksjonen i neste økt.
AGENTS.mdlastes bare inn hvis vilkårene for den valgte modusen er oppfylt. - Den innebygde
agents-md-pluginen er deaktivert i/plugin.
Sjekk først versjonen med kommandoen claude --version. Hvis den er eldre enn 2.1.277, oppdaterer du Claude Code. Hvis versjonen er tilstrekkelig, men delen fortsatt ikke vises, sjekk de andre årsakene som er nevnt ovenfor. Mens funksjonen ikke er tilgjengelig, er import av @AGENTS.md i CLAUDE.md fortsatt et fungerende alternativ.
Hva gjør du med den gamle @AGENTS.md-importen?
Viktigste poeng
Du kan beholde @AGENTS.md-importen i CLAUDE.md og den symbolske lenken: filen leses ikke to ganger i noen av modusene. En tekstlig forespørsel om å «lese AGENTS.md» bør erstattes med en import hvis du beholder CLAUDE.md. Før du sletter en fil, må du lagre alle nødvendige instruksjoner og kontrollere vilkårene for valgt modus. Hvis du bytter til direkte lesing, fjern alle SessionStart-hooker som manuelt skrev ut innholdet i AGENTS.md; ellers blir en ekstra kopi av filen lagt til i konteksten. Kontroller deretter innlasting i en ny økt; hvordan det gjøres, avhenger av versjonen og om det finnes blokkerende filer.
De neste stegene avhenger av det gamle oppsettet. Først må du kontrollere at funksjonen er tilgjengelig i økten, som beskrevet i forrige avsnitt.
CLAUDE.mdmed en@AGENTS.md-import. Du kan la den stå som den er – Claude Code leser ikke filen to ganger uansett hvilken verdi Project instructions har. Det er valgfritt å sletteCLAUDE.md: importen gir allerede Claude tilgang til innholdet iAGENTS.md. Fortsett å kontrollere innlastingen via importen med/memory; å spørre Claude direkte om innholdet i instruksjonene er bare en svak kontroll.CLAUDE.mdsom ber med ord om å leseAGENTS.md. En slik forespørsel er ikke en import og garanterer ikke i seg selv at filen lastes inn. Erstatt formuleringen med en@AGENTS.md-import hvis du vil beholdeCLAUDE.md(for eksempel for andre verktøy som også leser den). Hvis du bestemmer deg for å sletteCLAUDE.mdhelt og velgerclaude-md-or-agents-md-modus, må du først kontrollere atCLAUDE.mdikke inneholder unike instruksjoner, og at det ikke finnes noen annenCLAUDE.md,.claude/CLAUDE.mdellerCLAUDE.local.mdi arbeidskatalogen eller over den; ellers fortsetter Claude Code å lese den gjenværende filen i stedet forAGENTS.md. Etter at du har slettet den, må du kontrollere at overgangen er fullført: når det ikke finnes blokkerende filer, vises linjenAGENTS.md loadedi en interaktiv økt. HvisCLAUDE.mdblir værende og begge filene leses iclaude-md-and-agents-md-modus, kontrollerer du/memory(i versjon 2.1.280+). Et direkte spørsmål til Claude kan ikke skille direkte innlasting fra en import.CLAUDE.mdsom symbolsk lenke tilAGENTS.md. Du kan beholde den: filen blir ikke lest to ganger i noen av modusene. Før du sletter lenken iclaude-md-or-agents-md-modus, må du kontrollere at de nødvendige instruksjonene er bevart, og at det ikke finnes noen annenCLAUDE.md,.claude/CLAUDE.mdellerCLAUDE.local.mdi arbeidskatalogen eller over den. Kontroller innlastingen på samme måte: linjenAGENTS.md loadedved øktstart når det ikke finnes blokkerende filer, eller/memory(2.1.280+). HvisCLAUDE.mdblir værende iclaude-md-and-agents-md-modus, er det bare en svak kontroll å spørre Claude direkte. Fravær av en feil er ikke nok til å bekrefte innlasting.- En
SessionStart-hook som manuelt skrev ut innholdet iAGENTS.md. Når filen leses direkte, legger en slik hook til en ekstra kopi i konteksten. Mens hooken kjører, bekrefter ikke spørsmålet «hva står det i instruksjonene dine?» direkte innlasting: Claude kan svare ut fra tekst som hooken la til. Bytt i denne rekkefølgen:- Kontroller at funksjonen er tilgjengelig: versjon 2.1.277 eller nyere, økten mottar funksjonsflagg, pluginen er aktivert og den første økten etter installasjon eller oppdatering er fullført. Velg en modus for direkte lesing – verken
claude-mdellermanaged-only. I standardmodusen må du også kontrollere at det ikke finnes blokkerende filer. - Fjern hooken.
- Lukk økten og åpne en ny.
SessionStart-hooken legger til teksten ved oppstart, så innholdet forblir i konteksten til en økt som allerede er åpen. Claudes svar om instruksjonsinnholdet i en slik økt bekrefter ikke direkte innlasting. - Kontroller innlastingen i den nye økten. I versjon 2.1.280+ vises banen til
AGENTS.mdi/memory. I versjonene 2.1.277–2.1.279 ser du etter linjenAGENTS.md loadedved oppstart hvis det ikke finnes blokkerende filer: dokumentasjonen beskriver den spesifikt for tilfeller der ingenCLAUDE.mdble funnet. Hvis du beholderCLAUDE.mdog brukerclaude-md-and-agents-md-modus, er kontrollmulighetene begrenset:/memoryviser ikkeAGENTS.mdi disse versjonene, dokumentasjonen beskriver ingen innlastingslinje for dette tilfellet, og en parafrase av instruksjonene kan ikke skille direkte lesing fra en@-import iCLAUDE.md. Oppdater i så fall til 2.1.280+ og kontroller/memory.
- Kontroller at funksjonen er tilgjengelig: versjon 2.1.277 eller nyere, økten mottar funksjonsflagg, pluginen er aktivert og den første økten etter installasjon eller oppdatering er fullført. Velg en modus for direkte lesing – verken
Slik kontrollerer du at AGENTS.md ble lastet inn
Viktigste poeng
Fra og med versjon 2.1.280 vises AGENTS.md som er lastet inn via Project instructions, i /memory og i listen Memory files for kommandoen /context. I versjonene 2.1.277–2.1.279 vises den ikke der, selv om kommandoene fungerer og viser innlastet CLAUDE.md og andre minnefiler. I disse versjonene bør du, hvis det ikke finnes blokkerende filer, se etter linjen AGENTS.md loaded ved oppstart av økten. Å spørre Claude om innholdet i instruksjonene er bare en svak kontroll: svaret kan ikke skille direkte lesing fra en @-import og kan bygge på tekst som er lagt til av en SessionStart-hook. Derfor er det best å spørre bare i en ny økt etter at en slik hook er fjernet.
Det er ytterligere to forskjeller fra vanlig CLAUDE.md: InstructionsLoaded-hooker kjøres ikke for denne typen AGENTS.md (de fungerer for AGENTS.md som importeres via @-syntaks fra CLAUDE.md eller kobles til med en symbolsk CLAUDE.md-lenke); kataloger som legges til med flagget --add-dir sammen med variabelen CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD, laster bare inn den katalogens CLAUDE.md – dens AGENTS.md inkluderes ikke.
Hvis du vil gjennomgå innholdet i en stor prosjektinstruksjonsfil, kan du se den separate analysen om hvordan du konfigurerer CLAUDE.md uten at den blir oppblåst. Den tar for seg strukturen i instruksjonene, mens vilkårene for innlasting av AGENTS.md er beskrevet ovenfor. For arbeidsnotater mellom økter kan du se analysen om en ekstra hjerne i Claude Code – om personlig minne som legges oppå prosjektinstruksjonene.
Hva nå?
Funksjonen ble utgitt 18. september 2026 i versjon 2.1.277. Anthropic kan presisere detaljene i modusene i fremtidige utgivelser, så før du endrer innstillinger i et viktig prosjekt, bør du sammenligne denne artikkelen med gjeldende /config og den offisielle endringsloggen.
Kilder
Flere detaljer
Spørsmål om denne veiledningen: Claude Code leser nå AGENTS.md: dette ble endret i 2.1.277
Hvorfor lastes ikke AGENTS.md selv om filen finnes?
I standardmodus blokkerer CLAUDE.md, .claude/CLAUDE.md eller CLAUDE.local.md i arbeidsmappen eller en overordnet mappe automatisk valg av AGENTS.md. Kontroller også Claude Code-versjon, funksjonstilgjengelighet og Project instructions-modusen i /config.
Hvordan verifiserer jeg direkte lasting etter at en manuell hook er fjernet?
Åpne en ny økt slik at gammel SessionStart-utdata ikke er med. I versjon 2.1.280 eller nyere undersøker du /memory eller Memory files-listen i /context. I 2.1.277-2.1.279 gjelder oppstartens lastelinje når ingen blokkerende CLAUDE.md-filer finnes. En parafrase fra Claude alene er svakt belegg.