Blogg

Claude Code leser nå AGENTS.md: dette ble endret i 2.1.277

Markdown

18. 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
  1. september 2026 ble støtte for AGENTS.md lagt til i Claude Code 2.1.277. Hvis funksjonen er tilgjengelig i økten og i arbeidskatalogen, og det ikke finnes noen CLAUDE.md, .claude/CLAUDE.md eller CLAUDE.local.md noe sted i katalogkjeden over den, leser Claude Code AGENTS.md som standard uten manuell import. Tidligere ble dette gjort gjennom en @AGENTS.md-import i CLAUDE.md eller via en symbolsk lenke fra CLAUDE.md til AGENTS.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)

— Anthropic, claude-code CHANGELOG.md commit, ca02e7d, https://github.com/anthropics/claude-code/commit/ca02e7deeb0707f558b0afd7e9e5d67a382e12b3

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:

VerdiHva Claude Code leserNår den bør brukes
claude-md-or-agents-mdCLAUDE.md, eller AGENTS.md hvis det ikke finnes noen CLAUDE.md, .claude/CLAUDE.md eller CLAUDE.local.md i arbeidskatalogen eller over denStandard hvis repositoryet bare bruker én av de to filene, og det ikke finnes blokkerende filer over den
claude-md-and-agents-mdBegge filene sammen: først CLAUDE.md, deretter AGENTS.md i hver katalogDu 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-mdBare 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-onlyVed ø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 prosjektfilerFor 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.md lastes 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.md med 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 å slette CLAUDE.md: importen gir allerede Claude tilgang til innholdet i AGENTS.md. Fortsett å kontrollere innlastingen via importen med /memory; å spørre Claude direkte om innholdet i instruksjonene er bare en svak kontroll.
  • CLAUDE.md som ber med ord om å lese AGENTS.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 beholde CLAUDE.md (for eksempel for andre verktøy som også leser den). Hvis du bestemmer deg for å slette CLAUDE.md helt og velger claude-md-or-agents-md-modus, må du først kontrollere at CLAUDE.md ikke inneholder unike instruksjoner, og at det ikke finnes noen annen CLAUDE.md, .claude/CLAUDE.md eller CLAUDE.local.md i arbeidskatalogen eller over den; ellers fortsetter Claude Code å lese den gjenværende filen i stedet for AGENTS.md. Etter at du har slettet den, må du kontrollere at overgangen er fullført: når det ikke finnes blokkerende filer, vises linjen AGENTS.md loaded i en interaktiv økt. Hvis CLAUDE.md blir værende og begge filene leses i claude-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.md som symbolsk lenke til AGENTS.md. Du kan beholde den: filen blir ikke lest to ganger i noen av modusene. Før du sletter lenken i claude-md-or-agents-md-modus, må du kontrollere at de nødvendige instruksjonene er bevart, og at det ikke finnes noen annen CLAUDE.md, .claude/CLAUDE.md eller CLAUDE.local.md i arbeidskatalogen eller over den. Kontroller innlastingen på samme måte: linjen AGENTS.md loaded ved øktstart når det ikke finnes blokkerende filer, eller /memory (2.1.280+). Hvis CLAUDE.md blir værende i claude-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 i AGENTS.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:
    1. 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-md eller managed-only. I standardmodusen må du også kontrollere at det ikke finnes blokkerende filer.
    2. Fjern hooken.
    3. 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.
    4. Kontroller innlastingen i den nye økten. I versjon 2.1.280+ vises banen til AGENTS.md i /memory. I versjonene 2.1.277–2.1.279 ser du etter linjen AGENTS.md loaded ved oppstart hvis det ikke finnes blokkerende filer: dokumentasjonen beskriver den spesifikt for tilfeller der ingen CLAUDE.md ble funnet. Hvis du beholder CLAUDE.md og bruker claude-md-and-agents-md-modus, er kontrollmulighetene begrenset: /memory viser ikke AGENTS.md i disse versjonene, dokumentasjonen beskriver ingen innlastingslinje for dette tilfellet, og en parafrase av instruksjonene kan ikke skille direkte lesing fra en @-import i CLAUDE.md. Oppdater i så fall til 2.1.280+ og kontroller /memory.

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.

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.

Alle artikler