Tinklaraštis

Konteksto inžinerija 2026 m.: praktinis Claude Code vadovas

Markdown

Kas yra konteksto inžinerija ir kuo ji skiriasi nuo užklausų inžinerijos. Anthropic kanonas, 7 klaidos ir minimali Claude Code sąranka.

Skaityti visą straipsnį

Svarbiausia mintis

Konteksto inžinerija – tai disciplina, apimanti visko, kas patenka į Claude konteksto langą prieš jūsų pranešimą, konfigūravimą: sistemos užklausą, įrankius, istoriją, atminties failus ir įrankių pateikiamus duomenis. 2026 m. ji pakeitė užklausų inžineriją ir tapo svarbiausiu įgūdžiu – taip teigia Anthropic. Šiame vadove apžvelgiamas pirminiais šaltiniais paremtas kanonas, 7 dažnos klaidos, eikvojančios žetonus, ir praktiška 7 žingsnių Claude Code sąranka.

Informacijos apie darbą su Ailoot rasite dokumentacijoje.

Kas yra konteksto inžinerija? Vienu sakiniu

Svarbiausia mintis

Konteksto inžinerija – tai disciplina, apimanti visko, kas kiekviename žingsnyje patenka į DI agento konteksto langą, kuravimą: sistemos užklausos, įrankių, istorijos, atminties failų ir iš išorinių šaltinių gautų duomenų. Užklausų inžinerija atsakė į klausimą „Kaip parašyti užklausą?“ Konteksto inžinerija atsako į klausimą „Ką DI žino, kai parašote užklausą?“

Anthropic įtvirtino šį terminą 2025 m. rugsėjo 29 d. paskelbtame inžinerijos tinklaraščio įraše:

Konteksto inžinerija – tai strategijų visuma, skirta optimaliam žetonų (informacijos) rinkiniui parinkti ir palaikyti LLM išvadų generavimo metu, įskaitant viską, kas įtraukiama greta pačių užklausų.
— Anthropic Applied AI team, https://www.anthropic.com/engineering/effective-context-engineering-for-ai-agents

Tame pačiame straipsnyje pateikta svarbiausia frazė, padedanti pakeisti požiūrį:

Darbas su kalbos modeliais vis mažiau susijęs su tinkamų žodžių ir frazių paieška užklausose ir vis labiau – su atsakymu į platesnį klausimą: „Kokia konteksto konfigūracija greičiausiai sukels pageidaujamą modelio elgesį?“
— Anthropic Applied AI team, https://www.anthropic.com/engineering/effective-context-engineering-for-ai-agents

Pagrindinė mintis: kontekstas nėra jūsų parašytas pranešimas. Kontekstas – tai visas informacijos rinkinys, kurį DI mato prieš jūsų pranešimą: sistemos užklausa, įrankių aprašymai, pokalbio istorija, atminties failai ir per MCP įkelti duomenys. Užklausa yra paskutinis žingsnis. Konteksto inžinerija – tai visos į konteksto langą perduodamos informacijos architektūra.

Kodėl 2026 m. užklausų inžinerija paseno?

Svarbiausia mintis

Užklausų inžinerija atsirado tada, kai modeliai veikė pagal vieną užklausą – vieną ėjimą ir vieną užduotį. 2026 m. DI agentai dirba ilgose sesijose su įrankiais, atmintimi, poagentais ir duomenimis, kuriuos jie gauna per įrankius. Esant tokiai architektūrai, vienos užklausos formulavimas nebėra pagrindinis įgūdis – svarbiausia kuruoti visą informaciją, kurią mato agentas.

Šis pokytis įvyko 2025 m. vasarą.

2025 m. rugsėjo 29 d.: Anthropic įtvirtina šią discipliną inžinerijos tinklaraščio įraše ir pateikia 4 principų kanoną.

Užklausų inžinerija „nemirė“. Ji tapo baziniu raštingumu, panašiai kaip mokėjimas spausdinti klaviatūra. Ant jos atsirado disciplina, be kurios DI agentai sutrinka vykdydami ilgas užduotis: konteksto inžinerija.

