Claude Code läser nu AGENTS.md: vad ändrades i 2.1.277

Den 18 september 2026 lades stöd för AGENTS.md till i Claude Code 2.1.277. Om funktionen är tillgänglig i sessionen och i arbetskatalogen, och det inte finns någon CLAUDE.md, .claude/CLAUDE.md eller CLAUDE.local.md någonstans i katalogkedjan ovanför den, läser Claude Code AGENTS.md som standard utan manuell import. Tidigare gjordes detta via en import av @AGENTS.md i CLAUDE.md eller via en symbolisk länk från CLAUDE.md till AGENTS.md—läs mer i artikeln om en instruktionsfil för flera agenter.

Om du använder Claude Code och ett eller två andra verktyg i samma repository avgör läget Project instructions som du väljer vilka instruktionsfiler Claude Code läser. Nedan beskrivs villkoren för vart och ett av de fyra lägena och stegen för att byta från den gamla konfigurationen.

Mer material om hur du konfigurerar verktyg finns i Ailoot-dokumentationen.

Vad ändrades i version 2.1.277?#

I den officiella CHANGELOG.md för Claude Code-projektet på GitHub står det så här:

Översättning: stöd för AGENTS.md har lagts till—i ett projekt utan CLAUDE.md läser Claude Code nu AGENTS.md i stället; detta kan ändras under ”Project instructions” i /config (ännu inte tillgängligt på Bedrock, Vertex eller Foundry).

Före den här versionen innebar frånvaron av CLAUDE.md, .claude/CLAUDE.md och CLAUDE.local.md i arbetskatalogen och ovanför den inte i sig att AGENTS.md lästes in. En uttrycklig import, symbolisk länk eller manuell hook krävdes. Nu hämtar agenten filen automatiskt när funktionen är tillgänglig.

Vilka filer hindrar automatisk läsning av AGENTS.md#

Om du har en personlig ~/.claude/CLAUDE.md med inställningar för kodningsstil hindrar den inte Claude Code från att läsa projektets AGENTS.md. Men varje CLAUDE.local.md i arbetskatalogen—även en som inte har lagts till i Git och används för personliga anteckningar—hindrar automatisk läsning av AGENTS.md i standardläget. En uttrycklig import fungerar fortfarande; om du vill läsa båda filerna direkt måste du byta läge.

Om ett läge för direktläsning väljs under Project instructions (se ”4 lägen för Project instructions—vilket ska du välja?” nedan) och det inte finns någon CLAUDE.md, .claude/CLAUDE.md eller CLAUDE.local.md i arbetskatalogen eller ovanför den, läser Claude Code in alla AGENTS.md och .claude/AGENTS.md i dessa kataloger när sessionen startar. För fallet utan blockerande filer visar dokumentationen en rad som denna i en interaktiv session:

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

En AGENTS.md-fil i en underkatalog läses in när Claude öppnar en fil där med verktyget Read. I läget claude-md-or-agents-md sker detta bara om underkatalogen inte har en egen CLAUDE.md, .claude/CLAUDE.md eller CLAUDE.local.md. För claude-md-and-agents-md beskriver dokumentationen den allmänna regeln: CLAUDE.md och AGENTS.md läses tillsammans, med CLAUDE.md först och sedan AGENTS.md i varje katalog. AGENTS.local.md, AGENTS.override.md och allt i katalogen .agents/ läses inte in automatiskt.

Material om hur du konfigurerar en AI-agents arbetsyta, inklusive instruktionsfiler med projektkontext, finns i Ailoot-dokumentationen.

4 lägen för Project instructions—vilket ska du välja?#

Lägenas beteende i tabellen beskrivs i Anthropics dokumentation. Den högra kolumnen ger rekommendationer för när du ska välja respektive läge:

Du kan också välja läge utan gränssnittet, via settings.json:

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

Claude Code ignorerar det här värdet i inställningarna project och local. Enligt Anthropics dokumentation kan det anges i ~/.claude/settings.json, i en --settings-fil eller i organisationshanterade inställningar.

Om du redan har konfigurerat en gemensam instruktionsfil för flera AI-verktyg i ett repository förklarar instruktionerna för versioner före 2.1.277 hur importen med @ fungerar. Den här metoden fungerar fortfarande.

Varför finns inte Project instructions i /config?#

Kontrollera först versionen med kommandot claude --version. Om den är äldre än 2.1.277 uppdaterar du Claude Code. Om versionen är tillräckligt ny men avsnittet fortfarande inte visas kontrollerar du de andra orsakerna ovan. Medan funktionen inte är tillgänglig är import av @AGENTS.md i CLAUDE.md fortfarande en fungerande reservlösning.

Vad ska du göra med den gamla importen av @AGENTS.md?#

Nästa steg beror på den gamla konfigurationen. Kontrollera först att funktionen är tillgänglig i sessionen, enligt beskrivningen i föregående avsnitt.

