CLAUDE.md Opus 5:n jälkeen: miksi pitkät ohjeet ovat nyt Clauden tiellä

Tietoa Ailootin käytöstä on dokumentaatiossa.

Mikä Claudessa muuttui Opus 5:n julkaisun jälkeen?#

Opus 5 julkaistiin 24. heinäkuuta 2026, ja siitä tuli heti Claude Coden oletusmalli. Itse mallia – sen hintaa, vertailutuloksia ja työskentelytehotiloja – käsitellään perusteellisesti erillisessä oppaassa ”Kannattaako vaihtaa Claude Opus 5:een?”. Tämä artikkeli käsittelee jotain muuta: mallin julkaisu muutti myös sitä, miten sen kanssa kannattaa viestiä.

Anthropic julkaisi analyysin Clauden blogissa. Sen pääajatus kuuluu näin:

Avainilmaus on ”rajoitimme liikaa”. Kun mallit olivat heikompia, ne tarvitsivat tukirakenteita: tee näin, älä tee noin, tässä on esimerkki, toista se vielä kerran. Opus 5 ei enää tarvitse tällaisia tukirakenteita, ja mikä pahempaa, ne voivat alkaa olla sen tiellä. Anthropic ilmaisee uuden periaatteen yksinkertaisesti: anna Clauden käyttää omaa harkintaansa.

Mitä tämä tarkoittaa käytännössä sinulle?

• CLAUDE.md-tiedostosi on samanlainen järjestelmäprompti, mutta projektiasi varten. Jos Anthropic lyhensi omaansa 80 prosentilla, omasikin on luultavasti liian laaja.
• Pitkät sääntölistat eivät enää takaa ohjeiden noudattamista. Päinvastoin: mitä enemmän rivejä, sitä vähemmän tarkasti malli noudattaa niitä (tästä lisää alla dokumentaation lukujen kera).
• Käyttöön on tullut uusia mekanismeja – automaattinen muisti ja skills-kokonaisuudet – jotka ottavat hoitaakseen osan siitä työstä, joka sinun piti aiemmin kirjoittaa käsin CLAUDE.md-tiedostoon.

Pääasia on, että tärkein työ tehdään ennen promptia – siinä, mitä lisäät mallin kontekstiin ennen ensimmäistä pyyntöä. Opus 5 -päivitys on käytännössä Anthropicin virallinen vahvistus samalle ajatukselle. Tällä kertaa mukana on kuitenkin konkreettisia lukuja ja uusia työkaluja. Käyn ne läpi yksi kerrallaan.

Miksi pitkä CLAUDE.md on nyt mallin tiellä?#

Näin se toimii. CLAUDE.md on sääntötiedosto, jonka Claude lukee jokaisen istunnon alussa. Erillisessä oppaassa ”CLAUDE.md:n määrittäminen” kerrotaan, kuinka sellainen rakennetaan alusta alkaen; tämä artikkeli käsittelee päinvastaista: mitä siitä kannattaa nyt poistaa. Kaikki, mitä kirjoitat tiedostoon, lisätään kontekstiin ennen ensimmäistä pyyntöäsi ja pysyy siellä koko keskustelun ajan. Konteksti ei ole rajaton – jokainen ylimääräinen sääntörivi vie tilaa, joka voisi olla käytössä tehtävääsi varten.

Claude Code -dokumentaatio sanoo asian suoraan:

Toinen kohta on ensimmäistä tärkeämpi: pitkät tiedostot heikentävät ohjeiden noudattamista. Malli alkaa kuunnella vähemmän tarkasti. Tämä on ansa, johon melkein kaikki aloittelijat lankeavat. Ajatusketju vaikuttaa aukottomalta: haluan Clauden kuuntelevan minua, joten kirjoitan lisää sääntöjä. Käytännössä käy päinvastoin. Mitä pidempi lista on, sitä hajanaisempi mallin huomio on ja sitä useammin se sivuuttaa säännön.

Näin lähestymistapa on muuttunut:

On myös toinen ongelma: ristiriidat. Tiedoston kasvaessa siihen kertyy lähes väistämättä keskenään ristiriitaisia sääntöjä. Yhdessä kohdassa sanotaan ”kirjoita aina testit”, toisessa ”älä koske testikansioon”. Dokumentaation mukaan Claude saattaa valita kahdesta ristiriitaisesta säännöstä kumman tahansa sattumanvaraisesti. Toisin sanoen ylipitkä tiedosto tekee mallin toiminnasta vähemmän ennustettavaa.

