בלוג

למה Claude עושה את הדבר הלא נכון: 3 הנחיות

Markdown

Claude כותב את הדבר הלא נכון כי הוא ממהר לכתוב קוד בלי להבין את הכוונה שלך. אני מסביר למה ונותן לך 3 הנחיות מוכנות לשימוש שיגרמו לו לשאול שאלות קודם.

קריאת המאמר המלא

הנקודה המרכזית

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

למידע נוסף על השימוש בשירות, עיינו בתיעוד Ailoot.

למה Claude עושה את הדבר הלא נכון?

הנקודה המרכזית

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

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

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

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

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

אם תיתנו ל-Claude לקפוץ ישר לכתיבת קוד, ייתכן שהוא יפתור את הבעיה הלא נכונה.

— תיעוד Claude Code, https://code.claude.com/docs/en/best-practices

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

האם באמת המודל אשם — ולמה אפילו החזקים ביותר מחטיאים?

הנקודה המרכזית

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

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

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

מהי חקירה, ואיך היא מתקנת חוסר התאמה מול AI?

הנקודה המרכזית

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

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

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

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

איך גורמים ל-Claude לשאול אתכם שאלות קודם?

הנקודה המרכזית

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

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

הנחיההנחיה לחקירה — לגרום ל-Claude לראיין אתכם

אני רוצה לבנות [תיאור קצר של המשימה].

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

שאל שאלה אחת בכל פעם והמתן לתשובתי. עבור כל שאלה, הצע מיד את התשובה המומלצת שלך.

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

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

Anthropic מתארת את התמורה במונחים של השקעת זמן:

הזמן שמושקע בהכנת מפרט מדויק יקר יותר מהזמן שמושקע בצפייה במימוש.

— תיעוד Claude Code, https://code.claude.com/docs/en/best-practices

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

שיטת „הוכח לי שזו התוכנית הטובה ביותר”

הנקודה המרכזית

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

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

אם אינכם יכולים לבדוק את התוצאה, אל תגישו אותה.

— Anthropic, תיעוד Claude Code, https://code.claude.com/docs/en/best-practices

כמעט תמיד אני מוסיף להנחיה שלי סעיף „הוכח זאת”. הנה הניסוח המדויק:

הנחיההנחיה — לגרום לבינה המלאכותית להגן על התוכנית שלה

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

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

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

רק אז הצע מימוש.

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

ניתוח מקדים של כישלון: לגרום לבינה המלאכותית למצוא 10 סיבות לכישלון לפני שמתחילים

הנקודה המרכזית

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

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

הנחיההנחיה לניתוח מקדים של כישלון — לאיתור הפערים לפני שמתחילים

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

כתוב 10 סיבות לכך. למה לא נתנו את הדעת בהתחלה, מה הערכנו בחסר, היכן עיגלנו פינות ואילו הנחות התבררו כשגויות?

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

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

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

למה הקשר עמוס גורם ל-Claude להתנהג בטיפשות?

הנקודה המרכזית

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

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

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

Anthropic מכנה את מצב הכשל הזה „שיחת מגירת זבל”. הפתרון פשוט: השתמשו ב-/clear בין משימות שאינן קשורות כדי לנקות את החלון ולמנוע מהעומס של המשימה הקודמת לעבור למשימה החדשה.

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

חקירה או Plan Mode — מה ההבדל, ואיך משלבים ביניהם?

הנקודה המרכזית

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

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

מאפייןחקירהPlan Mode
מתי זה קורהלפני התוכנית — מבהיר את הכוונהלאחר מכן — יוצר תוכנית שינויים
מי שואל את מיהבינה המלאכותית מראיינת אתכםאתם קוראים את התוכנית ומאשרים אותה
מה מקבליםמפרט משימהתוכנית שינויים לפי קובץ
התועלת העיקריתמונעת „זה לא מה שרציתי”מונעת „אל תיגע בשום דבר אחר”

Anthropic מתארת תהליך עבודה קנוני בן ארבעה שלבים: תחילה Explore (Claude לומד ושואל שאלות), אחר כך Plan (בונה תוכנית בלי לבצע שינויים), אחר כך Implement (כותב קוד לפי התוכנית), ולבסוף Commit (מתעד את התוצאה). החקירה מתבצעת בשלב הראשון; Plan Mode בשני. לפירוט מלא של השלב השני, עיינו במדריך ל-Plan Mode ב-Claude Code.

הסתייגות חשובה מצד Anthropic עצמה: אל תעמיסו זאת על משימות קטנות.

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

— תיעוד Claude Code הרשמי, https://code.claude.com/docs/en/best-practices

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

5 טעויות בניסוח משימה שגורמות לבינה המלאכותית לעשות את הדבר הלא נכון

הנקודה המרכזית

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

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

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

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

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

הנקודה המרכזית

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

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

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

הניתוח האחרון של Anthropic מראה כמה עבודה כרוכה בכך: מפתחים משתמשים בבינה מלאכותית בכ-60% מהעבודה שלהם, אך יכולים לסמוך עליה לחלוטין רק ב-0-20% מהמשימות. את השאר דורשות ההבנה, הפיקוח והיכולת שלכם להסביר מה לבנות. זו המיומנות שכדאי לפתח, ולא המרדף אחר המודל החכם ביותר.

הכירו את Ailoot.

פרטים נוספים

שאלות ותשובות: למה Claude עושה את הדבר הלא נכון: 3 הנחיות

מתי להשתמש בהנחיית ראיון במקום לגשת ישר לקוד?

כשהתוצאה, מקרי הקצה או האילוצים אינם ברורים וטעויות יהיו יקרות. בקשו שאלה אחת בכל פעם ושמרו את התוצאה המוסכמת ב-SPEC.md; שגיאת כתיב או שינוי ברור בשורה אחת אפשר לבקש ישירות.

מה לבדוק לפני אישור התוכנית המוצעת?

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

כל המאמרים