CLAUDE.md Bästa metoder: Konfigurera Claude Code för alla projekt
CLAUDE.md är den enskilt mest effektfulla konfigurationen för Claude Code. En välskriven förvandlar generisk AI-assistans till projektspecifik expertis.
CLAUDE.md är en markdown-fil i roten av ditt projekt. Claude Code läser den i början av varje session innan du skriver något. En bra CLAUDE.md förvandlar generisk AI till ett verktyg som förstår ditt projekts konventioner, tekniska stack och röda linjer.
Vad ska du inkludera i CLAUDE.md?
Focus on information that a smart developer joining your team would need on day one. Keep it practical: tech stack, commands, conventions, and things to avoid.
Minimal CLAUDE.md-mall
# Project Context
Next.js 14 app with TypeScript, Tailwind CSS, and Prisma.
Database: PostgreSQL. Auth: NextAuth.js.
## Commands
- `npm run dev` — start dev server (port 3000)
- `npm run test` — run Jest tests
- `npm run lint` — run ESLint
- `npm run db:migrate` — run Prisma migrations
## Architecture
- Server components by default, client components in /components/client/
- API routes in /app/api/ with Zod validation
- Database queries in /lib/db/ (never in components)
## Conventions
- TypeScript strict mode, never use `any`
- Tailwind for styling, no CSS modules
- Conventional commits: feat:, fix:, chore:
## Do NOT
- Modify files in /legacy/ or /vendor/
- Change auth configuration without explicit approval
- Add new dependencies without asking firstVilka är de vanligaste CLAUDE.md-felen?
| Misstag | Varför det gör ont | Fixera |
|---|---|---|
| För lång (500+ rader) | Slösar bort sammanhangsfönstret på varje session | Håll under 200 rader, länk till dokument för detaljer |
| För vagt ("skriv ren kod") | Ger ingen handlingsbar vägledning | Var specifik: "Använd serverkomponenter som standard" |
| Saknade kommandon | Claude guesses how to run/test/build | Lista alla relevanta npm-skript |
| Inga begränsningar | Claude kan ändra känsliga filer | Lägg till ett tydligt avsnitt "GÖR INTE". |
| Duplikat av README | README är för människor, CLAUDE.md är för AI | Fokusera på konventioner och regler, inte projektbeskrivning |
Hur strukturerar du CLAUDE.md för stora projekt?
För stora kodbaser, använd @import-syntaxen för att dela upp konfigurationen mellan kataloger. Claude Code följer importen och bygger en helhetsbild.
# Root CLAUDE.md
## Global conventions
- TypeScript strict, no `any`
- All API routes validate input with Zod
@import packages/api/CLAUDE.md
@import packages/web/CLAUDE.md
@import packages/shared/CLAUDE.mdEach sub-CLAUDE.md contains rules specific to that package. This keeps the root file short while giving Claude Code deep context about each area of the codebase.
Hur genererar du CLAUDE.md automatiskt?
Claude Code kan generera en start CLAUDE.md genom att analysera ditt projekt:
# Auto-generate CLAUDE.md
claude /init
# This creates a CLAUDE.md based on:
# - package.json scripts
# - Project structure
# - Existing config files
# - Git history patternsHur är det med CLAUDE.mds minneshierarki?
Claude Code läser CLAUDE.md-filer från flera platser, i prioritetsordning:
- +Projektrot CLAUDE.md (alla i teamet delar detta)
- +Underkatalog CLAUDE.md-filer (via @import)
- +~/.claude/CLAUDE.md (your personal global preferences)
- +Auto Memory (MEMORY.md, managed by /memory command)
Inställningar på projektnivå åsidosätter personliga. Detta innebär att lagkonventioner alltid vinner över individuella preferenser.