CLAUDE.md Pinakamahusay na Gawain: Configure Claude Code Para sa Anumang Proyekto
Ang CLAUDE.md ay ang nag - iisang pinakamaimpluwensiyang kaayusan para sa Claude Code. Ang isang mahusay ang pagkakasulat ay gumagawa sa generic AI na tulong upang maging project-specific master.
Ang CLAUDE.md ay isang talaksang markdown sa ugat ng iyong proyekto. Claude Code sa pasimula ng bawat sesyon bago ka mag - type. ISANG mabuting CLAUDE. Binabago ng md ang generic AI upang maging isang kasangkapan na nakauunawa sa iyong mga kombensiyon, salansan ng teknolohiya, at mga pulang linya.
Ano ang dapat mong isama sa CLAUDE.md?
Magpokus sa impormasyon na kakailanganin ng isang matalinong developer na sumali sa inyong team sa isang araw. Panatilihin itong praktikal: salansan ng teknolohiya, utos, kombensiyon, at mga bagay na dapat iwasan.
Minimal CLAUDE.md template
# 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 firstAno ang pinakakaraniwang CLAUDE. mga pagkakamaling md?
| Pagkakamali | Kung Bakit ito masakit | Sapat |
|---|---|---|
| Napakahaba (500+ linya) | Mga bintana ng konteksto sa bawat sesyon | Manatili sa ilalim ng 200 linya, mag - ugnay sa mga doc para sa mga detalye |
| Napakalabo ("sulat ng malinis na kodigo") | Hindi nagbibigay ng praktikal na patnubay | Maging espesipiko: "Use server mga bahagi sa pamamagitan ng default" |
| Nawawalang mga utos | Inihuhula ni Claude kung paano tatakbo/test/build | Itala ang bawat kaugnay na snpm script |
| Walang pagbabawal | Maaaring baguhin ni Claude ang sensitibong mga file | Magdagdag ng malinaw na bahaging "Huwag" |
| Talaan ng mga Nilalaman | Ang CLAUDE ay para sa mga tao | Magtuon ng pansin sa mga kombensiyon at mga tuntunin, hindi sa paglalarawan sa proyekto |
Paano mo ginagawa ang CLAUDE.m para sa malalaking proyekto?
Para sa malalaking codebases, gamitin ang @import coordination upang hatiin ang pagsasaayos sa mga direktoryo. Ang Claude Code ay sumusunod sa mga pag-angkat at gumagawa ng kumpletong larawan.
# 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.mdAng bawat sub-CLAUD.md ay naglalaman ng mga tuntuning espesipiko sa paketeng iyon. Pinananatili nitong maikli ang root file habang binibigyan si Claude Code ng malalim na konteksto tungkol sa bawat saklaw ng codebase.
Paano mo kusang nililikha ang CLAUDE.md?
Ang Claude Code ay maaaring lumikha ng isang pasimulang CLAUDE. md sa pamamagitan ng pagsusuri sa iyong proyekto:
# Auto-generate CLAUDE.md
claude /init
# This creates a CLAUDE.md based on:
# - package.json scripts
# - Project structure
# - Existing config files
# - Git history patternsKumusta naman ang CLAUDE.md memory hierarkia?
Ganito ang mababasang CLAUDE.md files mula sa iba't ibang lokasyon:
- +Project root CLAUDE.md (Ibinabahagi ito ng bawat isa sa pangkat)
- +Subdirectory CLAUDE.md files (via @import)
- +~/.claude/CLAUDE.md (iyong personal na kagustuhang global)
- +Auto Memories (MEMORY.md, pinangangasiwaan ng /memory command)
Ang mga Project-level setting ay dumadaig sa mga personal na setting. Ito'y nangangahulugan na ang mga kombensiyon ng pangkat ay laging nananaig sa indibiduwal na mga kagustuhan.