Claude Code läser AGENTS.md när CLAUDE.md saknas

Det finns en viktig begränsning: Claude Code går till AGENTS.md bara när projektet saknar CLAUDE.md. Om de två filerna finns väljs fortfarande Anthropics egen.

Så fungerar CLAUDE.md och AGENTS.md

CLAUDE.md och AGENTS.md är vanliga textfiler skrivna i Markdown. De kan exempelvis innehålla kommandon för att starta projektet, regler för hur koden ska se ut och varningar om filer som AI-assistenten inte får ändra.

Fördelen är att reglerna följer med projektet. Du behöver inte upprepa dem varje gång du öppnar en ny konversation med kodassistenten.

CLAUDE.md är Anthropics egen lösning för Claude Code. AGENTS.md har vuxit fram som en gemensam konvention för flera olika kodverktyg. Formatet förvaltas numera av Agentic AI Foundation under Linux Foundation och används enligt konventionssajten agents.md i fler än 60 000 projekt med öppen källkod.

Sajten räknar upp drygt 20 kompatibla verktyg, däribland Codex, Cursor, Gemini CLI, Zed och Warp. Claude Code står inte med på listan. Anthropic har alltså lagt till stöd för en fil som andra aktörer redan bygger på, men har gett den ett beteende som följer Claude Codes egna regler.

Filen har inga obligatoriska rubriker eller fält. Ett enkelt exempel kan se ut så här:

# Projektinstruktioner

## Kommandon

- Installera paket med `npm install`
- Starta utvecklingsservern med `npm run dev`
- Kör testerna med `npm test`

## Regler

- Använd TypeScript
- Ändra inte filer i mappen `migrations`
- Kör testerna före varje commit

Claude Code väljer en fil som standard

Ändringen beskrivs kort i ändringsloggen för Claude Code 2.1.277: om ett projekt saknar CLAUDE.md hämtar Claude Code innehållet i AGENTS.md i stället.

Det innebär tre olika utfall:

• Bara CLAUDE.md finns: Claude Code använder den.
• Bara AGENTS.md finns: Claude Code använder den.
• Båda finns: Claude Code använder normalt bara CLAUDE.md.

Anthropic har alltså inte ersatt eller börjat avveckla CLAUDE.md. För projekt som redan har filen förändras inget.

Regeln omfattar också CLAUDE.local.md och .claude/CLAUDE.md i den aktuella mappen eller någon överordnad mapp. En personlig CLAUDE.local.md kan därför ge ett oväntat resultat: om projektet bygger på AGENTS.md slutar Claude Code att hämta innehållet därifrån för just dig.

En global ~/.claude/CLAUDE.md, organisationens centralt hanterade instruktioner och regler under .claude/rules/ blockerar däremot inte AGENTS.md.

Våra tester bekräftar prioriteringen

Vi provade beteendet i Claude Code 2.1.278, versionen som publicerades dagen efter lanseringen. Testerna kördes i tillfälliga tomma mappar. Varje projektfil fick ett påhittat kodord, varefter Claude Code fick frågan vilket kodord projektet använde.

När mappen bara innehöll AGENTS.md svarade Claude Code med kodordet från den filen. Det fungerade alltså utan någon extra inställning.

I nästa försök fanns CLAUDE.md och AGENTS.md, med olika kodord. Svaret innehöll bara ordet från CLAUDE.md. Det bekräftar att AGENTS.md inte laddas parallellt med Anthropics fil i standardläget.

När inställningen claude-md-and-agents-md aktiverades återgav Claude Code de två kodorden.

Vi provade även en AGENTS.md som innehöll raden @extra.md. Det andra kodordet låg i filen extra.md. Claude Code hittade båda orden, vilket visar att importraden fungerar även inifrån AGENTS.md.

Samma beteende syntes i aipress.se-projektet. Där finns de två filtyperna, och en vanlig session laddade endast CLAUDE.md.

I en interaktiv session visas också ett konkret kvitto när reservlösningen används:

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

Så får du Claude Code att läsa båda

Om projektet behöver behålla de två filerna kan du ändra prioriteringen:

1. Starta Claude Code.
2. Skriv /config.
3. Öppna inställningen Project instructions.
4. Välj claude-md-and-agents-md.

Ändringen börjar gälla från nästa meddelande och i nya sessioner.

Inställningen kan även skrivas i den personliga filen ~/.claude/settings.json:

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

Claude Code ignorerar detta val om det placeras i projektets eller den lokala inställningsfilen. Det behöver ligga i användarens inställningar, i en fil som anges med --settings eller i organisationens centralt hanterade konfiguration.

Samma fil fungerar olika i Claude Code och Codex

Förändringen gör det lättare att använda ett projekt med flera kodassistenter, men AGENTS.md är fortfarande ingen detaljerad teknisk standard. Konventionen anger i princip filnamnet, Markdown-formatet och möjligheten att placera mer specifika filer längre ned i projektets mappstruktur.

Varje produkt bestämmer själv hur innehållet ska hittas och kombineras.

Claude Code väljer normalt mellan CLAUDE.md och AGENTS.md. OpenAI Codex bygger i stället en kedja av projektregler. Enligt dokumentationen börjar programmet med en global fil under ~/.codex och lägger sedan till en fil från varje relevant mapp, från projektroten ned till den aktuella arbetsmappen. Material närmare koden får därmed högre prioritet. Den sammanlagda standardgränsen är 32 KiB.

Den globala filen är OpenAIs eget tillägg. Konventionen på agents.md beskriver bara placering i ett kodprojekt och definierar ingen fil på användarnivå. Personliga regler följer därför inte automatiskt med när du byter mellan olika kodassistenter.

Codex saknar dessutom en dokumenterad motsvarighet till Claude Codes @extra.md-importer. En sådan rad bör därför inte bära regler som måste fungera likadant på båda ställena. Lägg de gemensamma delarna direkt i AGENTS.md, eller dela upp dem mellan rätt undermappar.

Codex kan importera en uppsättning från Claude Code, och i skrivbordsappen går det att hålla det importerade materialet uppdaterat automatiskt. Förbindelsen går dock bara åt ett håll. En sökning efter ”codex” i hela Claude Codes ändringslogg ger ingen träff, så någon motsvarande väg tillbaka finns inte dokumenterad. Överföringen gäller dessutom uppsättningen, inte det arbete som senare har utförts i projektet. AGENTS.md är därför en gemensam utgångspunkt, inte en universell synkronisering mellan produkterna.

När AGENTS.md inte fungerar i Claude Code

Kontrollera först din version:

claude --version

AGENTS.md kräver version 2.1.277 eller senare. Efter en installation eller uppgradering kan stödet enligt dokumentationen börja fungera först i nästa session.

Det kan också saknas när sessionen inte hämtar funktionsflaggor från Anthropic. Det gäller bland annat vissa installationer via Amazon Bedrock, Google Vertex AI, Microsoft Foundry och andra externa leverantörer. Avstängd telemetri eller begränsningar för inbyggda insticksprogram och krokar kan ge samma resultat. Då visas inte heller valet Project instructions under /config.

För den som redan har CLAUDE.md finns inget som måste ändras. Nyheten märks främst i projekt som har skapats för andra kodassistenter: om AGENTS.md redan finns och ingen Claude-fil ligger i vägen kan Claude Code nu börja arbeta med projektets instruktioner direkt.