📚 פרק 6 מתוך 14 | קורס Claude Code בעברית

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

✅ מה תלמדו בפרק זה

  • איך יוצרים קובץ CLAUDE.md ידנית ואיך מוודאים שהוא עובד
  • איך משתמשים בפקודת /init כדי שClaude ייצור את הקובץ אוטומטית
  • 4 כללי אצבע לכתיבת קובץ CLAUDE.md אפקטיבי
  • ההבדלים בין שלושת סוגי הקבצים: Project Shared, Project Local ו-User Global
  • איך מוצאים את התיקייה הנסתרת .claude במק ובווינדוס

יצירה ידנית של CLAUDE.md

הדרך הפשוטה ביותר: צרו קובץ חדש בתיקיית השורש של הפרויקט בשם CLAUDE.md (השם חייב להיות בדיוק ככה, כולל אותיות גדולות). כתבו בתוכו הנחיות בפורמט Markdown ושמרו.

לדוגמה, אפילו הנחיה פשוטה כמו:

קובץ CLAUDE.md מינימלי:
# About My name is Ram. This is my expenses dashboard project.

אם תפתחו שיחה חדשה עם Claude Code ותשאלו "what is my name?" — הוא יקרא את הקובץ ויענה "Ram". זה עובד, אבל כמובן שאנחנו רוצים משהו מעמיק ומועיל הרבה יותר.

יצירה אוטומטית עם /init

במקום לכתוב הכל ידנית, אפשר לתת ל-Claude לעשות את העבודה. פתחו שיחה חדשה וכתבו /init. שימו לב מה קורה:

1

Claude סורק את הפרויקט

הוא בודק אילו קבצים ותיקיות קיימים, קורא את הקוד ומנתח את המבנה.

2

Claude מזהה את הטכנולוגיות

הוא מבין איזה שפות, פריימוורקים ותלויות נמצאים בשימוש.

3

Claude יוצר את הקובץ

הוא כותב CLAUDE.md מסודר עם Project Overview, פקודות הרצה, ארכיטקטורה ומוסכמות.

4

אתם בודקים ומשפרים

התוצאה היא נקודת התחלה מצוינת. עברו על הקובץ, תקנו אי-דיוקים והוסיפו הנחיות שרק אתם יודעים.

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

4 כללי אצבע לקובץ CLAUDE.md אפקטיבי

1 הסבירו גם "למה" ולא רק "מה"

אל תסתפקו בתיאור טכני יבש של הפרויקט. הוסיפו הקשר: למה הפרויקט הזה קיים, מה הוא משרת, מי המשתמשים שלו. כשClaude מבין את המטרה, הוא מקבל החלטות טובות יותר. לדוגמה: במקום רק "expenses dashboard" — כתבו "דשבורד הוצאות אישי שמנתח קובץ Excel חודשי ומציג סטטיסטיקות וגרפים בעברית".

2 השתמשו במבנה Markdown נכון

