קובץ 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 / עכבר המחשב.
קובץ .cursorrules
קובץ הוראות ארגוני ל-Cursor IDE שמכפה סטנדרטי קוד, ארכיטקטורה וטיפוסים על ה-AI.
Subagents ב-Claude Code
סוכנים מותאמים אישית ב-Claude Code עם system prompt + tools ספציפיים - קוראים מ-/agents directory.
Plan Mode ב-Claude Code
מצב ב-Claude Code שבו ה-AI כותב תוכנית מפורטת לפני שמתחיל לקודד - מקטין hallucinations.
חוב טכנולוגי (Tech Debt)
העלות העתידית שנוצרת מפתרון מהיר, המייצר "כדורי בוץ" בקוד (Big Ball of Mud) ומונע הוספת פיצ'רים.
שאלות נפוצות על קובץ 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 כמו כל קוד.
Audit הנדסי לפרויקט · 24 שעות · חינם
תארו מה שבור או מה החלום. נחזור עם אבחון הנדסי + תוכנית חילוץ ראשונית - בלי התחייבות.
מעדיפים לדלג? כתבו לנו ישירות בווצאפ