Kuo skiriasi konteksto ir užklausų inžinerija? 5 skirtumai

Svarbiausia mintis

Užklausų inžinerija optimizuoja vieną užklausą: parenkate formuluotę, šabloną ir toną. Konteksto inžinerija kuria visą informacinę aplinką prieš pateikiant tą užklausą: sistemos užklausą, įrankius, sesijos istoriją, atminties failus ir duomenų gavimą. Skirtumas atsiskleidžia penkiais aspektais: kas optimizuojama, laiko horizontas, pagrindinė rizika, esminis įgūdis ir projekto šaltinis.

AspektasUžklausų inžinerijaKonteksto inžinerija
Kas optimizuojamaVienos užklausos formuluotėVisas žetonų rinkinys: sistemos užklausa + įrankiai + istorija + gauti duomenys
Laiko horizontasVienas ėjimasDaug ėjimų ir perėjimai tarp sesijų
Pagrindinė rizikaModelis nesupranta užklausosModelis paskęsta triukšme (konteksto degradacija)
Esminis įgūdisReklaminių tekstų rašymas ir modelio supratimasInformacijos architektūra ir tikslinis duomenų gavimas
Projekto šaltinisJūsų užklausos šablonasCLAUDE.md, atminties failai, duomenų gavimas, poagentai, sutraukimas
Palyginimas„Kaip parašyti užklausą“„Ką DI žino, kai pateikiate užklausą“

Konteksto inžinerija nereiškia „tiesiog pilti daugiau“. Tai tikslus dozavimas. Jei jo per mažai, DI trūksta konteksto ir jis haliucinuoja. Jei per daug, DI paskęsta triukšme, pasimeta viduryje ir kainuoja daugiau.

Užklausų inžinerija rūpinosi paskutiniu žingsniu. Konteksto inžinerija rūpinasi viskuo, kas vyko prieš jį.

Kodėl 1M žetonų nereiškia „supilti viską“?

Svarbiausia mintis

2026 m. modelių konteksto langai išaugo: Claude Opus 4.7 ir Sonnet 4.6 palaiko 1 milijoną žetonų. Tai sukuria iliuziją, kad į langą galima supilti visą saugyklą. Praktiškai didelis langas nereiškia didelės naudingos atminties – modelių veikimas prastėja gerokai anksčiau, nei pasiekiama riba.

Dabartinės Claude modelių konteksto ribos:

ModelisKonteksto langasPrieinama su
Claude Haiku 4.5200 000 žetonųvisais planais
Claude Sonnet 4.61 000 000 žetonųPro+ su naudojimo kreditais
Claude Opus 4.71 000 000 žetonųPro, Max, Team, Enterprise

1M žetonų yra maždaug 2 500 teksto puslapių. Atrodo, kad būtų galima įkelti visą projekto dokumentaciją, visą susirašinėjimą ir visas specifikacijas – ir leisti DI pačiam susigaudyti. Tačiau Anthropic savo inžinerijos tinklaraštyje aiškiai teigia:

Kontekstą turėtumėte laikyti ribotu ištekliumi, kurio nauda mažėja.
— Anthropic Applied AI team, https://www.anthropic.com/engineering/effective-context-engineering-for-ai-agents

Kitaip tariant, kontekstas yra ribotas išteklius, kurio nauda mažėja. Kiekvienas papildomas žetonas naudos nesuteikia tiesiškai. Kuo ilgesnis langas, tuo prasčiau modelis apdoroja jame esančią informaciją.

2026 m. svarbiausias įgūdis – ne laikyti viską atvertą, o greitai pereiti prie siauro, konkrečiai užduočiai skirto konteksto.

Didžiausia klaida: ar daugiau konteksto reiškia prastesnį rezultatą?

Svarbiausia mintis

Kuo ilgesnis kontekstas, tuo prasčiau modelis apdoroja jame esančią informaciją. Šis reiškinys vadinamas konteksto degradacija. Taip pat pasireiškia „pasimetimo viduryje“ efektas: modeliai prisimena konteksto pradžią ir pabaigą, bet praleidžia vidurį. Praktinė išvada – ilgi atminties failai jums kenkia.