השתמשו בכותרות (#, ##), רשימות (-) ודגשים (**bold**) כדי לארגן את המידע. מבנה ברור עוזר ל-Claude להבחין בין עיקר לתפל — מה הכותרת הראשית, מה תתי-הסעיפים, ומה הנקודות החשובות. קובץ טקסט שטוח בלי מבנה הרבה פחות אפקטיבי.

3 שמרו על קובץ קצר ורלוונטי

לפי התיעוד הרשמי של Anthropic, מומלץ לשמור על CLAUDE.md עד כ-200 שורות. זכרו: כל תוכן הקובץ נטען לחלון ההקשר בתחילת כל שיחה. קובץ ארוך מדי צורך יותר מקום בהקשר, מפחית את מידת ההקפדה של Claude על ההנחיות, ומקשה גם עליכם לעקוב. אם הקובץ גדל מעבר לכך — פצלו הנחיות לתתי-קבצים בתיקיית .claude/rules/.

4 עדכנו את הקובץ כשClaude חוזר על טעויות

כשאתם מזהים ש-Claude חוזר על אותה טעות — זה הזמן לתעד אותה ב-CLAUDE.md. בקשו ממנו: "תוסיף ל-CLAUDE.md כלל שאומר לא להשתמש ב-var, רק ב-const או let". בפעם הבאה שהוא ייתקל באותו מצב, הוא כבר יהיה מודע לכלל. זהו תהליך חזרתי: עובדים, מזהים בעיה, מתעדים, ממשיכים.

❌ CLAUDE.md לא אפקטיבי

this is a project with html and javascript and excel file and it shows expenses and there are charts and a table and it should look nice and work well

✅ CLAUDE.md אפקטיבי

# Expenses Dashboard
Personal expense analyzer for Feb 2026.

## Run
Open dashboard.html in browser.

## Rules
– All amounts in ₪ (ILS)
– Charts use Chart.js
– RTL layout for Hebrew

שלושת סוגי קבצי CLAUDE.md

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

1. Project Shared — משותף לכל הצוות

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

2. Project Local — הגדרות אישיות לפרויקט

זהו הקובץ CLAUDE.local.md שנמצא גם הוא בתיקיית הפרויקט. ההבדל: הוא מיועד להנחיות אישיות שלכם בלבד ולא אמור להיות משותף עם הצוות. מומלץ להוסיף אותו ל-.gitignore.

דוגמה לקובץ CLAUDE.local.md:
# My Local Preferences – When I write in Hebrew, respond in Hebrew – My dev server runs on localhost:3001 – Use my test data in /fixtures/ram-test-data.json

3. User Global — הגדרות לכל הפרויקטים

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

סוג שם הקובץ מיקום משותף ב-Git?
Project Shared CLAUDE.md תיקיית השורש של הפרויקט כן
Project Local CLAUDE.local.md תיקיית השורש של הפרויקט לא (הוסיפו ל-.gitignore)
User Global CLAUDE.md ~/.claude/ לא

איך מוצאים את תיקיית .claude?

תיקיית .claude היא תיקייה נסתרת (Hidden Folder) שנמצאת בתיקיית הבית שלכם. ברוב המערכות היא לא מופיעה כברירת מחדל:

🍎 מק (macOS)

  • ב-Finder: לחצו Cmd + Shift + . (נקודה) כדי להציג תיקיות נסתרות
  • נווטו אל /Users/[שם_משתמש]/.claude/
  • או בטרמינל: open ~/.claude

🪟 ווינדוס (Windows)

  • ב-File Explorer: View → Show → Hidden Items
  • נווטו אל C:\Users\[שם_משתמש]\.claude\
  • או בשורת הפקודה: explorer %USERPROFILE%\.claude
⚠️ שם הקובץ חייב להיות מדויק: הקבצים חייבים להיקרא בדיוק CLAUDE.md ו-CLAUDE.local.md — כולל אותיות גדולות. שם שגוי (כמו claude.md באותיות קטנות) יגרום לClaude Code להתעלם מהקובץ.

שאלות נפוצות

כן, אבל רק כשמבקשים ממנו. Claude לא מעדכן את הקובץ באופן אוטומטי כשהוא נתקל בבעיה. אבל אפשר לבקש ממנו: "תוסיף ל-CLAUDE.md כלל שאומר…" והוא יערוך את הקובץ. בנוסף, הפקודה /init יכולה ליצור או לשפר קובץ קיים.
מומלץ להתחיל עם /init כדי לקבל בסיס טוב, ואז לערוך ידנית. Claude מזהה היטב פרטים טכניים (פקודות Build, ארכיטקטורה, תלויות), אבל רק אתם יודעים את ה"למה" — המטרה העסקית, ההקשר והמוסכמות שלא נכתבו בקוד.
לפי התיעוד הרשמי של Anthropic, מומלץ לשמור על עד 200 שורות לכל קובץ CLAUDE.md. קובץ ארוך מדי צורך יותר מקום בחלון ההקשר ומפחית את ההקפדה על ההנחיות. אם יש לכם הרבה הנחיות, פצלו אותן לקבצים נפרדים בתיקיית .claude/rules/.
שניהם נטענים יחד — הם לא מתנגשים אלא משלימים זה את זה. CLAUDE.local.md נטען אחרי CLAUDE.md, כך שהעדפות אישיות מתווספות להנחיות הפרויקט. אם יש סתירה, ההנחיה האחרונה שנקראה (מ-CLAUDE.local.md) תקבל עדיפות.
כן. השתמשו בתחביר @path/to/file כדי לייבא תוכן מקבצים אחרים. לדוגמה: @docs/api-conventions.md. הקבצים המיובאים יכולים לייבא קבצים נוספים בעצמם, עד 5 רמות עומק.

מה מחכה בפרק הבא?

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

🚀 רוצים ללמוד Claude Code בעברית?

קורס מלא של 14 פרקים, מהתקנה ועד אוטומציות מתקדמות

לכל פרקי הקורס ←

דברו איתנו