Jeden súbor s pokynmi pre Claude Code, Codex a Cursor v roku 2026
MarkdownJeden zdroj pravdy pre Claude Code, Codex a Cursor v roku 2026: kedy Claude Code číta AGENTS.md samo, import @AGENTS.md do CLAUDE.md, symbolický odkaz a /init.
Prečítať celý článok
Informácie o službe nájdete v dokumentácii Ailoot.
Čo sa zmení, keď používate Claude Code, Codex a Cursor spolu?
Kľúčové zistenie
V roku 2026 typické nastavenie vibe codera neobsahuje jeden nástroj, ale 3–5. Claude Code ako hlavný nástroj, Codex na dlhé autonómne úlohy, Cursor na rýchle úpravy v IDE. Každý má vlastný súbor s pokynmi: CLAUDE.md, AGENTS.md, .cursorrules. Ak ich synchronizujete ručne, upravíte jeden riadok na piatich miestach, zabudnete aktualizovať Cursor a o týždeň neskôr budú Claude a Codex dávať na rovnakú výzvu odlišné výsledky.
V opísanom príklade je Claude Code hlavný nástroj, zatiaľ čo Codex a Cursor sa používajú na konkrétne úlohy. Moje CLAUDE.md má približne 250 riadkov pokynov: čo čítať a v akom poradí, na čo sa nesmie siahať, ktoré príkazy používať pri nasadení a aké pravidlá platia pre formátovanie commitov. Keď som na projekte prvýkrát vyskúšal Codex CLI, nepoznal žiadne z pravidiel: spustil git push --force, šmátral v .env a bez rozmyslu premenovával súbory.
Najprv som ručne skopíroval CLAUDE.md do AGENTS.md. O dva týždne neskôr som zistil, že projekt už má štyri verzie rovnakých pokynov: v CLAUDE.md, AGENTS.md, .cursorrules a .windsurf/rules/. Všetky sa trochu líšili. Toto nie je problém Clauda ani Cursoru; je to základná pasca každého systému s viacerými zdrojmi pravdy. Podrobnejšie o tomto probléme píšem v sprievodcovi prácou s viacerými agentmi.
V júni 2026 priniesla dokumentácia pamäte Claude Code od Anthropic jedno riešenie: spoločný súbor a import. Od septembra 2026 číta Claude Code samo aj AGENTS.md, ak projekt nemá CLAUDE.md; import je potrebný vtedy, keď máte pravidlá špecifické pre Claude. Nižšie vysvetľujem, kedy stačí jediné AGENTS.md, ako nastaviť import a ako oddeliť spoločné pravidlá od tých špecifických pre Claude.
Číta Claude Code samo súbor AGENTS.md?
Kľúčové zistenie
Áno, od verzie 2.1.277, vydanej 18. septembra 2026, ale iba vtedy, ak v pracovnom adresári ani v žiadnom jeho nadradenom adresári nie je CLAUDE.md, .claude/CLAUDE.md ani CLAUDE.local.md. Ak CLAUDE.md existuje, Claude Code štandardne číta iba tento súbor a AGENTS.md sa zahrnie riadkom @AGENTS.md v súbore CLAUDE.md alebo pomocou symbolického odkazu. Správanie sa mení v časti Project instructions v /config. Pred septembrom Claude Code súbor AGENTS.md vôbec nečítalo a import bol jediným spôsobom.
Pred septembrom 2026 bola odpoveď „nie“. Issue #6235, v ktorom sa žiadala podpora AGENTS.md, bolo otvorené od augusta 2025 a uzavreli ho 17. augusta 2026. Dokumentácia pamäte celý ten čas odporúčala jedno riešenie: vytvoriť CLAUDE.md a zahrnúť doň AGENTS.md ako import. Od verzie 2.1.277 dokumentácia hovorí niečo iné:
Claude Code dokáže čítať
AGENTS.mdako pokyny pre projekt, takže repozitár už nastavený pre iných agentov funguje bez súboruCLAUDE.md, importu alebo konfigurácie.
To, ktoré súbory Claude Code číta, závisí od toho, ktoré súbory sa v projekte nachádzajú:
| Súbory v projekte | Čo číta Claude Code |
|---|---|
AGENTS.md, bez CLAUDE.md alebo CLAUDE.local.md v pracovnom adresári či v niektorom nadradenom adresári | AGENTS.md |
AGENTS.md a CLAUDE.md (alebo CLAUDE.local.md) v pracovnom adresári či v niektorom nadradenom adresári | Iba CLAUDE.md |
CLAUDE.md s riadkom @AGENTS.md | CLAUDE.md a AGENTS.md vložené cez import |
Pri tejto kontrole sa započítavajú súbory CLAUDE.md, .claude/CLAUDE.md a CLAUDE.local.md v pracovnom adresári a vo všetkých nadradených adresároch. Osobný súbor ~/.claude/CLAUDE.md, firemne spravovaný súbor a pravidlá z .claude/rules/ sa nezapočítavajú: načítavajú sa spolu so súborom AGENTS.md.
Keď neexistuje CLAUDE.md, Claude Code pri spustení načíta všetky súbory AGENTS.md a .claude/AGENTS.md v pracovnom adresári a jeho nadradených adresároch. Súbor AGENTS.md v podadresári načíta, keď v ňom otvorí súbor. Fungujú aj importy @path v súbore AGENTS.md. Claude Code nečíta AGENTS.local.md, AGENTS.override.md ani obsah adresára .agents/.
Háčik: započítava sa aj osobný súbor CLAUDE.local.md. Vytvorte si ho, aby ste v ňom uchovávali vlastné necommitnuté pravidlá, a Claude Code potichu prestane čítať AGENTS.md. Riešením je nastavenie uvedené nižšie.
Správanie sa mení v časti Project instructions v /config:
| Nastavenie | Čo číta Claude Code |
|---|---|
claude-md-or-agents-md (predvolené) | CLAUDE.md, alebo ak neexistuje ani on, ani CLAUDE.local.md, súbor AGENTS.md |
claude-md-and-agents-md | Oba súbory: v každom adresári najprv CLAUDE.md a potom AGENTS.md |
claude-md | Iba CLAUDE.md |
managed-only | Iba firemný spravovaný súbor CLAUDE.md a automatická pamäť |
Ak si chcete ponechať CLAUDE.local.md a zároveň nestratiť AGENTS.md, nastavte claude-md-and-agents-md. K dvojitému čítaniu nedôjde: ak je AGENTS.md už zahrnutý cez riadok @AGENTS.md alebo symbolický odkaz, Claude Code ho nenačíta druhýkrát bez ohľadu na nastavenie.
Pomocou príkazu /memory môžete skontrolovať, či sa súbor načítal: od verzie 2.1.280 sa cesta k súboru AGENTS.md zobrazuje v zozname. Vo verziách starších než 2.1.277 a v reláciách, v ktorých je vypnutý vstavaný plugin agents-md, Claude Code číta iba CLAUDE.md a v ponuke /config nie je položka Project instructions. Pred verziou 2.1.281 sa rovnako správali aj relácie cez Amazon Bedrock a relácie s vypnutou telemetriou. V prvej relácii po aktualizácii zo staršej verzie sa navyše môže stať, že sa AGENTS.md nenačíta; začne fungovať od nasledujúcej relácie.
Čo to znamená pre nastavenie s jedným súborom? Ak nemáte pravidlá špecifické pre Claude, môžete CLAUDE.md vynechať: stačí AGENTS.md a budú ho čítať Claude Code, Codex aj Cursor. Ak také pravidlá máte (režim plánovania pre rizikové adresáre, skills, hooks), potrebujete CLAUDE.md a Claude Code prestane AGENTS.md čítať samo. Potom do CLAUDE.md vložte AGENTS.md riadkom @AGENTS.md; toto nastavenie funguje rovnako ako pred septembrom. Pomáha aj so staršími verziami Claude Code. Podrobne to vysvetľujem nižšie.
Ako vložiť @AGENTS.md do súboru CLAUDE.md?
Kľúčové zistenie
Import je potrebný, keď projekt obsahuje CLAUDE.md: ak je prítomný, Claude Code štandardne nečíta AGENTS.md samo. Nastavíte ho tak, že na začiatok súboru CLAUDE.md napíšete riadok @AGENTS.md. Keď Claude Code spustí reláciu, na miesto tohto riadka vloží obsah súboru AGENTS.md a výsledok prečíta ako jeden text. Pod import môžete pridať sekciu „Claude Code“ s pravidlami, ktoré platia iba pre Claude. Importy fungujú s relatívnymi aj absolútnymi cestami a možno ich vnoriť až do štyroch úrovní.
Minimálny funkčný príklad z oficiálnej dokumentácie:
@AGENTS.md
## Claude Code
Use plan mode for changes under `src/billing/`.
Tu je postup. Prvý riadok, @AGENTS.md, je direktíva importu. Keď Claude Code na začiatku relácie analyzuje súbor CLAUDE.md, nájde tento import a vloží na jeho miesto celý obsah súboru AGENTS.md. Nasleduje nadpis ## Claude Code: je to obyčajný markdown, ale funguje ako sekcia „dodatkov špecifických pre Claude“. Pod ňou je pravidlo, ktoré platí iba pre Claude Code: pri zmenách v adresári billing použiť režim plánovania. Codex CLI ani Cursor tento súbor vôbec neotvárajú; používajú obyčajný súbor AGENTS.md.
Citát z dokumentácie o fungovaní importov:
Súbory CLAUDE.md môžu importovať ďalšie súbory pomocou syntaxe
@path/to/import. Importované súbory sa rozbalia a pri spustení relácie načítajú do kontextu spolu so súborom CLAUDE.md, ktorý na ne odkazuje.
Niekoľko praktických podrobností:
- Relatívne a absolútne cesty. Cesta
@AGENTS.mdje relatívna k súboru, ktorý obsahuje import. Cesty@/Users/me/shared/rules.mdalebo@~/.claude/personal.mdsú absolútne. Cestu@~/.claude/personal.mdpoužívam na osobné preferencie, ktoré nechcem vložiť do repozitára. - Hĺbka štyroch úrovní. Súbor
AGENTS.mdmôže importovať@docs/coding-style.mda súborcoding-style.mdmôže importovať ďalší súbor, až do štyroch úrovní. To stačí na akúkoľvek reálnu štruktúru. - Spätné apostrofy blokujú importy. Ak text obsahuje
`@README`, ide len o zmienku názvu, nie o import. Hodí sa to pri vysvetľovaní fungovania importov čitateľom bez toho, aby ste nejaký spustili. - Schválenie súborov mimo projektu. Ak import smeruje mimo pracovného adresára, napríklad na
@~/.claude/personal.md, Claude Code pri prvom použití zobrazí dialóg so zoznamom týchto súborov. Ak ho odmietnete, externé importy zostanú vypnuté a dialóg sa už nezobrazí. Import@AGENTS.mdv koreňovom adresári projektu dialóg nevyvolá. Chráni vás to pred náhodným načítaním nesúvisiaceho súboru do kontextu.
Po prechode na toto nastavenie v opísanom projekte sa moje CLAUDE.md skrátilo z 250 riadkov na 60: @AGENTS.md a päť až sedem pravidiel platných iba pre Claude Code (režim plánovania pre rizikové adresáre, na čo nesiahať v administračnej časti a ako formulovať commity). Všetky spoločné pravidlá sú v súbore AGENTS.md, ktorý čítajú Codex a Cursor.
Kedy zvoliť symbolický odkaz a kedy import?
Kľúčové zistenie
Anthropic ponúka dva mechanizmy: import cez @AGENTS.md alebo symbolický odkaz, ln -s AGENTS.md CLAUDE.md. Symbolický odkaz je jednoduchší — je to len alias a nevyžaduje zmeny súborov. Má však tri nevýhody: Windows vyžaduje oprávnenia správcu, do súboru CLAUDE.md nemožno pridať pravidlá špecifické pre Claude a Git niekedy zobrazuje symbolický odkaz ako zbytočnosť v rozdiele. Import je univerzálny spôsob. Ak nemáte pravidlá iba pre Claude, od verzie 2.1.277 nepotrebujete ani jedno: Claude Code si prečíta AGENTS.md samo.
Dokumentácia ukazuje možnosť so symbolickým odkazom takto:
ln -s AGENTS.md CLAUDE.md
A hneď uvádza otvorené varovanie pre Windows:
Ak vy alebo ktokoľvek, kto klonuje repozitár, pracujete vo Windows, použite import
@AGENTS.md. Vytvorenie symbolického odkazu tam vyžaduje oprávnenia správcu alebo režim Developer Mode. Git bez zapnutého nastaveniacore.symlinkspri checkout-e uložený odkaz zmení na obyčajný textový súbor, takže namiesto pokynov v danej kópii zostane jednoradový súborCLAUDE.md.
Porovnávacia tabuľka:
| Kritérium | Import @AGENTS.md | Symbolický odkaz ln -s |
|---|---|---|
| Funguje vo Windows bez oprávnení správcu | áno | nie (vyžaduje Developer Mode) |
| Možno pridať pravidlá iba pre Claude | áno, pod import | nie, súbor je totožný |
| V Gite sa zobrazuje ako obyčajný markdown | áno | ako odkaz (závisí od core.symlinks) |
| Možno importovať viac súborov | áno, až štyri úrovne | nie, vzťah jeden k jednému |
| Caching/neplatnosť v Claude Code | štandardné pre CLAUDE.md | funguje, ale symbolické odkazy majú úskalia v metadátach |
| Predvolená voľba | vhodná pre každého | iba ak nezáleží na používaní naprieč platformami |
V opísanom projekte používam importy. Dôvody:
- Tím používa rôzne platformy. Používam Mac; v príklade je tím približne rovnomerne rozdelený medzi Windows a Mac. Ak sa v repozitári objaví symbolický odkaz, používateľom Windows bez Developer Mode sa pri checkout-e zmení na obyčajný textový súbor s jediným riadkom
AGENTS.md. To spôsobuje zvláštne chyby: niekedy pravidlá fungujú, inokedy nie a nie je jasné prečo. - Chcem pravidlá iba pre Claude. Pod
@AGENTS.mdje v mojomCLAUDE.mdsekcia „Claude Code“ s pravidlami: použiť--effort highna architektonické úlohy, spustiťnpm run buildpredgit pusha ručne nevolať/api/v1/deploy. Codex týmto príkazom nerozumie. - Ladenie je jednoduchšie. Keď sa niečo pokazí, otvorím
CLAUDE.mda vidím import aj svoje zmeny. Pri symbolickom odkaze nie je zrejmé, že „toto bolo pridané sem“. Viac o ladení nastavení Claude Code nájdete v sprievodcovi bezpečným režimom.
Ak nemáte pravidlá špecifické pre Claude, od verzie 2.1.277 už symbolický odkaz nepotrebujete: odstráňte CLAUDE.md a Claude Code bude čítať AGENTS.md samo. Odkaz si ponechajte iba vtedy, ak niekto v tíme používa verziu staršiu než 2.1.277 a nemôže ju aktualizovať. Ak máte pravidlá špecifické pre Claude, import je pohodlnejší v deviatich prípadoch z desiatich.
Čo čítajú Codex, Cursor, Copilot, Windsurf a Gemini CLI?
Kľúčové zistenie
Každý nástroj číta vlastný súbor, niekedy aj viac než jeden. Claude Code číta CLAUDE.md a od septembra 2026 číta aj AGENTS.md, ak projekt nemá CLAUDE.md. Codex CLI číta AGENTS.md a AGENTS.override.md. Cursor číta starší formát .cursorrules alebo novší .cursor/rules/*.mdc a od leta 2026 číta aj AGENTS.md. Copilot číta .github/copilot-instructions.md alebo .github/instructions/*.instructions.md. Windsurf číta starší súbor .windsurfrules alebo novší adresár .windsurf/rules/. Gemini CLI číta GEMINI.md. Aider a Cline už prijali štandard AGENTS.md.
Prehľad siedmich hlavných nástrojov (na základe oficiálnej dokumentácie každého nástroja):
| Nástroj | Hlavný súbor s pokynmi | Alternatívy | Číta AGENTS.md? |
|---|---|---|---|
| Claude Code | CLAUDE.md | ~/.claude/CLAUDE.md, ./.claude/CLAUDE.md, spravovaná politika | áno, ak projekt nemá CLAUDE.md (od 2.1.277), inak cez import |
| Codex CLI (OpenAI) | AGENTS.md | AGENTS.override.md | áno (natívne) |
| Cursor | .cursor/rules/*.mdc | .cursorrules (zastarané) | áno |
| GitHub Copilot | .github/copilot-instructions.md | .github/instructions/*.instructions.md | cez rozšírenia |
| Windsurf | .windsurf/rules/ | .windsurfrules (zastarané) | áno |
| Gemini CLI | GEMINI.md | - | nie |
| Aider, Cline, opencode | AGENTS.md | - | áno (natívne) |
Čo z toho vyplýva? Ak má repozitár AGENTS.md (a tiež CLAUDE.md s importom, ak sú potrebné pravidlá špecifické pre Claude), päť zo siedmich nástrojov automaticky dostáva aktuálne pokyny. Cursor a Windsurf, ktoré majú vlastné natívne súbory, môžete ponechať tak, ako sú (AGENTS.md čítajú tiež), alebo do nich pridať import @AGENTS.md — ich syntax sa však líši a nie vždy je podporovaná.
Najjednoduchšia stratégia pre nový projekt:
- Vložte všetky spoločné pravidlá do
AGENTS.md— patrí tam 95 % pravidiel. - Vytvorte
CLAUDE.md, ak potrebujete pravidlá iba pre Claude: na prvý riadok vložte@AGENTS.mda pod neho pridajte sekciu s pravidlami iba pre Claude. Ak také pravidlá nemáte,CLAUDE.mdnetreba; Claude Code čítaAGENTS.mdsamo od verzie 2.1.277. - Adresár
.cursor/rules/ponechajte pre Cursor na zriedkavé prípady, keď je potrebné niečo špecifické pre Cursor (jeho príkazy@Codebasea@Docs). - To isté urobte pre Windsurf: zabudnite na starý
.windsurfrules; nový.windsurf/rules/používajte iba vtedy, keď sú potrebné vzory pre jeho syntax.
Tento prístup prináša 80 % výhod za 20 % práce. Podľa mojich skúseností sa pri organizovaní zmiešaných tímov v „Antigravity“ stáva údržba viac než dvoch zdrojov pravdy (spoločných a iba pre Claude) náročnou. Ak niekto z tímu pridá pravidlo do .cursorrules a zabudne na AGENTS.md, o týždeň neskôr sa Cursor a Codex nebudú zhodovať.
Ako Claude Code pri príkaze /init načíta existujúci súbor AGENTS.md?
Kľúčové zistenie
Príkaz /init vytvorí súbor CLAUDE.md podľa toho, čo už je v repozitári, a ušetrí 20–30 minút ručnej práce. V predvolenom nastavení preberá pravidlá Cursoru (.cursor/rules/, .cursorrules) a Copilotu (.github/copilot-instructions.md), zatiaľ čo AGENTS.md, .windsurfrules a .clinerules číta v režime CLAUDE_CODE_NEW_INIT=1. Tento režim spúšťa rovnaký interaktívny viacfázový postup: kladie otázky, skúma kód prostredníctvom podagenta a pred zápisom navrhuje plán. Od septembra 2026 má /init v projekte so súborom AGENTS.md nevýhodu: nový CLAUDE.md vypne priame čítanie AGENTS.md a pravidlá skončia v dvoch súboroch.
Anthropic vo svojej dokumentácii opisuje /init takto:
Spustenie príkazu
/initčíta súbory s pokynmi pre iné nástroje a presúva relevantné časti do vytváraného súboruCLAUDE.md: pravidlá Cursoru z.cursor/rules/alebo.cursorrules, pravidlá Copilotu z.github/copilot-instructions.mda pri nastaveníCLAUDE_CODE_NEW_INIT=1aj súborAGENTS.md, adresár.devin/rules/, adresár.windsurf/rules/alebo súbor.windsurfrulesa súbor.clinerules.
Čo to znamená v praxi? Opísaný repozitár mal súbor .cursorrules z čias, keď som skúšal Cursor (približne 80 riadkov), a súbor AGENTS.md (120 riadkov, zostavený ručne). Keď som spustil claude /init, príkaz použil oba súbory, odstránil podobné pravidlá a za minútu vytvoril čistý súbor CLAUDE.md. Potom som ho skontroloval a vykonal drobné úpravy — odstránil som zastarané položky a pridal štruktúru s nadpismi. Bolo to rýchlejšie než prepisovať všetko od začiatku.
Interaktívny režim, v ktorom /init číta aj AGENTS.md, sa zapína pomocou premennej prostredia:
CLAUDE_CODE_NEW_INIT=1 claude
Keď sa /init spustí, Claude položí sériu objasňujúcich otázok: ktoré prvky nakonfigurovať (CLAUDE.md, skills, hooks), aký technologický stack projekt používa a ktoré príkazy použiť na testy. Potom podagent preskúma kódovú základňu — prečíta package.json, README.md a konfiguračné súbory — a doplní chýbajúce časti. Nakoniec zobrazí návrh, ktorý môžete pred uložením upraviť. Viac o konfigurácii Claude Code pri zakladaní projektu nájdete v samostatnom sprievodcovi.
Teraz nevýhoda. Ak už projekt obsahuje aktívny súbor AGENTS.md, príkaz /init vedľa neho vytvorí súbor CLAUDE.md s kópiou jeho pravidiel. Od tej chvíle Claude Code štandardne číta iba CLAUDE.md, takže opäť existujú dva zdroje pravdy: vy aktualizujete AGENTS.md, zatiaľ čo Claude naďalej pracuje so starou kópiou. Príkaz /import robí niečo podobné: do CLAUDE.md pridá jednorazovú kópiu súboru AGENTS.md. Ak chcete zachovať jediný zdroj, po príkaze /init vložte na prvý riadok súboru CLAUDE.md import @AGENTS.md a odstráňte z CLAUDE.md všetko, čo opakuje obsah súboru AGENTS.md.
Príkaz /init je správnym začiatkom nového projektu alebo projektu, ktorý presúvate z Cursoru či Copilotu. Netreba na internete hľadať „najlepšiu šablónu CLAUDE.md“ — Anthropic už zohľadňuje obsah repozitára. Ak projekt už má aktívny AGENTS.md a nemá pravidlá iba pre Claude, /init nie je potrebný: Claude Code si prečíta AGENTS.md samo.
Ako oddeliť spoločné pokyny od tých špecifických pre Claude?
Kľúčové zistenie
Do AGENTS.md vložte pravidlá, ktorým rozumie každý agent AI: na čo nesiahať, ako pomenúvať vetvy, že .env obsahuje tajomstvo a ktoré príkazy používať na testy. Do CLAUDE.md (pod import) vložte pravidlá špecifické pre Claude Code: režim plánovania, skills, hooks, odkazy na skills a názvy modelov podľa verzie. Rozlíšenie je jednoduché: ak sa pravidlo začína slovami „Claude má“, patrí do CLAUDE.md. Ak sa začína slovami „nástroj má“, patrí do AGENTS.md.
Oddeľujem ich podľa tejto zásady. Spoločné pravidlá, ktoré patria do AGENTS.md:
- Na čo v kóde nesiahať. Adresáre
.env,node_modules,prisma/migrations(len cezprisma migrate),.next/,.git/. - Ako pomenúvať veci. Vetvy:
feat/,fix/,chore/. Commity: predponyfeat:,fix:,docs:a krátky opis. Súbory komponentov vkebab-case. - Príkazy na testy/lint.
npm run build,npm run lint,npm test. Ktorý príkaz spustiť predgit push. - Architektonické princípy. Čo patrí do
src/lib/, čo dosrc/components/, kde sa nachádza obchodná logika a kde používateľské rozhranie. - Bezpečnosť. Nikdy necommitujte tajomstvá. K produkčnej databáze pristupujte iba cez
prod-psql. K produkcii cez SSH pristupujte iba pomocou aliasuprod, nie cezroot@IP.
Pravidlá špecifické pre Claude, ktoré patria do CLAUDE.md (pod @AGENTS.md):
- Režim plánovania. Pri zmenách v rizikových adresároch (napríklad
src/billing/) používajteplan mode. - Úroveň úsilia. Na architektonické úlohy používajte
--effort higha na bežnú prácumedium. - Skills. Ktorých agentov AI a skills spúšťať v jednotlivých situáciách. Napríklad: „pri práci na sprievodcovi spustite skill
build-masterskaya-guide.“ - Pamäť Claude. Čo ukladať do automatickej pamäte a čo do
CLAUDE.local.md. Viac o pamäti Claude nájdete v sprievodcovi pamäťou a CLAUDE.md. - Hooks. Ak sú v
.claude/settings.jsonnakonfigurované hooks, opíšte vCLAUDE.md, čo robia (Codex a Cursor o nich nevedia a nemusia). - Skills a príkazy. Zoznam príkazov so lomkou, ktoré často používam (
/init,/cd,/memory,/plan).
Hranica nie je vždy jasná. Napríklad „nikdy nespúšťajte git push --force do main“ je zjavne spoločné pravidlo, takže patrí do AGENTS.md. Ale „pri spúšťaní git push do horúcej vetvy najprv použite režim plánovania“ je špecifické pre Claude Code, takže patrí do CLAUDE.md. Skúška znie: „Keby som zajtra odstránil Claude Code a nechal iba Codex, platilo by toto pravidlo stále?“ Ak áno, vložte ho do AGENTS.md. Ak nie, vložte ho do CLAUDE.md.
Čo patrí do AGENTS.md a čo do CLAUDE.md alebo .claude/rules?
Kľúčové zistenie
Pri veľkom projekte jeden súbor AGENTS.md nestačí — priveľmi narastie a každý agent si do kontextu načíta zbytočný materiál. Riešením je adresár .claude/rules/ so samostatnými súbormi podľa tém a YAML frontmatter paths: na spúšťanie pravidiel podľa cesty. Napríklad pravidlo pre API sa uplatní iba vtedy, keď Claude pracuje v src/api/. Takto sa ušetrí veľa miesta v kontextovom okne. Ekvivalentom pre Cursor je .cursor/rules/ a pre Windsurf .windsurf/rules/.
Ak pravidlá presiahnu 200 riadkov, je čas rozdeliť ich. Dokumentácia Anthropic odporúča cieliť na 200 riadkov na súbor, pretože pri dlhých súboroch CLAUDE.md Claude potichu prestáva dodržiavať pokyny: vyzerá to, že ich číta, ale riadi sa nimi menej často.
Štruktúra veľkého projektu, ktorá sa mi osvedčila:
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
Každý súbor v .claude/rules/ môže obsahovať 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 načítava tieto pravidlá iba pri práci so súbormi, ktoré zodpovedajú tomuto vzoru. Ak upravuje src/components/Button.tsx, pravidlá pre API sa do kontextu nepridajú. Kontextové okno tak využíva iba na relevantné informácie. Adresár .claude/rules/ funguje aj bez CLAUDE.md: ak projekt obsahuje iba AGENTS.md, pravidlá sa načítajú spolu s ním a nevypnú priame čítanie súboru AGENTS.md.
Cursor a Windsurf podporujú rovnaký prístup prostredníctvom adresárov .cursor/rules/ a .windsurf/rules/. Štandard AGENTS.md môže odkazovať na tieto adresáre, ale syntax pre rôzne nástroje ešte nie je úplne ustálená. Bezpečnejšie je ponechať spoločné pravidlá v AGENTS.md a pravidlá obmedzené na cesty duplikovať v .claude/rules/ a .cursor/rules/ — ide o zriedkavé špecifické prípady, nie o väčšinu pravidiel.
Užitočné umiestnenia pre CLAUDE.md (od najširšieho po najužšie):
| Úroveň | Umiestnenie | Účel |
|---|---|---|
| Spravovaná politika | /Library/Application Support/ClaudeCode/CLAUDE.md (Mac), /etc/claude-code/CLAUDE.md (Linux) | Firemné pravidlá, IT/DevOps |
| Používateľ | ~/.claude/CLAUDE.md | Osobné preferencie pre všetky projekty |
| Projekt | ./CLAUDE.md alebo ./.claude/CLAUDE.md | Pravidlá projektového tímu |
| Lokálne | ./CLAUDE.local.md (v .gitignore) | Osobné preferencie pre konkrétny projekt |
Príklad súboru ~/.claude/CLAUDE.md môže obsahovať dve pravidlá: „odpovedajte v jazyku, ktorý používateľ uprednostňuje“ a „píšte Ailoot presne takto“. Tieto pravidlá platia pre každý projekt, takže ich netreba duplikovať v každom repozitári.
Z týchto štyroch úrovní priame čítanie AGENTS.md vypína iba projektový CLAUDE.md a CLAUDE.local.md. Osobný ~/.claude/CLAUDE.md ani spravovaná politika neprekážajú; Claude Code ich číta spolu so súborom AGENTS.md.
Čo robiť, ak je AGENTS.md vo vašom projekte už zastaraný?
Kľúčové zistenie
Ak bol súbor AGENTS.md zostavený ešte v roku 2025 pre Codex alebo Aider a odvtedy ste ho neupravovali, otvorte projekt v Claude Code a požiadajte Claude, aby súbor upravilo. AGENTS.md je živý dokument; špecifikácia Linux Foundation sa aktualizuje. Hlavné pravidlo, ako ho udržiavať aktuálny: každé pravidlo musí odpovedať na otázku „Čo už ma unavuje opakovať Claude/Codexu?“ Ak neodpovedá, archivujte ho.
V opísanom projekte som mal AGENTS.md z mája 2025 — 180 riadkov, z ktorých mnohé boli zastarané (spomínal koncové body Anthropic API, ktoré sa odvtedy zmenili; príklady so syntaxou claude --tools, ktorá už neexistuje; a pravidlá pre ~/.claude/projects/ so zastaranou štruktúrou).
Postup, ktorý som použil pri jeho aktualizácii:
- Skontrolujte ho pomocou
claudev režime plánovania. Otvorím repozitár, spustímclaude --safe-modea požiadam: “RereadAGENTS.mdand suggest a list of items that are outdated or repeated. Don’t edit it; list them only.” Za dve minúty som dostal zoznam 23 položiek na kontrolu. - Odstráňte zjavne zastarané položky. Z 23 položiek bolo 9 jednoznačne zastaraných — syntax príkazov, koncové body a názvy príznakov. Tieto riadky som odstránil.
- Spojte duplicity. Ďalších 6 položiek opakovalo to isté inými slovami („nerobte force-push“, „nikdy nepoužívajte
--force“, „vyhnite sagit push -f“). Spojil som ich do jedného riadka. - Pridajte nové položky. Pridal som to, čo som si všimol, že Claude/Codex za posledný mesiac pravidelne robili nesprávne, podľa pravidla „jeden riadok na vzor chyby“. Tak vzniklo 8 nových položiek.
- Na záverečnú kontrolu použite podagenta. Požiadal som Claude o kontrolu s pokynom „nájdite rozpory, nejednoznačnosti a duplicity“. Našlo tri formulácie, ktoré sa dali spresniť. Opravil som ich.
Po hodine mal AGENTS.md 110 riadkov, bol aktuálny a poznal som každý riadok. Ľahko sa z neho dal vytvoriť 30-riadkový CLAUDE.md. Codex bolo potom pri testoch tiež viditeľne opatrnejšie — mám podozrenie, že niektoré jeho „čudné“ rozhodnutia vychádzali zo zastaraných pokynov, ktoré poctivo dodržiavalo.
Hlavné zásady živého súboru AGENTS.md:
- Každé pravidlo rieši opakujúcu sa chybu. Ak mi pravidlo ani raz počas mesiaca nenapadlo, nemá zmysel ho ponechávať.
- Píšte pravidlá ako príkazy, nie ako teóriu. „Použite dve medzery“ je pravidlo. „Štýl kódu má byť úhľadný“ pravidlom nie je.
- Konkrétne pokyny majú prednosť pred všeobecnými. „Pred
git pushspustitenpm run build“ je pravidlo. „Otestujte svoje zmeny“ pravidlom nie je.
Čo pri tomto nastavení určite NEFUNGUJE?
Kľúčové zistenie
Import @AGENTS.md nespôsobí, že sa rôzne nástroje budú správať rovnako. Každý má svoje zvláštnosti: Codex CLI nepozná .claude/rules/ ani hooks. Cursor má vlastný nástroj na automatické dopĺňanie, ktorý pri dopĺňaní textu nečíta CLAUDE.md. Copilot sa riadi súborom .github/copilot-instructions.md a samotné pravidlá v AGENTS.md mu nestačia. Neplatí „jeden súbor = jedno správanie“, ale „jeden zdroj základných pravidiel a potom dodatky špecifické pre každý nástroj“.
Niekoľko vecí, ktoré som sa za šesť mesiacov práce s týmto nastavením naučil ťažkou cestou:
1. Automatické dopĺňanie Cursoru nepoužíva AGENTS.md. Keď Cursor navrhne dokončenie riadka v editore, v reálnom čase nečíta AGENTS.md — pracuje tam samostatný rýchly nástroj. Pravidlá v AGENTS.md sú dôležité iba pri zadaní požiadavky v chate v rámci Cursoru. To znamená, že napísanie „nepoužívaj var, použi const“ do AGENTS.md automatické dopĺňanie neovplyvní; treba to nakonfigurovať cez ESLint alebo konfiguráciu TypeScriptu.
2. Hooks Claude Code v AGENTS.md nefungujú pre Codex. Ak má .claude/settings.json nakonfigurovaný hook PreToolUse, ktorý blokuje určitú akciu, táto informácia je užitočná iba pre Claude. Codex o hooks nevie; preň je to „nástroj rozhoduje sám“. Má zmysel napísať do AGENTS.md „nerob X“ a pod import do CLAUDE.md „existuje hook, ktorý X fyzicky blokuje“.
3. Copilot a .github/copilot-instructions.md. GitHub Copilot číta vlastný súbor a stále nečíta AGENTS.md veľmi dobre. Ak váš tím aktívne používa Copilot, pridajte buď samostatný .github/copilot-instructions.md so skrátenou verziou pravidiel, alebo použite rozšírenia Copilotu, ktoré poznajú AGENTS.md. Situácia sa rýchlo mení, takže o tri až šesť mesiacov môže vyzerať inak.
4. Git nesleduje symbolický odkaz ako zmenu v CLAUDE.md. Ak spustíte ln -s AGENTS.md CLAUDE.md a o týždeň neskôr aktualizujete AGENTS.md, Git zobrazí rozdiel iba pre AGENTS.md. Je to normálne, ale kolega kontrolujúci PR si nemusí uvedomiť, že sa aktualizoval aj CLAUDE.md (cez symbolický odkaz). Riešenie: do opisu PR výslovne napíšte: „aktualizovaný súbor AGENTS.md; Claude Code vidí ten istý súbor cez symbolický odkaz“.
5. Hlboké importy sa ťažko ladia. Ak AGENTS.md importuje @docs/coding-style.md, ten importuje @docs/typescript.md a nejaké pravidlo je v rozpore s iným, ladenie je náročné. Importy obmedzujem na jednu úroveň (CLAUDE.md → AGENTS.md) a ďalej ich nevnáram. Anthropic poskytuje hook InstructionsLoaded, ktorý zaznamenáva načítané súbory — hodí sa na ladenie vrstvených nastavení. Poznámka: hook sa spúšťa pre súbor AGENTS.md zahrnutý cez import alebo symbolický odkaz, ale nie pre súbor AGENTS.md, ktorý Claude Code prečítalo samo.
Zdroje
- Dokumentácia Claude Code Memory - sekcia AGENTS.md - kedy Claude Code číta AGENTS.md samo, nastavenia Project instructions, importy a symbolické odkazy, správanie príkazu
/init. - Dokumentácia Claude Code Memory - importovanie ďalších súborov - syntax
@path/to/file, hĺbka štyroch úrovní, relatívne a absolútne cesty. - agents.md - štandard Linux Foundation - oficiálny štandard AGENTS.md a zoznam podporovaných nástrojov.
- Dokumentácia Cursor Rules - čo Cursor číta (
.cursor/rules/*.mdc, AGENTS.md). - Vlastné pokyny GitHub Copilot - formát
.github/copilot-instructions.md. - Špecifikácia AGENTS.md na Linux Foundation - živá špecifikácia.
Kompletné nastavenie vibe codingu na jeden večer: klon AI + Druhý mozog + inžinierstvo kontextu.
Spoznajte Ailoot.
Viac podrobností
Otázky a odpovede: Jeden súbor s pokynmi pre Claude Code, Codex a Cursor v roku 2026
Kedy použiť import namiesto symbolického odkazu?
@AGENTS.md v CLAUDE.md použite pri špecifických dodatkoch Claude či kolegoch s Windows. Symbolický odkaz spája oba názvy s rovnakým obsahom, takže nemôže mať samostatnú sekciu iba pre Claude.
Ako overiť načítanie spoločných pokynov?
Spustite /memory a prezrite zoznam. Ak CLAUDE.md či CLAUDE.local.md potláča priame načítanie AGENTS.md, pridajte import alebo nastavte načítanie oboch a začnite novú reláciu.