Lygiagrečiai veikia ir antrasis efektas – pasimetimas viduryje.

Praktiškai svarbi taisyklė, paslėpta ilgo CLAUDE.md viduryje, gali sulaukti mažiau dėmesio. Tai rizika, kurią reikia išbandyti tikrose užduotyse, o ne garantija, kad modelis praleis konkrečią eilutę.

CLAUDE.md dokumentacijoje Anthropic rekomenduoja laikytis ilgio ribos:

Stenkitės, kad CLAUDE.md būtų trumpesnis nei 200 eilučių – ilgesni failai užima daugiau konteksto ir mažina instrukcijų laikymąsi.
— Anthropic, https://code.claude.com/docs/en/memory

Cituojamose gairėse mažiau nei 200 eilučių yra ilgio orientyras, o ne griežta riba, ties kuria nustojama laikytis taisyklių. 80–120 eilučių intervalas yra autoriaus pasirinkimas pagal čia aprašytus projektus, o ne atskiras Anthropic reikalavimas. Išlaikykite instrukcijų aktualumą ir išbandykite, ar vykdomos svarbios taisyklės; kiekviena pridėta eilutė konkuruoja dėl dėmesio bei konteksto. Daugiau apie tai, kaip sukonfigūruoti CLAUDE.md laikantis šios ribos, rasite vadove „Kaip sukonfigūruoti CLAUDE.md 2026 m.“.

5 konteksto inžinerijos principai pagal Anthropic

Svarbiausia mintis

2025 m. rugsėjo 29 d. inžinerijos tinklaraščio įraše Anthropic aprašė 5 pagrindines konteksto strategijas: ribotas išteklius, duomenų gavimą reikiamu metu, struktūruotą užrašų rašymą, sutraukimą ir poagentų architektūras. Tai kanonas, į kurį dabar remiasi visi kiti šios temos autoriai.

1 principas. Kontekstas yra ribotas išteklius

Tai pagrindinė prielaida, be kurios kiti keturi principai neveikia. Anthropic rašo:

Bendra rekomendacija dėl visų konteksto komponentų (sistemos užklausų, įrankių, pavyzdžių, pranešimų istorijos ir t. t.) – apgalvoti juos ir išlaikyti kontekstą informatyvų, bet koncentruotą.
— Anthropic Applied AI team, https://www.anthropic.com/engineering/effective-context-engineering-for-ai-agents

„Koncentruotas“ reiškia „tankus, be užpildo“. Kiekvienas žetonas lange turėtų iš esmės pakeisti modelio sprendimą. Jei CLAUDE.md eilutėje parašyta „stengiamės rašyti tvarkingą kodą“, ją galima ištrinti – ji nesuteikia jokios reikšmingos informacijos.

2 principas. Duomenų gavimas reikiamu metu

DI agentas, užuot iš anksto įkėlęs viską į langą, reikiamus duomenis pasiima per įrankius darbo metu. Tokia yra Claude Code architektūra: užuot naudojęsis vektorine duomenų baze ar indeksu, agentas naudoja glob ir grep, kaip gyvas inžinierius, rankiniu būdu ieškantis kodo.

Kada taikyti: kai iš anksto nežinote, kokių ištraukų reikės užduočiai atlikti.

3 principas. Struktūruotų užrašų rašymas

Agentas rašo pastabas į išorinę saugyklą ir prireikus jas įkelia. Claude Code tai įgyvendinama per atminties įrankį. Anthropic savo kulinarijos knygoje tai apibūdina taip:

Atmintis – tai struktūruoti užrašai: agentas rašo į išorinę nuolatinę saugyklą, kad galėtų sekti užduočių ir sesijų eigą, nelaikydamas visko aktyviame kontekste.
— Anthropic Cookbook, https://platform.claude.com/cookbook/tool-use-context-engineering-context-engineering-tools

Kada taikyti: ilgose sesijose, pereinant iš vienos sesijos į kitą ir kaupiant projekto žinias.

