Ena datoteka z navodili za Claude Code, Codex in Cursor leta 2026

Informacije o storitvi najdete v dokumentaciji Ailoot.

Kaj se spremeni, ko skupaj uporabljate Claude Code, Codex in Cursor?#

V opisanem primeru je glavno orodje Claude Code, Codex in Cursor pa se uporabljata za posebna opravila. Moj CLAUDE.md vsebuje približno 250 vrstic navodil: kaj prebrati in v kakšnem vrstnem redu, česa se ne smem dotakniti, katere ukaze uporabiti za namestitev ter kakšna so pravila za oblikovanje commitov. Ko sem v projektu prvič preizkusil Codex CLI, ni poznal nobenih pravil: izvedel je git push --force, brskal po .env in malomarno preimenoval datoteke.

Najprej sem ročno kopiral CLAUDE.md v AGENTS.md. Dva tedna pozneje sem ugotovil, da so v projektu že štiri različice istih navodil: v CLAUDE.md, AGENTS.md, .cursorrules in .windsurf/rules/. Vse so se nekoliko razlikovale. To ni težava Claudea ali Cursora, temveč osnovna past vsakega sistema z več viri resnice. O tem podrobneje pišem v vodniku za delo z več agenti.

Junija 2026 je Anthropicova dokumentacija o pomnilniku Claude Code ponudila en odgovor: skupna datoteka in uvoz. Od septembra 2026 Claude Code sam prebere AGENTS.md, če projekt nima datoteke CLAUDE.md; uvoz je potreben, kadar imate pravila, namenjena posebej Claudu. Spodaj pojasnim, kdaj zadostuje ena sama datoteka AGENTS.md, kako nastaviti uvoz in kako ločiti skupna pravila od pravil, specifičnih za Claude.

Ali Claude Code sam prebere AGENTS.md?#

Pred septembrom 2026 je bil odgovor »ne«. Issue #6235, v katerem so zahtevali podporo za AGENTS.md, je bil odprt od avgusta 2025 in zaprt 17. avgusta 2026. Dokumentacija o pomnilniku je ves ta čas priporočala eno rešitev: ustvarite CLAUDE.md in vanj kot uvoz vključite AGENTS.md. Od različice 2.1.277 dokumentacija pravi nekaj drugega:

Kaj natančno Claude Code prebere, je odvisno od tega, katere datoteke so v projektu:

Pri tem preverjanju štejejo datoteke CLAUDE.md, .claude/CLAUDE.md in CLAUDE.local.md v delovnem imeniku in katerem koli imeniku nad njim. Osebna datoteka ~/.claude/CLAUDE.md, upravljana korporativna datoteka in pravila iz .claude/rules/ ne štejejo: naložijo se skupaj z AGENTS.md.

Če datoteke CLAUDE.md ni, Claude Code ob zagonu prebere vse datoteke AGENTS.md in .claude/AGENTS.md v delovnem imeniku in nad njim, datoteko AGENTS.md v podimeniku pa zazna, ko odpre datoteko v tem podimeniku. Delujejo tudi uvozi @path znotraj datoteke AGENTS.md. Claude Code ne bere datotek AGENTS.local.md, AGENTS.override.md ali vsebine imenika .agents/.

Pozor: šteje tudi osebna datoteka CLAUDE.local.md. Če jo ustvarite, da bi shranili svoja neobjavljena pravila, Claude Code tiho preneha brati AGENTS.md. Rešitev je spodnja nastavitev.

Vedenje lahko spremenite v razdelku Project instructions pod /config:

Če želite obdržati CLAUDE.local.md, ne da bi izgubili AGENTS.md, nastavite claude-md-and-agents-md. Podvajanja ne bo: če je AGENTS.md že vključen prek vrstice @AGENTS.md ali simbolične povezave, ga Claude Code ne naloži še enkrat, ne glede na nastavitev.

