מה זה קובץ CLAUDE.md ולמה כל עסק צריך אחד
התשובה הקצרה: קובץ .md הוא קובץ טקסט רגיל בפורמט Markdown, שאפשר להשתמש בו למסמכים, README והערות. CLAUDE.md הוא קובץ .md בעל שם ותפקיד מיוחדים: Claude Code מאתר וקורא אותו אוטומטית בתחילת עבודה בתיקייה כדי לקבל הוראות קבועות על הפרויקט, הסגנון והכללים. כלומר, כל CLAUDE.md הוא קובץ Markdown — אבל קובץ .md רגיל אינו נטען אוטומטית כהוראות ל-Claude.
בקובץ הזה כותבים פעם אחת מי אתם, איך אתם עובדים ומה אסור ל-Claude לעשות. במקום להסביר מחדש בכל שיחה "אנחנו כותבים בעברית, בטון ישיר, בלי אימוג'ים" — ההנחיה כבר נמצאת בהקשר של Claude Code.
זה נשמע כמו פיצ'ר טכני לתכנתים, אבל זה בדיוק ההפך: זה אחד הכלים הכי שימושיים לבעל עסק שרוצה ש-Claude יעבוד בעקביות, בלי לחזור על אותן הנחיות שוב ושוב. במאמר הזה נסביר מה שמים בקובץ, מה לא, נראה דוגמה מלאה לעסק ישראלי (לא קוד!), ונסביר איך הפקודה /init יוצרת אותו לבד.
ה"תיק עובד חדש" של העובד הדיגיטלי
הדרך הכי פשוטה להבין את CLAUDE.md: תחשבו על עובד חדש שמצטרף לעסק שלכם. לפני שהוא מתחיל לעבוד, אתם נותנים לו תדריך קצר — מי הלקוחות, מה הטון של החברה, אילו כלים משתמשים, מה אסור לגעת בו, ואיך נראית עבודה טובה אצלכם. בלי התדריך הזה, העובד החדש יעשה טעויות שכל ותיק היה נמנע מהן, ואתם תצטרכו לתקן אותו כל יום מחדש.
CLAUDE.md הוא בדיוק התדריך הזה: Claude Code טוען אותו בתחילת העבודה בתיקייה. הוא שונה מ"זיכרון" של חשבון Claude, שיכול לשמור הקשר משיחות בהתאם למסלול ולהגדרות. CLAUDE.md הוא קובץ מפורש שנשאר בפרויקט, ניתן לשיתוף ולעריכה, ומיועד לכללי העבודה של אותה תיקייה.
מי שרוצה להבין קודם מה זה Claude בכלל ואיך הוא עובד — כדאי לקרוא את מה זה Claude לפני שממשיכים. ולמי שכבר עובד עם Claude Code, הכלי שרץ ישירות על קבצי הפרויקט או העסק שלכם — CLAUDE.md הוא חלק בלתי נפרד ממנו.
מה שמים בקובץ CLAUDE.md
הקובץ בנוי מסעיפים קצרים וברורים. הנה מה שכדאי לכלול:
1. מי אתם ומה העסק עושה. משפט או שניים על תחום הפעילות, קהל הלקוחות, והמונחים המקצועיים שחוזרים אצלכם. אם אתם משרד רואי חשבון, זה שונה לגמרי מסטודיו לעיצוב פנים — Claude צריך לדעת את ההקשר לפני שהוא כותב מילה אחת.
2. סגנון וטון כתיבה. עברית או אנגלית? פורמלי או קליל? יש מילים שאסור להשתמש בהן (למשל "היי" בפתיחת מייל ללקוח, או אימוג'ים במסמכים רשמיים)? זה בדיוק המקום לכתוב את זה, במקום לחזור על זה בכל פרומפט.
3. מבנה ותהליכי עבודה. איך אתם רוצים שדוחות ייראו? יש תבנית קבועה להצעת מחיר? יש סדר פעולות שחוזר על עצמו — קודם לבדוק מחירון, אחר כך לכתוב טיוטה, ורק אז לשלוח לאישור?
4. כללי "מותר ואסור". זה אולי הסעיף הכי חשוב. למשל: "אסור לשלוח מיילים בפועל, רק לכתוב טיוטה", "אסור להמציא נתונים פיננסיים — אם משהו לא ידוע, לשאול", "כל מחיר שמוזכר חייב להיות מהמחירון המצורף, לא מהזיכרון". כללים כאלה מונעים בדיוק את סוג הטעויות שגורמות לאובדן אמון בכלי.
5. קבצים וקישורים רלוונטיים. אם יש קובץ מחירון, תבנית חוזה, או רשימת לקוחות VIP שחוזרת בהרבה משימות — אפשר להפנות אליהם מתוך הקובץ כדי ש-Claude ידע מתי לבדוק אותם.
6. הגדרות טכניות (אם רלוונטי). אצל עסקים שמשתמשים ב-Claude Code לצורך אוטומציות — אילו פקודות מותר להריץ, אילו לא, ואיך מתנהגים מול מערכות חיצוניות. זה החלק שהכי דומה למה שמתכנתים כותבים, אבל גם בעל עסק שמריץ אוטומציות פשוטות צריך שורה או שתיים כאן.
מה לא שמים בקובץ
חשוב באותה מידה להבין מה לא שייך ל-CLAUDE.md:
- מידע רגיש — סיסמאות, מספרי חשבון בנק, פרטי אשראי. הקובץ הזה נטען אוטומטית ולעיתים משותף בין אנשי צוות — לא המקום למידע חסוי.
- נתונים משתנים — מחירים עדכניים, מלאי, סטטוס פרויקטים. אלה משתנים כל יום ולא שייכים לקובץ הוראות קבוע; עדיף קובץ נפרד שמתעדכן, או פשוט לצרף אותם בכל שיחה.
- הוראות חד-פעמיות. "תכתוב לי היום מייל ללקוח X" זו הוראה לשיחה הספציפית, לא כלל קבוע. CLAUDE.md מיועד למה שנכון תמיד, לא למשימה של הרגע.
- טקסט ארוך מדי. קובץ CLAUDE.md שתופס עשרות עמודים לא נקרא טוב יותר — הוא רק "צורך" יותר מקום מהקשר השיחה. עדיף כמה עשרות שורות ממוקדות מאשר מסמך מדיניות שלם.
דוגמה מלאה: קובץ CLAUDE.md לעסק ישראלי
הנה דוגמה לקובץ CLAUDE.md אמיתי, של סטודיו עיצוב גרפי קטן בתל אביב שמשתמש ב-Claude לכתיבת הצעות מחיר, תיאורי פרויקטים ותקשורת עם לקוחות:
# הנחיות קבועות — סטודיו "קו ישר" עיצוב גרפי
## מי אנחנו
סטודיו בוטיק לעיצוב מיתוג ואריזות, 4 עובדים, לקוחות בעיקר
מסעדות ומותגי מזון בישראל. מתמחים בעיצוב אריזה ולא בבניית
אתרים — לא לקבל על עצמנו הצעות בתחום הזה.
## טון כתיבה
- עברית תקנית, לא סלנג.
- פונים ללקוח בגוף שני רבים ("תוכלו", לא "תוכל").
- בלי אימוג'ים במיילים רשמיים ובהצעות מחיר.
- טון חם אבל מקצועי — לא "יבש" מדי, לא "חברי" מדי.
## מבנה הצעת מחיר
כל הצעת מחיר בנויה בסדר הזה: תיאור הפרויקט, שלבי עבודה,
לוח זמנים, מחיר כולל מע"מ, תנאי תשלום (50% מקדמה).
אורך מקסימלי: עמוד אחד.
## מותר ואסור
- אסור להציע הנחה בלי אישור מפורש שלי בשיחה.
- אסור להמציא מחירים — כל מחיר חייב להתבסס על מחירון
שאני מצרף, ואם אין מחירון בשיחה — לשאול אותי במקום לנחש.
- אסור לשלוח כלום בפועל ללקוח. רק להכין טיוטה ולסמן
"טיוטה לאישור" בראש המסמך.
- כשמתארים עבודה קודמת של הסטודיו, להשתמש רק בפרויקטים
שאני מזכיר בשיחה — לא להמציא לקוחות או תוצאות.
## מונחים שחוזרים
"בריף" = מסמך הדרישות מהלקוח. "קונספט" = כיוון עיצובי
ראשוני לפני עבודה מלאה. "מוקאפ" = הדמיה של האריזה הסופית.
שימו לב שאין כאן שורת קוד אחת — זה קובץ הוראות עסקי טהור. ה"קסם" הוא ש-Claude יזכור את כל זה בכל שיחה, כולל בעוד חודשיים, בלי שתצטרכו להקליד את זה מחדש.
איך /init יוצר את הקובץ אוטומטית
אם אתם עובדים עם Claude Code, לא צריך לכתוב את הקובץ מאפס. יש פקודה מובנית בשם /init שסורקת את התיקייה שאתם עובדים בה ומייצרת טיוטת CLAUDE.md ראשונית — היא מזהה קבצים קיימים, מבנה תיקיות, וסימנים לסגנון עבודה, ובונה מתוכם שלד התחלתי. אתם עדיין צריכים לעבור על הטיוטה ולהתאים אותה — הפקודה נותנת נקודת פתיחה, לא מוצר מוגמר. מדריך הפעלה מלא של Claude Code, כולל איך מריצים פקודות כאלה, נמצא באיך מתקינים Claude Code.
לאחר שהקובץ נוצר, כדאי לחזור אליו כל כמה שבועות ולעדכן — בדיוק כמו שהייתם מעדכנים תדריך לעובד חדש כשהתהליכים בעסק משתנים.
CLAUDE.md מול פרומפט רגיל — מה ההבדל
הרבה משתמשים מבלבלים בין כתיבת פרומפט טוב לבין קובץ CLAUDE.md. הטבלה הבאה מסכמת את ההבדל:
| קריטריון | פרומפט רגיל | קובץ CLAUDE.md |
|---|---|---|
| תוקף | לשיחה הנוכחית בלבד | קבוע, נטען בכל שיחה חדשה |
| מיקום | מוקלד בתוך הצ'אט | קובץ נפרד בתיקיית הפרויקט |
| מתי משתמשים | משימה חד-פעמית או ייחודית | כללים שחוזרים על עצמם תמיד |
| דוגמה | "כתוב לי מייל תודה ללקוח X" | "כל מייל תודה נכתב בעברית, בלי אימוג'ים, וחותם בשם הסטודיו" |
| מי צריך את זה | כל משתמש, בכל שיחה | בעיקר מי שעובד עם Claude Code או חוזר על אותן משימות |
במילים אחרות: CLAUDE.md לא מחליף פרומפט טוב — הוא חוסך מכם לחזור על אותו חלק מהפרומפט שוב ושוב. שילוב של שני הכלים יחד — CLAUDE.md לכללי היסוד, ופרומפט ממוקד למשימה הספציפית — הוא מה שנותן את התוצאה הכי טובה.
מתי כדאי להתחיל להשתמש ב-CLAUDE.md
אם אתם עדיין שולחים ל-Claude את אותן הנחיות פתיחה בכל שיחה — "אנחנו עסק ב-X, אני רוצה שתכתוב ב-Y, אל תעשה Z" — זה הסימן הכי ברור שהגיע הזמן לקובץ CLAUDE.md. במיוחד אם יותר מאדם אחד בעסק משתמש ב-Claude: קובץ משותף מבטיח שכולם מקבלים את אותה עקביות, בלי תלות בזיכרון של מי שהקליד את הפרומפט המקורי.
לעסקים שרוצים ללמוד את כל התהליך מהתחלה — הרשמה לקורס החינמי שלנו כוללת גם את הנושא הזה, ומי שכבר משתמש ב-Claude ורוצה להעמיק בהטמעה מלאה בעסק יכול לבדוק את הקורס המלא. לעסקים בתחום הכספים והדוחות יש התאמה ייעודית בקורס לניהול כספים.
לפני שממשיכים, שווה גם לעיין בספריית ה-Skills שלנו — חלק גדול מה-Skills כבר בנויים בהיגיון דומה ל-CLAUDE.md, רק ממוקדים במשימה אחת ספציפית. אפשר לשלב בין השניים: CLAUDE.md לכללי הבית הקבועים, ו-Skill מוכן למשימה חוזרת כמו כתיבת חוזה או ניתוח דוח.
שאלות נפוצות
מה ההבדל בין CLAUDE.md לזיכרון של Claude?
זיכרון Claude עשוי לשמור הקשר בין שיחות בהתאם למסלול ולהגדרות החשבון. CLAUDE.md שונה: זהו קובץ הוראות מפורש של Claude Code, שנשמר עם הפרויקט ונטען כשעובדים בתיקייה. לכן הוא מתאים לכללים שצריכים להיות גלויים, ניתנים לעריכה ולשיתוף עם הצוות.
האם צריך לדעת לתכנת כדי לכתוב CLAUDE.md?
לא. הקובץ הוא טקסט רגיל בעברית או אנגלית, בדיוק כמו שמזמינים תדריך לעובד חדש. אין בו קוד, ומי שיודע לכתוב מסמך נהלים קצר יודע לכתוב CLAUDE.md.
איפה שומרים את קובץ ה-CLAUDE.md?
בתיקיית העבודה הראשית של הפרויקט או העסק ב-Claude Code, תחת השם המדויק CLAUDE.md. Claude Code מחפש אותו שם אוטומטית בכל הפעלה — אין צורך "לצרף" אותו ידנית לכל שיחה.
מה קורה אם אני לא כותב קובץ CLAUDE.md בכלל?
Claude עדיין עובד, אבל בלי הקשר קבוע — תצטרכו לחזור ולהזכיר לו את סגנון העבודה, הכללים וההעדפות בכל שיחה מחדש. זה עובד, אבל פחות יעיל ופתוח יותר לחוסר עקביות בין שיחה לשיחה.
האם /init יוצר קובץ מושלם בלי צורך לערוך?
לא. הפקודה /init סורקת את התיקייה ובונה טיוטה ראשונית סבירה, אבל היא לא יודעת דברים שלא כתובים בשום מקום — כמו כללי "מותר ואסור" עסקיים או טון כתיבה שרק בראש שלכם. תמיד כדאי לעבור על הטיוטה ולהוסיף את החלקים האלה.
כמה ארוך צריך להיות קובץ CLAUDE.md טוב?
אין מספר קסם. עדיף לשמור על הקובץ קצר וממוקד — כללים חשובים, פקודות שימושיות והפניות למידע רלוונטי — ולא להפוך אותו למסמך מדיניות ארוך. קובץ עמוס מכניס להקשר מידע שפחות רלוונטי למשימה ועלול לפגוע במיקוד.