4 principas. Sutraukimas

Artėjant prie ribos, pranešimų istorija suspaudžiama į santrauką. Claude Code tai atliekama komanda /compact ir automatiniu sutraukimu, kai langas užpildomas apie 80 %. Anthropic rašo:

Kai langas tampa per didelis, sutraukimas jį suspaudžia.
— Anthropic Cookbook, https://platform.claude.com/cookbook/tool-use-context-engineering-context-engineering-tools

Kada taikyti: ilgose analitinėse diskusijose, kai pokalbio istorija tapo balastu ir užpildo langą, užuot padėjusi.

5 principas. Poagentų architektūros

Specializuoti poagentai dirba lygiagrečiai savo konteksto languose ir pateikia vadovaujančiam agentui sutrumpintas santraukas. Anthropic rašo:

Poagentai padeda suspausti informaciją: jie lygiagrečiai dirba savo konteksto languose ir tuo pat metu tiria skirtingus klausimo aspektus.
— Anthropic Engineering, https://www.anthropic.com/engineering/multi-agent-research-system

Vidinio jų testo rezultatai: vadovaujantis agentas Claude Opus 4 ir poagentai Claude Sonnet 4 mokslinių tyrimų užduotis atlieka +90.2 % kokybiškiau nei vienas Claude Opus 4. Kaina – apie 15 kartų daugiau žetonų. Išvada: toks metodas pagrįstas, kai rezultatas vertingas.

Daugiau apie poagentų konfigūravimą Claude Code rasite vadove „Claude Code poagentai“.

7 klaidos, eikvojančios žetonus ir trikdančios Claude Code

Svarbiausia mintis

Septyni dažni klaidingi šablonai, iliustruoti projektų pavyzdžiais. Kiekvienas jų arba be naudos eikvoja žetonus, arba dėl konteksto degradacijos sukelia haliucinacijas. Po kiekvienu pateikta, kaip tai sprendžia konteksto inžinerija.

#Klaidingas šablonasKas nutinkaKaip ištaisyti
1Į vieną užklausą įklijavau visą README ir 5 kodo failusPer vieną ėjimą langas užsipildo 50 %, o netrukus pasiekiama ribaIlgalaikiams faktams naudokite atminties įrankį, o duomenis gaukite reikiamu metu – leiskite Claude pačiam skaityti failus per read_file/glob
2CLAUDE.md turi 500 eilučiųIlgos instrukcijos gali bloginti jų laikymąsi, ypač kai svarbios taisyklės paslėptos viduryje80–120 eilučių, liepiamosios formos, skyriai komandoms ir stiliui. Svarbiausius dalykus pateikite pradžioje ir pabaigoje
3Ilgose sesijose nevykdau /compactSesija pasiekia 180k žetonų, Claude pamiršta pirmuosius pranešimus, o jūs rankomis kartojate kontekstąVykdykite /compact rankiniu būdu arba naudokite automatinį sutraukimą pagal slenkstį. Įtampos požymis – Claude darbalaukio versijos konteksto naudojimo indikatorius
4Vienas Claude viskamVienas agentas planuoja, ieško, koduoja, peržiūri ir testuoja – konteksto langas auga eksponentiškaiNaudokite poagentus: kiekvienas turi savo kontekstą, o vadovaujantis agentas surenka santraukas. Anthropic nurodo +90.2 % kokybę atliekant mokslinių tyrimų užduotis
5Atminties failai išauga dėl įrankių rezultatųAgentas tą patį failą perskaito 5 kartus, o įrankių iškvietimų rezultatai užpildo 96 % kontekstoIšvalykite įrankių rezultatus: palikite 4–6 naujausius, o kitus pašalinkite. Informacija, kad iškvietimas įvyko, išsaugoma
6Visą saugyklą įklijavau į examples/ aplankąDI ieško šablono tarp 200 pavyzdžių ir pasimetaAplanke examples/ laikykite 3–7 kanoninius šablonus, po vieną kiekvienam konkrečiam užduoties tipui
7200 eilučių „funkcijų plano“ Markdown sąrašasIlgas nestruktūruotas sąrašas gali apsunkinti užduočių sekimą; nėra visuotinio gedimo taško ties 50 eiluteHTML dokumentas arba numeruotas planas atskirame faile

