מה זה CLAUDE.md?

CLAUDE.md הוא קובץ Markdown ש-Claude Code טוען אוטומטית אל ההקשר בתחילת כל סשן, ובו הוראות קבועות לפרויקט — מוסכמות קוד, פקודות בנייה ומבנה הפרויקט — כדי שלא תצטרכו להסביר אותן מחדש בכל פעם.

מאת איליי אוסטרוב · מייסד DigitalBox ומדריך קורס Claude Code Mastery

עודכן ב-28 ביוני 2026

מונחים נרדפים (עברית): קובץ ההקשר · קובץ ההוראות הקבוע · קובץ הזיכרון של הפרויקט
English: CLAUDE.md · Claude Code memory file · project context file
הגדרה באנגלית: CLAUDE.md is a Markdown file that Claude Code automatically loads into context at the start of every session, holding persistent instructions — coding conventions, build commands, and project structure — so you don't have to re-explain them each time.

הבעיה ש-CLAUDE.md פותר

כל סשן של Claude Code מתחיל עם חלון הקשר נקי — קלוד לא "זוכר" מה הסברתם אתמול. בלי מנגנון קבוע, הייתם חוזרים בכל פעם על אותם דברים: איך מריצים את הבדיקות, באיזה סגנון לכתוב, איפה יושב כל חלק בקוד. CLAUDE.md הוא המקום שבו כותבים פעם אחת את מה שאחרת הייתם מסבירים שוב ושוב, וקלוד קורא אותו בתחילת כל שיחה.

איפה הקובץ יכול לחיות

אפשר להחזיק כמה קבצי CLAUDE.md בו-זמנית, כל אחד בהיקף אחר. הם נטענים יחד ומשורשרים להקשר — מההיקף הרחב (ארגון/משתמש) ועד הספציפי (פרויקט), כך שההוראה הקרובה יותר למקום שבו הפעלתם את קלוד נקראת אחרונה:

היקףמיקוםלמה זה מתאים
משתמש~/.claude/CLAUDE.mdהעדפות אישיות לכל הפרויקטים שלכם
פרויקט (משותף)./CLAUDE.md או ./.claude/CLAUDE.mdהוראות צוות — נכנס לגיט ומשותף לכולם
פרויקט (מקומי)./CLAUDE.local.mdהעדפות אישיות לפרויקט; להוסיף ל-.gitignore
ארגוןמיקום מדיניות מנוהלתסטנדרטים ומדיניות ברמת החברה

קבצי CLAUDE.md בתיקיות שמעל תיקיית העבודה נטענים במלואם בהפעלה; קבצים בתת-תיקיות נטענים לפי דרישה כשקלוד קורא קבצים שם.

איך מתחילים — הפקודה /init

הדרך המהירה ליצור CLAUDE.md היא להריץ /init בתוך Claude Code. קלוד סורק את הקוד ומייצר קובץ התחלתי עם פקודות בנייה, הוראות בדיקה ומוסכמות שזיהה. אם כבר קיים קובץ, /init מציע שיפורים במקום לדרוס. משם משכללים ידנית, ומוסיפים דברים שקלוד לא יכול היה לנחש לבד.

ייבוא קבצים עם @

אפשר לפצל את ההוראות לכמה קבצים ולייבא אותם עם התחביר @path:

See @README for project overview and @package.json for available commands.

# Additional Instructions
- git workflow @docs/git-instructions.md

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

זה הקשר, לא חוק נאכף

חשוב להבין: CLAUDE.md הוא הקשר שקלוד מנסה לפעול לפיו — לא תצורה שנאכפת טכנית. אין ערובה לציות מוחלט, במיוחד להוראות מעורפלות או סותרות. ככל שההוראות ספציפיות וקצרות יותר, כך הציות עקבי יותר. אם משהו חייב לרוץ בנקודה מסוימת (למשל לפני כל commit) — הכלי הנכון הוא Hook, שרץ כפקודת מערכת ללא תלות בהחלטת המודל.

🔎 הערת אימות (FLAG): המיקומים, התנהגות /init, תחביר הייבוא @path (עומק עד 4), וההבחנה בין הקשר לבין אכיפה אומתו מול התיעוד הרשמי code.claude.com/docs/en/memory נכון ל-28 ביוני 2026. פרטים מתעדכנים עם גרסאות — אמתו מול המקור לפני הסתמכות.

קשור ל־

שאלות נפוצות

איפה שמים את הקובץ CLAUDE.md?

הקובץ יכול לחיות בכמה מיקומים, לפי היקף: ברמת המשתמש (~/.claude/CLAUDE.md) לכל הפרויקטים; ברמת הפרויקט (./CLAUDE.md או ./.claude/CLAUDE.md) המשותף לצוות דרך גיט; ברמת הפרויקט-המקומית (./CLAUDE.local.md) להעדפות אישיות מחוץ לגיט; וברמת הארגון (מדיניות מנוהלת). כולם נטענים יחד ומשורשרים, מהרחב לספציפי.

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

מריצים /init בתוך Claude Code. קלוד סורק את הקוד ומייצר קובץ התחלתי עם פקודות בנייה, הוראות בדיקה ומוסכמות שזיהה. אם כבר קיים קובץ, /init מציע שיפורים במקום לדרוס אותו.

אפשר לייבא קבצים אחרים לתוך CLAUDE.md?

כן — בעזרת התחביר @path (למשל @README). הקבצים נטענים להקשר בהפעלה, והייבוא רקורסיבי עד עומק של ארבעה צעדים. כדי להזכיר נתיב בלי לייבא — עוטפים בגרשיים אחוריים.

מה ההבדל בין CLAUDE.md לבין Hook?

CLAUDE.md הוא הקשר שקלוד מנסה לפעול לפיו, בלי ערובה לציות מוחלט. Hook הוא פקודת מערכת שרצה אוטומטית באירוע מוגדר (למשל לפני שימוש בכלי) — ולכן מתאים לכל דבר שחייב לקרות תמיד, ללא תלות בהחלטת המודל.

רוצים ללמוד לבנות CLAUDE.md מקצועי לפרויקט שלכם?

קורס Claude Code Mastery מקדיש לכך מודול מעשי — בעברית, עם דוגמאות אמיתיות.

לעמוד הקורס