📘 תיעוד 3

איך קלוד קוד עובד

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

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

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

#לולאת הסוכן

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

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

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

לולאת הסוכן מופעלת על ידי שני רכיבים: מודלים שחושבים וכלים שפועלים. קלוד קוד הוא השכבה סביב המודל שמספקת את הכלים ומנהלת את ההקשר שהמודל רואה. השכבה הזו שמסביב היא מה שהמונח agentic harness מתייחס אליו.

#מודלים

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

כמה מודלים זמינים עם פשרות שונות. Sonnet מטפל היטב ברוב משימות הקידוד. Opus מספק חשיבה חזקה יותר להחלטות ארכיטקטורה מורכבות. עבור עם /model במהלך סשן, או התחל עם claude --model <name>.

כשהמדריך הזה אומר "קלוד בוחר" או "קלוד מחליט", המודל הוא זה שעושה את החשיבה.

#כלים

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

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

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

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

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

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

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

#למה לקלוד יש גישה

כשמריצים claude בתיקייה, קלוד קוד מקבל גישה אל:

• הפרויקט שלך. קבצים בתיקייה שלך ובתת התיקיות, ובנוסף קבצים במקומות אחרים עם הרשאה שלך.
• הטרמינל שלך. כל פקודה שאפשר להריץ: כלי בנייה, git, מנהלי חבילות, כלי מערכת, סקריפטים. אם אפשר לעשות את זה משורת הפקודה, גם קלוד יכול.
• מצב ה-git שלך. הענף הנוכחי, שינויים שלא בוצעו להם commit, והיסטוריית ה-commit האחרונה.
• הקובץ CLAUDE.md שלך. קובץ markdown שבו שומרים הוראות, מוסכמות והקשר ספציפיים לפרויקט, שקלוד צריך לדעת בכל סשן. אם במאגר יש AGENTS.md לסוכני קידוד אחרים, קלוד יכול לקרוא אותו במקום CLAUDE.md.
• זיכרון אוטומטי. דברים שקלוד לומד ושומר אוטומטית תוך כדי עבודה, כמו ההעדפות שלך. 200 השורות הראשונות או 25KB של MEMORY.md, מה שמגיע קודם, נטענים בתחילת כל סשן.
• הרחבות שאתה מגדיר. שרתי MCP לשירותים חיצוניים, skills לתהליכי עבודה, תת סוכנים לעבודה שמועברת, וClaude in Chrome לאינטראקציה עם הדפדפן.

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

#סביבות וממשקים

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

#סביבות הרצה

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

#ממשקים

אפשר לגשת לקלוד קוד דרך הטרמינל, אפליקציית שולחן העבודה, הרחבות IDE, claude.ai/code, Remote Control, Slack, וצינורות CI/CD. הממשק קובע איך רואים את קלוד ואיך מתקשרים איתו, אבל לולאת הסוכן שמתחת זהה. ראה שימוש בקלוד קוד בכל מקום לרשימה המלאה.

#עבודה עם סשנים

קלוד קוד שומר את השיחה שלך מקומית תוך כדי עבודה. כל הודעה, שימוש בכלי ותוצאה נכתבים לקובץ JSONL בטקסט רגיל תחת ~/.claude/projects/, וזה מאפשר חזרה לאחור, חידוש ופיצול של סשנים. לפני שקלוד משנה קוד, הוא גם שומר תצלום של הקבצים המושפעים כדי שאפשר יהיה לחזור אם צריך. לנתיבים, לשמירה, ולאיך מנקים את הנתונים האלה, ראה נתוני יישום ב-~/.claude.

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

#עבודה בין ענפים

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

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

מכיוון שסשנים קשורים לתיקיות, אפשר להריץ סשנים מקבילים של קלוד באמצעות git worktrees, שיוצרים תיקיות נפרדות לענפים נפרדים.

#חידוש או פיצול סשנים

חידוש סשן עם claude --continue או claude --resume פותח אותו מחדש תחת אותו מזהה סשן ומוסיף הודעות חדשות לשיחה הקיימת. פיצול עם --fork-session או /branch מעתיק את ההיסטוריה למזהה סשן חדש, ומשאיר את המקור ללא שינוי.

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

#חלון ההקשר

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

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

#הקשר שקלוד קוד מוסיף בעצמו

אם קלוד פועל לפי כלל שלא כתבת, כמו הוספת שורת Co-Authored-By ל-commit, ייתכן שהכלל הגיע מתזכורת מערכת. תוך כדי עבודה, קלוד קוד מוסיף הקשר משלו לשיחה לצד ההודעות שלך:

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

