Claude Code luo .claude-kansion jokaiseen projektiin jossa sitä käytetään. Useimmat käyttäjät tietävät sen olemassaolosta, mutta eivät koskaan avaa sitä. Se on virhe.
Kansio on Claude Coden ohjauskeskus. Se määrittää miten Claude käyttäytyy projektissasi, mitä komentoja se saa ajaa, millaisia työnkulkuja se osaa ja mitä se muistaa istuntojen välillä. Kun ymmärrät mitä kansio sisältää, voit konfiguroida Claude Coden toimimaan täsmälleen niin kuin tarvitset.
Tämä opas käy läpi jokaisen osan: tiedostot joita käytät päivittäin ja ne jotka asetat kerran ja unohdat. Jos Claude Code on sinulle uusi, kannattaa ensin lukea Claude Code -perusopas.
Kaksi kansiota, ei yksi
Ennen kuin sukellamme rakenteeseen, yksi tärkeä asia: .claude-kansioita on kaksi.
Ensimmäinen sijaitsee projektisi juuressa. Se sisältää tiimille jaetut asetukset ja commitoidaan versionhallintaan. Jokainen tiimin jäsen saa samat säännöt, samat komennot ja samat oikeuskäytännöt.
Toinen sijaitsee kotihakemistossasi (~/.claude/). Se sisältää henkilökohtaiset asetukset, istuntohistorian ja automaattisen muistin. Näitä ei jaeta kenellekään.
Tässä on kokonaiskuva molemmista:
projekti/
├── CLAUDE.md # Tiimin ohjeet (commitoidaan)
├── CLAUDE.local.md # Omat ohitukset (gitignored)
│
└── .claude/
├── settings.json # Oikeudet ja konfiguraatio
├── settings.local.json # Omat oikeusohitukset (gitignored)
├── commands/ # Omat slash-komennot
├── rules/ # Modulaariset sääntötiedostot
├── skills/ # Taitopaketit (automaattinen aktivointi)
├── agents/ # Erikoistuneet aliagentit
└── hooks/ # Tapahtumapohjaisia skriptejä
~/.claude/
├── CLAUDE.md # Globaalit ohjeet (kaikki projektit)
├── settings.json # Globaalit asetukset
├── commands/ # Omat komennot (kaikki projektit)
├── skills/ # Omat skillit (kaikki projektit)
├── agents/ # Omat agentit (kaikki projektit)
└── projects/ # Istuntohistoria + automuisti
Käytän tässä oppaassa esimerkkejä omasta AI-Sanomat-projektistani, jossa .claude-kansio sisältää 19 agenttia, yli 12 skilliä, yli 25 custom commandia ja 3 hooksia. Se on yksi intensiivisimmistä .claude-konfiguraatioista joita olen nähnyt, ja toimii hyvänä esimerkkinä siitä mitä kaikkea on mahdollista.
CLAUDE.md: projektin tärkein tiedosto
Kun käynnistät Claude Code -istunnon, ensimmäinen asia jonka Claude lukee on CLAUDE.md. Se ladataan suoraan järjestelmäkehotteeseen ja Claude pitää sen mielessä koko keskustelun ajan.
Yksinkertaisesti: mitä kirjoitat CLAUDE.md:hen, Claude noudattaa.
Jos kerrot Claudelle "kirjoita aina testit ennen toteutusta", se tekee niin. Jos sanot "älä koskaan käytä console.logia virheenkäsittelyyn, käytä aina custom logger -moduulia", se kunnioittaa sitä joka kerta.
Kolme tasoa
CLAUDE.md-tiedostoja voi olla useita ja ne muodostavat hierarkian:
Globaali (
~/.claude/CLAUDE.md): Henkilökohtaiset periaatteet jotka pätevät kaikissa projekteissaProjektikohtainen (
./CLAUDE.md): Projektin säännöt ja kontekstiAlikansiokohtainen (
./src/api/CLAUDE.md): Tietyn kansion erityissäännöt
Claude lukee kaikki tasot ja yhdistää ne. Projektikohtainen tiedosto on se jonka kirjoitat ensimmäisenä.
Mitä sinne kirjoitetaan
Useimmat kirjoittavat joko liikaa tai liian vähän. Tässä on toimiva ohje.
Tilaa AI-Sanomien Plus-jäsenyys niin näet loput sisällöstä
Tilaamalla AI-Sanomien maksullisen jäsenyyden saat pääsyn kaikkiin uutiskirjeen sisältöihin sekä tuet Suomen parasta AI-mediaa.
Tilaa jäsenyys tästä! Voit lopettaa koska tahansa.Miksi tilaus kannattaa?:
- Pääsy kaikkiin maksullisiin oppaisiin
- Webinaari-tallenteet
- Näet kaikki uutiskirjeen sisällöt, uudet AI-työkalut sekä vinkit tekoälyn käyttöön.
- GPT4o-botti: Tämä on tietoturvallinen versio ChatGPT:stä, jossa syöttämääsi dataa ei käytetä kielimallin kouluttamiseen.
- Tuet Suomen parasta AI-mediaa 😊