Anthropic kulinarijos knygoje pateikiamas konkretus 5-os klaidos matas: bazinėje sesijoje pirmasis konteksto dokumentas (apie C. elegans) techniškai buvo lange, tačiau palaidotas po 335k žetonų. Jis buvo prieinamas, bet praktikoje modelis jo neprisiminė. Atminties įrankis tai išsprendžia taip: užrašų failas aging_model_organisms_comparison.md užima apie 3000 žetonų, užuot iš naujo įkėlus visą pradinį korpusą.

Kasdienis palyginimas: konteksto langas yra rašomasis stalas. Jei ant jo guli 200 dokumentų, nerasite reikiamo, net jei jis ten yra. Konteksto inžinerija – tai disciplina, padedanti „ant stalo laikyti tik tai, ko reikia dabar, visa kita sudėti į archyvą ir prireikus įkelti“.

Kaip per vieną vakarą susikurti veikiančią sąranką?

Svarbiausia mintis

Minimalią veikiančią konteksto inžinerijos sąranką Claude Code sudaro 7 elementai: CLAUDE.md, pavyzdžiai, PRP dokumentai, atminties įrankis, /compact, poagentai ir duomenų gavimas reikiamu metu per įrankius. Pagrindinei struktūrai sukurti reikia 30–40 minučių; visai sąrankai su pavyzdžiais ir patikrintomis užklausomis – vieno vakaro. Ją galėsite tobulinti dirbdami.

Septyni žingsniai iš eilės:

  1. CLAUDE.md su 80–120 eilučių. Projekto šakniniame kataloge. Naudokite liepiamąją formą, o ne aprašymus. Anthropic oficialioje dokumentacijoje rekomenduoja laikytis principo Specificity: taisyklės turi būti konkrečios ir nedviprasmiškos, o ne bendri principai. Praktiškai „niekada nenaudokite įterptinių imitacijų testuose“ veikia geriau nei „stengiamės rašyti tvarkingą kodą“. Išsamų šabloną rasite vadove „Kaip sukonfigūruoti CLAUDE.md“.

  2. Aplankas examples/ su 3–7 patikrintais šablonais. Po vieną pavyzdį kiekvienam įprastam šablonui: API iškvietimui, testo rašymui, perkėlimui, klaidų apdorojimui. Pamatęs šabloną aplanke examples/, Claude tiksliai jį atkartoja. Be pavyzdžių jis dirba spėliodamas.

  3. PRP dokumentai svarbiausioms funkcijoms. PRP = Product Requirements Prompt. Po vieną failą kiekvienai funkcijai: kontekstas + planas + patvirtinimas + pavyzdžiai.

  4. Atminties įrankis ilgalaikiams faktams, išsaugomiems tarp sesijų. Anthropic kulinarijos knygoje Claude atminties įrankis įgyvendintas kaip struktūruotų užrašų saugykla. Naujoje sesijoje agentas, grįžęs prie užduoties, pirmiausia perskaito užrašus, o ne visą korpusą iš naujo.

  5. /compact ir automatinis sutraukimas, kai pasiekta 80 % ribos. Nelaukite, kol langas pasieks ribą. Nustatymuose įjunkite automatinį sutraukimą arba patys vykdykite /compact, kai atrodo, kad sesija sukasi ratu.

  6. Poagentai tyrimams / peržiūrai / planavimui. Kiekvienas poagentas turi savo kontekstą ir siaurą užklausą. Vadovaujantis Claude gauna tik santrauką, o ne pradinę medžiagą. Daugiau informacijos rasite „Claude Code poagentai“ ir „Claude Code įgūdžiai“ vadovuose. (Įgūdžiai – tai būdas supakuoti siaurą kompetenciją į įgūdį, kurį Claude pritaiko automatiškai.)

  7. Duomenų gavimas reikiamu metu, o ne išankstinis įkėlimas. Nepilkite į konteksto langą visos saugyklos. Leiskite Claude pačiam ieškoti naudojant glob ir grep. Tokia yra pačios Claude Code architektūra.

