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

> Stödet kom i version 2.1.277. Har projektet båda filerna läses bara CLAUDE.md. Så ställer du om Claude Code till att läsa båda två.

Publicerad: 2026-09-20  
Skribent: Thomas Karlsson  
Sajt: Aipress.se  
URL: https://aipress.se/nyheter/claude-code-laser-agents-md/

Claude Code kan numera hämta projektets fasta instruktioner från filen `AGENTS.md`. Stödet kom i version 2.1.277, som Anthropic publicerade den 18 september 2026. Det förenklar arbetet i projekt som redan har samma fil för exempelvis Codex, Gemini CLI eller Cursor.

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](https://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:

```md
# 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](https://code.claude.com/docs/en/changelog): 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.

![Terminalfönster där mappen bara innehåller AGENTS.md och Claude Code svarar med kodordet ur filen](https://aipress.se/images/posts/claude-code-laser-agents-md-test.webp)

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:

```text
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`:

```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](https://developers.openai.com/codex/agent-configuration/agents-md) 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:

```bash
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.