Yksinkertainen sääntö: CLAUDE.md on lyhyt muistiinpano asioista, joita Claude ei voi itse päätellä. Kaikki muu vie vain sen huomiota.

Mitä CLAUDE.md-tiedostossa kannattaa säilyttää ja mitä poistaa?#

Dokumentaatio antaa selkeän kriteerin sen arvioimiseen, ansaitseeko sääntö paikan CLAUDE.md-tiedostossa. Lisää se, jos:

1. Claude teki saman virheen toistamiseen.
2. Koodintarkistus havaitsi jotakin, mikä mallin olisi pitänyt tietää projektista.
3. Kirjoitat saman korjauksen chattiin toistamiseen.
4. Uusi tiimin jäsen tarvitsisi saman kontekstin välttääkseen projektin rikkomisen.

Yleisperiaate on säilyttää projektikohtaiset sudenkuopat ja poistaa ilmeiset asiat. Claude Codessa on jopa sisäänrakennettu claude doctor -tarkistus, joka ehdottaa ylipitkän CLAUDE.md-tiedoston siivoamista. Se karsii yksityiskohtia, jotka malli voi päätellä koodikannasta – kansiorakenteen, riippuvuusluettelon ja arkkitehtuurikatsauksen – ja säilyttää sudenkuopat, perustelut ja oletuksista poikkeavat käytännöt.

Toinen tärkeä sääntö on täsmällisyys. Epämääräiset ohjeet eivät toimi. Vertaa:

Ero on yksinkertainen. Malli voi tulkita ”muotoile oikein” haluamallaan tavalla. ”Käytä 2 välilyönnin sisennystä” voidaan tarkistaa yksiselitteisesti. Jokaisen CLAUDE.md-säännön pitäisi olla sellainen, että voit todentaa, noudatettiinko sitä vai ei.

Kolmanneksi poista ilmeinen. Jos kirjoitat CLAUDE.md-tiedostoon ”kirjoita siistiä koodia” tai ”noudata parhaita käytäntöjä”, se on kohinaa. Malli tietää sen jo, ja rivi vie tilaa sekä hajottaa sen huomion. Anthropic nimenomaisesti neuvoo olemaan käyttämättä kontekstia itsestään selviin asioihin.

Minne siirtää säännöt, jotka eivät kuulu CLAUDE.md-tiedostoon?#

Tässä tulee mukaan kaikkein aliarvostetuin työkalu. Jos aiemmin kaikkien ohjeiden piti olla CLAUDE.md-tiedostossa, pitkille menettelyille on nyt oma paikkansa: skills-kokonaisuudet. Erillisessä oppaassa ”Claude Code -skills-kokonaisuuksien valitseminen” selitetään, miten valitset sopivat lisäämättä niitä liikaa.

Ero on perustavanlaatuinen. CLAUDE.md ladataan kokonaan jokaisen istunnon alussa. Skilliä ei ladata. Dokumentaatiossa asia ilmaistaan näin:

Tätä kutsutaan vaiheittaiseksi tiedon paljastamiseksi: tietoa ladataan tarpeen mukaan. Ajatuksena on antaa mallille kontekstia osissa ja oikealla hetkellä. Anthropic siirsi yksityiskohtaiset ohjeensa, esimerkiksi koodikatselmuksia koskevat ohjeet, skills-kokonaisuuksiin ja poisti ne järjestelmäpromptista.

Kriteeri jonkin asian siirtämiselle skilliin on yksinkertainen: CLAUDE.md:n osio on muuttunut faktasta menettelyksi. Yhden rivin huomautus ”Buildit suoritetaan komennolla npm run build” on fakta ja kuuluu CLAUDE.md-tiedostoon. Kymmenen vaihetta projektin julkaisemiseen on menettely ja kuuluu skilliin.

Käytännön periaate: siirrä eteenpäin kaikki, mitä teet useammin kuin pari kertaa. Selitä kerran esimerkiksi, miten kokoat viikoittaisen asiakasraportin, muuta selitys skilliksi, eikä sinun tarvitse enää selittää sitä uudelleen. Skilli pysyy paikallaan viemättä kontekstia ja sen voi kutsua nimellä komennolla, kuten /otchet.

Skills-kokonaisuuksiin kannattaa siirtää esimerkiksi:

• Monivaiheiset menettelyt (julkaiseminen, raportin kokoaminen, julkaisua edeltävät tarkistukset).
• Pitkät ohjeet, joita tarvitaan harvoin mutta kokonaisuudessaan.
• Kaikki, mitä kopioit chatista toiseen toisen tai kolmannen kerran.

