📘 תיעוד 3

כיצד Claude Code עובד

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

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

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

#הלולאה הסוכנותית

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

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

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

הלולאה הסוכנותית מונעת על ידי שני רכיבים: מודלים שמבצעים שיקול דעת והיקש, וכלים שפועלים. Claude Code משמש כמעטפת הסוכנותית (agentic harness) סביב Claude: הוא מספק את הכלים, את ניהול ההקשר ואת סביבת ההרצה שהופכים מודל שפה לסוכן קידוד בעל יכולת.

#מודלים

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

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

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

#כלים

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

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

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

Claude בוחר באילו כלים להשתמש בהתבסס על ההנחיה שלך ועל מה שהוא לומד לאורך הדרך. כאשר אתה אומר "fix the failing tests", Claude עשוי:

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

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

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

#למה Claude יכול לגשת

כאשר אתה מריץ claude בתיקייה, Claude Code מקבל גישה אל:

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

מכיוון ש-Claude רואה את כל הפרויקט שלך, הוא יכול לעבוד לרוחבו. כאשר אתה מבקש מ-Claude לבצע "fix the authentication bug", הוא מחפש קבצים רלוונטיים, קורא קבצים מרובים כדי להבין את ההקשר, מבצע עריכות מתואמות ביניהם, מריץ בדיקות כדי לאמת את התיקון, ומבצע commit לשינויים אם אתה מבקש זאת. זה שונה מעוזרי קוד בתוך השורה (inline) שרואים רק את הקובץ הנוכחי.

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

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

#סביבות הרצה

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

#ממשקים

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

#עבודה עם הפעלות (sessions)

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

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

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

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

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

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

#חידוש או פיצול הפעלות

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

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

#חלון ההקשר

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

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

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

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

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

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

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

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

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

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

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

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

#שמירה על בטיחות באמצעות נקודות ביקורת (checkpoints) והרשאות

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

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

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

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

#שליטה במה ש-Claude יכול לעשות

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

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

אתה יכול גם לאשר פקודות ספציפיות ב-.claude/settings.json כדי ש-Claude לא ישאל בכל פעם. זה שימושי עבור פקודות מהימנות כמו 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 חוקר, מנסה משהו]

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

[Claude מתאים את הגישה]

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

#קטיעה והכוונה

אתה יכול לנתב מחדש את Claude בכל נקודה מבלי לחכות שהתור יסתיים או להתחיל מחדש:

• לחץ על Esc כדי לעצור את Claude מיד. קריאת הכלי הרצה מבוטלת ו-Claude ממתין להנחיה הבאה שלך. אם יש לך הודעות שממתינות בתור, Claude Code שולח אותן בשלב הבא.
• הקלד תיקון ולחץ על Enter כדי לשלוח אותו מבלי לעצור את הכלי שרץ. 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 מבין זאת בעצמו.

#מה הלאה

• הרחבה באמצעות תכונות: הוספת חיבורי skills ו-MCP
• תהליכי עבודה נפוצים: מדריכים צעד אחר צעד למשימות טיפוסיות