En instruktionsfil för Claude Code, Codex och Cursor 2026

Information om tjänsten finns i Ailoot-dokumentationen.

Vad förändras när du använder Claude Code, Codex och Cursor tillsammans?#

I exemplet som beskrivs är Claude Code huvudverktyget, medan Codex och Cursor används för specifika uppgifter. Min CLAUDE.md har ungefär 250 rader instruktioner: vad som ska läsas och i vilken ordning, vad som inte får röras, vilka kommandon som ska användas för driftsättning och reglerna för commit-format. När jag först provade Codex CLI i projektet kände det inte till några av reglerna: det körde git push --force, rotade runt i .env och döpte om filer vårdslöst.

Jag kopierade först CLAUDE.md till AGENTS.md för hand. Två veckor senare upptäckte jag att projektet redan hade fyra versioner av samma instruktion: i CLAUDE.md, AGENTS.md, .cursorrules och .windsurf/rules/. De skilde sig alla åt lite grann. Det här är inte ett Claude- eller Cursor-problem; det är den grundläggande fallgropen i alla system med flera källor till sanning. Jag diskuterar problemet mer ingående i guiden om arbete med flera agenter.

I juni 2026 gav Anthropics dokumentation om minne i Claude Code ett svar: en delad fil plus en import. Sedan september 2026 läser Claude Code AGENTS.md direkt om projektet saknar CLAUDE.md, och en import behövs när du har regler som är specifika för Claude. Nedan förklarar jag när en enda AGENTS.md räcker, hur du konfigurerar en import och hur du skiljer delade regler från Claude-specifika.

Läser Claude Code AGENTS.md direkt?#

Före september 2026 var svaret ”nej”. Issue #6235, där stöd för AGENTS.md efterfrågades, hade varit öppen sedan augusti 2025 och stängdes den 17 augusti 2026. Dokumentationen om minne pekade på en lösning hela tiden: skapa en CLAUDE.md och inkludera AGENTS.md i den som en import. Från och med version 2.1.277 säger dokumentationen något annat:

Exakt vad Claude Code läser beror på vilka filer som finns i projektet:

För den här kontrollen räknas CLAUDE.md, .claude/CLAUDE.md och CLAUDE.local.md i arbetskatalogen och i alla kataloger ovanför den. En personlig ~/.claude/CLAUDE.md, en centralt hanterad företagsfil och regler från .claude/rules/ räknas inte: de läses in tillsammans med AGENTS.md.

När det inte finns någon CLAUDE.md läser Claude Code alla AGENTS.md- och .claude/AGENTS.md-filer i arbetskatalogen och ovanför den vid start, och hämtar in en AGENTS.md i en underkatalog när programmet öppnar en fil i den underkatalogen. @path-importer inne i AGENTS.md fungerar också. Claude Code läser inte AGENTS.local.md, AGENTS.override.md eller innehållet i katalogen .agents/.

Fallgropen: även en personlig CLAUDE.local.md räknas. Skapa en sådan för att behålla dina ocommittade regler, så slutar Claude Code tyst att läsa AGENTS.md. Inställningen nedan är lösningen.

Beteendet ändras i /config, under Project instructions:

Om du vill behålla CLAUDE.local.md utan att förlora AGENTS.md ställer du in claude-md-and-agents-md. Ingen dubbelläsning sker: om AGENTS.md redan inkluderas via raden @AGENTS.md eller en symbolisk länk läser Claude Code inte in den en andra gång, oavsett inställning.

Du kan kontrollera om filen har lästs in med kommandot /memory: från och med version 2.1.280 visas sökvägen till AGENTS.md i listan. I versioner före 2.1.277 och i sessioner där det inbyggda plugin-programmet agents-md är inaktiverat läser Claude Code bara CLAUDE.md, och det finns ingen post för Project instructions i /config. Före version 2.1.281 fungerade sessioner via Amazon Bedrock och sessioner med telemetri inaktiverad på samma sätt. I den första sessionen efter uppdatering från en äldre version kan AGENTS.md också utebli; det fungerar från och med nästa session.