Papildomos praktinės taisyklės iš aprašytos projektinės patirties:

  • Viena užduotis, vienas langas. Baigę jį uždarykite ir atidarykite naują. Nekaupkite kelių iš eilės atliekamų užduočių istorijos.
  • Šablonas pirmajai naujo lango komandai. Kiekvieną kartą naudokite tą patį tekstą: “Read, in order, CLAUDE.md and the task area. Confirm in one line. Do not start the task; wait for the next message.” Aprašytoje darbo eigoje šis šablonas išsaugotas teksto fragmentų rengyklėje ir priskirtas vienam sparčiajam klavišui.
  • Kai konteksto langas užpildytas >60 %, pereikite į naują. Tarpinis būdas: paprašykite Claude „parašyti užklausą, kad gretimas pokalbis galėtų tęsti užduotį neprarasdamas jos prasmės“, nukopijuokite ją ir atidarykite naują langą.
  • Kiekviena DI klaida yra priežastis pridėti taisyklę. Nerašykite taisyklių atminties failuose ranka. Klaidos metu pasakykite Claude „tai neteisinga, nes...“ – jis suformuluos taisyklę į failą pagal susitarimą „Taisyklė → kodėl → kaip“.

Kas toliau: kaip vystysis konteksto inžinerijos disciplina?

Svarbiausia mintis

2026 m. konteksto inžinerija nuo tekstinių Markdown failų pereina prie labiau struktūruotų formatų. Atsirado „Dreaming“ funkcija, kai agentas per naktį iš naujo peržiūri ankstesnes sesijas. Toliau – HTML dokumentai, nuolatinė atmintis ir kelių agentų orkestravimas visoje produkto komandoje.

Šiuo metu disciplina vystosi viena kryptimi:

„Dreaming“ – sesijų peržiūra per naktį. 2026 m. gegužės 6 d. renginyje „Code w/ Claude SF“ Anthropic parodė funkciją, kuri leidžia agentui per naktį iš naujo peržiūrėti ankstesnes sesijas ir atnaujinti savo užrašus. Struktūruoti atminties failai dabar auga ne tik jums juos rašant, bet ir agentui darant išvadas iš sukauptos patirties.

Viena tendencija aiški: konteksto inžinerija tampa visaverte DI agentams skirtos informacijos architektūros disciplina, o ne vien „kaip parašyti CLAUDE.md“. Užklausų inžinerija buvo vienas pirmųjų šios disciplinos lygmenų. Konteksto inžinerija – kitas.

Pirmą vakarą verta įgyvendinti bent tiek: sukonfigūruoti CLAUDE.md, kad jį sudarytų 80–120 eilučių (vadovas čia), sukurti aplanką verslo žinioms, išmokti naudoti /compact ir nustoti eikvoti limitus.

Vėliau pridėkite poagentus (vadovas) ir Skills, kad specializuota kompetencija būtų perkelta iš bendro konteksto į atskirus įgūdžius.

Šaltiniai

Susipažinkite su Ailoot.

Išsamiau

Klausimai ir atsakymai

Ar 200 eilučių yra griežtas CLAUDE.md limitas?

Ne. Cituojamose gairėse rekomenduojama likti žemiau 200 eilučių, kad būtų taupomas kontekstas ir geriau laikomasi instrukcijų. Autoriaus 80–120 eilučių intervalas yra praktinė pirmenybė; svarbias taisykles tikrinkite su tikromis užduotimis, o ne laikykite eilučių skaičių garantija.

Ką iškelti iš pradinio konteksto?

Išsamius pavyzdžius, ilgus įrankių rezultatus ir konkrečios užduoties informacinę medžiagą perkelkite į atskirus failus. CLAUDE.md palikite glaustas taisykles ir nuorodas, tada reikiamas ištraukas gaukite tada, kai jų reikia užduočiai.

Visi straipsniai