קובץ CLAUDE.md, ניהול הקשר וכלים ב-Claude Code

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

עודכן ב-2026-06-03 · נבדק בעבודה יומיומית מול Claude Code. נכתב על ידי צוות Core-Code (אודות), עם סיוע AI שנבדק ידנית.

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

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

/init

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

מה כותבים בתוך הקובץ?

כותבים את מה שמפתח חדש היה צריך לדעת ביום הראשון: סטאק וגרסאות, פקודות נפוצות (build, test, lint), מוסכמות סגנון, מבנה התיקיות, ובמיוחד איסורים מפורשים. ככל שההוראות חדות וקצרות יותר, כך הסוכן מציית טוב יותר. הימנעו מקיר טקסט — העדיפו רשימות ממוקדות:

## הפרויקט
אתר Next.js 15 (App Router), JavaScript, Tailwind. עברית RTL.

## פקודות
- התקנה: `npm install`
- פיתוח: `npm run dev`
- בדיקות: `npm test` (להריץ לפני כל commit)
- בדיקת קוד: `npm run lint`

## סגנון
- קומפוננטות פונקציונליות בלבד; אין class components.
- שמות קבצים ב-kebab-case.
- כל טקסט למשתמש — בעברית.

## איסורים (חשוב)
- אל תוסיף תלויות חדשות בלי לשאול.
- אל תיגע בקבצים תחת `legacy/`.
- אל תכתוב סודות או מפתחות לקוד.

מחקר של GitHub מצא שמפתחים שהשתמשו ב-Copilot השלימו משימה נתונה מהר ב-55% — אבל היתרון הזה נשמר רק כשהפלט תואם את מוסכמות הפרויקט. קובץ CLAUDE.md טוב הוא בדיוק מה שמבטיח את ההתאמה הזו (מקור).

איך עובד חלון ההקשר?

חלון ההקשר (context window) הוא כמות הטקסט — קוד, הוראות, היסטוריית שיחה — שהמודל "רואה" בו-זמנית, ונמדד בטוקנים. הוא גדול אך סופי. כשהשיחה מתמלאת, פרטים ישנים נדחקים החוצה והאיכות יורדת. לכן ניהול הקשר פעיל הוא מיומנות מרכזית, לא פרט טכני.

שתי הפקודות המרכזיות לניהול:

/clear     # איפוס מלא של ההיסטוריה — בין משימות שונות
/compact   # דחיסת שיחה ארוכה תוך שימור עיקרי ההקשר

ככלל אצבע: נקו עם /clear בכל מעבר למשימה לא קשורה. כפי שמנסחים זאת מהנדסי Anthropic, הקשר הוא משאב מוגבל שיש לנהל בקפידה — "context is a finite resource with diminishing marginal returns" — והעמסת מידע לא רלוונטי פוגעת בדיוק (מקור).

Checkpoint

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

• א/clear — איפוס מלא של ההיסטוריה
• ב/compact — דחיסת השיחה
• ג/init — יצירת CLAUDE.md

מהם slash-commands?

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

/help        # רשימת כל הפקודות
/clear       # ניקוי ההקשר
/compact     # דחיסת ההקשר
/init        # יצירת CLAUDE.md
/cost        # עלות וצריכת טוקנים בסשן
/model       # החלפת המודל הפעיל

אפשר גם להגדיר פקודות slash מותאמות אישית כקובצי Markdown תחת .claude/commands/ בפרויקט — למשל פקודה /review עם הנחיות קבועות לסקירת קוד. כך הצוות כולו עובד עם אותם זרימות עבודה.

איך עובדים כלים והרשאות?

כלים (tools) הם הפעולות שהסוכן יכול לבצע: קריאת קובץ, עריכה, הרצת פקודת מערכת, חיפוש בקוד-בייס וחיבור שרתי MCP חיצוניים. כל פעולה שמשנה את המערכת כפופה למודל ההרשאות — קריאה מותרת כברירת מחדל, אך כתיבה והרצת פקודות דורשות אישור מפורש.

אפשר להגדיר מראש אילו כלים מותרים או אסורים בקובץ הגדרות .claude/settings.json בפרויקט:

{
  "permissions": {
    "allow": ["Read", "Edit", "Bash(npm test:*)"],
    "deny": ["Bash(rm -rf:*)", "Bash(git push:*)"]
  }
}

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

מה הלאה?

עם CLAUDE.md מסודר וניהול הקשר נכון, הסוכן עובד הרבה יותר עקבי. רוצים את אותה גישה בעורך גרפי? עברו למסלול Cursor (קרסר) שמכסה את הקובץ המקביל .cursorrules. וכדי לכוון את הסוכן לעקרונות נכונים, ראו DRY — מקור אמת יחיד ו-KISS — פשטות.