Vad betyder det här för en konfiguration med en fil? Om du inte har regler som bara gäller Claude kan du hoppa över CLAUDE.md: AGENTS.md räcker, och Claude Code, Codex och Cursor läser den. Om du har sådana regler (planläge för riskfyllda kataloger, skills, hooks) behöver du CLAUDE.md, och då slutar Claude Code att läsa AGENTS.md på egen hand. Inkludera då AGENTS.md i CLAUDE.md med raden @AGENTS.md; den här konfigurationen fungerar precis som före september. Den fungerar också med äldre versioner av Claude Code. Jag förklarar det i detalj nedan.

Hur importerar du @AGENTS.md i CLAUDE.md?#

Ett minimalt fungerande exempel från den officiella dokumentationen:

@AGENTS.md

## Claude Code

Use plan mode for changes under `src/billing/`.

Så här fungerar det. Den första raden, @AGENTS.md, är en importinstruktion. När Claude Code tolkar CLAUDE.md i början av en session hittar det importen och infogar hela innehållet i AGENTS.md där den står. Därefter kommer rubriken ## Claude Code: den är bara markdown, men fungerar som ett avsnitt med ”Claude-specifika tillägg”. Under den finns en regel som bara gäller Claude Code: använd planläge för ändringar i faktureringskatalogen. Codex CLI eller Cursor öppnar inte den här filen alls; de använder den vanliga AGENTS.md.

Ett citat ur dokumentationen om hur importer fungerar:

Några praktiska detaljer:

• Relativa och absoluta sökvägar. @AGENTS.md är relativ till filen som innehåller importen. @/Users/me/shared/rules.md eller @~/.claude/personal.md är absoluta. Jag använder @~/.claude/personal.md för personliga preferenser som jag inte vill lägga i kodförrådet.
• Fyra nivåers djup. AGENTS.md kan importera @docs/coding-style.md, och coding-style.md kan importera ytterligare en fil, upp till fyra nivåer. Det räcker för alla verkliga strukturer.
• Backticks blockerar importer. Om texten säger `@README` är det bara ett omnämnande av namnet, inte en import. Det är användbart när du förklarar för läsare hur importer fungerar utan att utlösa en.
• Godkännande för filer utanför projektet. Om en import pekar utanför arbetskatalogen, som @~/.claude/personal.md, visar Claude Code en dialog med en lista över de filerna första gången. Om du tackar nej förblir externa importer inaktiverade och dialogen visas inte igen. @AGENTS.md i projektets rot utlöser ingen dialog. Det skyddar dig från att av misstag läsa in en orelaterad fil i kontexten.

Efter att jag bytte till den här konfigurationen i det beskrivna projektet minskade min CLAUDE.md från 250 rader till 60: @AGENTS.md plus fem till sju regler som bara gäller Claude Code (planläge för riskfyllda kataloger, vad man inte ska röra i adminområdet och hur commits ska formuleras). Allt som delas ligger i AGENTS.md, som Codex och Cursor läser.

När bör du välja en symbolisk länk och när en import?#

Dokumentationen visar alternativet med symbolisk länk så här:

ln -s AGENTS.md CLAUDE.md

Och direkt därefter ger den en uppriktig varning om Windows:

Jämförelsetabell:

Jag använder importer i det beskrivna projektet. Skälen:

1. Teamet använder olika plattformar. Jag använder Mac; i exemplet är teamet ungefär jämnt fördelat mellan Windows och Mac. Om en symbolisk länk finns i kodförrådet checkas den ut som en vanlig textfil med en enda rad, AGENTS.md, för Windows-användare utan Developer Mode. Det skapar märkliga buggar: ibland fungerar reglerna, ibland inte, och det är oklart varför.
2. Jag vill ha Claude-specifika regler. Under @AGENTS.md har min CLAUDE.md ett avsnitt med rubriken ”Claude Code” och regler: använd --effort high för arkitekturuppgifter, kör npm run build före git push och anropa inte /api/v1/deploy för hand. Codex förstår inte de här kommandona.
3. Det är enklare att felsöka. När något går fel öppnar jag CLAUDE.md och ser importen och mina åsidosättningar. En symbolisk länk har inget ”det här lades till här”. Mer om felsökning av Claude Code-inställningar finns i guiden om säkert läge.

Om du inte har Claude-specifika regler behövs ingen symbolisk länk från och med version 2.1.277: ta bort CLAUDE.md, så läser Claude Code AGENTS.md direkt. Behåll den symboliska länken bara om någon i teamet använder en version äldre än 2.1.277 och inte kan uppdatera. Om du har Claude-specifika regler är en import smidigare i nio fall av tio.

Vad läser Codex, Cursor, Copilot, Windsurf och Gemini CLI?#

En översikt över de sju huvudverktygen (baserad på varje verktygs officiella dokumentation):

Vad innebär det här? Om ett kodförråd har AGENTS.md (plus en CLAUDE.md med import när Claude-specifika regler behövs) får fem av de sju verktygen automatiskt uppdaterade instruktioner. Cursor och Windsurf, som har egna inbyggda filer, kan antingen lämnas som de är (AGENTS.md läses också av dem) eller få en @AGENTS.md-import tillagd – men deras syntax skiljer sig åt och stöds inte alltid.

Den enklaste strategin för ett nytt projekt:

1. Lägg alla delade regler i AGENTS.md – 95 % av reglerna hör hemma där.
2. Skapa CLAUDE.md om du behöver regler som bara gäller Claude: skriv @AGENTS.md på första raden och lägg sedan till ett avsnitt med Claude-specifika regler nedanför. Om det inte finns några sådana regler behövs inte CLAUDE.md; sedan version 2.1.277 har Claude Code läst AGENTS.md direkt.
3. Behåll .cursor/rules/ för Cursor i de sällsynta fall då något specifikt för Cursor behövs (kommandona @Codebase och @Docs).
4. Gör likadant för Windsurf: glöm det gamla .windsurfrules; använd bara det nya .windsurf/rules/ när du behöver mönster för dess syntax.

Den här metoden ger dig 80 % av nyttan med 20 % av arbetet. Min erfarenhet är att det blir besvärligt att underhålla fler än två källor till sanning (delade regler plus Claude-specifika) när jag hanterade team med olika verktyg i ”Antigravity”. Om någon i teamet lägger till en regel i .cursorrules och glömmer AGENTS.md kommer Cursor och Codex att vara oense en vecka senare.

Hur hämtar /init i Claude Code in en befintlig AGENTS.md?#

Anthropic beskriver /init så här i sin dokumentation:

Vad innebär det i praktiken? Kodförrådet jag beskrev hade en .cursorrules från när jag provade Cursor (ungefär 80 rader) och en AGENTS.md (120 rader, sammanställd för hand). När jag körde claude /init tog kommandot båda filerna, tog bort liknande regler och sammanställde en ren CLAUDE.md på en minut. Jag kontrollerade den efteråt och gjorde mindre ändringar – tog bort inaktuella delar och lade till en struktur med rubriker. Det gick snabbare än att skriva om från grunden.

Det interaktiva läget, där /init också läser AGENTS.md, aktiveras via en miljövariabel:

CLAUDE_CODE_NEW_INIT=1 claude

När /init startar ställer Claude en rad klargörande frågor: vilka artefakter som ska konfigureras (CLAUDE.md, skills, hooks), vilken teknikstack projektet använder och vilka kommandon som ska användas för tester. Sedan utforskar en underagent kodbasen – läser package.json, README.md och konfigurationsfiler – och fyller i det som saknas. Till slut visar den ett förslag som du kan redigera innan det sparas. Mer om hur du konfigurerar Claude Code när du startar ett projekt finns i den separata guiden.

