CLAUDE.md po Opus 5: kodėl ilgos instrukcijos dabar trukdo Claude

Informacijos apie darbą su Ailoot rasite dokumentacijoje.

Kas pasikeitė Claude išleidus Opus 5?#

Opus 5 pasirodė 2026 m. liepos 24 d. ir iškart tapo numatytuoju Claude Code modeliu. Apie patį modelį – jo kainą, benchmarkus ir effort režimus – išsamiai rašoma atskirame vadove „Ar verta pereiti prie Claude Opus 5?“. Šis straipsnis apie ką kita: modelio išleidimas taip pat pakeitė tai, kaip veiksmingai su juo bendrauti.

Anthropic paskelbė analizę Claude tinklaraštyje. Pagrindinė jos mintis tokia:

Svarbiausia frazė – „per daug varžėme“. Kai modeliai buvo silpnesni, jiems reikėjo atramų: daryk tai, nedaryk ano, štai pavyzdys, pakartok jį dar kartą. Opus 5 tokios atramos nebereikia, o dar blogiau – ji gali pradėti trukdyti. Anthropic naują principą nusako paprastai: leiskite Claude pasitelkti savo nuovoką.

Ką tai reiškia jums praktiškai?

• Jūsų CLAUDE.md yra tokio paties tipo sistemos promptas, tik skirtas jūsų projektui. Jei Anthropic savąjį sumažino 80 procentų, jūsų failas tikriausiai irgi perpildytas.
• Ilgi taisyklių sąrašai nebūtinai padeda jų laikytis. Priešingai, kuo daugiau eilučių, tuo prasčiau modelis jų laikosi (apie tai plačiau toliau, pateikiant dokumentacijos duomenis).
• Atsirado naujų mechanizmų – automatinė atmintis ir skills, – kurie perima dalį darbo, kurį anksčiau reikėdavo rankiniu būdu surašyti faile CLAUDE.md.

Pagrindinė mintis: svarbiausias darbas atliekamas prieš promptą – tuo, ką įdedate į modelio kontekstą prieš pirmą užklausą. Opus 5 atnaujinimas iš esmės yra oficialus Anthropic patvirtinimas, kad ši mintis teisinga. Tačiau šįkart pateikiami konkretūs duomenys ir nauji įrankiai. Apžvelgsiu juos po vieną.

Kodėl ilgas CLAUDE.md dabar trukdo?#

Štai kaip tai veikia. CLAUDE.md yra taisyklių failas, kurį Claude perskaito kiekvienos sesijos pradžioje. Atskirame vadove „Kaip nustatyti CLAUDE.md“ paaiškinama, kaip tokį failą sukurti nuo pradžių; šiame straipsnyje aptariamas atvirkštinis procesas – ką iš jo dabar pašalinti. Viskas, ką jame parašote, įtraukiama į kontekstą prieš pirmąją jūsų užklausą ir lieka jame viso pokalbio metu. Kontekstas nėra begalinis, o kiekviena papildoma taisyklių eilutė užima vietą, kuri galėtų būti skirta jūsų užduočiai.

Claude Code dokumentacijoje tai pasakyta tiesiai:

Antrasis punktas svarbesnis už pirmąjį: ilgi failai blogina instrukcijų laikymąsi. Modelis ima mažiau atidžiai klausyti. Į šiuos spąstus patenka beveik kiekvienas pradedantysis. Atrodo, logika nepaneigiama: noriu, kad Claude manęs klausytų, taigi parašysiu daugiau taisyklių. Praktiškai nutinka priešingai. Kuo ilgesnis sąrašas, tuo labiau išsibarsto modelio dėmesys ir tuo dažniau jis praleidžia taisyklę.

Štai kaip pasikeitė požiūris:

Yra ir antra problema – prieštaravimai. Failui augant jame beveik neišvengiamai atsiranda viena kitai prieštaraujančių taisyklių. Vienoje vietoje parašyta „visada rašyk testus“, kitoje – „neliesk testų aplanko“. Dokumentacijoje perspėjama, kad jei dvi taisyklės prieštarauja viena kitai, Claude gali atsitiktinai pasirinkti bet kurią. Kitaip tariant, peraugęs failas daro modelio elgesį mažiau nuspėjamą.

