פרק 3
עבודה יומיומית ותהליכי פיתוח
מדריכים צעד אחר צעד לחקר מאגרי קוד, תיקון באגים, שיפור מבנה הקוד (refactoring), בדיקות ומשימות יומיומיות נוספות עם קלוד קוד.
הפרק מרכז תבניות מעשיות לפיתוח יומיומי. להנחיות כלליות יותר על כתיבת פרומפטים וניהול הקשר, מומלץ לעיין במדריך שיטות העבודה המומלצות (Best practices).
הנושאים המכוסים בפרק זה:
- תבניות פרומפטים לחקר קוד, תיקון באגים, שיפור מבנה הקוד, בדיקות, יצירת PRs ותיעוד.
- חידוש שיחות קודמות, מתן שם, פיצול סשן וניהול סשנים כדי שמשימה תוכל להתפרס על פני מספר ישיבות.
- הרצת סשנים מקבילים באמצעות worktrees כדי שעריכות מקבילות לא יתנגשו.
- תכנון לפני עריכה כדי לסקור שינויים לפני שהם נכתבים לדיסק.
- האצלת מחקר לסוכני משנה (subagents) כדי לשמור על חלון הקשר ראשי נקי.
- הזרמת פלט לקלוד בסקריפטים (piping) עבור CI ועיבוד באצ'.
#תבניות פרומפטים לתהליכים נפוצים
תבניות פרומפטים אלו מיועדות למשימות יומיומיות כגון חקר קוד לא מוכר, תיקון באגים, שיפור מבנה קוד, כתיבת בדיקות ויצירת PRs. כל תבנית עובדת בכל ממשק של קלוד קוד. התאם את הניסוח לפרויקט שלך.
#הבנת מאגרי קוד חדשים
להגדרת קלוד קוד במונורפו או במאגר קוד גדול, ראה את המדריך למונורפו ומאגרים גדולים.
#קבלת סקירה מהירה של מאגר הקוד
נניח שהצטרפת לפרויקט חדש ועליך להבין את המבנה שלו במהירות:
- ניווט לתיקיית השורש של הפרויקט:
החלף את
/path/to/projectבנתיב לפרויקט שלך.
cd /path/to/project - הפעלת קלוד קוד:
claude - בקשת סקירה כללית ברמה גבוהה:
give me an overview of this codebase- צלילה עמוקה יותר לרכיבים ספציפיים:
explain the main architecture patterns used herewhat are the key data models?how is authentication handled?טיפים:
- התחל בשאלות רחבות, ולאחר מכן צמצם לתחומים ספציפיים.
- שאל על מוסכמות קידוד ותבניות הנהוגות בפרויקט.
- בקש מילון מונחים ספציפיים לפרויקט.
#איתור קוד רלוונטי
נניח שעליך לאתר קוד הקשור לתכונה או לפונקציונליות מסוימת:
- בקש מקלוד למצוא קבצים רלוונטיים:
find the files that handle user authentication- קבל הקשר על האופן שבו רכיבים פועלים יחד:
how do these authentication files work together?- הבנת זרימת הביצוע:
trace the login process from front-end to databaseטיפים:
- היה ספציפי לגבי מה שאתה מחפש.
- השתמש במונחים מתוך הדומיין של הפרויקט.
- התקן תוסף תבונת קוד (code intelligence plugin) עבור שפת הפיתוח שלך כדי לתת לקלוד יכולת ניווט מדויקת של "go to definition" וכן "find references".
#תיקון באגים ביעילות
נניח שנתקלת בהודעת שגיאה ועליך לאתר את המקור שלה ולתקן אותו:
- שתף את השגיאה עם קלוד:
I'm seeing an error when I run npm test- בקש המלצות לתיקון:
suggest a few ways to fix the @ts-ignore in user.ts- החל את התיקון:
update user.ts to add the null check you suggestedטיפים:
- מסור לקלוד את הפקודה לשחזור הבעיה וקבלת stack trace.
- ציין את כל השלבים לשחזור השגיאה.
- עדכן את קלוד אם השגיאה מופיעה לסירוגין או באופן עקבי.
#שיפור מבנה הקוד (Refactoring)
נניח שעליך לעדכן קוד ישן כך שישתמש בתבניות ובפרקטיקות מודרניות. להסבת מאגר קוד שלם לשפה חדשה, ראה כיצד Anthropic מריצה מיגרציות קוד בקנה מידה גדול עם קלוד קוד בבלוג שלהם:
- זיהוי קוד ישן לצורך ארגון מחדש:
find deprecated API usage in our codebase- קבלת המלצות לארגון מחדש:
suggest how to refactor utils.js to use modern JavaScript features- החלת השינויים בצורה בטוחה:
refactor utils.js to use ES2024 features while maintaining the same behavior- אימות השינויים:
run tests for the refactored codeטיפים:
- בקש מקלוד להסביר את היתרונות של הגישה המודרנית.
- בקש שהשינויים ישמרו על תאימות לאחור בעת הצורך.
- בצע refactoring במנות קטנות הניתנות לבדיקה.
#עבודה עם בדיקות
נניח שעליך להוסיף בדיקות עבור קוד שאינו מכוסה:
- זיהוי קוד שאינו נבדק:
find functions in NotificationsService.swift that are not covered by tests- יצירת שלד הבדיקות:
add tests for the notification service- הוספת מקרי בדיקה משמעותיים:
add test cases for edge conditions in the notification service- הרצת הבדיקות ואימותן:
run the new tests and fix any failuresקלוד יכול ליצור בדיקות שעוקבות אחר התבניות והמוסכמות הקיימות בפרויקט שלך. כשאתה מבקש בדיקות, הגדר במפורש איזו התנהגות ברצונך לאמת. קלוד בוחן את קובצי הבדיקות הקיימים שלך כדי להתאים את הסגנון, הספריות (frameworks) ודפוסי הבדיקה (assertions) שכבר בשימוש.
לכיסוי מקיף, בקש מקלוד לזהות מקרי קצה שאולי פספסת. קלוד יכול לנתח את נתיבי הקוד שלך ולהציע בדיקות עבור תנאי שגיאה, ערכי גבול וקלטים בלתי צפויים שקל להתעלם מהם.
#יצירת Pull Requests
ניתן ליצור pull requests על ידי פנייה ישירה לקלוד ("create a pr for my changes"), או להנחות אותו צעד אחר צעד:
- סיכום השינויים שלך:
summarize the changes I've made to the authentication module- יצירת ה-pull request:
create a pr- סקירה וליטוש:
enhance the PR description with more context about the security improvementsכדי לאתר את הסשן מאוחר יותר, הרץ claude --from-pr 1234 עם מספר ה-PR שלך, פעולה הפותחת את בורר הסשנים כשהוא מסונן לסשנים המקושרים לאותו PR, או הדבק את כתובת ה-URL של ה-PR בשדה החיפוש של בורר /resume. קלוד קוד מקשר את הסשן ל-PR כאשר קלוד יוצר אותו באמצעות gh pr create או glab mr create, וכן כאשר קלוד עובד על PR קיים.
טיפ: סקור את ה-PR שקלוד יצר לפני הגשתו, ובקש מקלוד להדגיש סיכונים או שיקולים אפשריים.
#טיפול בתיעוד
נניח שעליך להוסיף או לעדכן תיעוד עבור הקוד שלך:
- זיהוי קוד ללא תיעוד:
find functions without proper JSDoc comments in the auth module- יצירת התיעוד:
add JSDoc comments to the undocumented functions in auth.js- סקירה ושיפור:
improve the generated documentation with more context and examples- אימות התיעוד:
check if the documentation follows our project standardsטיפים:
- הגדר את סגנון התיעוד הרצוי (כגון JSDoc, docstrings ועוד).
- בקש דוגמאות בתוך התיעוד.
- בקש תיעוד עבור ממשקי API ציבוריים, ממשקים ולוגיקה מורכבת.
#עבודה בפתקים ובתיקיות שאינן קוד
קלוד קוד עובד בכל תיקייה. הפעל אותו בתוך מאגר פתקים (notes vault), תיקיית תיעוד או כל אוסף של קובצי Markdown כדי לחפש, לערוך ולארגן מחדש תוכן בדיוק באותו אופן שבו היית עובד עם קוד.
התיקייה .claude/ וקובץ CLAUDE.md יושבים לצד תיקיות הגדרות של כלים אחרים ללא התנגשויות. קלוד קורא קבצים מחדש בכל קריאת כלי, כך שהוא מבחין בעריכות שביצעת ביישום אחר בפעם הבאה שהוא קורא את אותו קובץ.
#עבודה עם תמונות
נניח שעליך לעבוד עם תמונות במאגר הקוד שלך, ואתה מעוניין בעזרתו של קלוד בניתוח תוכן התמונה:
- הוספת תמונה לשיחה:
ניתן להשתמש בכל אחת מהשיטות הבאות:
- גרירה ושחרור של תמונה אל חלון קלוד קוד.
- העתקת תמונה והדבקתה ב-CLI באמצעות
Ctrl+V, או באמצעותAlt+Vב-Windows וב-WSL. - מסירת נתיב התמונה לקלוד, לדוגמה: "Analyze this image: /path/to/your/image.png".
- בקשה מקלוד לנתח את התמונה:
What does this image show?Describe the UI elements in this screenshotAre there any problematic elements in this diagram?- שימוש בתמונות כהקשר:
Here's a screenshot of the error. What's causing it?This is our current database schema. How should we modify it for the new feature?- קבלת הצעות קוד מתוך תוכן חזותי:
Generate CSS to match this design mockupWhat HTML structure would recreate this component?טיפים:
- השתמש בתמונות כאשר תיאור מילולי עלול להיות לא ברור או מסורבל.
- כלול צילומי מסך של שגיאות, עיצובי ממשק משתמש או דיאגרמות לצורך הקשר טוב יותר.
- ניתן לעבוד עם מספר תמונות בשיחה אחת.
- ניתוח תמונות עובד עם דיאגרמות, צילומי מסך, מוקאפים ועוד.
- כאשר קלוד מתייחס לתמונות (למשל
[Image #1]), לחץCmd+Click(ב-Mac) אוCtrl+Click(ב-Windows/Linux) על הקישור כדי לפתוח את התמונה במציג ברירת המחדל שלך.
#אזכור קבצים ותיקיות
השתמש ב-@ כדי לכלול במהירות קבצים או תיקיות מבלי להמתין שקלוד יקרא אותם בעצמו:
- אזכור קובץ בודד:
Explain the logic in @src/utils/auth.jsפעולה זו כוללת את תוכן הקובץ בשיחה כאשר הוא נכנס למגבלת הטוקנים של כלי ה-Read, 25,000 טוקנים כברירת מחדל. קובץ טקסט גדול מ-256KB אינו נכלל.
2. אזכור תיקייה:
What's the structure of @src/components?- אזכור משאבי MCP:
Show me the data from @github:repos/owner/repo/issuesפעולה זו מושכת נתונים משרתי MCP מחוברים במבנה @server:resource. לפרטים נוספים ראה משאבי MCP.
טיפים:
- נתיבי קבצים יכולים להיות יחסיים או מוחלטים.
- הקלדת
@פותחת תפריט הצעות נתיבים. לחץ עלEnterאוTabכדי לאשר את הנתיב המסומן, ולחץ שוב עלEnterכדי לשלוח את ההודעה. - אזכור קבצים עם
@מוסיף להקשר גם את קובץCLAUDE.mdשנמצא בתיקיית הקובץ ובתיקיות האב שלו. - אזכור תיקיות מציג את רשימת הקבצים, ולא את תוכנם.
- ניתן לאזכר מספר קבצים בהודעה אחת (לדוגמה: "@file1.js and @file2.js").
כדי שאזכורי @ לא יכללו את תוכן הקבצים ואת רשימות התיקיות בתוך ההודעה, הגדר CLAUDE_CODE_DISABLE_FILE_MENTIONS ל-1 במעטפת, או בבלוק env של הגדרות user או של הגדרות managed. קלוד מקבל אז את הנתיבים שאזכרת, יחד עם הערה לקרוא אותם באמצעות כלי הקבצים שלו. המשתנה דורש קלוד קוד בגרסה 2.1.299 ומעלה. קלוד קוד מתעלם ממנו בהגדרות project ובהגדרות local.
הוקים מסוג PreToolUse אינם רצים כאשר קלוד קוד כולל קובץ שאזכרת עם @, כי אין כאן קריאת כלי. אם אתה נשען על ההוקים האלה כדי לשלוט במה שקלוד קורא, חסום נתיבים ספציפיים או עצור את הכללת הקבצים מאזכורי @:
- חסימת נתיבים ספציפיים: הוסף כלל deny לכלי
Readעבורם. קלוד קוד אינו כולל קובץ שהכלל תואם לו. - עצירת הכללת קבצים מאזכורי
@: הגדרCLAUDE_CODE_DISABLE_FILE_MENTIONS=1. זה עוצר אזכורי קבצים ותיקיות עם@בהודעות שלך מלהכליל תוכן, גם עבור נתיבים שההוקים שלך אינם בודקים. ההוקים התואמים רצים אז לפני שקלוד פותח נתיב שאזכרת באמצעות כלי כמוRead.
#הרצת קלוד לפי לוח זמנים
נניח שברצונך שקלוד יטפל במשימה באופן אוטומטי ובאופן חוזר, כגון סקירת PRs פתוחים בכל בוקר, בדיקת תלויות שבועית או בדיקת כשלי CI במהלך הלילה. בחר באפשרות תזמון בהתאם למקום שבו תרצה שהמשימה תרוץ:
| אפשרות | היכן היא רצה | מתאימה ביותר עבור |
|---|---|---|
| משימות מתוזמנות בענן (Cloud scheduled tasks) | ענן, בניהול Anthropic כברירת מחדל | משימות שצריכות לרוץ גם כאשר המחשב שלך כבוי. יכולות לפעול גם בעקבות קריאות API או אירועי GitHub בנוסף ללוח זמנים. מוגדרות בכתובת claude.ai/code/routines. |
| משימות מתוזמנות באפליקציית שולחן העבודה (Desktop scheduled tasks) | המחשב שלך, דרך אפליקציית שולחן העבודה | משימות הזקוקות לגישה ישירה לקבצים מקומיים, כלים או שינויים שטרם נשמרו בקומיט. |
| GitHub Actions | צינור ה-CI שלך | משימות הקשורות לאירועי מאגר כמו פתיחת PR, או תזמוני cron שצריכים לשבת לצד הגדרות ה-workflow שלך. |
/loop | סשן ה-CLI הנוכחי | דגימה מהירה (polling) בזמן שסשן פתוח. הפקודות --resume ו---continue משחזרות לולאות במרווח זמן קבוע שטרם פגו. |
טיפ: בעת כתיבת פרומפטים למשימות מתוזמנות, הגדר במפורש כיצד נראית הצלחה ומה יש לעשות עם התוצאות. המשימה רצה באופן אוטונומי, ולכן אינה יכולה לשאול שאלות הבהרה. לדוגמה:
"Review open PRs labeled needs-review, leave inline comments on any issues, and post a summary in the #eng-reviews Slack channel."
#שאלות לקלוד על היכולות שלו
קלוד יכול לענות על שאלות בנוגע לתכונות ולמגבלות שלו. הוא מחפש את התשובות בתיעוד העדכני של קלוד קוד, ולכן הן אינן מוגבלות לגרסה שבה אתה רץ.
#דוגמאות לשאלות
can Claude Code create pull requests?how does Claude Code handle permissions?what skills are available?how do I use MCP with Claude Code?how do I configure Claude Code for Amazon Bedrock?what are the limitations of Claude Code?הערה: קלוד מספק תשובות מבוססות תיעוד לשאלות אלו. להדגמות מעשיות, הרץ /powerup כדי לקבל שיעורים אינטראקטיביים עם הדגמות מונפשות, או עיין בסעיפי תהליכי העבודה הספציפיים למעלה.
טיפים:
- שאל שאלות ספציפיות כדי לקבל תשובות מפורטות.
- קלוד יכול להסביר תכונות מורכבות כמו שילוב MCP, הגדרות ארגוניות ותהליכי עבודה מתקדמים.
#חידוש שיחות קודמות
כשמשימה נמשכת על פני כמה ישיבות, ממשיכים מהמקום שבו עצרת במקום להסביר את ההקשר מחדש. קלוד קוד שומר כל שיחה באופן מקומי.
claude --continueהפקודה מחדשת את הסשן האחרון בתיקייה הנוכחית. אם עדיין אין סשן כזה, היא מדפיסה No conversation found to continue ויוצאת. claude --resume פותחת רשימה לבחירה, ו-/resume מתוך סשן שרץ עוברת לשיחה אחרת. מתן שם, פיצול והפניה המלאה לבורר מופיעים בהמשך הפרק.
#הרצת סשנים מקבילים עם worktrees
אפשר לעבוד על תכונה בטרמינל אחד בזמן שקלוד מתקן באג בטרמינל אחר, בלי שהעריכות יתנגשו. כל git worktree הוא checkout נפרד על ענף משלו, שנוצר מקומיט קיים, ולכן המאגר צריך לפחות קומיט אחד לפני כן.
claude --worktree feature-authמריצים את אותה פקודה עם שם אחר בטרמינל שני כדי לפתוח סשן מקביל מבודד. במאגר בלי קומיטים הפקודה נכשלת עם Failed to resolve base branch "HEAD": git rev-parse failed. ניקוי, .worktreeinclude ותמיכה ב-VCS שאינו Git מתוארים בתיעוד ה-Worktrees. למעקב אחרי סשנים מקבילים ממסך אחד במקום מטרמינלים נפרדים, ראה סוכני רקע (background agents).
#תכנון לפני עריכה
לשינויים שרוצים לסקור לפני שהם נכתבים לדיסק, עוברים למצב תכנון. קלוד קורא קבצים ומציע תכנון, ואינו מבצע עריכות עד שמאשרים. שורת הסטטוס מציגה ⏸ plan mode on כשמצב התכנון פעיל.
claude --permission-mode planאפשר גם ללחוץ Shift+Tab באמצע הסשן עד ששורת הסטטוס מציגה ⏸ plan mode on. זרימת האישור ועריכת התכנון בעורך הטקסט מתוארות בתיעוד מצב התכנון (Plan mode).
#האצלת מחקר לסוכני משנה
חקירת מאגר גדול ממלאת את ההקשר בקריאות קבצים. מעבירים את החקירה לסוכן משנה כדי שרק הממצאים יחזרו.
use a subagent to investigate how our auth system handles token refreshסוכן המשנה קורא קבצים בחלון ההקשר שלו ומחזיר סיכום. הגדרת סוכנים מותאמים עם כלים ופרומפטים משלהם מתוארת בתיעוד סוכני המשנה (Subagents).
#הזרמת פלט לקלוד בסקריפטים
מריצים את קלוד באופן לא אינטראקטיבי עבור CI, pre-commit hooks או עיבוד באצ'. stdin ו-stdout פועלים כמו כל כלי Unix.
git log --oneline -20 | claude -p "summarize these recent commits"פורמטי פלט, דגלי הרשאות ודפוסי fan-out מתוארים בתיעוד המצב הלא אינטראקטיבי.
#חידוש שיחות קודמות וניהול סשנים
סשן הוא שיחה שמורה המשויכת לתיקיית פרויקט. קלוד קוד שומר אותה באופן מקומי תוך כדי עבודה, כך שאפשר להמשיך מהמקום שבו עצרת, לפצל ענף כדי לנסות גישה אחרת, או לעבור בין משימות.
אפליקציית שולחן העבודה, claude.ai/code ותוסף VS Code מנהלים כל אחד היסטוריית סשנים נפרדת, ואפליקציית שולחן העבודה יכולה גם לחדש סשן CLI. הסעיפים הבאים מתמקדים ב-CLI.
#חידוש סשן
הסשנים נשמרים באופן רציף לקובצי transcript מקומיים תוך כדי עבודה, כך שאפשר לחזור אליהם אחרי יציאה או אחרי הרצת /clear. נקודות הכניסה:
| פקודה | מה היא עושה |
|---|---|
claude --continue | פותחת מחדש את הסשן האחרון בתיקייה הנוכחית |
claude --resume | פותחת את בורר הסשנים |
claude --resume <name> | מחדשת ישירות את הסשן בעל השם |
claude --resume <transcript-path> | מחדשת את השיחה השמורה בקובץ ה-transcript מסוג .jsonl בנתיב מוחלט זה |
claude --from-pr <number> | פותחת את בורר הסשנים כשהוא מסונן לסשנים המקושרים לאותו pull request |
/resume | עוברת לשיחה אחרת מתוך סשן פעיל |
מתוך סשן שרץ, /resume עוברת לשיחה אחרת. מתן שם, פיצול והפניה המלאה לבורר הסשנים מופיעים בהמשך הפרק.
#חידוש סשן רקע שעדיין רץ
כאשר השיחה שמחדשים עם claude --resume או עם /resume שייכת לסשן רקע שעדיין רץ, קלוד קוד פותח את הסשן הרץ עצמו. עם --bg בשורת הפקודה, החידוש מתבצע כשיגור ברקע במקום זאת. לפני גרסה 2.1.285, קלוד קוד סירב לבצע את הפעולה והורה לפתוח את הסשן עם claude attach <id>, או לעצור אותו תחילה עם claude stop <id>.
מהמעטפת: הרצת
claude --resume <session>מפעילהclaude attachעל אותו סשן באותו טרמינל במקום לטעון את ה-transcript בעצמה. פרומפט שמועבר בשורת הפקודה, כמו ב-claude --resume <session> "check the tests too", נשלח תחילה אל הסשן כתור הבא שלו, וקלוד קוד מדפיסSent your prompt to the background session (<id>); opening it…לפני ההתחברות. הרצתclaude -p --resume <session> "prompt"המוקלדת בטרמינל פועלת באותו אופן, ולכן-pאינו משאיר הרצה זו במצב לא אינטראקטיבי.קלוד קוד אינו פותח את הסשן כאשר שורת הפקודה כוללת אחד מהבאים:
- קלט או פלט בצינור (piped) או בהפניה (redirected).
- דגלים המגדירים את הסשן, כגון
--permission-mode,--model, או--settings. - דגלים הקוראים את הפלט, כגון
--output-format jsonאו--json-schema. - דגלים המגבילים או מחזירים לאחור את ההרצה, כגון
--max-turnsאו--max-budget-usd.
בכל אחד מהמקרים האלה, או כאשר agent view כבוי, קלוד קוד אינו שולח דבר ויוצא עם קוד סטטוס 1. הוא מדפיס שהסשן רץ ברקע יחד עם פקודת
claude attach <id>שפותחת אותו, או מורה לאתר אותו ב-claude agentsכאשר אין באפשרותו לקבוע את המזהה. הוסף--fork-sessionכדי לחדש עותק של השיחה במקום זאת. כדי להמשיך את השיחה עצמה בסשן משלך, עם החלת הדגלים שלך, הרץclaude stop <id>ולאחר מכן חזור על הפקודה.פרומפט שמתחיל ב-
/או ב-!אינו נשלח, וכן לא נשלח שום פרומפט בזמן שהסשן ממתין לתשובתך על שאלה. בשני המקרים קלוד קוד אינו פותח את הסשן, וההודעה כוללת את המשפטYour prompt was not sent to itיחד עם הסיבה.מתוך סשן: הפקודה
/resumeמעבירה את השיחה הנוכחית שלך לרקע ומחברת טרמינל זה לסשן הרץ, תוך הדפסת ההודעהOpening "<title>", running in the background (<id>). לחיצה על←בפרומפט ריק מחזירה ל-agent view, שמציג גם את השיחה שעזבת. כאשר השיחה הנוכחית אינה יכולה לעבור לרקע, למשל מפני שאתה כבר מחובר לסשן רקע או ששמירת סשנים כבויה,/resumeמדפיסה במקום זאת את פקודתclaude attachשיש להריץ.
#מה משוחזר בסשן שחודש
כאשר קלוד קוד טוען שיחה מקובץ ה-transcript שלה, הסשן שחודש משחזר את השיחה יחד עם המצב שנשמר בה:
- היסטוריית שיחה: ההודעות, קריאות הכלים והתוצאות. אם הסשן עבר compaction, השיחה נפתחת בשורה
Conversation compacted. קלוד ממשיך עם סיכום ה-compaction האחרון, עם ההודעות שה-compaction השאיר בלי סיכום, ועם כל הודעה מאז. ההודעות שסוכמו ב-compaction האחרון אינן נטענות שוב. - קריאות כלים שנקטעו: כלי שעדיין רץ כשהתהליך הקודם הסתיים, למשל בקרישה, אינו מורץ שוב בחידוש.
- מודל: הסשן ממשיך במודל שבו השתמש, למעט המקרים שבתיעוד הרשמי של הגדרת מודל.
- סוכן (Agent): סשן שהתחיל עם
--agentאו עם הגדרתagentממשיך כאותו סוכן, כולל הגבלות הכלים והמודל שלו. אפשר להעביר--agentבחידוש כדי לבחור סוכן אחר. לגבי פרומפט המערכת בשני המקרים, ראה בתיעוד הרשמי של ה-CLI את הסעיף על דגלי פרומפט מערכת בשיחות שחודשו. קלוד קוד מחפש את הסוכן בשני מקומות: בתיקייה המקורית של הסשן (אם יש אמון ב-workspace), ואחר כך בתיקייה שממנה מחדשים, כך שסוכן ברמת פרויקט נטען גם בחידוש מתיקייה אחרת. אם קלוד קוד אינו מוצא את הסוכן באף אחד מהמקומות, הסשן מתחדש עם כלי ברירת המחדל ומוצגת אזהרה עם שם הסוכן. - מצב הרשאות (Permission mode): בחידוש מטרמינל עם
claude --continue,claude --resume <session-id>, אוclaude --resume <name>כאשר השם תואם לסשן יחיד, ובלי-p, קלוד קוד משחזר את מצב ההרשאות שבו היה הסשן, למעט המקרים שבסעיף מצב ההרשאות בעת חידוש. הסעיף הזה מכסה גם את בורר הסשנים, את/resume, וחידוש עםclaude -p. אפשר להעביר--permission-modeאו--dangerously-skip-permissionsכדי לדרוס את המצב המשוחזר. - יעד פעיל (Active goal): יעד שהיה פעיל כשהסשן הסתיים ממשיך לפעול. מונה התורות, הטיימר וחישוב צריכת הטוקנים מתאפסים.
- משימות מתוזמנות ברמת הסשן: משימות שטרם פגו משוחזרות. משימות Bash ומעקב ברקע אינן משוחזרות.
- עבודת רקע: סוכן משנה ברקע, פקודת Bash ברקע, או workflow שהסתיימו עם התהליך הקודם מופיעים ב-transcript שחודש כהערה שהעבודה לא הסתיימה. קלוד קוד אינו פותח תור חדש מההערות האלה. קלוד קורא אותן יחד עם ההנחיה הבאה שלך.
דגלי הגדרה מההרצה המקורית אינם משוחזרים במלואם. אם הסשן היה תלוי ב---mcp-config, --settings, --plugin-dir, --fallback-model, או בתיקיות שנוספו עם --add-dir, יש להעביר אותם שוב בחידוש. תיקיות שנוספו באמצע סשן עם /add-dir אינן משוחזרות (בורר הסשנים עדיין משתמש בהן לאיתור הסשן). קובצי הגדרות סטנדרטיים, כמו settings.json ו-settings.local.json, נקראים מחדש בהפעלה, ולכן הגדרה שחיה בהם אינה דורשת העברה מחדש. לגבי --system-prompt ו---append-system-prompt, ראה בתיעוד הרשמי של ה-CLI את הסעיף על דגלי פרומפט מערכת בשיחות שחודשו.
#מצב הרשאות בעת חידוש
מצב ההרשאות שבו קלוד קוד מתחיל סשן שחודש תלוי בדרך החידוש. המקרים להלן חלים כאשר קלוד קוד טוען את השיחה מקובץ ה-transcript שלה. כאשר פותחים במקום זאת סשן רקע שעדיין רץ, אותו סשן שומר על מצב ההרשאות שבו הוא נמצא:
- טרמינל:
claude --continue,claude --resume <session-id>, אוclaude --resume <name>כאשר השם תואם לסשן יחיד, ובלי-p. קלוד קוד משחזר את מצב ההרשאות שבו היה הסשן, למעט המקרים בטבלה. אפשר להעביר--permission-modeאו--dangerously-skip-permissionsכדי לדרוס את המצב המשוחזר. - לא אינטראקטיבי:
claude -p --resumeאוclaude -p --continue. קלוד קוד מתחיל את ההרצה במצב ההרשאות שבו הייתה מתחילה הרצתclaude -pחדשה, למעט סשן שהסתיים במצב תכנון ומתחדש במצב תכנון לפי התנאים בהמשך. - VS Code: חלונית השיחה של התוסף. הטבלה מכסה רק שיחה שהסתיימה במצב תכנון. לשאר המקרים ראה את תיעוד חידוש שיחות ב-VS Code.
- בורר הסשנים בהפעלה: סשן שנבחר מבורר הסשנים, בין אם נפתח עם
claude --resumeלבד, עםclaude --from-pr, או עם שם שתואם ליותר מסשן אחד. קלוד קוד מתחיל את הסשן במצב ההרשאות שבו היה מתחיל סשן חדש מאותה שורת פקודה, למעט סשן שהסתיים במצב תכנון: הוא מתחדש במצב תכנון, אלא אם מעבירים--permission-mode,--dangerously-skip-permissions, או--fork-session. שום מצב הרשאות שמור אחר אינו משוחזר. /resumeמתוך סשן, עם ארגומנט או בלעדיו: השיחה שאליה עוברים ממשיכה במצב ההרשאות של הסשן הנוכחי, למעט שיחה שהסתיימה במצב תכנון: היא מתחדשת במצב תכנון, גם אם הפעלת את קלוד קוד עם--permission-modeאו--dangerously-skip-permissions. אם השיחה הזו כבר הייתה פתוחה קודם באותה הרצה של קלוד קוד, למשל השיחה שהתחלת בה או שיחה שעזבת עם/clearאו/resume, היא ממשיכה במצב ההרשאות הנוכחי שלך במקום זאת.
אם כלל deny מסיר את הכלי ExitPlanMode, קלוד אינו יכול להציג תכנון לאישור, ולכן קלוד קוד אינו משחזר מצב תכנון. הסשן מתחיל במצב ההרשאות שבו סשן חדש היה מתחיל מאותה שורת פקודה. עם /resume, השיחה ממשיכה במצב ההרשאות הנוכחי שלך.
שחזור מצב תכנון בנתיבים הלא אינטראקטיביים וב-VS Code דורש קלוד קוד בגרסה 2.1.246 ומעלה. כל שורה בטבלה מציינת באיזה מצב הסשן הסתיים, באיזה נתיב מחדשים אותו מבין טרמינל, לא אינטראקטיבי ו-VS Code, ובאיזה מצב קלוד קוד מתחיל את הסשן המחודש.
| הסשן הסתיים במצב | איך מחדשים | מצב הרשאות אחרי החידוש |
|---|---|---|
bypassPermissions | טרמינל | מצב ההרשאות שבו סשן חדש היה מתחיל. כדי לעקוף הרשאות שוב, יש להפעיל זאת בהפעלה עם אחד מדגלי ההפעלה או עם permissions.defaultMode: "bypassPermissions" בהגדרות user, --settings, או managed |
plan | טרמינל | מצב תכנון. עם --fork-session, מצב ההרשאות שבו סשן חדש היה מתחיל |
plan | טרמינל, כאשר כלל deny מסיר את ExitPlanMode | מצב ההרשאות שבו סשן חדש היה מתחיל |
auto | טרמינל | auto, רק כאשר החשבון עדיין עומד בדרישות מצב auto |
| ידני | טרמינל | ידני, כאשר סשן חדש היה מתחיל במצב auto לפי ברירת המחדל המובנית. כאשר defaultMode מקובץ הגדרות נכנס לתוקף, קלוד קוד מתחיל את הסשן המחודש במצב שהוגדר שם במקום זאת |
plan | לא אינטראקטיבי, לפי התנאים בהמשך | מצב תכנון |
| כל מצב | לא אינטראקטיבי, בכל מקרה אחר | מצב ההרשאות שבו הרצת claude -p חדשה הייתה מתחילה |
plan | VS Code | מצב תכנון, עם החריגים שמופיעים בדף VS Code בתיעוד הרשמי |
#חידוש במצב תכנון עם -p
הרצת claude -p --resume או claude -p --continue מתחדשת במצב תכנון רק כאשר כל התנאים האלה מתקיימים:
- מעבירים
--permission-prompt-toolולא מעבירים--permission-prompts none, כדי שקלוד קוד יוכל להציג את התכנון לאישור - לא מעבירים
--permission-modeאו--dangerously-skip-permissions - לא מעבירים
--fork-session - ההרצה לא התחילה דרך channels
- אין כלל deny שמסיר את הכלי
ExitPlanMode
#דיאלוג "Resume this conversation?"
אם מופיע הדיאלוג "Resume this conversation?" בזמן חידוש סשן, האומדן שבו הוא החלק ממגבלת השימוש של 5 השעות שהשיחה השמורה לבדה הייתה צורכת. האומדן אינו סופר את מה שכבר נוצל.
בתוכניות Pro, Max ו-Ultra, הדיאלוג יכול להופיע כשמחדשים שיחה ארוכה אחרי הפסקה ארוכה, או על מודל אחר. הצריכה המשוערת מגיעה כששולחים את ההודעה הראשונה אחרי Resume, לא כשבוחרים באפשרות. בוחרים לפי השאלה אם המשימה הבאה עדיין צריכה את השיחה השמורה:
- Resume: ממשיכים לעבוד בשיחה השמורה.
- Start a new conversation: עוברים לעבודה שאינה צריכה את השיחה השמורה. כדי לפתוח אותה מאוחר יותר, מריצים
/resumeבפרומפט. האומדן אינו חל על ההודעה הראשונה בשיחה החדשה. אם האפשרות אומרת שקלוד יכול לחפש את השיחה הזו, עדיין אפשר להתייחס לעבודה קודמת בשיחה החדשה.
#איפה בורר הסשנים מחפש
קלוד קוד שומר סשנים לפי תיקיית פרויקט. כברירת מחדל הבורר מציג:
- סשנים מה-worktree הנוכחי, כולל סשני רקע, שמסומנים
bgברשימה. - סשנים שהתחילו במקום אחר והוסיפו את התיקייה הנוכחית עם
/add-dir.
השתמש ב-Ctrl+W כדי להרחיב לכל ה-worktrees של המאגר, או ב-Ctrl+A כדי להרחיב לכל פרויקט במכונה זו.
#/loop, -p, Agent SDK וסשני רקע
סשנים שהפרומפט הראשון שלהם היה פקודת /loop אינם מופיעים בבורר, וגם claude --continue מדלגת עליהם. הרצת /loop בהמשך השיחה אינה מסתירה את הסשן.
קלוד קוד משמיט מבורר הסשנים ומפקודת claude --continue שיחות שנוצרו באמצעות claude -p או באמצעות ה-Agent SDK. עדיין אפשר לחדש סשן כזה על ידי העברת מזהה הסשן שלו אל claude --resume <session-id>. בהרצת claude -p --continue, קלוד קוד כולל סשנים של -p, של ה-SDK ושל /loop.
claude --continue פותחת סשן רקע שהסתיים, אך לא סשן שעדיין רץ ברקע. פתיחת סשן רקע שהסתיים דורשת קלוד קוד בגרסה 2.1.257 ומעלה. אם השיחה האחרונה שלך היא כזו שהעברת לרקע והיא עדיין רצה שם, קלוד קוד יוצא עם ההודעה Your most recent conversation is running in the background ומציג את מזהה הסשן. במצב זה אפשר להתחבר אל הסשן מתוך claude agents, או להריץ claude --resume כדי לבחור סשן אחר.
#סשנים ב-worktrees ובפרויקטים אחרים
כשבוחרים סשן מ-worktree אחר של אותו מאגר, קלוד קוד מחדש אותו במקומו. כש-worktree של הסשן עצמו כבר לא קיים, קלוד קוד מחדש אותו בתיקייה הנוכחית. כשבוחרים סשן מפרויקט לא קשור, קלוד קוד מעתיק ללוח פקודת cd וחידוש. אם תיקיית הפרויקט ההוא כבר לא קיימת, קלוד קוד מחדש את הסשן בתיקייה הנוכחית, במקום להעתיק פקודת cd שהייתה נכשלת.
העברת סשן עם /cd מעבירה אותו לאחסון הפרויקט של התיקייה החדשה, והוא מופיע אחר כך בבורר של התיקייה הזו.
#חידוש לפי מזהה סשן או לפי שם
אפשר להריץ claude --resume <session-id> מכל תיקייה, כך שניתן לחדש סשן שהתחיל במקום אחר או שהועבר באמצעות /cd. קלוד קוד מחפש את המזהה לפי הסדר הבא:
- תיקיית הפרויקט הנוכחית ו-git worktrees שלה
- כל שאר הפרויקטים במכונה זו
החיפוש הבין-פרויקטי מפענח את המזהה רק כאשר בדיוק פרויקט אחד אחר מכיל transcript עם הודעות עבורו, כך שעותק ששוכפל ידנית גורם לקלוד קוד לדווח שהסשן לא נמצא במקום לחדש עותק שרירותי. אם אין סשן שמור שתואם למזהה, קלוד קוד מדווח: No conversation found with session ID: <session-id>.
חידוש לפי שם נפתר על פני המאגר הנוכחי וה-worktrees שלו. בשתי הצורות מתבצע חיפוש התאמה מדויקת, והסשן מתחדש ישירות גם אם הוא יושב ב-worktree אחר:
| פקודה | התאמה מדויקת | שם דו-משמעי |
|---|---|---|
claude --resume <name> | מחדשת ישירות | פותחת את בורר הסשנים עם השם ממולא מראש כמונח חיפוש |
/resume <name> | מחדשת ישירות | מדווחת שגיאה, יש להריץ /resume בלי ארגומנט כדי לפתוח את בורר הסשנים |
#מתן שם לסשנים
תן לסשנים שמות תיאוריים כדי למצוא אותם בבורר ולחדש אותם לפי שם. זה חשוב במיוחד כשעובדים על כמה משימות במקביל.
| מתי | איך מגדירים את השם |
|---|---|
| בהפעלה | claude -n auth-refactor |
| במהלך סשן | /rename auth-refactor. השם מופיע גם בשורת הפרומפט |
| מבורר הסשנים | סמן סשן ולחץ Ctrl+R |
| באישור תכנון | אישור תכנון במצב plan נותן לסשן כותרת שנוצרה לפי התכנון, אלא אם כבר נתת לו שם |
| מ-claude.ai או מאפליקציית Claude | שינוי שם של סשן Remote Control, קלוד קוד מחיל את אותו שם ב-CLI. דורש גרסה 2.1.221 ומעלה |
| מאפליקציית שולחן העבודה | שינוי שם של סשן באפליקציית שולחן העבודה |
אחרי שנתת שם דרך נתיב CLI או מ-claude.ai, חוזרים אליו עם claude --resume <name> או /resume <name>. סשן של אפליקציית שולחן העבודה מתחדש באפליקציית שולחן העבודה. אופן פתרון השם על פני worktrees מתואר בסעיף חידוש סשן.
סשן שלא נתת לו שם מקבל שני תוויות שקלוד קוד מקצה. רק הכותרת שנוצרה משמשת מזהה לחידוש:
שם תצוגה של ברירת מחדל: סשן אינטראקטיבי שלא נתת לו שם מקבל שם תצוגה כשהוא מתחיל. ברירת המחדל משלבת את שם תיקיית העבודה עם סיומת בת שני תווים, למשל
my-app-3f, ומזהה את הסשן ברשימות של סשנים רצים, כמו agent view ופלט שלclaude agents --json. ברירת המחדל אינה מזהה לחידוש. אם מעבירים אותה ל-claude --resumeאו ל-/resume, קלוד קוד אינו מוצא את הסשן.כותרת שנוצרה: אם לא נתת שם, קלוד קוד יוצר כותרת לסשן. הכותרת היא סיכום קצר של הפרומפט הראשון, שנכתב בבקשת רקע למודל הקטן והמהיר, בדרך כלל מודל ממחלקת Haiku. הרצת
claude -pשמתחילים ישירות ממעטפת או מסקריפט אינה מקבלת כותרת כזו.אישור תכנון מחליף את הכותרת שנוצרה בכותרת שמבוססת על התכנון. אפשר להעביר כל אחת מהכותרות ל-
claude --resumeאו ל-/resume, וקלוד קוד פותר אותה באותו אופן כמו שם שהגדרת.
מלכודות:
claude --continueמדלגת על סשן רקע שעדיין רץ, על סשן שהתחיל ב-/loop, ועל סשנים שלclaude -pושל ה-Agent SDK. אם אין סשן להמשך, היא מדפיסהNo conversation found to continueויוצאת. אם השיחה האחרונה היא סשן רקע שעדיין רץ, קלוד קוד יוצא עםYour most recent conversation is running in the backgroundומציג את מזהה הסשן.- חידוש סשן רקע שעדיין רץ מתוך המעטפת מפעיל
claude attach. אם שורת הפקודה מכילה דגלי הגדרה, דגלי קריאת פלט, דגלי הגבלת ריצה או צינורות קלט ופלט, קלוד קוד אינו שולח דבר ויוצא עם שגיאה. - מתוך סשן פעיל, הרצת
/resumeעל סשן רקע רץ מעבירה את הסשן הנוכחי שלך לרקע ומתחברת לסשן הרץ. - דגלים כמו
--mcp-configו---add-dirדורשים העברה מחדש בחידוש. - בטרמינל, סשן שהסתיים ב-
bypassPermissionsנפתח במצב של סשן חדש. סשן שהסתיים ב-planנפתח במצב תכנון, ועם--fork-sessionבמצב של סשן חדש. אם כלל deny מסיר אתExitPlanMode, גם סשן שהסתיים ב-planנפתח במצב של סשן חדש. סשן רקע שעדיין רץ שומר על מצבו. - בחירה מבורר הסשנים בהפעלה משחזרת מצב תכנון, אלא אם מעבירים
--permission-mode,--dangerously-skip-permissions, או--fork-session, או שכלל deny מסיר אתExitPlanMode. שאר מצבי ההרשאות השמורים אינם משוחזרים בנתיב הזה. /resumeמתוך סשן מחזיר שיחה שהסתיימה במצב תכנון למצב תכנון, גם אם ההפעלה כללה--permission-modeאו--dangerously-skip-permissions. אם כלל deny מסיר אתExitPlanMode, השיחה ממשיכה במצב ההרשאות הנוכחי. שיחה שכבר הייתה פתוחה באותה הרצה, למשל אחרי/clearאו/resume, נשארת במצב ההרשאות הנוכחי.- בדיאלוג "Resume this conversation?" האומדן הוא חלק ממגבלת 5 השעות של השיחה השמורה לבדה, בלי מה שכבר נוצל. הצריכה המשוערת מתרחשת בהודעה הראשונה אחרי Resume, לא ברגע הבחירה. Start a new conversation פותח שיחה שהאומדן אינו חל על ההודעה הראשונה שלה, ו-
/resumeמחזיר אחר כך לשיחה השמורה. בתוכניות Pro, Max ו-Ultra הדיאלוג יכול להופיע אחרי הפסקה ארוכה או במעבר למודל אחר. - שם דו-משמעי ב-
/resume <name>מחזיר שגיאה. אותו שם ב-claude --resume <name>פותח את הבורר. - שם תצוגה כמו
my-app-3fאינו פותח את הסשן בחידוש. כותרת שנוצרה כן פותחת אותו. - בבורר,
jו-kמזיזים בין שורות, וספרות1עד9מחדשות לפי מיקום. התווים האלה אינם פותחים חיפוש. CLAUDE_CODE_DISABLE_FILE_MENTIONS=1נקרא מהמעטפת, או מבלוקenvשל הגדרות user או של הגדרות managed. בהגדרות project או local קלוד קוד מתעלם ממנו. דורש גרסה 2.1.299 ומעלה. כשהמשתנה פעיל, אזכור@אינו כולל תוכן קובץ, ולכן הוקPreToolUseכן רץ לפני שקלוד פותח את הנתיב בכלי כמוRead. בלי המשתנה, הכללת הקובץ מאזכור@אינה קריאת כלי, וההוק אינו רץ. כלל deny עלReadמונע הכללה של נתיב תואם גם בלי המשתנה.- אחרי compaction, חידוש אינו מחזיר את ההודעות שסוכמו. נשארים סיכום ה-compaction האחרון, מה שהושאר בלי סיכום, ומה שנכתב מאז, והשיחה נפתחת בשורה
Conversation compacted.
#שימוש בבורר הסשנים
הרץ /resume מתוך סשן, או claude --resume בלי ארגומנטים, כדי לפתוח את בורר הסשנים האינטראקטיבי. השתמש בקיצורי מקשים אלה לניווט, חיפוש והרחבת הרשימה:
| קיצור | פעולה |
|---|---|
↑ / ↓ או k / j | מעבר בין סשנים |
→ / ← | פתיחה או סגירה של סשנים מקובצים |
Enter | חידוש הסשן המסומן |
1 עד 9 | חידוש הסשן במיקום הזה ברשימה |
Space | תצוגה מקדימה של תוכן הסשן. Ctrl+V עובד גם בטרמינלים שלא תופסים אותו כהדבקה |
Ctrl+R | שינוי שם של הסשן המסומן |
/ או כל תו להדפסה מלבד Space, j, k או ספרה | כניסה למצב חיפוש וסינון סשנים. הדבקת URL של pull request או merge request מ-GitHub, GitHub Enterprise, GitLab או Bitbucket מאתרת את הסשן שיצר אותו |
Ctrl+A | הצגת סשנים מכל הפרויקטים במכונה. לחיצה נוספת מחזירה למאגר הנוכחי |
Ctrl+W | הצגת סשנים מכל ה-worktrees של המאגר הנוכחי. לחיצה נוספת מחזירה ל-worktree הנוכחי. מוצג רק במאגר עם כמה worktrees |
Ctrl+B | סינון לסשנים מענף ה-git הנוכחי. לחיצה נוספת מציגה את כל הענפים |
Esc | יציאה מבורר הסשנים או ממצב חיפוש |
כל שורה מציגה את שם הסשן אם הגדרת אחד, ואחרת את כותרת הסשן שנוצרה על ידי AI, סיכום השיחה, או הפרומפט הראשון, יחד עם הזמן מאז הפעילות האחרונה, ענף ה-git וגודל הקובץ.
סשנים שנוצרו עם /branch או --fork-session מקבלים מזהי סשן משלהם ומופיעים כשורות נפרדות. כשהבורר מוצא יותר מרשומה אחת לאותו סשן, הוא מקבץ אותן תחת שורה אחת. לחץ → כדי לפתוח קבוצה.
אם קלוד קוד אינו יכול לטעון את הסשן שנבחר מבורר claude --resume, הוא מדפיס Failed to resume the conversation עם פקודה לניסיון חוזר, ואז יוצא עם קוד 1. מבורר /resume שבתוך סשן, קלוד קוד מדווח על הכישלון והשיחה הנוכחית ממשיכה לרוץ.
#פיצול סשן
פיצול יוצר עותק של השיחה עד כה ומעביר אותך אליו, ומשאיר את המקור שלם. משתמשים בזה כדי לנסות גישה אחרת בלי לאבד את המסלול שבו היית.
מתוך סשן, הרץ /branch עם שם אופציונלי:
/branch try-streaming-approachאם משמיטים את השם, קלוד קוד קורא לענף החדש על שם הפרומפט הראשון בשיחה.
משורת הפקודה, שלב --continue או --resume עם --fork-session:
claude --continue --fork-sessionאישור /branch מדפיס שני מזהי סשן: הענף החדש שבו אתה נמצא עכשיו, והמקור. המקור אינו משתנה על הדיסק ונשאר בבורר הסשנים. חוזרים אליו עם /resume <original-name> או על ידי העברת המזהה שלו ל-/resume.
/branch מעתיק את ה-transcript ומעביר את תהליך קלוד קוד הרץ לכתוב אליו. ההבחנה הזו קובעת מה הענף יורש:
| מצב | אחרי /branch |
|---|---|
| היסטוריית שיחה | מועתקת לענף עד הנקודה שבה הרצת /branch |
| הרשאות "Allow for this session" | עוברות הלאה. הענף רץ באותו תהליך, ולכן ההרשאות הקיימות עדיין חלות. אם מפצלים לתהליך נפרד עם --fork-session, התהליך החדש מתחיל בלעדיהן ויש לאשר מחדש שם |
| סוכני משנה ברקע ופקודות Bash ברקע שעדיין רצים | ממשיכים לרוץ. הפלט שלהם מופיע בענף החדש שעברת אליו, ולא בסשן המקורי |
| חיבור Remote Control | נשאר מחובר. טלפון או דפדפן שהיו מחוברים לסשן עוברים איתך לענף וממשיכים לקבל שם הודעות חדשות |
אם מחדשים את אותו סשן בשני טרמינלים בלי פיצול, הודעות משניהם נשזרות לתוך transcript אחד. לחזרה מבוססת checkpoint בתוך סשן יחיד, ראה את תיעוד ה-Checkpointing.
#ניהול הקשר בתוך סשן
הפקודות האלה שולטות במה שנמצא בחלון ההקשר בלי לעזוב את הסשן:
/clear: מתחיל מחדש עם הקשר ריק. קלוד קוד שומר את השיחה הקודמת. מחדשים אותה עם/resume, או, באותו תהליך של קלוד קוד, מרשומת הסשן הקודם בתפריט ה-rewind. בלי ארגומנט, השיחה החדשה שומרת שם שהוגדר עם--nameאו/rename, אבל לא כותרת סשן שנוצרה על ידי AI. כדי לתת שם לשיחה שאתה עוזב, העבר את השם, כמו ב-/clear release-prep. השיחה החדשה מתחילה אז בלי שם./compact [instructions]: מחליף את ההיסטוריה בסיכום, ואפשר למקד אותו במה שתציין./context: מציג מה צורך כרגע הקשר.
איך compaction מקיים אינטראקציה עם CLAUDE.md, skills ו-rules מתואר במדריך חלון ההקשר. מתי לנקות ומתי לדחוס מתואר בשיטות העבודה המומלצות.
#ייצוא ואיתור נתוני סשן
הרץ /export כדי לפתוח תפריט שמעתיק את השיחה הנוכחית ללוח, או שומר אותה כקובץ טקסט רגיל, כשהודעות ופלטי כלים מוצגים כטקסט קריא. העבר שם קובץ כדי לדלג על התפריט ולכתוב ישירות לקובץ הזה.
#גישה לשיחות מסקריפטים
/export מייצר transcript מעובד לקריאה של אדם. הממשקים הבאים מייצרים נתונים מובנים שסקריפט יכול לפרק: תוצאת JSON מהרצה, הנתיב לקובץ ה-transcript של סשן, או זרם אירועים חי. הבחירה לפי מה שמפעיל את הסקריפט:
- להריץ את קלוד פעם אחת וללכוד את התוצאה: הפעל
claude -pעם--output-format jsonאוstream-jsonכדי ללכוד את התוצאה, מזהה הסשן, השימוש והעלות של הרצה לא אינטראקטיבית כ-JSON מובנה. - לשאול סשן קיים שאלה: העבר מזהה סשן ל-
claude -p --resumeכדי לשלוח פרומפט המשך, למשל בקשת סיכום, וללכוד את התשובה המובנית. - להגיב לאירועי סשן: קרא את השדה
transcript_pathש-hooks ופקודות status line מקבלים כקלט. hook מסוגSessionEndיכול לארכב את ה-transcript כשסשן מסתיים. - להטמיע את קלוד באפליקציית TypeScript או Python: השתמש ב-Agent SDK כדי לקבל כל הודעה באופן תכנותי.
הדוגמה הבאה משתמשת בממשק השני. היא שולחת פרומפט המשך לסשן קיים וקוראת את התשובה עם jq:
claude -p --resume <session-id> --output-format json "summarize what we changed" | jq -r '.result'#איפה נשמרים ה-transcripts
כברירת מחדל, קלוד קוד שומר transcripts כ-JSONL בנתיב ~/.claude/projects/<project>/<session-id>.jsonl, כאשר <project> הוא נתיב תיקיית העבודה אחרי שתווים שאינם אלפאנומריים הוחלפו ב--. אם השם המומר חורג מ-200 תווים, קלוד קוד חותך אותו ל-200 תווים ומוסיף hash של הנתיב המלא, כדי ששם התיקייה יישאר בגבולות מערכת הקבצים.
כל שורה היא אובייקט JSON: הודעה, שימוש בכלי או תוצאה שלו, רשומה של בקשה שקלוד קוד שלח למודל, או רשומת מטא-נתונים. פורמט הרשומה פנימי לקלוד קוד ומשתנה בין גרסאות, ולכן סקריפטים שמפרקים את הקבצים האלה ישירות עלולים להישבר בכל שחרור. כדי לבנות על נתוני סשן, השתמש ב-/export או בממשקי הסקריפט שלמעלה.
המיקום, משך השמירה והכתיבה ניתנים להגדרה:
| כדי | הגדר | היכן |
|---|---|---|
להעביר את האחסון אל מחוץ ל-~/.claude | CLAUDE_CONFIG_DIR | משתנה סביבה |
לבחור בעצמך את שם תיקיית <project> | CLAUDE_CODE_PROJECT_DIR_NAME | משתנה סביבה |
| לשנות את שמירת 30 הימים | cleanupPeriodDays | settings.json |
| לקבוע גיל מרבי ל-transcripts של Claude Desktop ו-Cowork | desktopSessionCleanupPeriodDays | הגדרות user, הגדרות managed, או --settings |
להגביל את גודל קובץ ה-transcript של סשן -p או Agent SDK | CLAUDE_CODE_TRANSCRIPT_LOCAL_GC | משתנה סביבה |
| לדכא כתיבת transcript בכל המצבים | CLAUDE_CODE_SKIP_PROMPT_HISTORY | משתנה סביבה |
| לדכא כתיבה להרצה לא אינטראקטיבית אחת | --no-session-persistence | דגל CLI עם claude -p |
#מחיקת נתוני סשן
Transcripts מתיישנים לפי כללי סריקת השמירה. כדי למחוק מוקדם יותר את ה-transcripts של פרויקט ואת המצב הקשור, הרץ claude purge. אם מוחקים סשן רקע עם claude rm <id>, ה-transcript שלו נשאר על הדיסק ונשאר זמין דרך claude --resume.
#בחירת שם לתיקיית הפרויקט
כברירת מחדל, קלוד קוד גוזר את שם <project> מכל נתיב תיקיית העבודה. כדי לבחור את השם בעצמך, הגדר CLAUDE_CODE_PROJECT_DIR_NAME יחד עם CLAUDE_CONFIG_DIR. קלוד קוד שומר אז את ה-transcripts של הסשן ואת ה-auto memory תחת השם שלך. זה מתאים למארח שמטמיע את קלוד קוד ונותן לכל סשן תיקיית הגדרות משלו. דורש גרסה 2.1.234 ומעלה.
לדוגמה, ההפעלה הזו שומרת את הנתונים של tenant A תחת /srv/tenant-a וקוראת לתיקיית הפרויקט work:
CLAUDE_CONFIG_DIR=/srv/tenant-a CLAUDE_CODE_PROJECT_DIR_NAME=work claudeקלוד קוד כותב את ה-transcripts של הסשן אל /srv/tenant-a/projects/work/ ואת ה-auto memory אל /srv/tenant-a/projects/work/memory/, בלי תלות בתיקיית העבודה.
שלושה כללים חלים כשמגדירים את זה:
- הגדר גם
CLAUDE_CONFIG_DIR: השם אינו משתנה עם תיקיית העבודה, ולכן תחת~/.claudeשל ברירת המחדל הוא היה ממזג transcripts ו-auto memory של כל פרויקט לתיקייה אחת. קלוד קוד מתעלם מ-CLAUDE_CODE_PROJECT_DIR_NAMEכאשרCLAUDE_CONFIG_DIRאינו מוגדר. - השתמש ב-1 עד 64 אותיות, ספרות, מקפים או קווים תחתיים: אל תשתמש בשם התקן של Windows כמו
con. קלוד קוד מתעלם מכל ערך אחר ומשתמש בשם הנגזר. - הגדר אותו בסביבת המעטפת שמפעילה את
claude: קלוד קוד קורא אותו פעם אחת בהפעלה מהסביבה הזו, ולכן בלוקenvבקובץ הגדרות אינו יכול להגדיר אותו.
אחרי שנתת שם לתיקיית הפרויקט של תיקיית הגדרות, המשך להפעיל עם אותו שם. אם מפעילים את קלוד קוד עם אותו CLAUDE_CONFIG_DIR אבל בלי CLAUDE_CODE_PROJECT_DIR_NAME, הוא קורא וכותב שוב לתיקייה הנגזרת. הסשנים שנשמרו תחת השם שלך נשארים על הדיסק: לחץ Ctrl+A בבורר הסשנים כדי לרשום סשנים מכל תיקיית פרויקט תחת תיקיית ההגדרות הזו, כולל התיקייה שקבעת. בכל דרך הפעלה, claude --resume <session-id> מוצא סשן שנשמר תחת כל אחד מהשמות.
#ראה גם
דפים אלו ממשיכים מתהליכי העבודה היומיומיים וממכניקת הסשנים:
- שיטות העבודה המומלצות (Best practices): דפוסים להפקת המרב מקלוד קוד
- ניהול סשנים: חידוש, מתן שם ופיצול שיחות, מעבר למה שמכוסה כאן על הבורר
- Worktrees: הרצת סשנים מקבילים מבודדים בענפים נפרדים
- הרחבת קלוד קוד: הוספת skills, hooks, MCP, סוכני משנה ותוספים
- Checkpointing: החזרת קוד ושיחה לאחור לנקודה מוקדמת יותר
- חלון ההקשר: מה ממלא את ההקשר ומה שורד compaction
- מצב לא אינטראקטיבי: התנהגות סשנים תחת
claude -p