Nu till nackdelen. Om projektet redan har en aktiv AGENTS.md skapar /init en CLAUDE.md bredvid den med en kopia av dess regler. Från den punkten läser Claude Code som standard bara CLAUDE.md, så det finns två källor till sanning igen: du uppdaterar AGENTS.md, medan Claude fortsätter att arbeta utifrån den gamla kopian. Kommandot /import gör något liknande: det lägger till en engångskopia av AGENTS.md i CLAUDE.md. För att behålla en enda källa lägger du importen @AGENTS.md på första raden i CLAUDE.md efter /init och tar bort allt i CLAUDE.md som upprepar AGENTS.md.

/init är en bra utgångspunkt för ett nytt projekt eller ett projekt som du flyttar över från Cursor eller Copilot. Du behöver inte söka på nätet efter den ”bästa CLAUDE.md-mallen” – Anthropic utgår redan från innehållet i kodförrådet. Om projektet redan har en aktiv AGENTS.md och inga Claude-specifika regler behövs inte /init: Claude Code läser AGENTS.md direkt.

Hur skiljer du delade instruktioner från Claude-specifika?#

Jag skiljer dem åt enligt den här principen. Delade regler som hör hemma i AGENTS.md:

• Vad som inte får röras i koden. Mapparna .env, node_modules, prisma/migrations (endast via prisma migrate), .next/, .git/.
• Hur saker ska namnges. Grenar: feat/, fix/, chore/. Commits: prefixen feat:, fix:, docs: plus en kort beskrivning. Komponentfiler i kebab-case.
• Kommandon för test/lint. npm run build, npm run lint, npm test. Vilket kommando som ska köras före git push.
• Arkitekturprinciper. Vad som hör hemma i src/lib/, vad som hör hemma i src/components/, var affärslogiken finns och var användargränssnittet finns.
• Säkerhet. Checka aldrig in hemligheter. Kom åt produktionsdatabasen endast via prod-psql. Anslut till produktion över SSH endast via aliaset prod, inte root@IP.

Claude-specifika regler som hör hemma i CLAUDE.md (under @AGENTS.md):

• Planläge. Använd plan mode för ändringar i riskfyllda kataloger (till exempel src/billing/).
• Ansträngningsnivå. Använd --effort high för arkitekturuppgifter och medium för rutinuppgifter.
• Skills. Vilka AI-agenter och skills som ska köras i olika situationer. Exempel: ”kör skillen build-masterskaya-guide när du arbetar med en guide”.
• Claude-minne. Vad som ska läggas i automatiskt minne och vad som ska läggas i CLAUDE.local.md. Mer om Claude-minne finns i guiden om Memory och CLAUDE.md.
• Hooks. Om .claude/settings.json har konfigurerade hooks beskriver du i CLAUDE.md vad de gör (Codex och Cursor känner inte till dem och behöver inte göra det).
• Skills och kommandon. En lista över slash-kommandon som jag ofta använder (/init, /cd, /memory, /plan).

Gränsen är inte alltid tydlig. Till exempel är ”kör aldrig git push --force till main” uppenbart en delad regel och hör hemma i AGENTS.md. Men ”använd planläge när du kör git push till en het gren” är specifikt för Claude Code och hör därför hemma i CLAUDE.md. Testet är: ”Om jag tog bort Claude Code i morgon och bara behöll Codex, skulle den här regeln fortfarande gälla?” Om ja, lägg den i AGENTS.md. Om nej, lägg den i CLAUDE.md.

Vad hör hemma i AGENTS.md, och vad hör hemma i CLAUDE.md eller .claude/rules?#

