Skip to content
חזרה לבלוג
Tips·Code Velocity Academy

תגית:md הפרקטיקה הטובה ביותר: קוד קלוד לכל פרויקט

CLAUDE.md היא התצורה היחידה המשפיעה ביותר עבור קוד קלוד. אחד כתוב היטב הופך סיוע בינה מלאכותית גנרית למומחיות ספציפית לפרויקט.

CLAUDE.md הוא קובץ סימון בבסיס הפרויקט שלך. קלוד קוד קורא אותו בתחילת כל פגישה לפני שאתה מקליד משהו. CLAUDE.md טוב הופך בינה מלאכותית גנרית לכלי שמבין את המוסכמות של הפרויקט, ערימת הטכנולוגיה והקווים האדומים של הפרויקט שלך.

מה עליך לכלול ב-CLAUDE.md?

להתמקד במידע כי מפתח חכם להצטרף לצוות שלך יהיה צורך ביום אחד. שמור על זה מעשי: ערימה טכנולוגית, פקודות, מוסכמות, דברים להימנע.

תבנית Minimal CLAUDE.md

markdown
# 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

מה הם הנפוצים ביותר. טעויות?

טעותלמה זה כואבלתקן
יותר מדי זמן (500+ שורות)החלון של פסולת בכל פגישהשמור מתחת ל-200 שורות, קישור לפרטים
מעורפל מדי ("קוד נקי")לא נותנים הדרכה מעשיתלהיות ספציפי: "רכיבי שרת באמצעות ברירת מחדל"
פקודות חסרותקלוד מניח איך לרוץ / להעיד /כל תסריט NPM רלוונטי
אין הגבלותקלוד עשוי לשנות קבצים רגישיםהוספת סעיף "אל תעשה"
עקבו אחרי ReadMEMEReadME מיועד לבני אדם, CLAUDE.md הוא עבור AIלהתמקד במוסכמות ובכללים, לא בתיאור הפרויקט

איך בונים את CLAUDE עבור פרויקטים גדולים?

עבור בסיסי קוד גדולים, השתמש בסנמס @import כדי לפצל תצורה על פני ספריות. קוד קלוד עוקב אחר יבוא ונבנה תמונה שלמה.

markdown
# 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

כל תת-CLE.md מכיל כללים ספציפיים לחבילה זו. זה שומר את קובץ השורש קצר תוך מתן קודקוד עמוק בהקשר של כל אזור של בסיס הקוד.

איך מייצרים את CLAUDE.md באופן אוטומטי?

קוד קלוד יכול ליצור החל CLAUDE. על ידי ניתוח הפרויקט שלך:

bash
# 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 (כולם בקבוצה חולקים את זה)
  • +קבצי CUDE.md (באמצעות @import)
  • +/ ./CLE AUDAMD (העדפות גלובליות אישיות)
  • +זיכרון אוטומטי (MEMORY.md, המנוהל על ידי פקודה /זיכרון)

הגדרות ברמת הפרויקט גוברות על האישיות. משמעות הדבר היא שמוסכמות קבוצתיות תמיד מנצחות על העדפות אישיות.

שאלות נפוצות

Related resources

Glossary
Tools

Related posts

I Replaced My Entire Debug Workflow With One Command
Workflow · Apr 5, 2026
מהו קידוד סוכן? המעבר מצ'אט ל-AI אוטונומי
Concept · Mar 1, 2026
The Hidden Cost of Manual Code Reviews (And How to Cut It by 67%)
Career · Apr 3, 2026

מוכן להפסיק לקודד לאט?

37 שיעורים. פרויקטים אמיתיים. מההתקנה הראשונה ועד שליחת פיצ'רים עם Claude Code. מודול 1 חינם.

התחל חינם - מודול 1
חזרה לבלוגהתחל חינם - מודול 1