КЛАУДЕ.мд Кращі практики: Налаштування коду для будь-якого проекту
CLAUDE.md є єдиною найбільш ефективною конфігурацією для Claude Code. А також записується на одну з основних напрямів AI.
CLAUDE.md - розмітка файлу в корені вашого проекту. Код Claude читати його на початку кожного сеансу перед тим, як ви набираєте нічого. Хороший CLAUDE. md трансформує загальний AI в інструмент, який розуміє конвенції вашого проекту, тек-стека та червоні лінії.
Що потрібно включити в CLAUDE.md?
Зосередьтеся про інформацію, яка приєднується до вашої команди, буде потрібно на день. Зберігайте це практичне: tech стека, команди, конвенції та речі, щоб уникнути.
Мінімал CLAUDE.md шаблон
# 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 firstЯкі найбільш поширені КЛАУДЕ. md помилки?
| Проживання | Чому болить | Фіксація |
|---|---|---|
| Довгий (500+ ліній) | Відходи контекстного вікна на кожній сесії | Зберігати під 200 рядків, посилання на docs для деталей |
| Too vague ("Невірний чистий код") | Подарує не дієві вказівки | Будь-ласка: "Використовувати компоненти сервера за замовчуванням" |
| Місячні команди | Клод здогадує, як запустити / протестувати / побудувати | Список кожного відповідного скрипта npm |
| Немає обмежень | Claude може змінювати конфіденційні файли | Додати чіткий розділ "НЕ" |
| Дублікат РЕАДМЕ | КЛАУДЕМ - для людини | Фокус на конвенції та правила, не опис проекту |
Як побудувати CLAUDE.md для великих проектів?
Для великих баз коду використовуйте синтаксис @import для розщеплення конфігурації по каталогам. Claude Code: імпорт і збірка повного зображення.
# 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.mdКожен суб-CLAUDE.md містить правила, специфічні для цього пакету. Цей файл зберігає короткий час при наданні Claude Code глибокого контексту про кожну область бази коду.
Як ви генеруєте CLAUDE.md автоматично?
Claude Code може генерувати початок CLAUDE. md шляхом аналізу вашого проекту:
# Auto-generate CLAUDE.md
claude /init
# This creates a CLAUDE.md based on:
# - package.json scripts
# - Project structure
# - Existing config files
# - Git history patternsЩо про Ієрархію пам'яті CLAUDE.md?
Claude Code читає файли CLAUDE.md з декількох локацій, з метою пріоритету:
- +Корінь проекту CLAUDE.md (все це стосується команд)
- +Subdirectory CLAUDE.md файли (через @import)
- +~/.claude/CLAUDE.md (сучасні світові переваги)
- +Авто пам'яті (MEMORY.md, керований командою /memory)
Настроювання проекту наділені особистими. Командні конвенції завжди перемагаються за індивідуальними вподобаннями.