מבית אנתרופיק ישראל
01 / 12
פיתוח · מודול 52

CLAUDE.md -
הזיכרון של הפרויקט.

קובץ קטן אחד שהופך את קלוד מ“אורח שמנחש” ל“חבר צוות שמכיר את הקוד”. מה זה, ולמה זה משנה את כל השיחה.

12 שקופיות  ·  Claude Code  ·  ~7 דקות
הבעיה

כל שיחה מתחילה מאפס.

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

אז אתם מסבירים את אותם דברים שוב ושוב - או מקבלים קוד שלא מתאים לפרויקט.

הפתרון

קובץ אחד בשורש הפרויקט.

my-project/ ├── CLAUDE.md ← כאן ├── package.json ├── src/ └── ...

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

המודל המנטלי

לא פרומפט.
דף קליטה.

פרומפט הוא בקשה חד-פעמית. CLAUDE.md הוא משהו אחר: דף ההדרכה שעובד חדש מקבל ביום הראשון - “ככה אנחנו עובדים פה”.

כתבתם אותו פעם אחת, והוא מלווה כל שיחה עתידית בפרויקט הזה.

מה נכנס פנימה

ההקשר שצריך לדעת.

  • Stack. אילו טכנולוגיות, גרסאות, ספריות מרכזיות.
  • פקודות. איך מריצים, בונים, בודקים - הפקודה המדויקת.
  • קונבנציות. סגנון קוד, מבנה תיקיות, דפוסים מקובלים.
  • מה לא לעשות. אזורים רגישים, מה אסור לשנות, מלכודות.

לא תיעוד מלא - רק מה שקלוד צריך כדי לא לטעות.

ההבדל בפועל

אותה בקשה, שתי תוצאות.

בלי CLAUDE.md
"תוסיף בדיקה לפונקציה formatPrice" → קלוד מנחש framework בדיקות, ממציא פקודת הרצה, כותב בסגנון שלא תואם לפרויקט.
עם CLAUDE.md
"תוסיף בדיקה לפונקציה formatPrice" → יודע שזה Vitest, מריץ pnpm test, כותב בדיוק בסגנון הבדיקות הקיימות.
איפה הוא חי

שלוש רמות, נטענות יחד.

  • שורש הפרויקט. CLAUDE.md - ההקשר של הפרויקט הספציפי. הנפוץ ביותר.
  • גלובלי. ~/.claude/CLAUDE.md - העדפות אישיות שחלות על כל הפרויקטים.
  • תת-תיקייה. CLAUDE.md בתוך תיקייה פנימית - הקשר ממוקד לאותו חלק בקוד.

קלוד מצרף את כולם. הספציפי גובר על הכללי.

מי כותב אותו

לא חייבים מאפס.

/init

הפקודה /init ב-Claude Code סורקת את הפרויקט ומייצרת טיוטת CLAUDE.md אוטומטית - stack, פקודות, מבנה. משם אתם עורכים ומדייקים.

מתי זה משתלם

ככל שחוזרים,
משתלם יותר.

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

כתיבה של חמש דקות שמחזירה את עצמה כבר בשיחה השנייה.

לפני שמתלהבים

זה לא קסם.

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

קצר, מדויק, ומתוחזק - עדיף על ארוך ונשכח.

שלוש אי-הבנות נפוצות

מה CLAUDE.md איננו.

  • לא README. README הוא לבני אדם. CLAUDE.md הוא לקלוד - הוראות תפעוליות, לא הסברים.
  • לא תיעוד מלא. לא צריך לתאר כל קובץ. רק מה שמשפיע על איך לעבוד.
  • לא “כתוב ושכח”. הפרויקט משתנה - הקובץ צריך להשתנות איתו, אחרת הוא מטעה.
השלב הבא

עכשיו - איך כותבים אחד מצוין.

ClaudeLearn · סוף מודול 52 · חזרה לקטלוג

→ השתמשו במקשי החצים ←  ·  רווח להמשך