Ali je bila datoteka zaznana, lahko preverite z ukazom /memory: od različice 2.1.280 se pot do AGENTS.md pojavi na seznamu. V različicah pred 2.1.277 in sejah, v katerih je vgrajeni vtičnik agents-md onemogočen, Claude Code bere samo CLAUDE.md, v /config pa ni možnosti Project instructions. Pred različico 2.1.281 so enako delovale tudi seje prek Amazon Bedrock in seje z onemogočeno telemetrijo. V prvi seji po posodobitvi s starejše različice se AGENTS.md morda prav tako ne bo zaznal; delovati začne v naslednji seji.

Kaj to pomeni za nastavitev z eno datoteko? Če nimate pravil, namenjenih posebej Claudu, lahko izpustite CLAUDE.md: AGENTS.md zadostuje in prebrali jo bodo Claude Code, Codex in Cursor. Če takšna pravila imate (plan mode za tvegane imenike, skills, hooks), potrebujete CLAUDE.md, Claude Code pa bo prenehal samostojno brati AGENTS.md. Nato vključite AGENTS.md v CLAUDE.md z vrstico @AGENTS.md; ta nastavitev deluje enako kot pred septembrom. Pomaga tudi pri starejših različicah Claude Code. Podrobnosti pojasnim spodaj.

Kako uvoziti @AGENTS.md v CLAUDE.md?#

Minimalni delujoči primer iz uradne dokumentacije:

@AGENTS.md

## Claude Code

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

Tako deluje. Prva vrstica, @AGENTS.md, je direktiva za uvoz. Ko Claude Code na začetku seje razčleni CLAUDE.md, najde ta uvoz in na njegovo mesto vstavi celotno vsebino AGENTS.md. Sledi naslov ## Claude Code: to je navaden markdown, ki služi kot razdelek »dodatna pravila za Claude«. Pod njim je pravilo, ki velja samo za Claude Code: pri spremembah v imeniku billing uporabi plan mode. Codex CLI ali Cursor te datoteke sploh ne odpreta; uporabljata navadni AGENTS.md.

Citat iz dokumentacije o delovanju uvozov:

Nekaj praktičnih podrobnosti:

• Relativne in absolutne poti. @AGENTS.md je relativna pot glede na datoteko, ki vsebuje uvoz. @/Users/me/shared/rules.md ali @~/.claude/personal.md sta absolutni poti. @~/.claude/personal.md uporabljam za osebne nastavitve, ki jih ne želim dodati v skladišče.
• Globina štirih korakov. AGENTS.md lahko uvozi @docs/coding-style.md, datoteka coding-style.md pa lahko uvozi drugo datoteko, skupaj do štirih ravni. To zadostuje za vsako dejansko strukturo.
• Ograjeni narekovaji preprečijo uvoz. Če besedilo vsebuje `@README`, gre zgolj za omembo imena, ne za uvoz. To je uporabno, ko bralcem razlagate delovanje uvozov, ne da bi ga sprožili.
• Odobritev za datoteke zunaj projekta. Če uvoz kaže zunaj delovnega imenika, kot pri @~/.claude/personal.md, Claude Code ob prvi uporabi prikaže pogovorno okno s seznamom teh datotek. Če ga zavrnete, zunanji uvozi ostanejo onemogočeni, pogovorno okno pa se ne prikaže več. @AGENTS.md v korenu projekta ne sproži pogovornega okna. To vas ščiti pred nenamernim nalaganjem nepovezane datoteke v kontekst.

Ko sem v opisanem projektu prešel na to nastavitev, se je moj CLAUDE.md skrajšal z 250 na 60 vrstic: @AGENTS.md in pet do sedem pravil, ki veljajo samo za Claude Code (plan mode za tvegane imenike, česa se ne dotikati v skrbniškem območju in kako oblikovati commite). Vsa skupna pravila so v AGENTS.md, ki jo bereta Codex in Cursor.

Kdaj izbrati simbolično povezavo in kdaj uvoz?#

Dokumentacija možnost s simbolično povezavo pokaže takole:

ln -s AGENTS.md CLAUDE.md

Nato takoj poda odkrito opozorilo glede sistema Windows:

Primerjalna tabela:

V opisanem projektu uporabljam uvoze. Razlogi:

