קלוד קוד מדריכים: מה ללמוד ובאיזה סדר

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

רוב המדריכים מלמדים פרומפטים. הצוואר בקבוק הוא קונטקסט

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

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

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

לעבוד בפרוסות שאפשר לאמת בפחות משתי דקות

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

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

הוכחה עדיפה על קריאה. טסט שנכשל לפני השינוי ועובר אחריו. דף שאני באמת טוען. שאילתה שאני באמת מריץ. אני מריץ לבד את תדאם, Brainers Club, The Next Level, Luma.ai וערבויות ישיר, והסיבה היחידה שזה בר קיימא היא שכלום לא נכנס על סמך תחושה.

הסדר שהייתי לומד בו היום

1. 01להתקין ולעבוד שבוע על פרויקט שאפשר לזרוק, כדי ללמוד איך הוא נכשל כשכלום לא בסיכון.
2. 02לכתוב CLAUDE.md לריפו אמיתי אחד, ולעדכן אותו בכל פעם שהמודל מנחש לא נכון.
3. 03להתאמן על פריסה: לקחת פיצ'ר שאתם כבר יודעים לבנות ולהוביל אותו בשלושה או ארבעה שלבים בדוקים.
4. 04ללמוד לקרוא diff כמו שצריך, כולל הקבצים שלא ציפיתם שייגע בהם.
5. 05להוסיף טסטים לכל לוגיקה שיכולה להיכשל בשקט, ולדרוש מהמודל להריץ אותם לפני שהוא אומר שסיים.
6. 06רק אז לעבור לעבודה מקבילית וללולאות סוכן, שבהן כמה משימות רצות יחד ואתם הופכים למבקרים במקום למקלידים.

ביקורת קוד היא המיומנות שמפרידה בין מי שמשגר למי שלא

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

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

עברית, RTL וכל מה שמדריכים מדלגים עליו

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

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

מה משתנה כשמריצים בלולאות

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

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

אם תעשו רק דבר אחד השבוע

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