CLAUDE.md az Opus 5 után: miért állnak most a hosszú utasítások Claude útjában

Az Ailoot használatáról a dokumentációban talál információt.

Mi változott a Claude-ban az Opus 5 megjelenése után?#

Az Opus 5 2026. július 24-én jelent meg, és azonnal a Claude Code alapértelmezett modelljévé vált. Magáról a modellről – az áráról, a benchmarkokról és az effort módokról – részletesen olvashat egy külön útmutatóban: „Érdemes Claude Opus 5-re váltani?”. Ez a cikk másról szól: a modell megjelenése azt is megváltoztatta, hogyan érdemes hatékonyan kommunikálni vele.

Az Anthropic elemzést tett közzé a Claude blogján. A fő állítása így szól:

A kulcskifejezés: „túlságosan korlátoztuk”. Amikor a modellek gyengébbek voltak, támaszra volt szükségük: ezt csináld, azt ne csináld, itt egy példa, ismételd meg még egyszer. Az Opus 5-nek már nincs szüksége ilyen támaszra, sőt, az akár az útjába is állhat. Az Anthropic egyszerűen fogalmazza meg az új elvet: hagyjuk, hogy Claude a saját belátása szerint döntsön.

Mit jelent ez a gyakorlatban az Ön számára?

• Az Ön CLAUDE.md fájlja ugyanolyan rendszerprompt, csak a projektjéhez. Ha az Anthropic a sajátját 80 százalékkal csökkentette, az Öné valószínűleg szintén túlterhelt.
• A hosszú szabálylisták már nem garantálják az utasítások követését. Épp ellenkezőleg: minél több sorból állnak, a modell annál kevésbé követi őket figyelmesen (erről alább, a dokumentáció számaival együtt).
• Új mechanizmusok jelentek meg – az automatikus memória és a skills –, amelyek átveszik a korábban kézzel, a CLAUDE.md fájlban rögzített teendők egy részét.

A legfontosabb munka a prompt előtt történik: azon múlik, mit helyez a modell kontextusába az első kérés előtt. Az Opus 5 frissítése lényegében az Anthropic hivatalos megerősítése ugyanezen gondolat mellett. Ezúttal azonban konkrét számokkal és új eszközökkel is alátámasztják. Vegyük sorra őket.

Miért áll most útban egy hosszú CLAUDE.md fájl?#

Így működik: a CLAUDE.md egy szabályokat tartalmazó fájl, amelyet Claude minden munkamenet kezdetén elolvas. Egy külön útmutató, a „CLAUDE.md beállítása”, elmagyarázza, hogyan hozható létre a fájl az alapoktól; ez a cikk ennek a fordítottját mutatja be: mit kell most eltávolítani belőle. Minden, amit odaír, az első kérése előtt bekerül a kontextusba, és a beszélgetés során végig ott marad. A kontextus nem végtelen – minden további szabály sorai olyan helyet foglalnak el, amelyet a feladatára is lehetne fordítani.

A Claude Code dokumentációja kertelés nélkül fogalmaz:

A második pont fontosabb az elsőnél: a hosszú fájlok csökkentik az utasítások követését. A modell kevésbé figyel oda. Ez szinte minden kezdő csapdája. A logika megdönthetetlennek tűnik: azt akarom, hogy Claude hallgasson rám, ezért több szabályt írok. A gyakorlatban ennek az ellenkezője történik. Minél hosszabb a lista, annál inkább szétszóródik a modell figyelme, és annál gyakrabban hagy ki egy szabályt.

Így változott meg a megközelítés:

Van egy második probléma is: az ellentmondások. Ahogy nő a fájl, szinte elkerülhetetlenül felhalmozódnak benne az egymásnak ellentmondó szabályok. Az egyik helyen az áll: „mindig írj teszteket”, máshol pedig: „ne nyúlj a tests mappához”. A dokumentáció arra figyelmeztet, hogy ha két szabály ellentmond egymásnak, Claude véletlenszerűen bármelyiket választhatja. Más szóval a túlterhelt fájl kevésbé kiszámíthatóvá teszi a modell viselkedését.

Egyszerű szabály: a CLAUDE.md egy rövid megjegyzés arról, amit Claude nem tud magától kikövetkeztetni. Minden más csak a figyelmét foglalja.