Om reglerna överstiger 200 rader är det dags att dela upp dem. Anthropics dokumentation rekommenderar att sikta på 200 rader per fil, eftersom långa CLAUDE.md-filer börjar leda till att regler följs sämre utan att det märks: Claude verkar läsa dem men följer dem mer sällan.

En struktur för ett stort projekt som fungerar för mig:

my-project/
├── AGENTS.md                    # 100-150 lines, shared
├── CLAUDE.md                    # 30-50 lines: @AGENTS.md + Claude-only
└── .claude/
    ├── CLAUDE.md                # alternative to root file, same file
    └── rules/
        ├── api.md               # with paths: ['src/api/**']
        ├── components.md        # with paths: ['src/components/**']
        ├── testing.md           # without paths, always active
        └── security.md          # without paths, always active

Varje fil i .claude/rules/ kan ha frontmatter:

---
paths:
  - "src/api/**/*.ts"
---

# API rules
- Every endpoint validates input with zod
- Errors use the standard `{error, code}` format
- OpenAPI comments are required

Claude läser in dessa regler bara när det arbetar med filer som matchar mönstret. Om det ändrar src/components/Button.tsx läggs API-reglerna inte till i kontexten. På så sätt används kontextfönstret bara för det som är relevant. Katalogen .claude/rules/ fungerar också utan CLAUDE.md: om projektet bara innehåller AGENTS.md läses dess regler in tillsammans med den, och de inaktiverar inte direkt läsning av AGENTS.md.

Cursor och Windsurf stöder samma metod genom katalogerna .cursor/rules/ och .windsurf/rules/. AGENTS.md-standarden kan hänvisa till dessa kataloger, men syntaxen mellan verktygen är ännu inte helt stabil. Det är säkrare att hålla delade regler i AGENTS.md och duplicera sökvägsbegränsade regler i .claude/rules/ och .cursor/rules/ – det här är sällsynta specialfall, inte huvuddelen av reglerna.

Användbara platser för CLAUDE.md (ordnade från bredast till snävaste omfattning):

Ett exempel på en ~/.claude/CLAUDE.md kan innehålla två regler: ”svara på det språk användaren föredrar” och ”stava Ailoot exakt så här”. De här reglerna gäller för alla projekt, så det finns ingen anledning att duplicera dem i varje kodförråd.

Av dessa fyra nivåer är det bara en projektbaserad CLAUDE.md och CLAUDE.local.md som inaktiverar direkt läsning av AGENTS.md. En personlig ~/.claude/CLAUDE.md och en centralt hanterad policy står inte i vägen; Claude Code läser in dem tillsammans med AGENTS.md.

Vad ska du göra om AGENTS.md redan är inaktuell i projektet?#

I projektet jag beskrev hade jag en AGENTS.md från maj 2025 – 180 rader, många av dem inaktuella (den nämnde Anthropic API-slutpunkter som hade ändrats sedan dess, exempel med den syntax för claude --tools som inte längre finns och regler om ~/.claude/projects/ med en inaktuell struktur).

Planen jag använde för att uppdatera den:

1. Granska den med claude i planläge. Jag öppnar kodförrådet, kör claude --safe-mode och ber: “Läs AGENTS.md igen och föreslå en lista över inaktuella eller upprepade punkter. Redigera den inte; lista bara punkterna.” På två minuter fick jag en lista med 23 punkter att granska.
2. Ta bort uppenbart inaktuella punkter. Av de 23 punkterna var 9 tydligt inaktuella – kommandosyntax, slutpunkter och flaggnamn. Jag tog bort de raderna.
3. Slå ihop dubbletter. Ytterligare 6 punkter upprepade varandra med olika formuleringar (”gör ingen force-push”, ”använd aldrig --force”, ”undvik git push -f”). Jag slog ihop dem till en rad.
4. Lägg till nya punkter. Jag lade till sådant som jag hade märkt att Claude/Codex regelbundet fick fel under den senaste månaden, enligt regeln ”en rad per felmönster”. Det gav 8 nya punkter.
5. Kör en underagent för slutgranskning. Jag bad Claude granska den med instruktionen ”hitta motsägelser, tvetydigheter och dubbletter”. Den hittade tre formuleringar som kunde göras tydligare. Jag rättade dem.

