CLAUDE.md אחרי Opus 5: למה הוראות ארוכות מפריעות עכשיו ל-Claude

מידע על עבודה עם Ailoot זמין בתיעוד.

מה השתנה ב-Claude אחרי השקת Opus 5?#

Opus 5 יצא ב-24 ביולי 2026 והפך מיד למודל ברירת המחדל ב-Claude Code. המודל עצמו — המחיר, המדדים ומצבי המאמץ שלו — נסקר בהרחבה במדריך נפרד, „האם כדאי לעבור ל-Claude Opus 5?”. המאמר הזה עוסק במשהו אחר: ההשקה שינתה גם את האופן שבו כדאי לדבר איתו.

Anthropic פרסמה ניתוח בבלוג של Claude. עיקרו כך:

הביטוי המרכזי הוא „הגבלנו יותר מדי”. כשהמודלים היו חלשים יותר, הם נזקקו לפיגומים: עשו כך, אל תעשו כך, הנה דוגמה, חזרו על זה פעם נוספת. Opus 5 כבר לא זקוק לפיגומים האלה, וגרוע מכך, הם עלולים להתחיל להפריע לו. Anthropic מציגה את העיקרון החדש בפשטות: תנו ל-Claude להפעיל שיקול דעת משלו.

מה זה אומר עבורכם בפועל?

• CLAUDE.md שלכם הוא מאותו סוג כמו פרומפט מערכת, אבל עבור הפרויקט שלכם. אם Anthropic קיצרה את שלה ב-80 אחוז, כנראה גם הקובץ שלכם תפוח מדי.
• רשימות ארוכות של כללים כבר לא מבטיחות ציות. להפך, ככל שיש יותר שורות, כך המודל מקפיד עליהן פחות (עוד על כך בהמשך, עם נתונים מהתיעוד).
• הופיעו מנגנונים חדשים — זיכרון אוטומטי ומיומנויות — שלוקחים על עצמם חלק מהעבודה שבעבר הייתם צריכים לפרט ידנית ב-CLAUDE.md.

הנקודה המרכזית: העבודה החשובה ביותר מתרחשת לפני הפרומפט — במה שאתם מכניסים להקשר של המודל לפני הבקשה הראשונה. עדכון Opus 5 הוא למעשה אישור רשמי של Anthropic לאותו רעיון. הפעם, עם זאת, הוא מגיע עם נתונים קונקרטיים וכלים חדשים. נעבור עליהם אחד־אחד.

למה CLAUDE.md ארוך מפריע עכשיו?#

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

התיעוד של Claude Code אומר זאת במפורש:

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

כך השתנתה הגישה:

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

כלל פשוט: CLAUDE.md הוא הערה קצרה על מה ש-Claude אינו יכול להסיק בעצמו. כל דבר מעבר לכך רק תופס את תשומת הלב שלו.

מה להשאיר ב-CLAUDE.md ומה להסיר?#

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

1. Claude עשה את אותה טעות בפעם השנייה.
2. בדיקת קוד גילתה משהו שהמודל היה אמור לדעת על הפרויקט הזה.
3. אתם מקלידים את אותו תיקון בצ'אט בפעם השנייה.
4. אדם חדש בצוות יצטרך את אותו הקשר כדי להימנע משבירת הפרויקט.

העיקרון הכללי הוא להשאיר מכשולים ייחודיים לפרויקט ולהסיר את המובן מאליו. ל-Claude Code יש אפילו בדיקה מובנית בשם claude doctor, שמציעה לנקות CLAUDE.md מנופח. היא מסירה פרטים שהמודל יכול להסיק מבסיס הקוד — מבנה התיקיות, רשימת התלויות וסקירת הארכיטקטורה — ומשאירה מכשולים, נימוקים ומוסכמות ששונות מברירות המחדל.

הכלל החשוב השני הוא ספציפיות. ניסוח מעורפל לא עובד. השוו:

ההבדל פשוט. המודל יכול לפרש „עצבו אותו כראוי” בכל דרך שירצה. אפשר לבדוק באופן חד־משמעי „השתמשו בהזחה של 2 רווחים”. כל כלל ב-CLAUDE.md צריך להיות דבר שאפשר לבדוק ולראות — אם פעלו לפיו או לא.

ושלישית, הסירו את המובן מאליו. אם תכתבו ב-CLAUDE.md „כתבו קוד נקי” או „פעלו לפי שיטות העבודה המומלצות”, זה רעש. המודל כבר יודע זאת, והשורה תופסת מקום ומפזרת את תשומת לבו. Anthropic ממליצה במפורש לא לבזבז הקשר על דברים מובנים מאליהם.

לאן להעביר כללים שלא מתאימים ל-CLAUDE.md?#

כאן נכנס לתמונה הכלי הכי פחות מוערך. בעבר כל ההוראות היו צריכות להישאר ב-CLAUDE.md; כעת יש מקום ייעודי לנוהלים ארוכים: מיומנויות. מדריך נפרד, „איך לבחור מיומנויות Claude Code”, מסביר איך לבחור את המתאימות בלי להוסיף יותר מדי.

ההבדל מהותי. CLAUDE.md נטען במלואו בתחילת כל הפעלה. מיומנות לא. התיעוד מנסח זאת כך:

לתהליך הזה קוראים גילוי הדרגתי — טעינת מידע לפי הצורך. הרעיון הוא לספק למודל הקשר במנות, ברגע המתאים. Anthropic העבירה את ההוראות המפורטות שלה — למשל הוראות לסקירת קוד — למיומנויות והסירה אותן מפרומפט המערכת.

הקריטריון להעברת משהו למיומנות פשוט: קטע ב-CLAUDE.md הפך מעובדה לנוהל. הערה בת שורה אחת, „בונים באמצעות npm run build”, היא עובדה ושייכת ל-CLAUDE.md. עשרה צעדים ל„איך אנחנו מפרסמים את הפרויקט” הם נוהל ושייכים למיומנות.

עיקרון מעשי: העבירו כל דבר שאתם עושים יותר מפעמיים. הסבירו פעם אחת איך מרכיבים, למשל, דוח שבועי ללקוח, הפכו את ההסבר למיומנות, ולא תצטרכו להסביר אותו שוב. המיומנות תמתין בלי לתפוס מקום בהקשר, ואפשר יהיה לקרוא לה בשמה באמצעות פקודה כמו /otchet.

דברים שכדאי להעביר למיומנויות:

• נהלים רב־שלביים (פרסום, הכנת דוח, בדיקות לפני השקה).
• הוראות ארוכות שנחוצות לעיתים רחוקות אך במלואן.
• כל דבר שאתם מעתיקים מצ'אט אחד לאחר בפעם השנייה או השלישית.

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

מהו זיכרון אוטומטי ולמה להשתמש בו ב-2026?#

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

ההבדל בין שני סוגי הזיכרון:

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

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

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

למה Opus 5 מתווכח עם ההוראות שלכם?#

יש לכך גם צד שני.

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

מה זה אומר עבורכם אם שדרגתם ל-Opus 5 ומשהו משתבש:

1. בדקו מחדש את המיומנויות והתוספים הישנים שלכם. הגדרות שנבנו עבור מודלים קודמים עשויות להתנגש בהיגיון החדש. כדאי לבדוק שוב משהו שפעם עבד כמו שעון.
2. הסירו את הניסוח הנוקשה ביותר. מודלים מהדור החמישי מסתדרים פחות טוב עם פקודות כמו „לעולם אל תעשו X, תמיד עשו רק Y” מאשר עם ניסוח גמיש שמסביר מדוע.
3. שימו לב למקרים שבהם המודל עוצר מוקדם מדי. לפעמים זה סימן לכך שהוראה סותרת את עצמה או מתנגשת בכלל ב-CLAUDE.md מנופח.