Välimuotona ovat kansiokohtaiset säännöt. Jos ohje koskee vain yhtä projektin osaa, voit sijoittaa sen hakemistoon .claude/rules/ ja liittää sen asiaankuuluviin tiedostoihin. Silloin se ladataan vain, kun Claude työskentelee kyseisten tiedostojen parissa, eikä se ole koko ajan kontekstissa.

Mitä automaattinen muisti on ja miksi sitä kannattaa käyttää vuonna 2026?#

Toinen uusi mekanismi, joka keventää CLAUDE.md-tiedoston kuormaa, on automaattinen muisti. Ajatuksena on, että Claude muistaa nyt kirjoittamiesi asioiden lisäksi myös itse havaitsemiaan asioita. Erillisessä oppaassa ”Claude-muisti ja CLAUDE.md” selitetään, miten sen toimintatapa eroaa CLAUDE.md:stä.

Kahden muistityypin erot:

Näin se toimii: kun Claude työskentelee tehtäväsi parissa, se huomaa hyödyllisiä yksityiskohtia – millä komennolla build suoritetaan, missä vianmääritys jumittui, mitä pyysit sitä tekemään toisin – ja tallentaa ne muistiinpanoihinsa. Se palauttaa ne käyttöön seuraavassa istunnossa. Tärkeää: se tallentaa valikoivasti vain sen, mistä se arvioi olevan hyötyä myöhemmin.

Muistiinpanot sijaitsevat erillisessä projektikohtaisessa kansiossa, jossa on indeksitiedosto nimeltä MEMORY.md. Voit tarkastella ja muokata niitä komennolla /memory. Ne ovat tavallisia tekstitiedostoja, joten voit lukea, muokata tai poistaa niitä milloin tahansa.

Mitä tämä käytännössä muuttaa sinulle: Claude kirjaa nyt muistiin osan asioista, jotka lisäsit aiemmin itse CLAUDE.md-tiedostoon jokaisen virheen jälkeen. Näin sääntötiedostosi jää vielä lyhyemmäksi – ja se on hyvä asia.

Miksi Opus 5 väittelee ohjeistasi vastaan?#

Asialla on myös kääntöpuolensa.

Malli, joka saa käyttää harkintaansa, on määritelmän mukaan joskus eri mieltä jäykästä komennosta, jos se näkee kontekstissa paremman vaihtoehdon.

Mitä tämä tarkoittaa, jos olet päivittänyt Opus 5:een ja jokin menee pieleen?

1. Tarkista vanhat skills-kokonaisuutesi ja pluginisi uudelleen. Aiemmille malleille rakennetut kokoonpanot voivat olla ristiriidassa uuden logiikan kanssa. Aiemmin kellontarkasti toiminut asia kannattaa nyt testata uudelleen.
2. Poista kaikkein jäykimmät sanamuodot. Viidennen sukupolven mallit käsittelevät komentoja, kuten ”älä koskaan tee X:ää, tee aina vain Y:tä”, huonommin kuin joustavia ohjeita, joissa kerrotaan miksi.
3. Tarkkaile tilanteita, joissa malli lopettaa liian aikaisin. Joskus se kertoo, että ohje on ristiriitainen tai törmää ylipitkän CLAUDE.md-tiedoston sääntöön.

Näin kirjoitat CLAUDE.md:n uudelleen Opus 5:tä varten: vaihe vaiheelta#

Näin käsittelet aiemmille malleille perittyä CLAUDE.md-tiedostoa.

1. Suorita sisäänrakennettu tarkistus

   Kirjoita projektissa claude doctor. Se ehdottaa, mitä ylipitkästä tiedostosta kannattaa poistaa ja mitä säilyttää.

2. Poista itsestäänselvyydet

   Poista jokainen rivi, jonka Claude voi päätellä itse koodista: kansiorakenne, kirjasto- ja riippuvuusluettelo sekä yleiset ilmaukset, kuten ”kirjoita siistiä koodia”.

3. Poista ristiriidat

   Käy tiedosto läpi ylhäältä alas ja etsi keskenään ristiriitaiset säännöt. Säilytä toinen ja poista sen kanssa ristiriidassa oleva sääntö.

4. Siirrä menettelyt skills-kokonaisuuksiin

   Siirrä erilliseen skilliin kaikki, mikä on muuttunut faktasta vaihe vaiheelta eteneväksi ohjeeksi. Jätä CLAUDE.md-tiedostoon yhden rivin linkki.

5. Täsmennä jäljelle jäävät säännöt

   Muotoile jokainen sääntö uudelleen niin, että sen noudattaminen voidaan tarkistaa: ”muotoile oikein” muuttuu muotoon ”käytä 2 välilyönnin sisennystä”.

