מדריך קלוד קוד בעברית
לאתר הראשי כל המדריכים קלאודפלייר קלוד דסקטופ גרוק CLI גרוק בוט MCP קרסור וואטסאפ OpenClaw n8n בענן n8n בהתקנה עצמית

תיעוד 120

נקודות ביקורת (Checkpointing)

מעקב, החזרה לאחור ותמצות של עריכות ושיחת Claude כדי לנהל את מצב ה-session.

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

#כיצד פועלות נקודות ביקורת

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

#מעקב אוטומטי

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

  • כל בקשת משתמש יוצרת נקודת ביקורת חדשה.
  • Claude Code שומר תצלומי בזק (snapshots) של קבצים עבור 100 נקודות הביקורת האחרונות ב-session. הסרת נקודת ביקורת ישנה מוחקת את קובצי ה-snapshot ששום נקודת ביקורת שנותרה אינה מפנה אליהם, למעט ה-snapshot הראשון של כל קובץ, שבו תוסף VS Code משתמש כקו בסיס (baseline) להשוואות השינויים (diffs) של ה-session.
  • Claude Code שומר נקודות ביקורת יחד עם השיחה, כך שעדיין תוכל להריץ /rewind לאחר חידוש session.
  • Claude Code מוחק את תצלומי הבזק של קובצי ה-session במסגרת סריקת השימור (retention sweep), כברירת מחדל כ-30 יום לאחר שה-session שמר snapshot לאחרונה. החזרה לאחור לנקודת ביקורת שה-snapshots שלה כבר אינם קיימים עלולה להיכשל עם השגיאה No files were restored. כדי לשמור snapshots לפרק זמן ארוך יותר, הגדר את cleanupPeriodDays.

#החזרה לאחור ותמצות

הרץ /rewind, או לחץ פעמיים על Esc כאשר שורת הקלט ריקה, כדי לפתוח את תפריט ה-rewind.

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

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

  • Restore code and conversation: שחזור הן של הקוד והן של השיחה לאותה נקודה
  • Restore conversation: חזרה לאחור לאותה הודעה תוך שמירה על הקוד הנוכחי
  • Restore code: ביטול שינויי הקבצים תוך שמירה על השיחה
  • Summarize from here: כיווץ השיחה מנקודה זו והלאה לסיכום, מה שמפנה מקום בחלון ההקשר (context window)
  • Summarize up to here: כיווץ השיחה שלפני נקודה זו לסיכום, תוך השארת ההודעות המאוחרות יותר ללא שינוי
  • Never mind: חזרה לרשימת ההודעות בלי לבצע שינויים

שתי האפשרויות לשחזור קוד מופיעות רק כאשר בנקודת הביקורת שנבחרה קיימים שינויי קבצים מתועדים שניתן לבטל. אם לא נלכדו עריכות קבצים לאחר אותה נקודה, התפריט מציע רק את Restore conversation, אפשרויות התמצות ו-Never mind.

לאחר שחזור השיחה או בחירה ב-Summarize from here, הבקשה המקורית מההודעה שנבחרה משוחזרת לתוך שדה הקלט, כדי שתוכל לשלוח אותה מחדש או לערוך אותה.

בחירה ב-Summarize up to here משאירה אותך בסוף השיחה כאשר שדה הקלט ריק. בכל אחת מאפשרויות התמצות, מופיע סימון Summarized conversation בשיחה במקום שבו היו ההודעות המכווצות.

#חזרה לאחור מעבר לשיחה שנוקתה

אם הרצת /clear מוקדם יותר באותו תהליך של Claude Code, תפריט ה-rewind מציג רשומה נוספת בראש הרשימה המסומנת בתווית /resume <session-id> (previous session). בחר בה כדי לחדש את השיחה שהייתה פעילה לפני ש-/clear רץ. הרשומה זמינה עד שתצא מ-Claude Code או תחדש session אחר, והיא דורשת את Claude Code בגרסה v2.1.191 ומעלה. בגרסאות מוקדמות יותר, הרץ /resume ובחר את ה-session הקודם מתוך הרשימה במקום זאת.

#הנחיית תמצות

תמצות אינו משנה קבצים בדיסק, וההודעות המקוריות נשארות בתמליל ה-session, כך ש-Claude עדיין יכול להתייחס לפרטים. כדי להנחות במה הסיכום יתמקד, סמן אפשרות Summarize באמצעות מקשי החצים והקלד הנחיות במקום שבו השורה מציינת add context (optional), ולאחר מכן לחץ על Enter. בחירת האפשרות באמצעות מקש המספר שלה מתמצתת מיד ללא הנחיות.

הערה: תמצות משאיר אותך באותו ה-session ומכווץ את ההקשר, בדומה לפעולה ממוקדת של /compact. כדי להסתעף ולנסות גישה שונה תוך שמירה על ה-session המקורי ללא שינוי, השתמש במקום זאת ב-/branch או ב-claude --continue --fork-session.

#תרחישי שימוש נפוצים

נקודות ביקורת שימושיות במיוחד כאשר:

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

#מגבלות

#שינויים של פקודות Bash אינם במעקב

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

rm file.txt
mv old.txt new.txt
cp source.txt dest.txt

שינויי קבצים אלה אינם ניתנים לביטול באמצעות rewind. רק עריכות קבצים ישירות שבוצעו דרך כלי עריכת הקבצים של Claude נמצאות במעקב.

#עריכות של סוכני משנה אינן משוחזרות

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

  • Foreground forked skill: מיומנות עם context: fork שרצה בקדמה (foreground) עורכת את עץ העבודה (working tree) שלך במהלך התור שלך, ולכן פעולת rewind משחזרת את העריכות שלה כרגיל. הגדר background: false כדי להריץ פיצול בקדמה. מספר מצבים, המפורטים בדף המיומנויות, מריצים אותה שם ללא קשר להגדרה.
  • כל סוכן משנה אחר: פעולת rewind אינה משחזרת את העריכות. השתמש ב-git כדי להחזיר אותן לקדמותן. זה כולל מיומנות מפוצלת שרצה ברקע, שהיא ברירת המחדל, והרצה ברקע של /code-review --fix.

#שינויים חיצוניים אינם במעקב

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

#נתיבי קישורים סימבוליים וקישורים קשיחים אינם משוחזרים

מנגנון נקודות הביקורת אינו מחזיר לאחור קבצים מקושרים סימבולית (symlinked) או מקושרים קשיחה (hard-linked). כאשר אתה בוחר ב-Restore code או ב-Restore code and conversation מתוך תפריט /rewind, ה-Claude Code מדלג על כל נתיב במעקב שהוא קישור סימבולי או קישור קשיח ומציג את האזהרה Restored the code, but skipped N files. הקבצים שדולגו שומרים על התוכן הנוכחי שלהם. כדי לבטל את שינויי ה-session באחד מהם, בקש מ-Claude לבטל את העריכה או ערוך את הקובץ בעצמך. קובצי תצורה שמנהל dotfiles מקשר באמצעות symlink לתוך הפרויקט שלך וקבצים ש-pnpm מקשר באמצעות hard link למקומם שייכים שניהם לקטגוריה זו.

כדי לראות על אילו נתיבים השחזור מדלג, הפעל רישום דיבאג עם /debug לפני שאתה משחזר: יומן הדיבאג בנתיב ~/.claude/debug/<session-id>.txt מציין את שמו של כל נתיב שדולג. לכל אחת מסיבות הדילוג וצעדי השחזור, עיין ב-ערך הקבצים שדולגו בהפניות לשגיאות.

#לא תחליף לבקרת גרסאות

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

#ראו גם