1. Ekipa je mešana. Uporabljam Mac; v tem primeru je ekipa približno enakomerno razdeljena med Windows in Mac. Če je v skladišču simbolična povezava, jo bodo uporabniki sistema Windows brez Developer Mode prenesli kot navadno besedilno datoteko z eno samo vrstico AGENTS.md. To povzroča nenavadne napake: včasih pravila delujejo, včasih ne, vzrok pa ni jasen.
2. Želim pravila, specifična za Claude. Pod @AGENTS.md ima moj CLAUDE.md razdelek »Claude Code« s pravili: za arhitekturna opravila uporabi --effort high, pred git push zaženi npm run build in ne kliči ročno /api/v1/deploy. Codex teh ukazov ne razume.
3. Lažje odpravljanje napak. Ko gre kaj narobe, odprem CLAUDE.md in vidim uvoz ter svoje prilagoditve. Pri simbolični povezavi ni oznake »to je bilo dodano tukaj«. Več o odpravljanju napak v nastavitvah Claude Code preberite v vodniku za safe mode.

Če nimate pravil, specifičnih za Claude, simbolična povezava od različice 2.1.277 ni več potrebna: izbrišite CLAUDE.md in Claude Code bo sam prebral AGENTS.md. Simbolično povezavo ohranite le, če kdo v ekipi uporablja različico pred 2.1.277 in je ne more posodobiti. Če imate pravila za Claude, je uvoz v devetih primerih od desetih priročnejši.

Kaj berejo Codex, Cursor, Copilot, Windsurf in Gemini CLI?#

Pregled sedmih glavnih orodij (na podlagi uradne dokumentacije posameznega orodja):

Kaj sledi iz tega? Če ima repozitorij AGENTS.md (in po potrebi še CLAUDE.md z uvozom za pravila, specifična za Claude), pet od sedmih orodij samodejno dobi sveža navodila. Cursor in Windsurf, ki imata lastni izvorni datoteki, lahko pustite pri miru (AGENTS.md bereta tudi onidve) ali dodate uvoz @AGENTS.md—vendar se njuna sintaksa razlikuje in ni vedno podprta.

Najpreprostejša strategija za nov projekt:

1. Vsa skupna pravila zapišite v AGENTS.md—tja sodi 95% pravil.
2. Ustvarite CLAUDE.md, če potrebujete pravila, namenjena samo Claudu: v prvo vrstico postavite @AGENTS.md, nato pa spodaj dodajte razdelek s pravili za Claude. Če takšnih pravil ni, datoteke CLAUDE.md ne potrebujete; Claude Code od različice 2.1.277 sam bere AGENTS.md.
3. Ohranite .cursor/rules/ za Cursor za redke primere, ko potrebujete nekaj, specifično za Cursor (ukaza @Codebase in @Docs).
4. Enako naredite za Windsurf: pozabite na stari .windsurfrules; novi .windsurf/rules/ uporabite samo, če potrebujete vzorce za njegovo sintakso.

Ta pristop prinese 80% koristi z 20% dela. Po mojih izkušnjah je pri urejanju mešanih ekip v »Antigravity« vzdrževanje več kot dveh virov resnice (skupnega in Claude-specifičnega) postalo naporno. Če kdo v ekipi doda pravilo v .cursorrules in pozabi posodobiti AGENTS.md, se Cursor in Codex čez teden dni ne bosta strinjala.

Kako /init v Claude Code uporabi obstoječi AGENTS.md?#

Anthropic v dokumentaciji /init opisuje takole:

Kaj to pomeni v praksi? Opisani repozitorij je imel datoteko .cursorrules iz časa, ko sem preizkušal Cursor (približno 80 vrstic), in ročno sestavljeno datoteko AGENTS.md (120 vrstic). Ko sem zagnal claude /init, je ukaz uporabil obe datoteki, odstranil podvojena podobna pravila in v minuti sestavil urejeno datoteko CLAUDE.md. Nato sem jo pregledal in nekoliko popravil—odstranil zastarele elemente ter dodal strukturo z naslovi. To je bilo hitreje kot pisanje od začetka.

Interaktivni način, v katerem /init bere tudi AGENTS.md, omogočite s spremenljivko okolja:

