קובץ CLAUDE.mdCLAUDE.md File
הגדרה מהירה
מה זה CLAUDE.md File? (TL;DR)
CLAUDE.md הוא קובץ הוראות פרויקט שClaude Code קורא אוטומטית. שונה מ-.cursorrules כי נטען פעם בתחילת session. כל פרויקט שמשתמש ב-Claude Code חייב אחד.
ידוע גם בכתיבים: CLAUDE.md · claude.md · claude md · קובץ claude.md · קובץ הוראות Claude · instructions Claude
עיקרי המונח (Key Takeaways)
- ▸CLAUDE.md = קובץ הוראות פרויקט שClaude Code קורא אוטומטית בכל session.
- ▸מיקום: בשורש (root) של ה-repo. אפשר גם sub-CLAUDE.md בתת-תיקיות (monorepos).
- ▸שונה מ-.cursorrules: נטען פעם בתחילת session, לא בכל קריאה.
- ▸תוכן: Project Overview → Tech Stack → Architecture → Coding conventions → Pitfalls.
- ▸גודל אופטימלי: 50-80 שורות בהתחלה, מקסימום 300.
- ▸בלעדיו: hallucinations, חוסר עקביות, חוב טכני מצטבר.
- ▸רוב הצוותים מחזיקים את שניהם - .cursorrules ל-Cursor, CLAUDE.md ל-Claude Code.
ציטוט
השתמשתם בדף הזה? תנו קרדיט.
עתונאים, חוקרים וצוותי AI - בחרו פורמט להעתקה. ה-citation האקדמי שלנו בקליק.
מונחים קשורים
Claude Code (קלוד קוד)
Claude Code הוא ה-CLI של Anthropic לפיתוח אוטונומי עם AI. סטנדרט 2026 לעבודות planning + refactoring + MCP integrations.
שימוש מחשב מבוסס AI (Claude)
יכולת אלגוריתמית המאפשרת לסוכן Claude 3.5 לקרוא את המסך ולהקליד טקסט דרך Terminal / עכבר המחשב.
Hooks (קלוד קוד)
Hooks הם פקודות shell שרצות אוטומטית באירועי מחזור-חיים של Claude Code (כמו PreToolUse ו-PostToolUse), ומוגדרות בקובץ settings.json כדי לאכוף פורמט, tests ו-guardrails דטרמיניסטיים סביב הסוכן.
Skills (קלוד קוד)
Skills הן חבילות הוראות רב-פעמיות ל-Claude Code: תיקייה עם קובץ SKILL.md (frontmatter + הנחיות) שהסוכן טוען אוטומטית כשהמשימה תואמת ל-description.
Plugins (קלוד קוד)
Plugins הם חבילות הפצה של Claude Code שאורזות יחד slash commands, subagents, skills, hooks ו-MCP servers, מוגדרות ב-plugin.json ומותקנות ממרקטפלייס - התקנה אחת שמסנכרנת setup שלם לכל הצוות.
פקודות Slash (קלוד קוד)
פקודות Slash הן prompts שמורים כקבצי markdown ב-.claude/commands, שנקראים ב-/name ותומכים ב-$ARGUMENTS, frontmatter, הרצת bash עם ! וצירוף קבצים עם @.
שאלות נפוצות על קובץ CLAUDE.md
איפה שמים את CLAUDE.md בפרויקט?+
בשורש הפרויקט (root) כמו .cursorrules. Claude Code קורא אותו אוטומטית כשמריצים claude code בתיקייה. אפשר גם sub-CLAUDE.md בתת-תיקיות (למשל apps/web/CLAUDE.md) להוראות ספציפיות לחלק מסוים של monorepo.
מה ההבדל בין CLAUDE.md ל-.cursorrules?+
CLAUDE.md נטען פעם בתחילת ה-session ב-Claude Code CLI. <a href="/glossary/cursorrules-file">.cursorrules</a> נטען בכל קריאה ל-AI ב-Cursor IDE. מנגנון שונה אבל מטרה דומה. רוב הצוותים מחזיקים את שניהם בגלל שעובדים בשני הכלים.
איזה תוכן חייב להיות ב-CLAUDE.md?+
מבנה מומלץ: (1) Project Overview - 5 שורות, (2) Tech Stack list, (3) Architecture decisions (ADRs בקצרה), (4) Coding conventions - typing, naming, file size, (5) Common pitfalls שייחודיים לפרויקט, (6) Deployment + CI/CD, (7) Testing approach. כדאי שיהיה גם folder structure overview.
האם Claude Code עובד גם בלי CLAUDE.md?+
כן, אבל איכות הקוד נופלת משמעותית. בלי CLAUDE.md ה-AI לא יודע: באיזה state management להשתמש, איך לטפל בשגיאות, מה ה-naming conventions, איפה הקבצים. תוצאה: hallucinations, חוסר עקביות, וחוב טכני. תמיד עדיף עם CLAUDE.md.
איך מתחזקים CLAUDE.md לאורך זמן?+
התחילו עם 50-80 שורות. עדכנו כל פעם שמזהים anti-pattern (Claude עושה את אותה טעות פעמיים+). הגבילו ל-300 שורות מקסימום - אחרת זה מתחיל לאכול context window. כדאי לעדכן עם כל שינוי ארכיטקטוני משמעותי. שמרו ב-git כמו כל קוד.
מדברים בוואטסאפ, לא בטפסים
תארו בשתי שורות מה שבור או מה החלום. ההודעה נפתחת אצלכם מוכנה — אתם רק לוחצים שלח.
מעדיפים להתקשר? 054-211-8143