Mit tartson meg a CLAUDE.md fájlban, és mit távolítson el?#

A dokumentáció világos szempontot ad annak eldöntéséhez, hogy egy szabály megérdemli-e a helyét a CLAUDE.md fájlban. Akkor adja hozzá, ha:

1. Claude másodszor is ugyanazt a hibát követte el.
2. Egy kódellenőrzés olyasmit talált, amit a modellnek tudnia kellett volna erről a projektről.
3. Másodszor gépeli be ugyanazt a javítást a csevegésbe.
4. A csapat új tagjának is szüksége lenne ugyanerre a kontextusra, hogy ne törje el a projektet.

Az általános elv: tartsa meg a projektre jellemző buktatókat, és távolítsa el a nyilvánvaló dolgokat. A Claude Code még egy beépített claude doctor ellenőrzéssel is rendelkezik, amely a túlterhelt CLAUDE.md rendbetételét javasolja. Eltávolítja a kódbázisból kikövetkeztethető részleteket – a mappastruktúrát, a függőségek listáját, az architektúra áttekintését –, és megtartja a buktatókat, az indoklásokat, valamint az alapértelmezettől eltérő konvenciókat.

A második fontos szabály a konkrétság. A homályos megfogalmazás nem működik. Hasonlítsa össze:

A különbség egyszerű. A modell úgy értelmezheti a „formázd megfelelően” kifejezést, ahogy akarja. A „használj 2 szóközös behúzást” egyértelműen ellenőrizhető. A CLAUDE.md minden szabályának olyasminek kell lennie, amit ellenőrizni és látni lehet – hogy betartották-e vagy sem.

Harmadszor pedig távolítsa el a nyilvánvaló dolgokat. Ha azt írja a CLAUDE.md fájlba, hogy „írj tiszta kódot” vagy „kövesd a bevált gyakorlatokat”, az csak zaj. A modell ezt már tudja, a sor pedig helyet foglal, és szétszórja a figyelmét. Az Anthropic kifejezetten azt tanácsolja, hogy ne pazarolja a kontextust nyilvánvaló dolgokra.

Hová helyezze át azokat a szabályokat, amelyek nem valók a CLAUDE.md fájlba?#

Itt lép színre a leginkább alábecsült eszköz. Ha korábban minden utasításnak a CLAUDE.md fájlban kellett maradnia, a hosszú eljárások most már saját helyet kapnak: a skills fájlokat. Egy külön útmutató, a „Hogyan válasszon Claude Code skillst?”, elmagyarázza, hogyan válassza ki a megfelelőt anélkül, hogy túl sokat adna hozzá.

A különbség alapvető. A CLAUDE.md minden munkamenet elején teljes egészében betöltődik. Egy skill nem. A dokumentáció így fogalmaz:

Ezt fokozatos feltárásnak nevezik: az információ szükség szerinti betöltésének. Az ötlet az, hogy a modell a megfelelő pillanatban, részletekben kapja meg a kontextust. Az Anthropic a részletes utasításait – például a kódellenőrzéshez szükségeseket – skills fájlokba helyezte át, és eltávolította a rendszerpromptból.

Az áthelyezés egyszerű feltétele: a CLAUDE.md egyik része tényből eljárássá nőtt. Az egysoros „A build a npm run build paranccsal fut” tény, és a CLAUDE.md fájlban a helye. A projekt közzétételének tíz lépése eljárás, és egy skillbe való.

Gyakorlati elv: adjon tovább mindent, amit néhány alkalomnál többször csinál. Egyszer magyarázza el például, hogyan állít össze egy heti ügyféljelentést, alakítsa az útmutatást skillé, és többé nem kell újra elmagyaráznia. A skill készen áll, de nem foglal kontextust, és név szerint hívható elő egy olyan paranccsal, mint a /otchet.

A skills fájlokba érdemes áthelyezni:

• A több lépésből álló eljárásokat (közzététel, jelentés összeállítása, kiadás előtti ellenőrzések).
• A hosszú utasításokat, amelyekre ritkán, de teljes egészükben van szükség.
• Mindent, amit második vagy harmadik alkalommal másol át az egyik csevegésből a másikba.

