3 טעויות מהחודש הראשון שלי עם Claude Code
בחודש הראשון עשיתי שלוש טעויות שחוזרות אצל כמעט כל מי שמתחיל: נתתי לקובץ ההוראות לגדול בלי סוף, ביקשתי משימות ענקיות בהודעה אחת, והאמנתי לו כשכתב שהוא סיים. במדריך: בדיקה של חצי דקה שמראה אם אתה כבר בתוך הטעות הראשונה, ושלושה משפטים שאתה כותב לו, מוכנים להעתקה.
למי זה מתאים
- עובד עם Claude Code כמה שבועות, ומרגיש שהוא מקשיב פחות? מתחילים בבדיקה בחלק 1.
- רוצה רק את המשפטים? קופצים לחלק 2, מעתיקים ומשתמשים מהיום.
- עוד אין לך CLAUDE.md? מתחילים במדריך היום הראשון וחוזרים לכאן אחרי חודש.
תוכן עניינים
הבדיקה של חצי דקה: כמה ארוך ה-CLAUDE.md שלך
CLAUDE.md הוא קובץ ההוראות ש-Claude Code קורא בתחילת כל שיחה. התיעוד של Anthropic ממליץ להחזיק כל קובץ כזה מתחת ל-200 שורות, כי קובץ ארוך יותר תופס יותר מקום בזיכרון של השיחה, והוא מקשיב להוראות שבו פחות.
פותחים שיחה חדשה ומדביקים:
תבדוק כמה שורות יש בכל קובץ CLAUDE.md שנטען אצלי בשיחה הזאת, כולל ~/.claude/CLAUDE.md וכל קובץ שהוא מייבא עם @. תכתוב לי טבלה: איפה הקובץ וכמה שורות יש בו. תספור עם wc -l ולא בהערכה, ותסמן כל קובץ שעובר 200 שורות.עובד בטרמינל? אפשר גם ישר, מתוך תיקיית הפרויקט:
wc -l ~/.claude/CLAUDE.md CLAUDE.mdאיך קוראים את התוצאה
- כל הקבצים מתחת ל-200: אתה בסדר. קפוץ למשפטים 2 ו-3.
- קובץ אחד או יותר מעל 200: זו הטעות הראשונה שלי. משפט 1 מתקן אותה.
- קובץ קצר שמייבא קבצים אחרים עם @: סופרים גם אותם. לפי התיעוד, קובץ מיובא נטען יחד עם הקובץ שמייבא אותו, אז הוא לא חוסך מקום.
שלושת המשפטים, להעתקה
1. כשהקובץ עבר 200 שורות
תקצר את CLAUDE.md מתחת למאתיים שורות, ותשאיר רק מה שהוא חייב לדעת בכל משימה.2. לפני משימה גדולה
תשאל אותי שאלות עד שאתה יכול לכתוב תוכנית, ותתחיל רק אחרי שאני מאשר.3. כשהוא כותב "סיימתי"
תראה לי את הבדיקה שהרצת, ומה יצא בה.טעות 1: קובץ הוראות שרק גדל
מה עשיתי: אחרי כל פיצ'ר ביקשתי ממנו לתעד אותו ב-CLAUDE.md. ב-git של האפליקציה הראשונה שלי רואים שהקובץ גדל מ-153 שורות ב-20.07.2025 ל-1,248 שורות חודש אחרי. אף אחד לא קרא את זה, חוץ ממנו, וגם הוא הפסיק להקשיב.
מה עושים: קודם עותק גיבוי, כי הוא כותב על הקובץ עצמו. בבדיקה שלי, בתיקייה בלי git, הוא דרס את המקור בלי גיבוי.
לפני שאתה משנה את CLAUDE.md, תשמור עותק שלו בשם CLAUDE.md.bak באותה תיקייה.ואז משפט 1:
תקצר את CLAUDE.md מתחת למאתיים שורות, ותשאיר רק מה שהוא חייב לדעת בכל משימה.מה יצא אצלי: בתיקיית הדגמה עם קובץ ארוך, wc -l מדד 1,420 שורות לפני ו-63 אחרי. כללי העבודה נשארו. ההיסטוריה של כל פיצ'ר, וכלל אחד שהיה כתוב 30 פעם, יצאו או התכווצו לשורה אחת.
שים לב: בסיכום שלו הוא כתב "מכ-1,000 שורות לכ-65". זו הערכה. את המספר האמיתי בודקים בבדיקה מחלק 1, שוב.
ומה עם מה שיצא? הוראה שנחוצה רק לחלק אחד של הפרויקט, התיעוד ממליץ להעביר לקובץ בתיקייה .claude/rules/, שנטען רק כשהוא עובד על הקבצים האלה.
טעות 2: בקשה אחת ענקית
מה עשיתי: ביקשתי ממנו לתקן דבר אחד בצ'אט של האפליקציה. ב-03.08.2025 יצא commit אחד ששינה 31 קבצים. אין דרך לבדוק 31 קבצים, אז לא בדקתי.
מה עושים: לפני משימה גדולה, כותבים את מה שאתה רוצה, ובסוף מוסיפים את משפט 2:
תשאל אותי שאלות עד שאתה יכול לכתוב תוכנית, ותתחיל רק אחרי שאני מאשר.מה יצא אצלי: בתיקיית הדגמה של אתר לסטודיו ביקשתי "הרשמה לסדנאות עם תשלום" עם המשפט הזה. הוא חזר עם 13 שאלות, על ספק הסליקה, חשבוניות, מקומות מוגבלים ורשימת המתנה. 0 קבצים השתנו עד שעניתי.
למה זה עובד: התיעוד של Claude Code ממליץ בדיוק על זה כשעוד לא ברור לך מה אתה רוצה: לבקש ממנו לראיין אותך עד שאפשר לכתוב תוכנית, ורק אז לבנות.
טעות 3: האמנתי ל"סיימתי"
מה עשיתי: ב-13.08.2025 הוא כתב לי שלוש פעמים ביום אחד "מוכן לפרודקשן". האמנתי. ב-15.08.2025 כבר תיקנתי באג באותו קוד.
מה עושים: כשהוא כותב שסיים, לא שואלים "זה עובד?". מבקשים את ההוכחה:
תראה לי את הבדיקה שהרצת, ומה יצא בה.מה יצא אצלי: בתיקיית הדגמה ביקשתי לתקן חישוב מע"מ. הוא כתב "הרצתי את הבדיקה והיא עוברת". אחרי המשפט הזה הוא הראה את הבדיקה ואת הפלט שלה, pass 1, fail 0, והוסיף בעצמו:
"לפני התיקון לא הרצתי את הבדיקה. עם 0.17 התוצאה הייתה 117, ולכן היא הייתה אמורה להיכשל, אבל את זה חישבתי ולא ראיתי בפועל."
זה כל העניין. "סיימתי" לבד לא אומר אם משהו רץ. גם התיעוד של Claude Code ממליץ לבקש ראיה: את הפקודה שהוא הריץ ואת הפלט שלה.
הכלל שנשאר אצלי עד היום
יותר משנה אחרי, זה כתוב אצלי בקובץ ההוראות: משימה לא נגמרת בלי הוכחה. כדי שלא תצטרך לבקש כל פעם, שומרים את זה פעם אחת. מדביקים בשיחה חדשה:
משימה לא נגמרת בלי הוכחה. בסוף כל משימה תראה לי את הפקודה שהרצת ואת הפלט שלה. אם לא הרצת כלום, תגיד את זה במפורש.
תשמור את זה ב-CLAUDE.md, לכל הפרויקטים.איך יודעים שזה עבד
- הקובץ: הבדיקה מחלק 1 מראה מתחת ל-200 שורות.
- השאלות: אחרי משפט 2 הוא שואל ולא משנה קבצים עד שאתה כותב "מאשר".
- ההוכחה: בסוף משימה הוא מראה פקודה ופלט, או כותב שלא הריץ כלום.
לא עבד? לפי הסדר:
- פותחים שיחה חדשה. הקובץ נטען בתחילת שיחה, לא באמצע.
- שואלים "איפה שמרת את הכלל?". אם הוא בקובץ של הפרויקט ולא ב-
~/.claude/CLAUDE.md, כותבים שוב "לכל הפרויקטים". - הקובץ עדיין ארוך? מריצים את משפט 1 שוב, ואת הבדיקה אחריו.
מקורות
- CLAUDE.md, היעד של פחות מ-200 שורות, ייבוא עם @ ו-
.claude/rules/: code.claude.com/docs/en/memory - לבקש ממנו לראיין אותך, ולבקש ראיה לפני "סיימתי": code.claude.com/docs/en/best-practices
- המספרים על הטעויות שלי (153, 1,248, 31 והתאריכים) נמדדו בהיסטוריית ה-git של האפליקציה הראשונה שלי.
- הדוגמאות הן פלט אמיתי של Claude Code מתיקיות הדגמה נקיות, ב-13 בנובמבר 2026.
כמה שורות יצאו לך?
תשלח לי בפרטי באינסטגרם את המספר מהבדיקה, לפני ואחרי משפט 1. ואם הוא שוב כתב "סיימתי" בלי הוכחה, תכתוב לו משפט 3 ותראה מה הוא עונה.
@danielthegoldman