Miért olvassa újra a Claude Code az egész projektet, és hogyan oldható meg ez

Ailoot dokumentációja: API, kulcsok és csatlakozás.

Miért olvassa újra a Claude Code minden alkalommal elölről a projektet?#

Sokan azt gondolják, hogy ez hiba. Valójában így tervezték meg a Claude Code-ot: nincs saját projektindexe. Amikor megkéred, hogy javítson ki valamit, nincs kéznél előre elkészített kódtérképe – újra feltérképezi a projektet: megkeresi a releváns fájlokat, rákeres a szükséges karakterláncokra, és betölti a fájlokat a memóriájába.

Ennek a megközelítésnek valódi előnyei vannak. A kód mindig naprakész – nincs elavult index. Semmit sem kell beállítani. A kódod nem kerül adatbázisba.

De van egy hátránya: minden új feladat újabb keresést és fájlolvasást jelent. A tokenek arra mennek el, hogy a Claude ismét kiderítse, hol található minden, pedig ezt már az előző munkamenetben megállapította. Minél nagyobb a projekt, annál többe kerül ez a felderítés. Pontosan ezért érezheted úgy, hogy az ügynök „mindent elolvas”.

Valójában mennyi tokent éget el ez?#

A költség már a kérésed előtt elkezdődik. Egy független mérés egyszerűen megmutatja: a Claude Code körülbelül 33,000 tokennyi rendszerpromptot és eszközleírást küld el, mielőtt elolvasná az üzeneted első karakterét. Összehasonlításképpen az OpenCode körülbelül 7,000-ről indul.

Ezután jön az újbóli beolvasás. Minden fájlkeresés és minden olvasás tokeneket ad a kontextushoz. A Claude Code hivatalos dokumentációja egyenesen kimondja: a fájlolvasás dominálja a kontextushasználatot. Egy 2,400 tokenes auth.ts elemzése 2,400 tokent jelent, amelyet csak a Claude lát, és ugyanez vonatkozik minden fájlra, amelyet a felderítés során megnyit.

A közönségünk számára ez pénzben és korlátokban mérhető. A vibe codingba belevágók legnagyobb félelme az, hogy „Fizettem, és feleslegesen elfogytak a korlátok.” Ha az ügynök minden feladatnál átvizsgálja a projektet és elölről olvassa be a fájlokat, kétszer olyan gyorsan fogy a kontextus: először a rendszer többletterhelésére, aztán a felderítésre. A „Hová mennek a Claude Code tokenjei?” című útmutatóban bemutattam a teljes térképet arról, hogy pontosan mire mennek el a Claude Code tokenjei – a projekt újbóli beolvasása egy a kilenc mintázat közül.

Mi az a tartós kódmemória?#

A kódmemória pontosan azt a hiányt pótolja, ami miatt a Claude újraolvassa a projektet. Az ötlet egyszerű: vizsgáltassuk át egyszer az összes kódot, építsünk belőle térképet, és tartsuk kéznél. Így az ügynöknek nem kell minden alkalommal elölről keresnie – a térképtől kérdez.

Technikailag így működik. Egy külön eszköz átvizsgálja a projektet, és összetevőkre bontja: milyen függvények és osztályok vannak, melyik kit hív meg, és mely fájlok kapcsolódnak egymáshoz. Ezt a struktúrát lemezre menti. Amikor a Claude-nak meg kell értenie, hol található a fizetési logika, vagy mi romlik el egy függvény szerkesztésekor, egyetlen célzott lekérdezést indít a térképhez ahelyett, hogy több tucat fájlt olvasna el.

Ez a térkép MCP-n keresztül kapcsolódik – ez a külső eszközök Claude Code-hoz csatlakoztatásának szabványos módja (más szerverek csatlakoztatásáról a „MCP-szerverek a Claude Code-hoz” útmutatóban írtam). A kódmemória-eszköz saját térképes keresőparancsokat ad hozzá, amelyeket a Claude önállóan használ, amikor tájékozódnia kell a projektben.

A gyakorlatban a különbség a „olvasd el az egész mappát, hogy megtalálj egy függvényt” és a „kérdezd meg a térképtől, hol van a függvény” között van. Az első több tízezer tokenbe kerül; a második néhány százba.

Kétféle kódmemória: miben különböznek?#

A kódmemória-eszközök abban különböznek, hogy mit építenek fel a projektedből. A legegyszerűbb úgy gondolni rájuk, hogy az egyik sebészi precizitású szerkesztési lehetőséget ad, a másik pedig jelentés alapján keres.

A GitHub-csillagok száma 2026. július 15-i állapotot tükröz (a GitHub API szerint). Mindkét eszköz ingyenes és nyílt forráskódú, mindkettő működik a Claude Code-dal, és mindkettő MCP-szerverként csatlakozik.

Rövid összefoglaló nem programozóknak. A Serena sebészi precizitású eszköz: akkor használd, ha ugyanazt a részt szerkeszted a projekt több pontján, és fontos a pontosság. A claude-context jelentésalapú keresést végez: leírás alapján talál kódot, de ehhez felhőadatbázist kell beállítani és kulcsra van szükség.

Mikor válaszd a Serenát vagy a claude-contextet?#

A két eszköz nem ugyanazért az egyetlen díjért versenyez. Más-más dolgokra emlékeznek, ezért a választás a feladattól függ.

Válaszd a Serenát, ha sokat refaktorálsz. Olyan kódnavigációt ad az ügynöknek, mint egy intelligens fejlesztői környezet: megkeresi egy függvény definícióját és az összes tényleges hívási helyét, majd gondosan átnevezi a függvényt, vagy lecseréli a törzsét a projekt egészében. A szerző így írja le az előnyt.