Van egy köztes lehetőség is: a mappaspecifikus szabályok. Ha egy utasítás csak a projekt egy részére vonatkozik, elhelyezheti a .claude/rules/ mappában, és összekapcsolhatja a releváns fájlokkal. Ekkor csak akkor töltődik be, amikor Claude ezekkel a fájlokkal dolgozik, ahelyett hogy folyamatosan a kontextusban maradna.

Mi az automatikus memória, és miért használjuk 2026-ban?#

A CLAUDE.md terhét enyhítő második új mechanizmus az automatikus memória. Az ötlet az, hogy Claude már nemcsak arra emlékszik, amit Ön leírt, hanem arra is, amit maga vett észre. Egy külön útmutató, a „Claude memória vagy CLAUDE.md?”, elmagyarázza, miben különbözik a működése a CLAUDE.md fájlétól.

A kétféle memória közötti különbség:

Így működik: miközben Claude a feladatán dolgozik, észreveszi a hasznos részleteket – melyik parancs futtatja a buildet, hol akadt el a hibakeresés, mit kért tőle, hogy másképp csináljon –, majd elmenti ezeket a jegyzeteibe. A következő munkamenetben előveszi őket. Fontos: szelektíven ment, és csak azt tartja meg, amit a jövőre nézve hasznosnak ítél.

A jegyzetek projektenként külön mappában találhatók, a MEMORY.md nevű indexfájllal együtt. A /memory paranccsal megtekintheti és szerkesztheti őket. Közönséges szövegfájlok, ezért bármikor elolvashatja, szerkesztheti vagy törölheti őket.

A gyakorlati változás az Ön számára: Claude most már rögzíti annak egy részét, amit korábban minden hiba után Ön adott hozzá a CLAUDE.md fájlhoz. Ettől még rövidebb lesz a szabályfájlja – és ez jó.

Miért vitatkozik az Opus 5 az utasításaival?#

Ennek azonban van egy másik oldala is.

Ha egy modell a saját belátása szerint dönthet, akkor definíció szerint időnként nem ért egyet egy merev paranccsal, amikor a kontextus alapján jobb lehetőséget lát.

Mit jelent ez Önnek, ha már áttért az Opus 5-re, és valami nem működik:

1. Ellenőrizze újra a régi skills fájljait és pluginjait. A korábbi modellekhez készült beállítások ütközhetnek az új logikával. Amit korábban óramű pontossággal működött, azt most érdemes újra tesztelni.
2. Távolítsa el a legmerevebb megfogalmazásokat. Az ötödik generációs modellek rosszabbul kezelik az olyan parancsokat, mint „soha ne csináld az X-et, mindig csak az Y-t csináld”, mint az olyan rugalmas megfogalmazásokat, amelyek megmagyarázzák, miért kell valamit tenni.
3. Figyelje meg, hol áll le a modell túl korán. Ez néha arra utal, hogy egy utasítás önmagának mond ellent, vagy összeütközik a túlterhelt CLAUDE.md egyik szabályával.

A CLAUDE.md átírása az Opus 5-höz: lépésről lépésre#

Így érdemes kezelni a korábbi modellektől örökölt CLAUDE.md fájlt.

1. Futtassa a beépített ellenőrzést

   Írja be a projektben a claude doctor parancsot. Javaslatot tesz arra, mit távolítson el a túlterhelt fájlból, és mit tartson meg.

2. Távolítsa el a nyilvánvaló dolgokat

   Töröljön minden sort, amelyre Claude magából a kódból következtetni tud: a mappastruktúrát, a könyvtárak listáját és az olyan általános kifejezéseket, mint „írj tiszta kódot”.

3. Távolítsa el az ellentmondásokat

   Menjen végig a fájlon fentről lefelé, és keresse meg az egymásnak ellentmondó szabályokat. Az egyiket tartsa meg, az ellentmondót pedig törölje.

4. Helyezze át az eljárásokat skills fájlokba

   Helyezzen át külön skillbe mindent, ami tényből lépésről lépésre követendő utasítássá vált. Hagyjon egy egysoros hivatkozást a CLAUDE.md fájlban.

5. Tegye konkréttá a megmaradó szabályokat

   Fogalmazza át az egyes szabályokat úgy, hogy ellenőrizhetők legyenek: „formázd megfelelően” helyett „használj 2 szóközös behúzást”.