איך לשכתב את CLAUDE.md עבור Opus 5: שלב אחר שלב#

כך תעבדו עם קובץ CLAUDE.md שעבר מדורות קודמים של מודלים.

1. הריצו את הבדיקה המובנית

   הקלידו claude doctor בפרויקט. היא תציע מה להסיר מהקובץ המנופח ומה להשאיר.

2. הסירו את המובן מאליו

   מחקו כל שורה ש-Claude יכול להסיק מהקוד עצמו: מבנה תיקיות, רשימת ספריות וביטויים כלליים כמו „כתבו קוד נקי”.

3. הסירו סתירות

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

4. העבירו נהלים למיומנויות

   העבירו למיומנות נפרדת כל דבר שהפך מעובדה להוראה צעד־אחר־צעד. השאירו קישור בן שורה אחת ב-CLAUDE.md.

5. הפכו את הכללים שנותרו לספציפיים

   נסחו מחדש כל כלל כך שאפשר יהיה לבדוק אותו: „עצבו אותו כראוי” הופך ל„השתמשו בהזחה של 2 רווחים”.

6. הפעילו זיכרון אוטומטי ובדקו את האורך

   ודאו שהזיכרון האוטומטי פועל (/memory) ושהקובץ קצר מ-200 שורות. אם לא, יש עוד משהו שצריך להעביר.

כדי להימנע מביצוע המעבר הראשון בעצמכם, תנו ל-Claude לעשות את העבודה. הנה הנחיה שאפשר להשתמש בה כנקודת פתיחה — העתיקו אותה והדביקו אותה בהפעלה שנפתחה מתוך הפרויקט:

קרא את CLAUDE.md שלי ואת הקוד שלי. המשימה שלך היא לקצר את CLAUDE.md ולהפוך אותו למועיל יותר עבור מודל מהדור החמישי.

עבור על הקובץ וחלק את כל הכללים לשלוש קבוצות:

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

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

להעביר למיומנות - נהלים רב־שלביים שנמצאים כרגע כטקסט ב-CLAUDE.md.

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

שימו לב לשורה האחרונה: „אל תשנה שום דבר עד שאאשר”. במודל שמפעיל כעת שיקול דעת, זה חשוב: בקשו ממנו להציג תחילה תוכנית, והשאירו את ההחלטה בידיכם.

למה ההקשר חשוב יותר מהפרומפט?#

אם מניחים לרגע את הפרטים על Opus 5 ומביטים בתמונה הרחבה, כל הניתוח הזה עוסק ברעיון אחד: ההקשר חשוב יותר מהפרומפט. העבודה החשובה ביותר מתרחשת לפני הבקשה — כשמרכיבים את הסביבה שבה המודל יעבוד.

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

הנה בדיקה פשוטה: בלי מוח ראשון, מוח שני לא יעזור. במאמר הזה, „מוח שני” פירושו מבנה הידע על פרויקט שהמודל קורא עם כל בקשה. אבל הוא עובד רק כשיש לו בסיס בהבנה ברורה שלכם את המשימה. כלי מגביר את החשיבה שלכם, ושם מסתיים תפקידו.

עדכון Opus 5 חידד את ההיגיון הזה. Anthropic הראתה בעבודה שלה שכשהמודל חכם מספיק, כללים נוספים רק מזיקים, והיתרון הוא של מי שבנה את ההקשר בקפידה. זו מיומנות שתישאר איתכם גם בדור המודל הבא, בין אם Opus 6 ובין אם כל מודל אחר.

מאיפה כדאי להתחיל עכשיו?#

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

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

אפשר ליישם זאת בפרויקט אמיתי משלכם: CLAUDE.md, מוח שני ומיומנויות למשימות שלכם.

הכירו את Ailoot.