Paprasta taisyklė: CLAUDE.md yra trumpa pastaba apie tai, ko Claude negali numanyti pats. Visa kita tik užima jo dėmesį.

Ką palikti CLAUDE.md, o ką pašalinti?#

Dokumentacijoje pateikiamas aiškus kriterijus, padedantis nuspręsti, ar taisyklė verta vietos faile CLAUDE.md. Pridėkite ją, jei:

1. Claude tą pačią klaidą padarė antrą kartą.
2. Kodo patikra aptiko dalyką, kurį modelis turėjo žinoti apie šį projektą.
3. Tą pačią pataisą pokalbyje rašote antrą kartą.
4. Naujam komandos nariui reikėtų to paties konteksto, kad jis nesugadintų projekto.

Bendras principas – palikti konkrečiam projektui būdingas problemas ir pašalinti tai, kas akivaizdu. Claude Code turi netgi integruotą claude doctor patikrą, kuri siūlo sutvarkyti peraugusį CLAUDE.md. Ji pašalina detales, kurias modelis gali numanyti iš kodo bazės – aplankų struktūrą, priklausomybių sąrašą, architektūros apžvalgą, – ir palieka problemas, jų priežastis bei nuo numatytųjų besiskiriančias konvencijas.

Antroji svarbi taisyklė – konkretumas. Miglotos formuluotės neveikia. Palyginkite:

Skirtumas paprastas. Modelis gali savaip interpretuoti „tinkamai suformatuok“. „Naudok 2 tarpų įtrauką“ galima vienareikšmiškai patikrinti. Kiekviena CLAUDE.md taisyklė turėtų būti tokia, kad galėtumėte aiškiai patikrinti, ar jos laikytasi.

Trečia, pašalinkite tai, kas akivaizdu. Jei įrašysite „rašyk švarų kodą“ arba „laikykis geriausios praktikos“, tai bus triukšmas. Modelis tai jau žino, o eilutė užima vietą ir blaško jo dėmesį. Anthropic aiškiai pataria neeikvoti konteksto akivaizdiems dalykams.

Kur perkelti taisykles, kurios netelpa į CLAUDE.md?#

Čia praverčia labiausiai neįvertintas įrankis. Jei anksčiau visos instrukcijos turėjo likti faile CLAUDE.md, dabar ilgos procedūros turi atskirą vietą – skills. Atskirame vadove „Kaip pasirinkti Claude Code skills“ aiškinama, kaip išsirinkti tinkamus ir nepridėti jų per daug.

Skirtumas esminis. CLAUDE.md visas įkeliamas kiekvienos sesijos pradžioje. Skill – ne. Dokumentacijoje tai nusakoma taip:

Tai vadinama laipsnišku informacijos pateikimu – informacijos įkėlimu pagal poreikį. Idėja tokia: pateikti modeliui kontekstą dalimis, tinkamu metu. Anthropic perkėlė savo išsamias instrukcijas, pavyzdžiui, kodo peržiūros instrukcijas, į skills ir pašalino jas iš sistemos prompto.

Kriterijus, pagal kurį nuspręsite, ar ką nors perkelti į skill, paprastas: CLAUDE.md skiltis iš fakto virto procedūra. Vienos eilutės pastaba „Build vykdomas per npm run build“ yra faktas ir priklauso CLAUDE.md. Dešimt žingsnių, aiškinančių „kaip skelbiame projektą“, yra procedūra ir priklauso skill.

Praktinis principas: perkelkite viską, ką darote daugiau nei porą kartų. Vieną kartą paaiškinkite, pavyzdžiui, kaip rengiate savaitinę kliento ataskaitą, paverskite tą paaiškinimą skill ir daugiau nebereikės jo kartoti. Skill lieka pasiekiamas, neužima konteksto ir jį galima iškviesti vardu tokia komanda kaip /otchet.

Į skills verta perkelti:

• Kelių etapų procedūras (publikavimą, ataskaitos rengimą, patikras prieš išleidimą).
• Ilgas instrukcijas, kurių retai prireikia, bet reikia visų.
• Viską, ką antrą ar trečią kartą kopijuojate iš vieno pokalbio į kitą.