A Serena nem közöl pontos megtakarítási százalékot, és nem tulajdonítok neki kitalált adatot. Az előnye más jellegű: amikor a szokásos keresés negyven találatot ad vissza megjegyzésekkel és karakterláncokkal együtt, majd a Claude négy teljes fájlt olvas el, a Serena néhány pontos lekérdezéssel válaszol. Ez kevesebb hívást és kevesebb téves egyezést jelent, így kisebb az esélye annak, hogy az ügynök rossz dolgot szerkeszt.

Válaszd a claude-contextet, ha jelentésalapú keresésre van szükséged, és nem zavar a beállítása. A kódot vektorokká (a jelentés numerikus ujjlenyomataivá) alakítja, majd leírás alapján keres: „keresd meg, hol van a fizetési logikánk”, akkor is, ha nem tudod a függvények nevét. Ennek a keresésnek az ára a többlet-beállítás.

A claude-context külső vektoradatbázist, embedding-szolgáltatói kulcsot és a Node egy újabb verzióját igényli. A két eszköz közül ezt körülményesebb beállítani, ezért azt ajánlom a kezdőknek, hogy mással kezdjenek.

Mit tehetsz közvetlenül a Claude Code-ban harmadik féltől származó eszközök nélkül?#

Mielőtt harmadik féltől származó eszközöket telepítenél, hozd ki a legtöbbet abból, amit a Claude Code már eleve tartalmaz. Ezek a parancsok ingyenesek és azonnal használhatók.

1. /context—élő bontást mutat arról, mi foglalja el az ablakot: rendszerprompt, CLAUDE.md, memória, eszközök és fájlok. A /mcp parancs az egyes csatlakoztatott szerverek költségét mutatja, a /memory pedig azt, hogy mi töltődött be indításkor.
2. /compact—rövid összefoglalóvá tömöríti a beszélgetési előzményeket, és folytatja ugyanazt a feladatot. A fókuszt úgy irányíthatod, hogy hozzáadod a /compact parancshoz, mit őrizzen meg.
3. /clear—eldobja a teljes előzményt. A hivatalos ajánlás szerint akkor futtasd, amikor egy nem kapcsolódó feladatra váltasz, hogy a régi beszélgetés ne szorítsa ki a szükséges fájlokat.
4. /doctor (más néven /checkup, bevezetve 2026. július 8-án)—diagnosztizálja a beállítást és javításokat javasol: eltávolítja a CLAUDE.md duplikátumait, megtalálja a nem használt eszközöket és szervereket, valamint észleli a lassú kezelőket.

Külön megjegyzés a CLAUDE.md-ről. Ez a fájl minden munkamenet elején betöltődik a kontextusba, és minden üzenetben szerepel. Ha túl nagy, folyamatosan fizetsz érte. A hivatalos ajánlás szerint maradjon 200 sor alatt, a referenciaanyagok részleteit pedig helyezd át igény szerint betöltődő skillekbe. A CLAUDE.md helyes összeállításáról a külön „A CLAUDE.md konfigurálása” útmutatóban írtam.

Egy másik beépített lehetőség az alügynökök használata. Saját, elkülönített kontextusuk van, ezért rájuk bízhatod a nagyobb olvasási és felderítési feladatokat anélkül, hogy felduzzasztanád a fő ablakot. Az Anthropic mérnöki elemzésében így fogalmazza meg az általános elvet.

Egy további MCP-szerver még nagyobbá teszi a kontextust?#

Az az elképzelés, hogy „még egy szerver még nagyobb kontextusterhelést jelent”, korábban igaz volt, de a Claude Code megváltozott. Az MCP-eszközök leírása alapértelmezés szerint halasztva töltődik be: indításkor csak a szervernevek kerülnek a kontextusba, a teljes leírások pedig akkor, amikor az adott feladathoz szükség van egy konkrét eszközre. A dokumentáció ezt egyenesen kimondja.

A kódmemória mérlege egyszerű. Az eszköznevek kis, állandó többletterhelést jelentenek, miközben több ezer token takarítható meg azzal, hogy az ügynöknek nem kell újraolvasnia a fájlokat. Az egyensúly egyértelműen az indexnek kedvez.

Néhány őszinte fenntartás, hogy ne várj csodát. Az indexet időnként újra kell építeni – a térkép a kódot a beolvasás pillanatában tükrözi, és nagyobb módosítások után frissíteni kell (ez eszközönként eltér: egyesek automatikusan frissítenek, másokhoz parancs szükséges). Az olyan nagy állítások, mint a „120-szor kevesebb token”, a kiválasztott lekérdezések legjobb esetét írják le, nem azt, amit minden feladatnál tapasztalsz. A tényleges megtakarítás szerényebb, de így is észrevehető. Ha részletesebben szeretnéd megismerni, hogyan kerülheted el általában a korlátok kimerítését, külön elemzést írtam erről: „Hogyan kerüld el a Claude Code korlátainak kimerítését”.

Mivel kezdj még ma?#

Ha mindent lehántasz, ami felesleges, a mai terv egyszerű:

1. Futtasd a /doctor parancsot, és távolítsd el, amit javasol: a CLAUDE.md duplikátumait és a nem használt eszközöket.
2. Rövidítsd le a CLAUDE.md fájlt 200 sorra, a referenciaanyagokat pedig helyezd át skillekbe.

Ezután válassz az igényeid szerint: ha sokat refaktorálsz, add hozzá a Serenát a precíz szerkesztéshez; ha jelentésalapú keresésre van szükséged, állítsd be a claude-contextet. A kódmemória és a rendezett kontextus már megoldja a mai fő problémát.

Ha az Ailooton keresztül szeretnél hozzáférni AI-modellekhez, nézd meg az Ailootot.