6. Kapcsolja be az automatikus memóriát, és ellenőrizze a fájl hosszát

   Győződjön meg arról, hogy működik az automatikus memória (/memory), és a fájl 200 sornál rövidebb. Ha nem, van még valami, amit át kell helyezni.

Ha nem szeretné kézzel elvégezni az első átnézést, bízza a munkát Claude-ra. Íme egy kiindulópontként használható prompt – másolja ki, és illessze be egy, a projektben megnyitott munkamenetbe:

Olvasd el a CLAUDE.md fájlomat és a kódomat. A feladatod, hogy rövidebbé és egy ötödik generációs modell számára hasznosabbá tedd a CLAUDE.md fájlt.

Vedd végig a fájl összes szabályát, és oszd őket három csoportba:

KEEP - projektspecifikus buktatók és olyan konvenciók, amelyekre a kódból magadtól nem tudsz következtetni.

DELETE - nyilvánvaló dolgok, amelyeket már tudsz, és minden, ami kikövetkeztethető a kódból.

MOVE TO A SKILL - a CLAUDE.md fájlban jelenleg szövegként szereplő, több lépésből álló eljárások.

Az 1. csoport szabályait fogalmazd át úgy, hogy konkrétak és ellenőrizhetők legyenek.
Keresd meg az egymásnak ellentmondó szabályokat, és külön mutasd be őket.
Adj vissza egy új, 200 sornál rövidebb CLAUDE.md fájlt, valamint a skills fájlokba áthelyezésre javasolt elemek listáját.
Ne módosíts egyetlen fájlt sem, amíg meg nem erősítem.

Figyelje meg az utolsó sort: „Ne változtass meg semmit, amíg meg nem erősítem.” Egy olyan modellnél, amely most már a saját belátása szerint dönt, ez fontos: először mutassa meg vele a tervet, a döntést pedig tartsa meg magának.

Miért fontosabb a kontextus a promptnál?#

Ha félretesszük az Opus 5-tel kapcsolatos részleteket, és a nagyobb képet nézzük, az egész elemzés egyetlen gondolatról szól: a kontextus fontosabb, mint a prompt. A legfontosabb munka a kérés előtt történik – amikor összeállítja azt a környezetet, amelyben a modell dolgozni fog.

A CLAUDE.md, a skills fájlok és az automatikus memória mind ugyanannak a részei: annak, amit Claude az első üzenete előtt lát. Végtelenül finomíthatja a kérés megfogalmazását, de ha a kontextus rosszul van összeállítva – túlterhelt CLAUDE.md, ellentmondó szabályok, hiányzó struktúra –, az eredmények továbbra is következetlenek lesznek.

Egy egyszerű ellenőrzés: első agy nélkül a második agy nem segít. A „második agy” ebben a cikkben a projektről szóló tudás struktúráját jelenti, amelyet a modell minden kérésnél elolvas. Ez azonban csak akkor működik, ha Ön világosan érti a feladatot. Az eszköz felerősíti a gondolkodását, és ezzel véget is ér a szerepe.

Az Opus 5 frissítése még élesebbé tette ezt a gondolatot. Az Anthropic a saját munkájával mutatta meg, hogy ha a modell elég okos, a további szabályok csak ártanak, és az jár előnyben, aki gondosan állította össze a kontextust. Ez olyan készség, amely a következő modelleknél is megmarad, legyen szó az Opus 6-ról vagy bármi másról.

Mivel kezdje most?#

Ne halogassa „majd egyszerre”. A legegyszerűbb első lépés, ha most megnyitja a CLAUDE.md fájlt, és őszintén felteszi magának a kérdést minden egyes sorral kapcsolatban: ez olyan buktató, amelyre Claude nem tud magától következtetni, vagy egy nyilvánvaló dolog, amelyet biztos, ami biztos alapon írtam hozzá? A második csoport minden eleme törlésre jelölt.

Ezután futtassa végig a fájlt az előző szakasz promptján, helyezze át a hosszú eljárásokat skills fájlokba, és ellenőrizze, hogy be van-e kapcsolva az automatikus memória. Egy este munkája, és a kontextusa tömör, pontos alapot ad majd a modellnek.

Mindezt egy saját, valódi projekten is alkalmazhatja: CLAUDE.md, második agy és az Ön feladataihoz készült skills fájlok.

Ismerje meg az Ailootot.