• CLAUDE.md med import av @AGENTS.md. Du kan låta den vara som den är—Claude Code läser inte in filen två gånger med något värde för Project instructions. Det är valfritt att ta bort CLAUDE.md: importen ger redan Claude tillgång till innehållet i AGENTS.md. Fortsätt kontrollera inläsningen via importen med /memory; en direkt fråga till Claude om instruktionernas innehåll är bara en svag kontroll.
• CLAUDE.md som ber med ord att läsa AGENTS.md. En sådan begäran är ingen import och garanterar inte i sig att filen läses in. Ersätt formuleringen med en import av @AGENTS.md om du vill behålla CLAUDE.md (till exempel för verktyg som också läser den). Om du bestämmer dig för att ta bort CLAUDE.md helt och har valt läget claude-md-or-agents-md kontrollerar du först att CLAUDE.md inte innehåller några unika instruktioner och att det inte finns någon annan CLAUDE.md, .claude/CLAUDE.md eller CLAUDE.local.md i arbetskatalogen eller ovanför den; annars fortsätter Claude Code att läsa den kvarvarande filen i stället för AGENTS.md. När du har tagit bort den kontrollerar du att övergången har skett: när det inte finns några blockerande filer kvar visas raden AGENTS.md loaded i en interaktiv session. Om CLAUDE.md finns kvar och båda filerna läses i läget claude-md-and-agents-md kontrollerar du /memory (i version 2.1.280+). En direkt fråga till Claude kan inte skilja direkt inläsning från en import.
• CLAUDE.md som symbolisk länk till AGENTS.md. Du kan behålla den: den läses inte in två gånger i något läge. Innan du tar bort länken i läget claude-md-or-agents-md kontrollerar du att de nödvändiga instruktionerna är bevarade och att det inte finns någon annan CLAUDE.md, .claude/CLAUDE.md eller CLAUDE.local.md i arbetskatalogen eller ovanför den. Kontrollera inläsningen på samma sätt: raden AGENTS.md loaded vid sessionsstart när inga blockerande filer finns, eller /memory (2.1.280+). Om CLAUDE.md finns kvar i läget claude-md-and-agents-md är en direkt fråga till Claude bara en svag kontroll. Att inget fel visas räcker inte för att bekräfta inläsningen.
• En SessionStart-hook som manuellt skrev ut innehållet i AGENTS.md. När filen läses direkt lägger en sådan hook in en andra kopia i kontexten. Så länge hooken körs bekräftar inte frågan ”vad står det i dina instruktioner?” direkt inläsning: Claude kan svara utifrån text som hooken lade till. Byt i den här ordningen:
  1. Kontrollera att funktionen är tillgänglig: version 2.1.277 eller senare, sessionen får funktionsflaggor, plugin-programmet är aktiverat och den första sessionen efter installation eller uppdatering är avslutad. Välj ett läge för direktläsning—varken claude-md eller managed-only. Kontrollera också att det inte finns några blockerande filer om du använder standardläget.
  2. Ta bort hooken.
  3. Stäng sessionen och öppna en ny. SessionStart-hooken lägger till sin text vid start, så innehållet finns kvar i kontexten i en redan öppen session. Claudes svar om instruktionsinnehållet i en sådan session bekräftar inte direkt inläsning.
  4. Kontrollera inläsningen i den nya sessionen. I version 2.1.280+ visas sökvägen till AGENTS.md i /memory. I versionerna 2.1.277–2.1.279 letar du, om det inte finns några blockerande filer, efter raden AGENTS.md loaded vid start: dokumentationen beskriver den specifikt för fallet där ingen CLAUDE.md hittades. Om du behåller CLAUDE.md och använder läget claude-md-and-agents-md är kontrollen begränsad: /memory visar inte AGENTS.md i dessa versioner, dokumentationen beskriver ingen inläsningsrad för det här fallet och en parafras av instruktionerna kan inte skilja direktläsning från en @-import i CLAUDE.md. Uppdatera i så fall till 2.1.280+ och kontrollera /memory.

Så kontrollerar du att AGENTS.md lästes in#

Ytterligare två skillnader jämfört med vanlig CLAUDE.md: InstructionsLoaded-hooks körs inte för den här typen av AGENTS.md (de fungerar däremot för AGENTS.md som importerats med @-syntax från CLAUDE.md eller kopplats via en symbolisk CLAUDE.md-länk); kataloger som lagts till med flaggan --add-dir tillsammans med variabeln CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD läser endast in den katalogens CLAUDE.md—dess AGENTS.md ingår inte.

Om du behöver granska innehållet i en stor projektinstruktionsfil kan du läsa den separata analysen om hur du konfigurerar CLAUDE.md utan att göra den överlastad. Den tar upp instruktionernas struktur, medan villkoren för inläsning av AGENTS.md beskrivs ovan. För arbetsanteckningar mellan sessioner, se analysen om en andra hjärna i Claude Code—om personligt minne ovanpå projektinstruktionerna.

Vad händer härnäst?#

Funktionen släpptes den 18 september 2026 i version 2.1.277. Anthropic kan förtydliga detaljer om lägena i framtida versioner, så kontrollera den här artikeln mot den aktuella /config och den officiella ändringsloggen innan du ändrar inställningar i ett viktigt projekt.