כדי לשנות או להסיר את שורות הייחוס, הגדר את attribution. כדי להסיר את הוראות ה-commit ובקשת המשיכה המובנות של קלוד קוד, הגדר את includeGitInstructions ל-false. למתגים האחרים, ראה כיבוי ההקשר שהסוכן שלך מחליף.

#כשההקשר מתמלא

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

כדי לשלוט במה שנשמר במהלך הצמצום, הוסף מקטע "Compact Instructions" ל-CLAUDE.md, או הרץ /compact עם מיקוד (כמו /compact focus on the API changes).

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

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

#ניהול הקשר עם skills ותת סוכנים

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

Skills נטענים לפי דרישה. קלוד רואה תיאורי skill בתחילת הסשן, אבל התוכן המלא נטען רק כשמשתמשים ב-skill. ל-skills שאתה מפעיל ידנית, הגדר disable-model-invocation: true כדי להשאיר את התיאורים מחוץ להקשר עד שצריך אותם. ל-skills שלא כתבת, השתמש ב-skillOverrides כדי לעשות אותו דבר מההגדרות.

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

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

#שמירה על בטיחות עם נקודות ביקורת והרשאות

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

#ביטול שינויים עם נקודות ביקורת

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

נקודות ביקורת נפרדות מ-git ונשארות זמינות כשמחדשים שיחה. הן מכסות רק שינויי קבצים, ושחזור מדלג על קבצים שהם symlink או hard link. פעולות שמשפיעות על מערכות מרוחקות (מסדי נתונים, API, פריסות) אי אפשר לשמור כנקודת ביקורת. שולטים בהן באמצעות מצב ההרשאות וכללי ההרשאות שלך.

#שליטה במה שקלוד יכול לעשות

בחר מצב הרשאות כדי לקבוע מה קלוד יכול לעשות בלי לשאול אותך. לחץ Shift+Tab כדי לעבור בין מצבי ההרשאות:

• Auto: מסווג בודק את רוב הפעולות ברקע וחוסם את המסוכנות במקום לשאול אותך. ב-Claude Code מגרסה v2.1.283 ואילך, זה מצב ההרשאות ההתחלתי המובנה לסשנים אינטראקטיביים בטרמינל וב-VS Code. בגרסאות קודמות, זה מצב ההרשאות ההתחלתי המובנה רק בתוכניות Pro, Max, Ultra ו-Team.
• Manual: קלוד שואל לפני עריכות קבצים ופקודות מעטפת
• Accept edits: קלוד עורך קבצים ומריץ פקודות מערכת קבצים נפוצות כמו mkdir ו-mv בלי לשאול, ועדיין שואל לגבי פקודות אחרות
• Plan: קלוד חוקר ומציע תוכנית בלי לערוך את קובצי המקור שלך

אפשר גם לאשר פקודות מסוימות ב-.claude/settings.json כדי שקלוד לא ישאל בכל פעם. זה שימושי לפקודות מהימנות כמו npm test או git status. אפשר לתחום הגדרות ממדיניות כלל ארגונית ועד להעדפות אישיות. ראה הרשאות לפרטים.

#עבודה יעילה עם Claude Code

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

#בקש עזרה מ-Claude Code

Claude Code יכול ללמד אותך איך להשתמש בו. שאל שאלות כמו "how do I set up hooks?" או "what's the best way to structure my CLAUDE.md?" ו-Claude יסביר.

גם פקודות מובנות מנחות אותך בהגדרה:

• /init יוצר CLAUDE.md התחלתי לפרויקט שלך
• /doctor מריץ בדיקת הגדרה שמאבחנת בעיות התקנה ותצורה ויכול לתקן אותן

#זו שיחה

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

Fix the login bug

[Claude investigates, tries something]

That's not quite right. The issue is in the session handling.

[Claude adjusts approach]

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

#עצור וכוון

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

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

#האצל, אל תכתיב

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

The checkout flow is broken for users with expired cards.
The relevant code is in src/payments/. Can you investigate and fix it?

אין צורך לציין אילו קבצים לקרוא או אילו פקודות להריץ. Claude מבין את זה בעצמו.

#מה הלאה

[card] הרחבה עם יכולות

הוספת skills וחיבורי MCP

[card] תהליכי עבודה נפוצים

מדריכים צעד אחר צעד למשימות טיפוסיות