CLAUDE_CODE_NEW_INIT=1 claude

Ko se /init zažene, Claude postavi več pojasnjevalnih vprašanj: katere elemente naj konfigurira (CLAUDE.md, skills, hooks), kateri tehnološki sklad uporablja projekt in katere ukaze naj uporablja za teste. Nato podagent razišče kodno zbirko—prebere package.json, README.md in konfiguracijske datoteke—ter dopolni manjkajoče dele. Na koncu prikaže predlog, ki ga lahko pred shranjevanjem uredite. Več o konfiguraciji Claude Code ob začetku projekta preberite v ločenem vodniku.

Zdaj pa slaba stran. Če projekt že vsebuje aktivni AGENTS.md, bo /init poleg njega ustvaril CLAUDE.md s kopijo njegovih pravil. Od takrat Claude Code privzeto bere samo CLAUDE.md, zato imate znova dva vira resnice: vi posodabljate AGENTS.md, Claude pa še naprej uporablja staro kopijo. Ukaz /import naredi nekaj podobnega: v CLAUDE.md doda enkratno kopijo datoteke AGENTS.md. Če želite ohraniti en sam vir, po uporabi /init postavite uvoz @AGENTS.md v prvo vrstico datoteke CLAUDE.md in iz nje odstranite vse, kar ponavlja vsebino datoteke AGENTS.md.

/init je pravo izhodišče za nov projekt ali projekt, ki ga prenašate s Cursora ali Copilota. Na spletu vam ni treba iskati »najboljše predloge CLAUDE.md«—Anthropic že upošteva vsebino repozitorija. Če projekt že ima aktivni AGENTS.md in nima pravil, namenjenih samo Claudu, /init ni potreben: Claude Code bo sam prebral AGENTS.md.

Kako ločiti skupna navodila od navodil, specifičnih za Claude?#

Ločujem jih po tem načelu. Skupna pravila, ki sodijo v AGENTS.md:

• Česa se v kodi ne dotikati. Map .env, node_modules, prisma/migrations (samo prek prisma migrate), .next/ in .git/.
• Kako poimenovati stvari. Veje: predpone feat/, fix/, chore/. Commity: predpone feat:, fix:, docs: in kratek opis. Datoteke komponent naj uporabljajo kebab-case.
• Ukazi za testiranje/lint. npm run build, npm run lint, npm test. Kateri ukaz zagnati pred git push.
• Arhitekturna načela. Kaj sodi v src/lib/, kaj v src/components/, kje je poslovna logika in kje uporabniški vmesnik.
• Varnost. Nikoli ne commitajte skrivnosti. Do produkcijske podatkovne zbirke dostopajte samo prek prod-psql. Do produkcije prek SSH dostopajte samo z aliasom prod, ne z root@IP.

Pravila, specifična za Claude, ki sodijo v CLAUDE.md (pod @AGENTS.md):

• Plan mode. Za spremembe v tveganih imenikih (na primer src/billing/) uporabite plan mode.
• Raven truda. Za arhitekturna opravila uporabite --effort high, za rutinsko delo pa medium.
• Skills. Katere AI-agente in skills zagnati v posameznih primerih. Na primer: »Pri delu na vodniku zaženite skill build-masterskaya-guide.«
• Claudeov pomnilnik. Kaj shraniti v samodejni pomnilnik in kaj v CLAUDE.local.md. Več o Claudeovem pomnilniku preberite v vodniku o pomnilniku in CLAUDE.md.
• Hooks. Če so v .claude/settings.json nastavljeni hooks, v CLAUDE.md opišite, kaj počnejo (Codex in Cursor zanje ne vesta in tega ne potrebujeta).
• Skills in ukazi. Seznam ukazov s poševnico, ki jih pogosto uporabljam (/init, /cd, /memory, /plan).