Efter en timme var AGENTS.md 110 rader lång och aktuell, och jag kände till varje rad. Det var lätt att bygga en CLAUDE.md på 30 rader utifrån den. Codex blev också märkbart noggrannare med tester efteråt – jag misstänker att en del av dess ”konstiga” beslut berodde på inaktuella instruktioner som det hade följt i god tro.

Huvudprinciperna för en levande AGENTS.md:

• Varje regel svarar mot ett återkommande misstag. Om jag inte kom att tänka på en regel en enda gång under månaden finns det ingen poäng med att behålla den.
• Skriv regler som uppmaningar, inte som teori. ”Använd två blanksteg” är en regel. ”Kodstilen bör vara snygg” är det inte.
• Var konkret. ”Kör npm run build före git push” är en regel. ”Testa ändringarna” är det inte.

Vad fungerar DEFINITIVT INTE med den här konfigurationen?#

Några saker jag lärde mig den hårda vägen under sex månaders arbete med den här konfigurationen:

1. Cursor-autokomplettering använder inte AGENTS.md. När Cursor föreslår att komplettera en rad i redigeraren läser det inte AGENTS.md i realtid – det är en separat snabb motor som arbetar. Regler i AGENTS.md spelar bara roll när du skickar en chattförfrågan i Cursor. Det betyder att om du skriver ”använd inte var, använd const” i AGENTS.md påverkar det inte automatisk komplettering; du behöver konfigurera detta via ESLint eller TypeScript-konfigurationen.

2. Claude Code-hooks i AGENTS.md fungerar inte för Codex. Om .claude/settings.json har en konfigurerad PreToolUse-hook som blockerar en viss åtgärd är den informationen bara användbar för Claude. Codex känner inte till hooks; för det är det ”verktyget bestämmer själv”. Det är rimligt att skriva ”gör inte X” i AGENTS.md och ”det finns en hook som fysiskt blockerar X” i CLAUDE.md under importen.

3. Copilot och .github/copilot-instructions.md. GitHub Copilot läser sin egen fil och läser fortfarande inte AGENTS.md särskilt bra. Om ditt team använder Copilot aktivt kan du antingen lägga till en separat .github/copilot-instructions.md med en förkortad version av reglerna eller använda Copilot Extensions som känner till AGENTS.md. Det här förändras snabbt, så bilden kan se annorlunda ut om tre till sex månader.

4. Git registrerar inte en symbolisk länk som en ändring i CLAUDE.md. Om du kör ln -s AGENTS.md CLAUDE.md och uppdaterar AGENTS.md en vecka senare visar Git en diff bara för AGENTS.md. Det är normalt, men en kollega som granskar PR:en kanske inte inser att CLAUDE.md också har uppdaterats (via den symboliska länken). Lösning: skriv uttryckligen i PR-beskrivningen: ”uppdaterade AGENTS.md; Claude Code ser samma fil via den symboliska länken”.

5. Djupa importer är svåra att felsöka. Om AGENTS.md importerar @docs/coding-style.md, som importerar @docs/typescript.md, och någon regel står i konflikt med en annan blir felsökningen svår. Jag håller importer på en nivå (CLAUDE.md → AGENTS.md) och nästlar inte vidare. Anthropic tillhandahåller en InstructionsLoaded-hook som loggar vilka filer som lästes in – användbart för att felsöka lagerindelade konfigurationer. Obs: hooken körs för AGENTS.md som inkluderas via en import eller symbolisk länk, men inte för AGENTS.md som Claude Code läste självt.

Den kompletta uppsättningen för vibe-kodning på en kväll: AI-klon + Second Brain + kontextteknik.

Lär känna Ailoot.