Yra ir tarpinis variantas – konkretiems aplankams skirtos taisyklės. Jei instrukcija svarbi tik vienai projekto daliai, galite ją įdėti į .claude/rules/ ir susieti su atitinkamais failais. Tuomet ji įkeliama tik tada, kai Claude dirba su tais failais, o ne nuolat lieka kontekste.

Kas yra automatinė atmintis ir kodėl ją naudoti 2026 m.?#

Antras naujas mechanizmas, palengvinantis CLAUDE.md naštą, yra automatinė atmintis. Idėja tokia: dabar Claude prisimena ne tik tai, ką parašėte, bet ir tai, ką pats pastebėjo. Atskirame vadove „Claude atmintis ir CLAUDE.md“ aiškinama, kuo jos veikimas skiriasi nuo CLAUDE.md.

Šių dviejų atminties rūšių skirtumai:

Štai kaip tai veikia: dirbdamas su jūsų užduotimi Claude pastebi naudingas detales – kuri komanda vykdo build, kur derinant klaidas iškilo kliūtis, ką paprašėte daryti kitaip, – ir išsaugo jas savo pastabose. Jis vėl jas panaudoja kitoje sesijoje. Svarbu: pastabas jis saugo pasirinktinai ir palieka tik tai, kas, jo manymu, bus naudinga ateityje.

Kiekvienas projektas turi atskirą aplanką su pastabomis ir indekso failą MEMORY.md. Jas galite peržiūrėti ir redaguoti komanda /memory. Tai paprasti tekstiniai failai, todėl galite juos bet kada skaityti, redaguoti arba ištrinti.

Ką tai keičia praktiškai: dabar Claude užrašo dalį to, ką anksčiau po kiekvienos klaidos patys įtraukdavote į CLAUDE.md. Dėl to jūsų taisyklių failas dar labiau sutrumpėja – ir tai gerai.

Kodėl Opus 5 ginčija jūsų instrukcijas?#

Yra ir kita medalio pusė.

Modelis, kuriam leidžiama vadovautis savo nuovoka, pagal apibrėžimą kartais nesutiks su griežta komanda, jei kontekste matys geresnį variantą.

Ką daryti, jei atnaujinote į Opus 5 ir kažkas nepavyksta:

1. Dar kartą patikrinkite senus skills ir plugins. Ankstesniems modeliams sukurtos sąrankos gali prieštarauti naujai logikai. Verta dar kartą patikrinti ir tai, kas anksčiau veikė nepriekaištingai.
2. Pašalinkite griežčiausias formuluotes. Penktosios kartos modeliai prasčiau vykdo tokias komandas kaip „niekada nedaryk X, visada daryk tik Y“ nei lanksčias formuluotes, paaiškinančias priežastį.
3. Stebėkite, kur modelis sustoja per anksti. Kartais tai reiškia, kad instrukcija prieštarauja pati sau arba kertasi su taisykle perpildytame CLAUDE.md.

Kaip perrašyti CLAUDE.md, kad tiktų Opus 5: žingsnis po žingsnio#

Štai kaip tvarkyti iš ankstesnių modelių paveldėtą CLAUDE.md.

1. Paleiskite integruotą patikrą

   Projekte įveskite claude doctor. Ji pasiūlys, ką pašalinti iš perpildyto failo, o ką palikti.

2. Pašalinkite akivaizdžius dalykus

   Ištrinkite kiekvieną eilutę, kurią Claude gali nustatyti iš paties kodo: aplankų struktūrą, bibliotekų sąrašą ir bendras frazes, tokias kaip „rašyk švarų kodą“.

3. Pašalinkite prieštaravimus

   Nuo pradžios iki galo peržiūrėkite failą ir suraskite viena kitai prieštaraujančias taisykles. Vieną palikite, o jai prieštaraujančią ištrinkite.

4. Perkelkite procedūras į skills

   Viską, kas iš fakto virto nuoseklia instrukcija, perkelkite į atskirą skill. CLAUDE.md palikite vienos eilutės nuorodą.

5. Patikslinkite likusias taisykles

   Kiekvieną taisyklę suformuluokite taip, kad ją būtų galima patikrinti: „tinkamai suformatuok“ pakeiskite į „naudok 2 tarpų įtrauką“.