Meja ni vedno jasna. »Nikoli ne izvedi git push --force v vejo main« je očitno skupno pravilo, zato sodi v AGENTS.md. Toda »pred ukazom git push v vročo vejo najprej uporabi plan mode« je specifično za Claude Code, zato sodi v CLAUDE.md. Preizkusite tako: »Če bi jutri odstranil Claude Code in obdržal samo Codex, ali bi to pravilo še veljalo?« Če da, ga zapišite v AGENTS.md. Če ne, ga zapišite v CLAUDE.md.

Kaj sodi v AGENTS.md in kaj v CLAUDE.md ali .claude/rules?#

Če pravila presežejo 200 vrstic, jih je čas razdeliti. Anthropicova dokumentacija priporoča približno 200 vrstic na datoteko, saj Claude pri dolgih datotekah CLAUDE.md začne tiho slabše upoštevati navodila: videti je, da jih prebere, vendar jih upošteva redkeje.

Struktura za velik projekt, ki se je pri meni obnesla:

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

Vsaka datoteka v .claude/rules/ lahko vsebuje zaglavje 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 ta pravila naloži samo pri delu z datotekami, ki ustrezajo temu vzorcu. Če spreminja src/components/Button.tsx, se pravila za API ne dodajo v kontekst. Tako se kontekstno okno porabi le za relevantno vsebino. Imenik .claude/rules/ deluje tudi brez CLAUDE.md: če projekt vsebuje samo AGENTS.md, se njegova pravila naložijo skupaj z njo in ne onemogočijo neposrednega branja AGENTS.md.

Cursor in Windsurf podpirata enak pristop prek imenikov .cursor/rules/ in .windsurf/rules/. Standard AGENTS.md se lahko sklicuje na te imenike, vendar sintaksa, skupna različnim orodjem, še ni povsem stabilna. Varneje je skupna pravila ohraniti v AGENTS.md, pravila, omejena na določene poti, pa podvojiti v .claude/rules/ in .cursor/rules/—to so redke posebnosti, ne večina pravil.

Uporabne lokacije za CLAUDE.md (od najširšega do najožjega obsega):

Datoteka ~/.claude/CLAUDE.md bi lahko vsebovala dve pravili: »odgovarjaj v uporabnikovem prednostnem jeziku« in »Ailoot vedno zapiši natanko tako«. Ti pravili veljata za vsak projekt, zato ju ni treba podvajati v vsakem repozitoriju.

Od teh štirih ravni neposredno branje AGENTS.md onemogočita samo projektna datoteka CLAUDE.md in CLAUDE.local.md. Osebna datoteka ~/.claude/CLAUDE.md in upravljani pravilnik ne ovirata branja; Claude Code ju naloži skupaj z AGENTS.md.

Kaj storiti, če je AGENTS.md v vašem projektu že zastarel?#

V opisanem projektu sem imel AGENTS.md iz maja 2025—180 vrstic, med katerimi jih je bilo veliko zastarelih (omenjala je končne točke Anthropic API, ki so se od takrat spremenile; primere s sintakso claude --tools, ki ne obstaja več; ter pravila za ~/.claude/projects/ z zastarelo strukturo).

Za posodobitev sem uporabil ta načrt:

1. Preglejte ga z ukazom claude v načinu plan mode. Odprem repozitorij, zaženem claude --safe-mode in prosim: “Znova preberi AGENTS.md in predlagaj seznam zastarelih ali podvojenih elementov. Ne urejaj datoteke; samo naštej jih.” V dveh minutah sem dobil seznam 23 elementov za pregled.
2. Odstranite očitno zastarele elemente. Od 23 elementov jih je bilo 9 očitno zastarelih—sintaksa ukazov, končne točke in imena zastavic. Te vrstice sem izbrisal.
3. Združite podvojene elemente. Še 6 elementov je z različnimi besedami ponavljalo isto (»ne uporabljaj force-push«, »nikoli ne uporabi --force«, »izogibaj se ukazu git push -f«). Združil sem jih v eno vrstico.
4. Dodajte nove elemente. Dodal sem stvari, pri katerih sta se Claude/Codex v zadnjem mesecu redno motila, po pravilu »ena vrstica za vsak vzorec napake«. Tako je nastalo 8 novih elementov.
5. Za končni pregled uporabite podagenta. Clauda sem prosil za pregled z navodilom »poišči protislovja, dvoumnosti in podvojitve«. Našel je tri formulacije, ki bi bile lahko jasnejše. Popravil sem jih.