6. Ota automaattinen muisti käyttöön ja tarkista tiedoston pituus

   Varmista, että automaattinen muisti toimii (/memory) ja tiedostossa on alle 200 riviä. Jos ei, siirrettävää on vielä.

Jos et halua tehdä ensimmäistä kierrosta käsin, pyydä Claudea hoitamaan työ. Tässä on lähtökohdaksi sopiva prompti – kopioi se ja liitä se projektissasi avattuun istuntoon:

Lue CLAUDE.md-tiedostoni ja koodini. Tehtäväsi on tehdä CLAUDE.md-tiedostosta lyhyempi ja hyödyllisempi viidennen sukupolven mallille.

Käy tiedosto läpi ja jaa kaikki säännöt kolmeen ryhmään:

SÄILYTÄ – projektikohtaiset sudenkuopat ja käytännöt, joita et voi päätellä itse koodista.

POISTA – itsestään selvät asiat, jotka jo tiedät, sekä kaikki, mikä voidaan päätellä koodista.

SIIRRÄ SKILLIIN – monivaiheiset menettelytavat, jotka ovat tällä hetkellä tekstinä CLAUDE.md-tiedostossa.

Muotoile ryhmän 1 epämääräiset säännöt uudelleen konkreettisiksi ja todennettaviksi.
Etsi keskenään ristiriitaiset säännöt ja näytä ne erikseen.
Palauta uusi, alle 200-rivinen CLAUDE.md-versio sekä luettelo asioista, joiden siirtämistä skills-kokonaisuuksiin ehdotat.
Älä muuta tiedostoja ennen kuin vahvistan.

Huomaa viimeinen rivi: ”Älä muuta mitään ennen kuin vahvistan.” Tämä on tärkeää mallin käyttäessä nyt omaa harkintaansa: pyydä sitä näyttämään ensin suunnitelmansa ja jätä päätös sinulle.

Miksi konteksti on promptia tärkeämpi?#

Jos siirrytään Opus 5:n yksityiskohdista laajempaan kuvaan, koko analyysin ydin on yksi ajatus: konteksti on promptia tärkeämpi. Tärkein työ tehdään ennen pyyntöä – kun kokoat ympäristön, jossa malli työskentelee.

CLAUDE.md, skills-kokonaisuudet ja automaattinen muisti ovat kaikki osa samaa asiaa: sitä, mitä Claude näkee ennen ensimmäistä viestiäsi. Voit hioa pyyntösi sanamuotoa loputtomiin, mutta jos konteksti on koottu huonosti – CLAUDE.md on ylipitkä, säännöt ristiriitaisia eikä rakennetta ole – tulokset jäävät silti epäjohdonmukaisiksi.

Yksinkertainen tarkistus: ilman ensimmäisiä aivoja toisista aivoista ei ole apua. ”Toisilla aivoilla” tämä artikkeli tarkoittaa projektin tietorakennetta, jonka malli lukee jokaisen pyynnön yhteydessä. Se toimii kuitenkin vain, kun perustana on selkeä ymmärryksesi tehtävästä. Työkalu vahvistaa ajatteluasi, ja siihen sen rooli päättyy.

Opus 5 -päivitys terävöitti tätä logiikkaa. Anthropic osoitti omalla työllään, että kun malli on tarpeeksi älykäs, lisäsäännöt vain haittaavat ja etulyöntiasema on sillä, joka on koonnut kontekstin huolellisesti. Tämä taito kulkee mukanasi jokaisen tulevan mallin kohdalla, olipa se Opus 6 tai jokin muu.

Mistä sinun kannattaa aloittaa nyt?#

Älä lykkää sitä ”joskus myöhemmin”. Yksinkertaisin ensimmäinen askel on avata CLAUDE.md juuri nyt ja kysyä rehellisesti jokaisesta rivistä: onko tämä sudenkuoppa, jota Claude ei voi päätellä, vai itsestäänselvyys, jonka lisäsin varmuuden vuoksi? Kaikki jälkimmäiseen ryhmään kuuluva voidaan poistaa.

Käy sitten tiedosto läpi edellisen osion promptilla, siirrä pitkät menettelyt skills-kokonaisuuksiin ja tarkista, että automaattinen muisti on käytössä. Yksi ilta työtä, ja kontekstistasi tulee mallille tiivis ja täsmällinen perusta.

Voit soveltaa tätä omassa oikeassa projektissasi: CLAUDE.md, toiset aivot ja tehtäviäsi varten tehdyt skills-kokonaisuudet.

Tutustu Ailootiin.