Claude Code ei ole vain yksittäisen kehittäjän työkalu - se skaalautuu koko tiimin käyttöön. Jaetut CLAUDE.md-tiedostot, MCP-konfiguraatiot ja Git-hookit varmistavat yhtenäiset käytännöt. Tässä oppaassa käymme läpi parhaat käytännöt tiimikäyttöön.
Tärkein askel tiimikäytössä on yhteisen CLAUDE.md-tiedoston luominen ja ylläpitäminen.
Mitä tiimin CLAUDE.md:ssä pitäisi olla:
1. Projektin konteksti - Mitä sovellus tekee, miksi se on olemassa 2. Arkkitehtuuri - Miten järjestelmä on rakennettu 3. Konventiot - Nimeämiskäytännöt, tiedostorakenne, koodityyli 4. Prosessit - Branch-strategia, PR-käytännöt, testausvaatimukset 5. Turvallisuus - Mitä ei saa koskaan tehdä (env-muuttujat, salaisuudet)
Ylläpito: - Lisää CLAUDE.md versionhallintaan - Katselmoi muutokset PR:ssä - Päivitä kun käytännöt muuttuvat - Nimeä vastuuhenkilö
# MyApp - Claude Code Instructions
## Projekti
SaaS-sovellus pienyritystcn laskutukseen. 15k MAU. Tuotannossa.
## Stack
- Next.js 15 App Router, TypeScript, Tailwind CSS v4
- PostgreSQL + Drizzle ORM
- Auth: NextAuth.js v5
- Maksaminen: Stripe
- Hosting: Vercel + Supabase
## Tärkeät komennot
- npm run dev - kehityspalvelin (port 3000)
- npm test - Vitest testit
- npm run lint - ESLint + Prettier
- npm run db:push - tietokantamigraatiot
## Konventiot
- Server Components oletuksena
- Named exports kaikissa tiedostoissa
- Error boundary jokaiselle sivulle
- Suomeksi kommentit, englanniksi koodi
## PR-vaatimukset
- Testit uusille funktioille
- Ei TypeScript-virheitä (tsc --noEmit)
- Lint läpäisee
- PR-kuvaus selittää miksi muutos tehdään
## Turvallisuus
- ÄLÄ KOSKAAN commitoi .env-tiedostoja
- ÄLÄ logita käyttäjien henkilötietoja
- Validoi kaikki user input ZodillaClaude Code -komennot voi integroida Git-hookkeihin, jolloin tietyt tehtävät suoritetaan automaattisesti:
Pre-commit hook: Tarkista koodin laatu ennen commitia.
Commit-msg hook: Paranna commit-viestejä automaattisesti.
Pre-push hook: Aja testit ennen pushia.
Huomio: Hookit hidastavat työnkulkua ja maksavat API-käyttöä. Käytä harkiten.
# Esimerkki: Pre-commit hook
# .git/hooks/pre-commit
#!/bin/bash
# Tarkista staged-tiedostot Claude Codella
STAGED_FILES=$(git diff --cached --name-only --diff-filter=ACM)
if [ -n "$STAGED_FILES" ]; then
claude --print "Tarkista nämä muutokset nopeasti.
Raportoi vain kriittiset ongelmat:
- Turvallisuusongelmat
- Selkeät bugit
- .env tai salaisuudet koodissa
Tiedostot: $STAGED_FILES"
fi
# Esimerkki: Commit-msg hook
# .git/hooks/commit-msg
#!/bin/bash
# Paranna commit-viesti
MSG_FILE=$1
MSG=$(cat "$MSG_FILE")
claude --print "Paranna tämä commit-viesti conventional commits -muotoon: $MSG" > "$MSG_FILE"Claude Code on erinomainen onboarding-työkalu. Uusi tiimiläinen voi tutustua projektiin Clauden avulla:
Ensimmäinen päivä: 1. Asenna Claude Code 2. Claude selittää projektin rakenteen 3. Claude opastaa kehitysympäristön pystyttämisessä 4. Claude auttaa ensimmäisen tehtävän kanssa
Tyypillisiä onboarding-prompteja:
# Projektin ymmärtäminen:
> selitä tämän projektin rakenne ja arkkitehtuuri
> mitä teknologioita tämä käyttää ja miksi?
> miten autentikaatio on toteutettu?
# Kehitysympäristön pystytys:
> auta pystyttämään kehitysympäristö tähän projektiin
# Claude lukee README:n, .env.example:n ja auttaa
# Ensimmäinen tehtävä:
> auta minua ymmärtämään issue #42 ja aloita toteutus
# Claude lukee issuen, etsii relevantin koodin ja opastaa
# Koodipohjan navigointi:
> missä käyttäjän profiilitiedot haetaan?
> miten maksuprosessi toimii end-to-end?
> näytä miten testit on organisoituClaude Code voi toimia osana CI/CD-putkea automatisoiden toistuvia tehtäviä:
Käyttötapauksia: - Automaattinen PR-katselmointi - Hajonuneiden testien korjausehdotukset - Dokumentaation päivitys muutosten perusteella - Koodin laadun tarkistus
One-shot-komennot ovat avain: CI-putkessa käytetään one-shot-komentoja, koska interaktiivinen sessio ei ole mahdollinen.
# GitHub Actions esimerkki:
# .github/workflows/claude-review.yml
name: Claude Code Review
on:
pull_request:
types: [opened, synchronize]
jobs:
review:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: '20'
- run: npm install -g @anthropic-ai/claude-code
- run: |
claude --print "Tee lyhyt koodikatselmointi tämän PR:n muutoksista.
Keskity: turvallisuus, suorituskyky, ylläpidettävyys.
Raportoi vain oikeat ongelmat."
env:
ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}Yhteenveto parhaista käytännöistä kun tiimi käyttää Claude Codea:
1. Yhteinen konfiguraatio: - Jaettu CLAUDE.md versionhallinnassa - Jaetut MCP-palvelinkonfiguraatiot (.claude/mcp.json) - Yhtenäiset työnkulut ja konventiot
2. Turvallisuus: - API-avaimet ympäristömuuttujissa, ei koodissa - .cursorignore/.gitignore kunnossa - Ei salaisuuksia CLAUDE.md:ssä - Katselmoi AI:n tekemät muutokset aina
3. Kustannusten hallinta: - Seuraa /cost-komennolla - Aseta budjettirajoituksia API-avaimille - Käytä /compact pitkissä sessioissa - One-shot-komennot ovat edullisempia kuin pitkät sessiot
4. Laadunvarmistus: - AI:n tuotosta katselmoidaan kuten ihmisen koodia - Testit ajetaan aina ennen mergeä - Claude Coden ehdotuksia ei hyväksytä sokeasti - Diffin tarkistus ennen jokaista commitia
Käytä Anthropic API -konsolin budjettirajoituksia. Seuraa käyttöä /cost-komennolla. Suosi one-shot-komentoja pitkien sessioiden sijaan ja käytä /compact tiivistämään kontekstia.
Ei suositella. Jokaisella tiimin jäsenellä tulisi olla oma API-avain tai Claude Pro -tilaus. Näin voit seurata käyttöä yksilötasolla ja hallita oikeuksia.
Lisää .env, .env.local ja muut arkaluontoiset tiedostot .gitignore-tiedostoon. Mainitse CLAUDE.md:ssä ettei salaisuuksia saa logittaa tai sisällyttää vastauksiin. Käytä ympäristömuuttujia aina.
Opas MCP-palvelinten (Model Context Protocol) käyttöön - laajenna Claude Codea uusilla työkaluilla.
Opas Git-operaatioihin ja GitHub-työnkulkuihin Claude Coden avulla.
Opas CLAUDE.md-projektiohjeiden luomiseen - konfiguroi Claude Code projektillesi.
Löydä lisää vinkkejä ja oppaita Claude Coden tehokäyttöön.
Kaikki Claude Code -oppaat