Po eni uri je imel AGENTS.md 110 vrstic, bil je posodobljen in poznal sem vsako vrstico. Iz njega je bilo lahko sestaviti CLAUDE.md s 30 vrsticami. Codex je bil po tem tudi opazno previdnejši pri testih—sumim, da so nekatere njegove »čudne« odločitve izhajale iz zastarelih pravil, ki jih je v dobri veri upošteval.

Glavna načela za sproti posodobljeno datoteko AGENTS.md:

• Vsako pravilo odgovarja na ponavljajočo se napako. Če se v enem mesecu na pravilo sploh nisem spomnil, ga ni vredno obdržati.
• Pravila zapišite kot ukaze, ne kot teorijo. »Uporabljaj dva presledka« je pravilo. »Slog kode naj bo urejen« ni.
• Konkretno je boljše od splošnega. »Pred git push zaženi npm run build« je pravilo. »Preizkusite spremembe« ni.

Kaj s to nastavitvijo zagotovo NE deluje?#

Nekaj stvari, ki sem se jih v šestih mesecih dela s to nastavitvijo naučil na težji način:

1. Cursorjevo samodokončevanje ne uporablja AGENTS.md. Ko Cursor v urejevalniku predlaga dokončanje vrstice, datoteke AGENTS.md ne bere sproti—za to skrbi ločen hiter mehanizem. Pravila v AGENTS.md so pomembna samo, ko v Cursorju pošljete zahtevo v klepetu. To pomeni, da zapis »ne uporabljaj var, uporabi const« v AGENTS.md ne bo vplival na samodokončevanje; to morate nastaviti prek ESLint ali konfiguracije TypeScript.

2. Hooks Claude Code v AGENTS.md ne delujejo za Codex. Če je v .claude/settings.json nastavljen hook PreToolUse, ki blokira določeno dejanje, je ta podatek uporaben samo za Claude. Codex ne pozna hooks; zanj je to »orodje se odloči samo«. Smiselno je v AGENTS.md zapisati »ne naredi X«, v CLAUDE.md pod uvozom pa »obstaja hook, ki fizično blokira X«.

3. Copilot in .github/copilot-instructions.md. GitHub Copilot bere svojo datoteko in še vedno ne bere dobro AGENTS.md. Če vaša ekipa aktivno uporablja Copilot, dodajte ločeno datoteko .github/copilot-instructions.md s skrajšano različico pravil ali uporabite Copilot Extensions, ki poznajo AGENTS.md. To se hitro spreminja, zato je lahko slika čez tri do šest mesecev drugačna.

4. Git ne zazna simbolične povezave kot spremembe CLAUDE.md. Če zaženete ln -s AGENTS.md CLAUDE.md in teden pozneje posodobite AGENTS.md, bo Git pokazal samo diff za AGENTS.md. To je normalno, vendar sodelavec, ki pregleduje PR, morda ne bo vedel, da je bila posodobljena tudi CLAUDE.md (prek simbolične povezave). Rešitev: v opisu PR izrecno napišite »posodobljen AGENTS.md; Claude Code vidi isto datoteko prek simbolične povezave«.

5. Globoke uvoze je težko razhroščevati. Če AGENTS.md uvozi @docs/coding-style.md, ta pa @docs/typescript.md, pravila pa si nasprotujejo, je odpravljanje napak zahtevno. Uvoze omejujem na eno raven (CLAUDE.md → AGENTS.md) in jih ne gnezdim globlje. Anthropic ponuja hook InstructionsLoaded, ki zabeleži, katere datoteke so bile naložene—uporaben je za odpravljanje napak pri večplastnih nastavitvah. Opomba: hook se sproži za AGENTS.md, vključeno prek uvoza ali simbolične povezave, ne pa za AGENTS.md, ki jo Claude Code prebere sam.

Celotna postavitev za vibe coding v enem večeru: klon AI + Drugi možgani + inženiring konteksta.

Spoznajte Ailoot.