Claude Memory: Memory, CLAUDE.md ja Auto Memory
MarkdownKolme Clauden muistijärjestelmää: missä ne toimivat, miten asetuksia hallitaan, mitä kannattaa tallentaa ja miten välttää viisi yleistä virhettä.
Lue koko artikkeli
Tärkeimmät kohdat
Claudessa on vuonna 2026 kolme muistijärjestelmää: Claude.ai:n Memory — pilvipohjainen ja maksuton maaliskuusta 2026 lähtien; Claude Coden CLAUDE.md — tiedosto, jossa ovat sääntösi; Auto Memory — agentin projektistasi tekemät muistiinpanot. Kaikki kolme toimivat eri tavoin ja eri tuotteissa: Memory ei siirry Claude Codeen, eikä CLAUDE.md toimi claude.ai:ssa. Tässä artikkelissa on vertailutaulukko, ohjeet kunkin järjestelmän käyttöönottoon ja siihen, mitä mihinkin kannattaa tallentaa, sekä viisi virhettä, jotka rikkovat asetukset.
Käytännön ohjeet Ailootin käyttöön ovat dokumentaatiossa.
Mitä Claude-muisti on, ja miksi siinä on kolme kerrosta?
Tärkeimmät kohdat
Claudessa on vuonna 2026 kolme erillistä muistikerrosta, ja ne ovat eri tuotteissa. Memory toimii Claude.ai:ssa — verkkokeskustelussa ja mobiilisovelluksessa. CLAUDE.md ja Auto Memory toimivat Claude Codessa — tietokoneellasi päätteen kautta. Ne eivät ole sama asia. Memory ei siirry Claude Codeen, eikä CLAUDE.md toimi Claude.ai:ssa. Kun ihmiset sanovat ”Claude unohti projektini”, he yleensä sekoittavat sen, missä kukin muistityyppi sijaitsee.
Avaat Claude.ai:n tiistaina ja kerrot sille kohdeyleisöstäsi, vastausmuodosta ja kirjoitustyylistäsi. Palaat torstaina uuteen keskusteluun — ja Claude muistaa jo nämä asiat. Se on Memory-toiminnon ansiota.
Avaat Claude Coden päätteessä, käytät kaksi viikkoa projektiin perehtymiseen ja kerrot kansiorakenteesta, käyttöönoton säännöistä ja suosikkikirjastoistasi. Suljet istunnon ja avaat sen uudelleen tunnin päästä — agentti aloittaa taas alusta. Memory ei toimi täällä. Tarvitset CLAUDE.md-tiedoston, jotta tilanne muuttuu.
Vuonna 2026 tuli kolmas kerros. Claude Coden Auto Memory tarkoittaa, että agentti kirjoittaa itse muistiinpanoja projektistasi: mitkä komennot toimivat, mitkä testit menevät läpi ja mitkä repositorion polut ovat arkaluonteisia. Muistiinpanot tallennetaan paikallisesti levyllesi ja ladataan automaattisesti seuraavassa istunnossa.
Suurin sekaannus syntyy, kun ihmiset kuulevat, että ”Claude muistaa nyt”, ja luulevat sen toimivan automaattisesti kaikkialla. Näin ei ole. Claude.ai:n Memory ei siirry Claude Codeen — virallisessa Claude Code -dokumentaatiossa kuvataan kaksi muistimekanismia, eikä Chat Memory ole niistä kumpikaan. CLAUDE.md ja Auto Memory toimivat Claude Codessa — ne ovat aivan eri järjestelmiä. Sama pätee Anthropic API:in: siinä on erillinen Memory-työkalu, joka ei liity keskustelumuistiin.
Tässä oppaassa käsitellään kaikkia kolmea, jotta tiedät, mitä mihinkin kannattaa tallentaa ja miksi Claude yhtäkkiä ”unohtaa” projektin, vaikka ”otit muistin käyttöön”.
Mikä on Claude.ai:n Memory, ja ketkä saavat sen maksutta vuonna 2026?
Tärkeimmät kohdat
Claude.ai:n Memory on tiliisi sidottu pilvipohjainen muisti. Maaliskuusta 2026 lähtien Anthropic on tarjonnut sen maksutta kaikilla tilauksilla, myös Free-tilauksella. Se toimii vain claude.ai:ssa ja mobiilisovelluksessa. Claude tunnistaa keskusteluista automaattisesti pitkäaikaisesti hyödyllisiä tietoja (ammatti, vastaustyyli, työn konteksti) ja tallentaa ne Memory-profiiliisi. Hallitse niitä kohdassa Settings → Capabilities → Memory.
Miten Memory kerää tietoja
Anthropic kutsuu tätä Memory Synthesis -toiminnoksi. Noin kerran päivässä Claude käsittelee viimeaikaisia keskustelujasi, tunnistaa pitkällä aikavälillä hyödylliset asiat ja kirjoittaa Memory-profiiliisi lyhyitä yhteenvetoja. Ne eivät ole viestiesi sanatarkkoja lainauksia — ne ovat tiivistettyjä toteamuksia, kuten ”käyttäjä on markkinoija, pyörittää verkkoprojektia ja pitää lyhyistä vastauksista ilman täytettä”.
Seuraavan keskustelun alussa nämä yhteenvedot lisätään automaattisesti kontekstiin. Claude tietää, kuka olet, mitä teet ja millaisesta vastaustyylistä pidät — ilman että sinun tarvitsee kertoa sitä jokaisessa keskustelussa uudelleen.
Mitkä tilaukset tukevat Memory-toimintoa?
Anthropic otti Memory-toiminnon käyttöön vaiheittain: 11. syyskuuta 2025 — Team ja Enterprise; 23. lokakuuta 2025 — Pro ja Max; 2. maaliskuuta 2026 — maksutta kaikilla tilauksilla, ja lisäksi käyttöön tuli Import-työkalu ChatGPT:stä, Geministä ja Grokista.
| Tilaus | Memory toimii | Ominaisuudet |
|---|---|---|
| Free | Kyllä | Memory on toiminut maaliskuusta 2026 lähtien, mutta Chat Search (hakeminen keskusteluhistoriasta) on edelleen saatavilla vain maksullisilla tilauksilla |
| Pro ($20/kk) | Kyllä | Memory + Chat Search |
| Max | Kyllä | Memory + Chat Search |
| Team / Enterprise | Kyllä | Sidottu tiimin tiliin |
| API | Ei | Chat Memory ei siirry mukana. Agenttikehittäjille on erillinen Memory-työkalu |
| Claude Code | Ei | Käytä Claude Codessa CLAUDE.md:tä ja Auto Memorya |
Tämä on tärkeää: Memory toimii siellä, missä on Claude.ai:n verkkokäyttöliittymä tai mobiilisovellus. Kun käytät Claudea oman koodisi tai CLI:n kautta, Memory ei ole käytettävissä.
Mistä sitä voi tarkastella ja muokata
Claude.ai:ssa: Settings → Capabilities → Memory. Suora URL: claude.ai/settings/capabilities?modal=memory. Näkyviin tulee luettelo kaikesta, mitä Claude on tallentanut sinusta. Kolme painiketta:
- Pause — Claude säilyttää kertyneen muistin mutta lakkaa käyttämästä sitä ja lisäämästä siihen tietoja.
- Reset memory — poistaa kaiken.
Kun valitset tämän vaihtoehdon ja napsautat 'Reset memory', toimintoa ei voi perua.
— Anthropic, https://support.claude.com/en/articles/11817273 - Edit individual entries — voit poistaa yksittäisiä merkintöjä käsin.
Keskustelun sisäiset ohjaustoiminnot toimivat suoraan chatissa: pyydä Claudea ”muistamaan X” tai ”unohtamaan Y”, niin Memory päivittyy ilman, että sinun tarvitsee avata Settings-kohtaa.
Vielä yksi tärkeä asia: Claude.ai:n Projects-ominaisuudella on erillinen muisti.
Claude luo jokaiselle projektille erillisen muistin. Näin tuotelanseerauksen suunnittelu pysyy erillään asiakastyöstä ja luottamukselliset keskustelut erillään yleisestä toiminnasta.
Tämä tarkoittaa, etteivät Projectin sisäiset keskustelut siirry yleiseen Memoryyn eivätkä yleiset keskustelut Projectin muistiin.
Voit kysyä suoraan Claudelta
Kirjoita missä tahansa keskustelussa: ”Mitä muistat minusta?” Claude luettelee, mitä se muistaa tätä keskustelua varten. Tämä on nopein tapa tarkistaa, mitä Memory-profiiliisi on tallentunut.
Tietosuoja
Anthropic sanoo nimenomaisesti, että muistisi on yksityinen tilillesi eikä sitä jaeta muiden käyttäjien kanssa. Anthropic voi oletusarvoisesti käyttää keskustelujasi (myös Memoryyn päätyviä) malliensa parantamiseen. Voit poistaa tämän käytöstä tietosuoja-asetuksissa kohdassa Data Controls.
Mikä on Claude Coden CLAUDE.md, ja miten se eroaa Memorysta?
Tärkeimmät kohdat
CLAUDE.md on projektin juuressa oleva tekstitiedosto, jonka Claude Code lukee jokaisen istunnon alussa. Sinä kirjoitat säännöt: mitä työkaluja käytetään, miten kansiot on järjestetty ja mitä ei saa tehdä. Toisin kuin Memoryssa, mitään ei kerätä automaattisesti — päätät itse, mitä tiedostoon lisätään. Lisäksi jokaisella projektilla on oma tiedostonsa, ei koko tilin yhteistä tiedostoa.
Memory kerää tietoa sinusta ihmisenä — tyylistäsi, mieltymyksistäsi ja ammatistasi. CLAUDE.md käsittelee tiettyä projektia: tätä repositoriota, näitä komentoja ja näitä koodityön käytäntöjä. Ero on perustavanlaatuinen: Memory kokoaa yhteen sen, ”millainen olen yleisesti”, kun taas CLAUDE.md kertoo, ”miten tämä työ on järjestetty”.
Mistä Claude Code etsii CLAUDE.md-tiedostoa
Neljästä paikasta yhtä aikaa, tärkeysjärjestyksessä vähäisimmästä suurimpaan:
| Taso | Sijainti | Mitä siihen kannattaa kirjoittaa |
|---|---|---|
| Koko organisaatio | /Library/Application Support/ClaudeCode/CLAUDE.md Macissa, /etc/claude-code/CLAUDE.md Linuxissa | Yrityksen säännöt kaikille tiimiprojekteille |
| Käyttäjä | ~/.claude/CLAUDE.md | Henkilökohtaiset säännöt, jotka koskevat kaikkia projektejasi |
| Projekti | ./CLAUDE.md projektin juuressa | Päätiedosto — projektikohtainen ja git-repositorioon commitattu |
| Paikallinen | ./CLAUDE.local.md | Projektimuistiinpanosi, joita ei commitata git-repositorioon |
Kaikki neljä tiedostoa ladataan samaan aikaan ja yhdistetään; ne eivät korvaa toisiaan.
Kaikki löydetyt tiedostot yhdistetään kontekstiin sen sijaan, että ne korvaisivat toisensa. Koko hakemistopuussa sisältö järjestetään tiedostojärjestelmän juuresta työskentelyhakemistoosi.
Järjestys etenee laajasta rajauksesta suppeaan. Project ja Local tulevat viimeisinä — niiden sisältö sijoittuu siis kontekstin loppuun, lähemmäs pyyntöä. Siksi kaikki tärkeät asiat kannattaa pitää projektin CLAUDE.md-tiedostossa.
Mitä siihen yleensä kirjoitetaan
- Projektin teknologiapino — Next.js / Prisma / PostgreSQL / Redis
- Komennot — miten testit suoritetaan, projekti rakennetaan ja julkaistaan
- Arkaluonteiset polut — mitä kansioita ei saa muokata ilman nimenomaista pyyntöä
- Käytännöt — commit-viestien ja tiedostonimien muoto
- Liiketoimintasäännöt — mikä projektissa on tärkeää (esimerkiksi älä koskaan kovakoodaa hintoja)
- Kontekstiviittaukset — ”liiketoimintalogiikka on kansiossa
docs/business/; designjärjestelmä kansiossadocs/design/” (voit valita kansioiden nimet itse; tärkeintä on, ettei kaikkea sullota yhteen tiedostoon)
Katso CLAUDE.md-opas, jossa on valmis malli ja kattava erittely.
Miten CLAUDE.md eroaa Memorysta
| Ominaisuus | Memory (Claude.ai) | CLAUDE.md (Claude Code) |
|---|---|---|
| Tallennuspaikka | Anthropicin pilvi | Repositorion tiedosto |
| Kuka kirjoittaa sen | Claude automaattisesti | Sinä |
| Mihin se liittyy | Tiliisi | Tiettyyn projektiin |
| Missä se toimii | claude.ai + mobiilisovellus | Claude Code päätteessä |
| Sisällön tarkastelu | Settings → Memory | Avaa tiedosto tekstieditorissa |
| Päivitystapa | Memory Synthesis kerran päivässä | Muokkaat sitä käsin |
| Päivityskomento | Pyydä Claudea päivittämään tai poista se Settings-kohdasta | /memory Claude Codessa |
Yhdellä lauseella: Memory on pääsi; CLAUDE.md on projektin ohjeistus toimiston seinällä.
Mikä on Claude Coden Auto Memory, ja mihin se tallennetaan?
Tärkeimmät kohdat
Auto Memory on Claude Coden uusi ominaisuus vuodelta 2026. Agentti kirjoittaa itse projektiasi koskevia muistiinpanoja paikalliseen kansioon ~/.claude/projects/[project-name]/memory/ — mitä komentoja voi käyttää, mitkä repositorion polut ovat arkaluonteisia ja mitä sudenkuoppia agentti on jo kohdannut. Toisin kuin CLAUDE.md-tiedoston, jonka säännöt kirjoitat itse, Auto Memory täyttyy automaattisesti. Sen muistiinpanotiedostot tallennetaan paikallisesti. Valittua tekstiä ladataan mallikontekstiin. Se täydentää CLAUDE.md:tä, ei korvaa sitä.
Miten Auto Memory eroaa CLAUDE.md:stä
CLAUDE.md sisältää ohjeesi. Auto Memory sisältää muistiinpanoja, joita agentti kirjoittaa itselleen. Kyse on erityyppisestä sisällöstä.
Kirjoitat CLAUDE.md-tiedoston itse: ”vastaa aina käyttäjän suosimalla kielellä”, ”julkaise komennolla npm run deploy”, ”älä koske legacy/-kansioon”. Nämä ovat etukäteen asettamiasi sääntöjä.
Auto Memory sisältää Clauden työn edetessä oppimia asioita. Claude suorittaa testin, joka epäonnistuu puuttuvan paketin vuoksi — Claude kirjoittaa muistiin: ”tässä projektissa suorita npm install ennen testejä”. Silloin se ei toista samaa virhettä seuraavassa istunnossa.
Tallennuspaikka
Paikallisesti levylläsi, jokaiselle projektille omassa kansiossaan:
~/.claude/projects/[project-name]/memory/
Päätiedoston nimi on MEMORY.md. Tärkeä yksityiskohta: Claude Code lataa CLAUDE.md-tiedoston kokonaan, mutta MEMORY.md-tiedostolla on raja — siitä ladataan vain ensimmäiset 200 riviä tai 25KB, sen mukaan kumpi tulee ensin. Näin Claude ei huku kuukausien aikana kertyneisiin omiin muistiinpanoihinsa. Muistiinpanot säilyvät paikallisessa hakemistossa projektirepositorion ulkopuolella. Ladattu teksti tulee osaksi määritettyyn mallipalveluun lähetettävää keskustelukontekstia. Paikallinen säilytys ei ole lupaus verkottomasta käsittelystä. Älä laita salaisuuksia näihin tiedostoihin.
Milloin se toimii
Auto Memory toimii Claude Codessa versiosta v2.1.59+ lähtien ja on oletusarvoisesti käytössä uusissa asennuksissa. Tarkista tila ja hallitse toimintoa komennolla:
/memory
Komento avaa editorin kaikille muistikerroksille — sekä CLAUDE.md:lle että MEMORY.md:lle. Näet, mitä Claude on jo kirjannut projektistasi, ja voit muokata tai tyhjentää muistiinpanoja. Voit poistaa Auto Memoryn kokonaan käytöstä asettamalla autoMemoryEnabled: false tiedostossa ~/.claude/settings.json tai käyttämällä ympäristömuuttujaa CLAUDE_CODE_DISABLE_AUTO_MEMORY=1.
Mitä sinne yleensä tallentuu
- Toimineet tai epäonnistuneet komennot
- Agentin selvittämä projektirakenne
- Kohdatut haitalliset käytännöt
- Tärkeiden tiedostojen ja funktioiden nimet
Anthropicin virallinen Claude Code -dokumentaatio kuvaa eron suoraan:
CLAUDE.md-tiedostot: ohjeita, jotka kirjoitat antaaksesi Claude-pysyvää kontekstia. Auto memory: muistiinpanoja, joita Claude kirjoittaa itse korjaustesi ja mieltymystesi perusteella.
Toisin sanoen: CLAUDE.md = kirjoittamasi ohjeet. Auto Memory = muistiinpanot, joita Claude kirjoittaa itselleen korjaustesi ja mieltymystesi pohjalta.
Memory vai CLAUDE.md: kumpi järjestelmä sopii mihinkin tehtävään?
Tärkeimmät kohdat
Jos työskentelet selaimessa claude.ai:ssa, tarvitset Memoryn, jotta Claude muistaa sinut käyttäjänä. Jos työskentelet projektin parissa Claude Codessa, tarvitset CLAUDE.md-tiedoston, jotta Claude muistaa projektin säännöt; Auto Memory toimii taustakerroksena. Nämä järjestelmät eivät kilpaile keskenään — ne ratkaisevat eri ongelmia eri tuotteissa. Memory ei siirry Claude Codeen, eikä CLAUDE.md toimi claude.ai:ssa.
Päätösmatriisi
| Tilanne | Mitä ottaa käyttöön |
|---|---|
| Keskustelen Clauden kanssa selaimessa eri aiheista | Memory |
| Työskentelen yhden projektin parissa Claude Coden kautta päätteessä | CLAUDE.md (perusta) + Auto Memory (taustalla) |
| Minulla on useita projekteja Claude Codessa | CLAUDE.md joka projektissa + Auto Memory |
| Käytän Claudea koodissani API:n kautta | Kumpikaan ei toimi — lisää säännöt manuaalisesti system promptiin |
| Haluan Clauden muistavan kirjoitustyylini | Memory Claude.ai:ssa |
| Haluan Clauden muistavan projektin rakenteen | Projektin CLAUDE.md |
Memory ja CLAUDE.md eivät toista toisiaan. Ne toimivat eri tuotteissa ja tallentavat eri asioita. Ne ovat kuin henkilökohtainen kalenteri ja yrityksen toimintaperiaatteet — molemmat ovat hyödyllisiä, mutta kukaan ei sekoita niitä keskenään.
Milloin Memory kannattaa ottaa käyttöön: 3 tilannetta, joissa siitä on oikeasti hyötyä
Tärkeimmät kohdat
Claude.ai:n Memory on hyödyllinen kolmessa työtilanteessa: puhut usein eri aiheista etkä halua esitellä itseäsi joka kerta; kirjoitat paljon lyhyitä tekstejä samalla tyylillä; tai Clauden on muistettava rooliisi liittyvä konteksti. Jos työskentelet pääasiassa Claude Coden kautta, et tarvitse Memorya, koska se ei toimi siellä.
Tilanne 1. Käytät claude.ai:ta henkilökohtaisena avustajana
Kirjoitat Claudelle joka päivä: muokkaa sähköpostia, analysoi taulukkoa, keksi idea. Aiheet vaihtelevat, mutta sinä pysyt samana. Memory säästää sinut sanomasta: ”Hei, olen markkinoija, pyöritän verkkoprojektia ja pidän tällaisesta vastaustyylistä.”
Viikon käytön jälkeen Claude tuntee ammattisi, vastausmuotosi, suosikkimuotosi, pituuden ja sävyn. Jokainen uusi keskustelu alkaa tämän tiedon pohjalta. Säästät 30–60 sekuntia keskustelua kohden.
Tilanne 2. Kirjoitat paljon sisältöä samalla tyylillä
Mainokset, sosiaalisen median julkaisut, sähköpostiuutiskirjeet — sama brändiääni. Memory oppii tyylisi: mitä sanoja ei pidä käyttää, millainen sävy pitää olla ja kuinka pitkiä kappaleiden tulisi olla.
Kerro kerran parin viikon aikana Claudelle: ”teksteissämme ei käytetä ajatusviivoja, sävy on ystävällinen, enintään 3 kappaletta”. Se tallentuu. Sen jälkeen jokainen uusi teksti noudattaa tyyliäsi ilman muistutuksia.
Tilanne 3. Tarvitset rooliisi liittyvää kontekstia
Olet suunnittelija, jolla on tietty työkalupino — Figma + Sketch, ei Photoshop. Olet SaaS-tuotepäällikkö, et verkkokaupan tuotepäällikkö.
Memory tunnistaa rooliisi liittyvän kontekstin ja mukauttaa vastauksia sen mukaan automaattisesti. Vähemmän yleisluontoisia vastauksia, enemmän juuri sinun työhösi sopivia.
Milloin Memorya ei tarvita
Jos työskentelet pääasiassa Claude Coden kanssa päätteessä, Memorysta ei ole sinulle hyötyä. Se ei yksinkertaisesti toimi siellä. Käytä sen sijaan CLAUDE.md:tä äläkä sekoita näitä kahta.
Jos käytät Claudea koodissasi API:n kautta, se ei toimi sielläkään. Lisää ohjeet manuaalisesti system promptiin.
Jos sinulla on vain yhdenlaisia tehtäviä eikä sinua haittaa toistaa konteksti jokaisen keskustelun alussa, Memory ei ole välttämätön. Se on mukavuusominaisuus, ei vaatimus.
Mitä CLAUDE.md-tiedostoon kannattaa kirjoittaa, ja mitä Auto Memory poimii itse?
Tärkeimmät kohdat
Kirjoita CLAUDE.md-tiedostoon pysyvät säännöt — sellaiset, jotka eivät muutu istunnosta toiseen: teknologiapino, käytännöt, arkaluonteiset polut ja liiketoimintalogiikka. Auto Memory kerää itse muuttuvat yksityiskohdat — mitkä komennot toimivat, missä sudenkuopat ovat ja millainen projektin rakenne on. Sääntö on yksinkertainen: kaikki, minkä pitää aina toimia poikkeuksetta, kuuluu CLAUDE.md-tiedostoon. Kaiken, minkä Claude voi oppia työn edetessä, voi jättää Auto Memoryyn.
Mitä CLAUDE.md-tiedostoon täytyy kirjoittaa
- Projektin kuvaus yhdessä kappaleessa — mikä se on, kenelle se on tarkoitettu ja miksi.
- Projektin teknologiat — käytetyt frameworkit, kirjastot ja tietokannat.
- Komennot — testit, build ja julkaisu. Täsmälliset komennot.
- Arkaluonteiset hakemistot — mitä ei saa muokata ilman nimenomaista pyyntöä.
- Käytännöt — commit-viestien ja tiedostonimien muoto sekä vastauskieli.
- Kontekstiviittaukset — esimerkiksi ”liiketoimintalogiikka on kansiossa
docs/business/; design on kansiossadocs/design/”. Kansioiden nimet saat päättää itse.
Mitä voit jättää Auto Memoryn hoidettavaksi
- Paikallisen ympäristön tiedot — tällä koneella Python on polussa
/usr/local/bin/python3.11. - Projektin muutokset — mikä komento epäonnistui eilen ja miksi.
- Väliaikaiset havainnot — missä tietyn moduulin testit sijaitsevat.
- Työnkulun vinkit — mikä skripti suoritetaan minkäkin vaiheen jälkeen.
Mitä ei pidä laittaa kumpaankaan
- API-avaimet, salasanat ja tokenit — ne kuuluvat
.env-tiedostoon, eivät muistitiedostoihin. - Asiakkaiden henkilötiedot.
- Tiedot, jotka voivat pian vanhentua (hinnat, kohorttien päivämäärät, väliaikaiset kampanjat).
- Kertakäyttöiset promptit — ne tukkivat kontekstin.
200 rivin sääntö
Anthropic suosittelee dokumentaatiossaan pitämään CLAUDE.md:n noin 100–200 rivin pituisena. Yli 200 rivin jälkeen Claude alkaa lukea sitä tehottomammin — pitkä konteksti kuluttaa resursseja ja heikentää tarkkuutta. Kun tiedosto kasvaa, siirrä osioita erillisiin lähellä oleviin .md-tiedostoihin ja jätä CLAUDE.md:hen lyhyet viittaukset: ”katso koodityyli tiedostosta docs/code-style.md”.
Katso Claude Coden Second Brain -opas, jossa tiedostorakenne käydään läpi tarkemmin. Siinä selitetään, miten rakenne kasvaa CLAUDE.md:stä viideksi kontekstikansioksi.
Mitkä 5 virhettä rikkovat Claude-muistin, ja miten vältät ne?
Tärkeimmät kohdat
Tavallisimmat virheet Claude-muistin kanssa vuonna 2026 ovat Memoryn ja CLAUDE.md:n sekoittaminen, tiedostonimien kirjainkoon unohtaminen, liian suuren CLAUDE.md:n säilyttäminen, salaisuuksien tallentaminen siihen sekä odotus, että Auto Memory poimii automaattisesti asiat, jotka ovat vain omassa päässäsi. Kukin virhe rikkoo asetukset omalla tavallaan — ja Claude vaikuttaa ”tyhmältä”, vaikka ongelma on asetuksissa.
Virhe 1. Memoryn ja CLAUDE.md:n sekoittaminen
Yleisin virhe. Joku kuulee, että ”Claude muistaa nyt”, ottaa Memoryn käyttöön claude.ai:ssa, avaa sitten Claude Coden päätteessä ja ihmettelee, miksi agentti on taas ”unohtanut”.
Claude.ai:n Memory ei siirry Claude Codeen. Kyseessä ovat eri tuotteet, joilla on eri arkkitehtuurit. Jos haluat Clauden muistavan projektin päätteessä, kirjoita CLAUDE.md. Jos haluat Clauden muistavan sinut selaimessa, ota Memory käyttöön.
Näin vältät sen. Päätä ennen muistin määrittämistä, missä työskentelet pääasiassa. Jos käytät claude.ai:ta, käytä Memorya. Jos käytät Claude Codea, käytä CLAUDE.md:tä ja Auto Memorya. Jos käytät molempia, määritä molemmat järjestelmät sen sijaan, että yrittäisit yhdistää ne.
Virhe 2. Tiedostonimien kirjainkoon unohtaminen
CLAUDE.md on kirjainkokoriippuvainen tiedostonimi. Agentti lukee isokirjaimisen CLAUDE.md-tiedoston. Tiedostoja claude.md ja Claude.md se ei lue. Sama koskee tiedostoa CLAUDE.local.md. Tämä on tavallinen virhe, kun Claude Code otetaan käyttöön ensimmäistä kertaa: luodaan tiedosto, kirjoitetaan ohjeet ja ihmetellään, miksi se ei toimi — vaikka tiedoston nimi on kirjoitettu pienillä kirjaimilla.
Näin vältät sen. Tarkista kirjainkoko ennen tallentamista. Macissa valitse tiedosto Finderissa ja paina Enter — koko nimi tulee näkyviin. Päätteessä: ls -la CLAUDE*. Jos tuloksena on claude.md, nimeä se uudelleen: mv claude.md CLAUDE.md.
Virhe 3. CLAUDE.md on kasvanut 800 rivin pituiseksi
Saat valmiin mallin, lisäät kaikki tärkeiltä vaikuttavat säännöt ja päädyt 800-riviseen tiedostoon. Claude lukee sitä nyt hitaammin, mutta vastausten laatu heikkenee. Pitkä konteksti vie mallin huomiota.
Näin vältät sen. Pidä CLAUDE.md noin 100–200 rivin pituisena. Siirrä yli 200 rivin jälkeen osioita erillisiin .md-tiedostoihin ja jätä CLAUDE.md:hen viittauksia: ”katso koodityyli tiedostosta docs/code-style.md”. Se on sama periaate kuin kaikessa ihmisille tarkoitetussa dokumentaatiossa — älä sullota kaikkea yhteen tiedostoon.
Virhe 4. Salaisuuksien säilyttäminen CLAUDE.md:ssä tai Auto Memoryssa
API-avaimia, salasanoja ja tokeneita ei saa tallentaa muistitiedostoihin. CLAUDE.md commitoidaan yleensä git-repositorioon, joten salaisuudet voivat vuotaa sinne. Auto Memory tallennetaan paikallisesti, mutta tiedot voivat silti näkyä kuvakaappauksessa tai jaetussa keskustelussa tai vuotaa MCP-palvelimen kautta, jos sillä on levykäyttöoikeus.
Näin vältät sen. Säilytä salaisuudet .env-tiedostossa (ja lisää .env tiedostoon .gitignore). Mainitse CLAUDE.md:ssä vain muuttujien nimet: ”API-avain on muuttujassa STRIPE_KEY; hae se .env-tiedostosta.”
Virhe 5. Odotus, että Auto Memory selvittää liiketoimintalogiikan itsenäisesti
Auto Memory kerää teknisiä havaintoja — komentoja, virheitä ja rakennetta. Se ei opi liiketoimintasääntöjä itsekseen (”kiinteistönvälitystoimisto ei saa ottaa vastaan tietyn rajan alittavia tilauksia”, ”kirjoituksissa ei saa käyttää tiettyjä sanoja”). Ne kuuluvat CLAUDE.md-tiedostoon tai erillisiin .md-tiedostoihin, joihin CLAUDE.md:ssä viitataan.
Näin vältät sen. Pidä asiat erillään: tekniset yksityiskohdat tallentuvat automaattisesti Auto Memoryyn. Liiketoimintasäännöt, tyyli ja käytännöt kirjoitat käsin CLAUDE.md-tiedostoon. Älä odota toisen korvaavan toista.
Miten otat Memoryn ja CLAUDE.md:n käyttöön yhden illan aikana (vaiheittainen opas)?
Tärkeimmät kohdat
Voit ottaa koko järjestelyn käyttöön 30–40 minuutissa: aktivoi Memory Claude.ai:ssa, luo CLAUDE.md projektiisi ja tarkista, että Auto Memory toimii. Sen jälkeen voit täydentää asetuksia käsin: lisää CLAUDE.md:hen jokaisen agentin virheen jälkeen yksi rivi, jossa sanotaan ”älä tee noin”. Kuukauden kuluttua sinulla on elävä ”projektin perustuslaki”.
Ota Memory käyttöön Claude.ai:ssa. Avaa Settings → Capabilities → Memory. Kytke valitsin päälle. Tarkista heti tietosuoja-asetukset — päätä, saako Anthropic käyttää keskustelujasi mallien kouluttamiseen. Päätös on sinun.
Keskustele Clauden kanssa omana itsenäsi. Kerro seuraavissa 2–3 keskustelussa, kuka olet, mitä teet ja millaisesta vastaustyylistä pidät. Memory Synthesis tallentaa nämä tiedot vuorokauden kuluessa.
Tarkista seuraavana päivänä, mitä tallentui. Kirjoita missä tahansa keskustelussa: ”Mitä muistat minusta?” Claude luettelee muistamansa asiat. Jos jokin ei miellytä, poista se kohdasta Settings → Memory tai pyydä Claudea unohtamaan se.
Luo CLAUDE.md projektiisi. Luo pääprojektisi juureen tiedosto nimeltä
CLAUDE.md(isoilla kirjaimilla). Hae valmis malli CLAUDE.md-oppaasta — siinä on 6 osiota ja Anthropic suosittelee noin 200 rivin pituutta.Täytä projektia koskevat osiot. Kuvaile teknologiapino, komennot, arkaluonteiset polut ja käytännöt. Enintään 200 riviä — sitä pidemmän tiedoston Claude lukee tehottomammin.
Tarkista Auto Memory. Anna Claude Codessa komento
/memory. Kaikkien kerrosten editori avautuu. Auto Memory on yksi niistä. Lue, mitä Claude jo tietää projektistasi.Commitoi CLAUDE.md git-repositorioon. Se on osa projektia. Jos työskentelet tiimissä, kaikki näkevät säännöt.
Jatka tavalliseen tapaan. Lisää CLAUDE.md:hen jokaisen agentin virheen jälkeen yksi rivi, jossa sanotaan ”älä tee noin”. Kuukauden kuluttua sinulla on elävä sääntökokoelma, eikä Claude enää lankea tuttuihin ansoihin.
Mikä ei toimi: 3 asiaa, joita Claude-muisti ei säilytä
Tärkeimmät kohdat
Mikään Clauden kolmesta muistijärjestelmästä ei säilytä aktiivista istuntoasi, kun vaihdat mallia, sellaisten tiedostojen kontekstia, joita et ole erikseen näyttänyt agentille, eikä yksityisiä komentoja, jotka annat puheella tai puhelimen kautta. Nämä ovat arkkitehtuurin rajoituksia, eivät virheitä. Ne kannattaa tietää, jotta et pety.
Istunnon tila ei säily mallia vaihdettaessa
Työskentelet Claude Codessa Opus 4.8:lla ja vaihdat sitten Sonnet 4.6:een — istunnon konteksti voi nollautua, koska malleilla on eri konteksti-ikkunat. CLAUDE.md ja Auto Memory latautuvat automaattisesti uuteen istuntoon, mutta aktiivinen keskustelu ei siirry mukana.
Tiedostoja, joita et ole näyttänyt, ei ladata
Claude näkee vain CLAUDE.md-tiedostossa olevan sisällön, Auto Memoryn sisällön ja sen, mitä olet erikseen avannut nykyisessä istunnossa. Jos projektissasi on 500 tiedostoa ja kirjoitat ”katso, miten käsittelen maksuja”, agentti ei tiedä, mitä tiedostoa pitäisi tarkastella. Sinun on annettava polku erikseen tai lisättävä viittaus CLAUDE.md-tiedostoon.
Memory ei toimi yksittäisissä API-keskusteluissa
Jokainen Claude API:in lähetettävä pyyntö on erillinen. Mitään muistia ei ladata. Jos rakennat chatbotin API:n kautta, välität system promptin ja viestihistorian itse. Memory, CLAUDE.md ja Auto Memory eivät auta tässä.
Mitä seuraavaksi: muisti Second Brainin lähtökohtana
Tärkeimmät kohdat
Claude-muisti on ensimmäinen askel kohti projektiin liittyvää Second Brainia. CLAUDE.md asettaa säännöt, Auto Memory kerää tekniset muutokset, mutta todellinen hyöty syntyy, kun lisäät niiden rinnalle liiketoimintakontekstia sisältäviä kansioita — kohderyhmä, talous ja tuote. Silloin Claude alkaa kirjoittaa juuri sinun tehtävääsi sopivia ”laadukkaita ratkaisuja yleisesti”.
CLAUDE.md ja Auto Memory auttavat Claudea muistamaan, miten koodi on järjestetty. Se riittää teknisiin tehtäviin: refaktorointiin, virheiden korjaamiseen, migraatioihin ja testeihin.
Mutta heti kun sinun on tehtävä liiketoimintapäätöksiä — kenelle lähetät sähköpostia, miten muotoilet tarjouksen tai minkä hinnan asetat — tekninen muisti ei riitä. Tarvitset kontekstia: keitä asiakkaasi ovat, miten he tekevät päätöksiä ja miten liiketoimintasi talous toimii.
Se on Second Brain — projektin rinnalla oleva liiketoimintatiedon kansio, johon Claude pääsee CLAUDE.md:n viittausten kautta. Koodin muisti ja liiketoiminnan muisti — silloin agentti lakkaa olemasta ”älykäs avustaja, joka hallusinoi” ja muuttuu kanssakirjoittajaksesi.
Lähteet
- Claude Code Docs - Memory - CLAUDE.md:n ja Auto Memoryn virallinen dokumentaatio
- Anthropic - Bringing memory to Claude - Claude.ai:n Memory-ominaisuuden julkistus (syyskuu 2025)
- Anthropic Support - Memory and Chat Search - Memoryn käyttö Claude.ai:ssa
- Claude Code Docs - Settings - Claude Coden asetukset (autoMemoryEnabled ja muut)
- Claude Code on GitHub - lähdekoodi ja muutosloki
Tutustu Ailootiin lisää osoitteessa ailoot.ai.
Lisätietoja
Kysymyksiä tästä oppaasta: Claude Memory: Memory, CLAUDE.md ja Auto Memory
Miksi Memoryn käyttöönotto Claude.ai:ssa ei palauta pääteprojektini kontekstia?
Claude.ai Memory ja Claude Coden projektitiedostot ovat erillisiä järjestelmiä. Anna Claude Codessa projektiohjeet CLAUDE.md-tiedostolla ja tarkista erilliset Auto Memory -muistiinpanot komennolla /memory.
Onko Auto Memory turvallinen API-avaimille, koska tiedostot ovat paikallisia?
Ei. Ladatuista muistiinpanoista tulee mallikontekstia, ja levylle pääsevät työkalut voivat myös lukea niitä. Pidä avaimet ja salasanat sekä Auto Memoryn että CLAUDE.md:n ulkopuolella. Tallenna salaisuudet erikseen ja dokumentoi vain muuttujien nimet.