6. Įjunkite automatinę atmintį ir patikrinkite failo ilgį

   Įsitikinkite, kad automatinė atmintis veikia (/memory) ir kad failas trumpesnis nei 200 eilučių. Jei ne, yra dar ką perkelti.

Kad pirmojo etapo nereikėtų atlikti rankiniu būdu, paprašykite Claude tai padaryti. Štai raginimas, nuo kurio galite pradėti – nukopijuokite jį ir įklijuokite į sesiją, atidarytą savo projekte:

Perskaityk mano CLAUDE.md ir mano kodą. Tavo užduotis – sutrumpinti CLAUDE.md ir padaryti jį naudingesnį penktosios kartos modeliui.

Peržiūrėk failą ir suskirstyk visas taisykles į tris grupes:

KEEP – konkrečiam projektui būdingi keblumai ir susitarimai, kurių negali nustatyti vien iš kodo.

DELETE – akivaizdūs dalykai, kuriuos jau žinai, ir visa, ką galima nustatyti iš kodo.

MOVE TO A SKILL – kelių etapų procedūros, kurios dabar pateiktos kaip tekstas faile CLAUDE.md.

1 grupės taisykles suformuluok iš naujo taip, kad jos būtų konkrečios ir patikrinamos.
Surask viena kitai prieštaraujančias taisykles ir pateik jas atskirai.
Grąžink naują CLAUDE.md versiją, trumpesnę nei 200 eilučių, ir sąrašą, ką siūlai perkelti į skills.
Nekeisk jokių failų, kol nepatvirtinsiu.

Atkreipkite dėmesį į paskutinę eilutę: „Nieko nekeisk, kol nepatvirtinsiu.“ Modeliui, kuris dabar vadovaujasi savo nuovoka, tai svarbu: pirmiausia paprašykite parodyti planą, o sprendimą pasilikite sau.

Kodėl kontekstas svarbesnis už promptą?#

Atidėjus į šalį Opus 5 ypatumus ir pažvelgus plačiau, visa ši analizė sukasi apie vieną mintį: kontekstas svarbesnis už promptą. Svarbiausias darbas atliekamas prieš pateikiant užklausą – kai paruošiate aplinką, kurioje modelis dirbs.

CLAUDE.md, skills ir automatinė atmintis yra vieno dalyko dalys: to, ką Claude mato prieš jūsų pirmąją žinutę. Galite be galo tobulinti užklausos formuluotę, tačiau jei kontekstas paruoštas prastai – CLAUDE.md perpildytas, taisyklės prieštarauja viena kitai, nėra struktūros – rezultatai vis tiek bus nenuoseklūs.

Paprastas patikrinimas: be pirmųjų smegenų antrosios smegenys nepadės. Šiame straipsnyje „antrosiomis smegenimis“ vadinama projekto žinių struktūra, kurią modelis perskaito su kiekviena užklausa. Tačiau tai veikia tik tada, kai ją papildo jūsų aiškus užduoties supratimas. Įrankis sustiprina jūsų mąstymą – tuo jo vaidmuo ir baigiasi.

Opus 5 atnaujinimas šią logiką išryškino. Savo darbu Anthropic parodė, kad modeliui tapus pakankamai išmaniam papildomos taisyklės tik kenkia, o pranašumą įgyja tas, kuris kruopščiai paruošė kontekstą. Šis įgūdis pravers ir su kiekvienu kitu modeliu – Opus 6 ar bet kuriuo kitu.

Nuo ko pradėti dabar?#

Neatidėkite to „kada nors“. Paprasčiausias pirmasis žingsnis – čia pat atsidaryti CLAUDE.md ir sąžiningai savęs paklausti apie kiekvieną eilutę: ar tai problema, kurios Claude negali numanyti, ar akivaizdus dalykas, kurį pridėjau dėl visa ko? Viską, kas priklauso antrajai grupei, galima ištrinti.

Tada peržiūrėkite failą naudodami ankstesniame skyriuje pateiktą raginimą, perkelkite ilgas procedūras į skills ir patikrinkite, ar įjungta automatinė atmintis. Vieno vakaro darbas, ir jūsų kontekstas taps glaustu bei tiksliu pagrindu modeliui.

Tai galite pritaikyti savo realiame projekte: CLAUDE.md, antrosios smegenys ir jūsų užduotims skirti skills.

Susipažinkite su Ailoot.