Claude Code בעברית: המדריך המעשי לעבודה נכונה

מה זה Claude Code, ובמה הוא שונה

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

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

המשאב האמיתי הוא ההקשר, לא המודל

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

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

CLAUDE.md: הקובץ שמשפיע יותר מכל פרומפט

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

# הפרויקט

אפליקציית Next.js עם TypeScript ב-strict mode.

## פקודות
- פיתוח: `npm run dev`
- בדיקות: `npm run test` (חייב לעבור לפני commit)
- טיפוסים: `npm run typecheck`

## מוסכמות
- Server Components כברירת מחדל. Client רק כשצריך אינטראקטיביות.
- אין `any`. אם אין ברירה, להוסיף הערה שמסבירה למה.
- כל תיקון באג מגיע עם טסט שנכשל לפניו.

## מלכודות
- `src/legacy/` לא מכוסה בבדיקות. לא לגעת בלי לשאול.

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

לולאת העבודה: לחקור, לתכנן, לבנות, לאמת

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

1. חקירה. לבקש ממנו לקרוא את הקוד הרלוונטי ולהסביר איך זה עובד היום, לפני שהוא משנה משהו. אם ההסבר שגוי, גיליתם את זה בזול.
2. תכנון. לבקש תוכנית לפני קוד. Plan Mode קיים בדיוק בשביל זה: הוא חוקר בלי להיות מסוגל לערוך קבצים, ומציג תוכנית לאישור.
3. בנייה. פרוסות קטנות שאפשר לאמת. שינוי אחד הגיוני בכל פעם, לא שכתוב של חמישה קבצים.
4. אימות. להריץ. בדיקות, שרת פיתוח, המסך האמיתי. ״נראה טוב״ הוא לא אימות.

כשמתחילים לעבוד ברצינות

• Plan Mode. מצב שבו הסוכן חוקר ומתכנן בלי הרשאת עריכה. מתאים לכל שינוי שנוגע ביותר מקובץ אחד.
• סוכני משנה. משימות חיפוש רחבות אפשר להוציא לסוכן נפרד, שיחזיר מסקנה במקום להציף את ההקשר הראשי בעשרות קבצים.
• פקודות מותאמות. תהליך שחוזר על עצמו, כמו סבב ביקורת קוד או תהליך שחרור גרסה, אפשר לשמור כפקודה במקום לנסח אותו כל פעם מחדש.
• MCP. פרוטוקול שמחבר את הסוכן למקורות חיצוניים: מסד נתונים, מערכת ניהול משימות, שירות ענן. כך הוא עובד מול המצב האמיתי ולא מול ניחוש.
• Hooks. הרצה אוטומטית של פעולה בנקודות מוגדרות, למשל הרצת פורמט אחרי כל עריכה. אכיפה במקום בקשה מנומסת.
• Git worktrees. כדי להריץ כמה משימות במקביל בלי שיתנגשו על אותם קבצים.

שש טעויות שגורמות לרוב התסכול

1. לבקש הכול בבת אחת. ״תבנה לי מערכת ניהול לקוחות״ יפיק ערימת קוד שאף אחד לא יתחזק. פרקו למשימות שאפשר לבדוק.
2. לא לתת לו להריץ כלום. סוכן שלא מריץ בדיקות מנחש אם הקוד עובד. גם אתם.
3. לאשר Diff בלי לקרוא. האחריות על הקוד נשארת שלכם. שינוי שלא הבנתם הוא חוב שייגבה בהמשך.
4. להילחם בשיחה מזוהמת. אחרי עשרה תיקונים כושלים, שיחה חדשה עם הקשר נקי כמעט תמיד מהירה יותר.
5. לתאר את הפתרון במקום את הבעיה. כשאומרים לו בדיוק איזה קוד לכתוב, מקבלים בדיוק את זה, כולל הטעות שבהנחה שלכם.
6. לערבב הכול בקומיט אחד. רפקטור, שדרוג גרסה ופיצ׳ר חדש יחד הופכים כל בעיה עתידית לחקירה ארוכה.

מתי לא להשתמש בזה

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

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

שאלות נפוצות

צריך לדעת לתכנת כדי להשתמש ב-Claude Code?

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

מה ההבדל בין Claude Code לבין השלמה אוטומטית בעורך?

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

האם הוא יכול לשבור לי את הפרויקט?

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

כמה זה עולה בפועל?

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

עברית עובדת טוב?

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