📘 תיעוד 9

ניהול סשנים

מתן שמות, חידוש, יצירת ענפים והחלפה בין שיחות של Claude Code. מכסה את --continue, את --resume, את --from-pr, את בורר הסשנים של /resume, מתן שמות לסשנים, ייצוא תמלילים והיכן תמלילים נשמרים.

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

אפליקציית שולחן העבודה (desktop app), האתר claude.ai/code ותוסף VS Code, כל אחד מהם מנהל היסטוריית סשנים משלו. דף זה עוסק ב-CLI.

#חידוש סשן

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

‏Claude Code אינו כולל סשנים שנוצרו באמצעות claude -p או באמצעות Agent SDK בבורר הסשנים ובפקודה claude --continue. עדיין תוכל לחדש סשן כזה על ידי העברת מזהה הסשן שלו לפקודה claude --resume <session-id>. באמצעות claude --continue, ‏Claude Code מדלג גם על סשנים שהפרומפט הראשון שלהם היה /loop. כאשר אתה מריץ claude -p --continue, ‏Claude Code כולל סשנים של -p, של SDK ושל /loop.

הפקודה claude --continue פותחת סשן רקע שהסתיים, אך לא סשן שעדיין פועל. פתיחת סשני רקע שהסתיימו דורשת את Claude Code v2.1.257 ומעלה. אם השיחה האחרונה ביותר שלך היא שיחה שהעברת לרקע והיא עדיין רצה שם, Claude Code יוצא עם ההודעה Your most recent conversation is running in the background ומציג את מזהה הסשן. התחבר לסשן מתוך claude agents, או הרץ claude --resume כדי לבחור סשן אחר.

תוכל להריץ claude --resume <session-id> מכל ספרייה: Claude Code מחפש את המזהה תחילה בספריית הפרויקט הנוכחית וב-git worktrees שלה, ולאחר מכן בכל פרויקט אחר במחשב זה, כך שהוא מוצא סשן שהתחיל במקום אחר או הועבר באמצעות /cd. החיפוש הבין-פרויקטלי מאתר את המזהה רק כאשר בדיוק פרויקט אחד אחר מכיל תמליל עם הודעות עבורו, כך שהעתק כפול שנוצר ידנית יגרום ל-Claude Code לדווח שהסשן לא נמצא, במקום לחדש עותק שרירותי. אם אין סשן שמור התואם למזהה, Claude Code מדווח: No conversation found with session ID: <session-id>. לפני גרסה v2.1.223, החיפוש נעצר בספריית הפרויקט הנוכחית וב-git worktrees שלה, ולכן נדרשת לחדש את הסשן מהספרייה שבה הוא פעל לאחרונה.

#מה משחזר סשן שחודש

סשן שחודש משחזר את השיחה יחד עם המצב שנשמר בה:

• היסטוריית שיחה: ההיסטוריה המלאה, כולל קריאות לכלים ותוצאותיהן. כלי שעדיין פעל כאשר התהליך הקודם הסתיים, למשל בעת קריסה, אינו מסיים לפעול ואינו מופעל שוב כאשר אתה מחדש את הסשן. Claude ממשיך ללא הפלט שלו.
• מודל: הסשן ממשיך במודל שבו השתמש. המודל אינו משוחזר כאשר הוא הוצא משימוש או אינו מורשה על ידי availableModels, כאשר דגל --model או משתנה סביבה ממשפחת ANTHROPIC_MODEL בוחר מודל בעת ההפעלה, או בספקים המשתמשים במזהי פריסה (deployment IDs) ספציפיים לספק, כגון Amazon Bedrock, Google Cloud's Agent Platform, ו-Microsoft Foundry. ראה הגדרות מודל לסדר הקביעה.
• סוכן (Agent): סשן שהופעל עם --agent או עם ההגדרה agent ממשיך כסוכן זה, תוך שמירה על הגבלות הכלים והמודל שלו. העבר את --agent בעת חידוש הסשן כדי לבחור סוכן אחר. עבור ה-system prompt בכל אחד מהמקרים, ראה דגלי system prompt בשיחות שחודשו. ‏Claude Code מחפש את הסוכן בשני מקומות: בספרייה המקורית של הסשן, בתנאי שסימנת שאתה נותן אמון בסביבת עבודה זו, ולאחר מכן בספרייה שממנה אתה מחדש את הסשן, כך שסוכן ברמת הפרויקט עדיין נטען כאשר אתה מחדש מספרייה אחרת. אם Claude Code אינו מוצא את הסוכן באף אחד מהמקומות, הסשן מתחדש עם כלי ברירת המחדל ומציג אזהרה המציינת את שם הסוכן.
• מצב הרשאות: אם אתה מחדש מתוך מסוף עם claude --continue, claude --resume <session-id>, או claude --resume <name> כאשר השם תואם לסשן יחיד, ללא -p, ‏Claude Code משחזר את מצב ההרשאות שבו היה הסשן, למעט במקרים המפורטים במצב הרשאות בעת חידוש, המכסה גם את בורר הסשנים, את /resume, וחידוש עם claude -p. העבר את --permission-mode או את --dangerously-skip-permissions כדי לעקוף את המצב ששוחזר.
• יעד פעיל: יעד שעדיין היה פעיל כאשר הסשן הסתיים מועבר הלאה. ספירת התורות (turns) שלו, הטיימר ונקודת הייחוס של ניצול הטוקנים מתאפסים.
• משימות מתוזמנות: משימות שלא פג תוקפן משוחזרות. משימות Bash ברקע ומשימות ניטור אינן משוחזרות.

לא כל דגל הגדרה מההפעלה המקורית משוחזר. אם הסשן היה תלוי ב---mcp-config, ב---settings, ב---plugin-dir, ב---fallback-model, או בספריות שנוספו עם --add-dir, העבר אותם שוב בעת החידוש. ספריות שנוספו במהלך הסשן באמצעות /add-dir אינן משוחזרות גם הן, אף על פי שבורר הסשנים עדיין משתמש בהן כדי לאתר את הסשן. קובצי ההגדרות הסטנדרטיים, כגון settings.json ו-settings.local.json, נקראים מחדש בעת ההפעלה, ולכן אין צורך להעביר שוב הגדרות שנמצאות בהם. עבור --system-prompt ו---append-system-prompt, ראה דגלי system prompt בשיחות שחודשו.

#מצב הרשאות בעת חידוש

באיזה מצב הרשאות יופעל סשן שחודש על ידי Claude Code תלוי באופן שבו אתה מחדש אותו:

• מסוף: claude --continue, claude --resume <session-id>, או claude --resume <name> כאשר השם תואם לסשן יחיד, ללא -p. ‏Claude Code משחזר את מצב ההרשאות שבו היה הסשן, למעט במקרים שבטבלה. העבר את --permission-mode או את --dangerously-skip-permissions כדי לעקוף את המצב ששוחזר.
• מצב לא אינטראקטיבי: claude -p --resume או claude -p --continue. ‏Claude Code מתחיל את הריצה במצב ההרשאות שבו הייתה מתחילה ריצת claude -p חדשה, למעט סשן שהסתיים ב-plan mode שמתחדש ב-plan mode תחת התנאים שלהלן.
• ‏VS Code: חלונית השיחה של התוסף. הטבלה מכסה רק שיחה שהסתיימה ב-plan mode. לגבי השאר, ראה חידוש שיחות קודמות.
• בורר הסשנים בעת ההפעלה: סשן שאתה בוחר מתוך בורר הסשנים, בין אם פתחת אותו באמצעות claude --resume לבדו, באמצעות claude --from-pr, או עם שם שתואם ליותר מסשן אחד. Claude Code אינו משחזר את מצב ההרשאות השמור. הוא מתחיל את הסשן במצב ההרשאות שבו היה מתחיל סשן חדש מאותה שורת פקודה.
• ‏/resume מתוך סשן, עם או בלי ארגומנט: Claude Code אינו משחזר את מצב ההרשאות השמור. השיחה שאליה אתה עובר ממשיכה במצב ההרשאות של הסשן הנוכחי שלך.

שחזור של plan mode במסלול הלא-אינטראקטיבי ובמסלול של VS Code דורש את Claude Code v2.1.246 ומעלה. כל שורה מציינת את מצב ההרשאות שבו הסתיים הסשן, באיזה מהמסלולים (מסוף, לא-אינטראקטיבי, או VS Code) אתה מחדש אותו, ואת מצב ההרשאות שבו Claude Code מתחיל את הסשן המחודש.

חידוש במצב plan עם `-p`

ריצת claude -p --resume או claude -p --continue מתחדשת במצב plan רק כאשר כל ארבעת התנאים מתקיימים:

• אתה מעביר את --permission-prompt-tool, כדי ש-Claude Code יוכל להציג את התוכנית לאישור
• אינך מעביר את --permission-mode או את --dangerously-skip-permissions
• אינך מעביר את --fork-session
• הריצה אינה מופעלת דרך ערוצים

#חידוש מתוך סיכום

בתוכנית Pro או Max, כאשר אתה מחדש סשן שלא היה פעיל במשך יותר מכשעה ויש בו מעל 100,000 טוקנים, Claude Code משחזר את השיחה ולאחר מכן פותח תיבת דו-שיח לפני שאתה שולח את ההודעה הראשונה שלך. תוקף ה-prompt cache של הסשן פג עד אז, ולכן הבקשה הבאה מעבדת את ההיסטוריה המלאה פעם אחת, ללא תלות באפשרות שתבחר בתיבת הדו-שיח.

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

• Resume from summary: מפעיל את /compact באופן מיידי. Claude Code שולח בקשת סיכום אחת על פני ההיסטוריה המלאה, ולאחר מכן מחליף את ההיסטוריה בסיכום, בחילופי הדברים האחרונים שלך, ובעד חמישה קבצים שנקראו לאחרונה. בקשות מאוחרות יותר נושאות את הסיכום במקום את ההיסטוריה המלאה.
• Resume full session as-is: טוען את השיחה ללא שינוי. לאחר שתשלח את ההודעה הראשונה שלך, Claude Code מעבד מחדש ושומר מחדש במטמון את ההיסטוריה המלאה, ולאחר מכן קורא אותה שוב מהמטמון בבקשות הבאות כל עוד המטמון נשאר חם.
• Don't ask me again: מחדש את הסשן המלא ומפסיק להציג את תיבת הדו-שיח בכל החידושים העתידיים.

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

#היכן מחפש בורר הסשנים

‏Claude Code שומר סשנים לפי ספריית פרויקט. כברירת מחדל בורר הסשנים מציג:

• סשנים מ-worktree הנוכחי, כולל סשני רקע, המסומנים כ-bg ברשימה
• סשנים שהתחילו במקום אחר והוסיפו את הספרייה הנוכחית באמצעות /add-dir

השתמש ב-Ctrl+W כדי להרחיב לכל ה-worktrees של המאגר, או ב-Ctrl+A כדי להרחיב לכל פרויקט במחשב זה.

סשנים שהפרומפט הראשון שלהם היה פקודת /loop אינם מופיעים בבורר, ו-claude --continue מדלג עליהם גם כן. הפעלת /loop בשלב מאוחר יותר של שיחה אינה מסתירה את הסשן. לפני גרסה v2.1.211, הפעלת /loop בשלב מוקדם של שיחה הסתירה את הסשן מהבורר לצמיתות.

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

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

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

#מתן שמות לסשנים שלך

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

לאחר שנתת שם לסשן דרך ה-CLI או מתוך claude.ai, חזור אליו באמצעות claude --resume <name> או /resume <name>. סשן מאפליקציית שולחן העבודה מתחדש באפליקציה, השומרת היסטוריית סשנים משלה. ראה חידוש סשן לאופן שבו מתבצע זיהוי שמות בין worktrees שונים.

כאשר אתה מתחיל או מחדש סשן אינטראקטיבי עם שם שסשן פעיל אחר במחשב זה כבר משתמש בו, או משנה שם של סשן לשם כזה, Claude Code משאיר את השם אצל הסשן שכבר מחזיק בו, משנה את השם של הסשן שלך לגרסה עם סיומת בת שתי מילים, כגון auth-refactor-graceful-unicorn, ומודיע לך על כך. הרץ /rename עם שם חדש אם אתה מעדיף לבחור שם בעצמך. לפני גרסה v2.1.232, שני הסשנים שמרו על השם.

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

• הוא אינו בודק כותרות שנוצרו על ידי בינה מלאכותית או שמות תצוגה של ברירת מחדל.
• הוא אינו בודק את ה---name של סשן רקע או סשן -p בעת ההפעלה.
• הוא אינו יכול לשנות שם של סשן בגרסה מוקדמת יותר של Claude Code.

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

• שם תצוגה כברירת מחדל: סשנים אינטראקטיביים שמעולם לא הענקת להם שם עדיין מקבלים שם תצוגה כברירת מחדל בעת הפעלתם. דורש את Claude Code v2.1.196 ומעלה. ברירת המחדל משלבת את שם ספריית העבודה עם סיומת של שני תווים, למשל my-app-3f, ומזהה את הסשן ברשימות של סשנים פועלים, כגון agent view ופלט של claude agents --json. ברירת המחדל אינה משמשת כמזהה לחידוש. אם תעביר אותה לפקודה claude --resume או ל-/resume, ‏Claude Code לא ימצא את הסשן. מתן שם לסשן מחליף את ברירת המחדל ברשימות אלו, וכך גם קבלת תוכנית.
• כותרת שנוצרה: אם אינך מעניק שם לסשן, Claude Code יוצר עבורו כותרת סשן. הכותרת היא סיכום קצר של הפרומפט הראשון שלך, שנכתב על ידי בקשת רקע למודל הקטן והמהיר, בדרך כלל מודל ממשפחת Haiku. קבלת תוכנית מחליפה אותה בכותרת המבוססת על התוכנית. מתן שם לסשן מחליף את הכותרת שנוצרה. אתה רואה את כותרת הפרומפט הראשון בבורר הסשנים ובשדה session_name ב-statusline כאשר לא מוגדר שם. כותרת התוכנית מופיעה באותם שני מקומות וגם ברשימות של סשנים פועלים, שבהן היא תופסת את מקומו של שם התצוגה של ברירת המחדל. תוכל להעביר כל אחת מהכותרות אל claude --resume או אל /resume, ו-Claude Code יאתר אותה באותו אופן כמו שם שהגדרת בעצמך.

#שימוש בבורר הסשנים

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

כל שורה מציגה את שם הסשן אם הגדרת כזה, ואם לא, את כותרת הסשן שנוצרה על ידי הבינה המלאכותית, סיכום השיחה, או הפרומפט הראשון, יחד עם הזמן שחלף מאז הפעילות האחרונה, ענף ה-git, וגודל הקובץ. הרחב לכל הפרויקטים באמצעות Ctrl+A כדי לראות גם את נתיב הפרויקט של כל סשן.

סשנים שנוצרו עם /branch או עם --fork-session מקבלים מזהי סשן משלהם ומופיעים כשורות נפרדות. כאשר הבורר מוצא יותר מרשומה אחת עבור אותו סשן, הוא מקבץ אותן תחת שורה בודדת. לחץ על → כדי להרחיב קבוצה.

אם Claude Code אינו מצליח לטעון את הסשן שבחרת מתוך הבורר של claude --resume, הוא מדפיס Failed to resume the conversation יחד עם פקודה לניסיון חוזר, ולאחר מכן יוצא עם קוד 1. מתוך הבורר של /resume בתוך סשן, Claude Code מדווח על הכישלון והשיחה הנוכחית שלך ממשיכה לפעול.

#פיצול סשן

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

מתוך סשן, הרץ /branch עם שם אופציונלי:

/branch try-streaming-approach

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

משורת הפקודה, שלב את --continue או את --resume עם --fork-session:

claude --continue --fork-session

אישור הפקודה /branch מדפיס שני מזהי סשן: הענף החדש שבו אתה נמצא כעת והמקורי. המקורי נשאר ללא שינוי בדיסק וממשיך להופיע בבורר הסשנים. חזור אליו באמצעות /resume <original-name> או על ידי העברת המזהה שלו ל-/resume.

הפקודה /branch מעתיקה את התמליל ומעבירה את תהליך Claude Code הפועל לכתוב אליו. הבחנה זו קובעת מה הענף יירש:

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

#ניהול הקשר בתוך סשן

פקודות אלו שולטות במה שנמצא בחלון ההקשר מבלי לעזוב את הסשן:

• /clear: התחלה מחדש עם הקשר ריק. Claude Code שומר את השיחה הקודמת. חדש אותה באמצעות /resume, או, באותו תהליך של Claude Code, מתוך רשומת השיחה הקודמת בתפריט ה-rewind. ללא ארגומנט, השיחה החדשה שומרת שם שהגדרת באמצעות --name או /rename, אך לא כותרת סשן שנוצרה על ידי בינה מלאכותית. כדי לתת שם לשיחה שאתה עוזב במקום זאת, העבר את השם, כגון /clear release-prep. השיחה החדשה תתחיל ללא שם
• /compact [instructions]: החלפת ההיסטוריה בסיכום, כאשר ניתן למקד אותו במה שתגדיר
• /context: הצגת מה שצורך כעת הקשר

למידע על האופן שבו דחיסה פועלת מול CLAUDE.md, מול כישורים (skills) ומול כללים (rules), ראה את מדריך חלון ההקשר. לאסטרטגיות מתי לנקות לעומת מתי לדחוס, ראה שיטות מומלצות.

#ייצוא ואיתור נתוני סשן

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

#גישה לשיחות מתוך סקריפטים

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

• הפעלת Claude פעם אחת ולכידת התוצאה: הפעל את claude -p עם --output-format json או stream-json כדי ללכוד את התוצאה, מזהה הסשן, השימוש והעלות של ריצה לא אינטראקטיבית כ-JSON מובנה.
• שאלת שאלה בסשן קיים: העבר מזהה סשן אל claude -p --resume כדי לשלוח פרומפט המשך, כגון בקשת סיכום, וללכוד את התגובה המובנית.
• תגובה לאירועי סשן: קרא את השדה transcript_path ש-hooks ופקודות בשורת הסטטוס מקבלים כקלט. ה-hook מסוג SessionEnd יכול לארכב את התמליל כאשר סשן מסתיים.
• הטמעת Claude באפליקציית TypeScript או Python: השתמש ב-Agent SDK כדי לקבל כל הודעה באופן תכנותי.

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

claude -p --resume <session-id> --output-format json "summarize what we changed" | jq -r '.result'

#היכן תמלילים נשמרים

כברירת מחדל, Claude Code שומר תמלילים כקובצי JSONL בנתיב ~/.claude/projects/<project>/<session-id>.jsonl, כאשר <project> הוא נתיב ספריית העבודה שלך כאשר תווים שאינם אלפאנומריים מוחלפים ב--. עבור ספריית עבודה ששמה המומר עולה על 200 תווים, Claude Code מקצר את השם ל-200 תווים ומוסיף גיבוב (hash) של הנתיב המלא, כך ששם הספרייה יישאר במגבלות מערכת הקבצים.

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

המיקום, משך השמירה והתנהגות הכתיבה ניתנים להגדרה:

#מחיקת נתוני סשן

תמלילים נמחקים עם הזמן במסגרת כללי סריקת השמירה. כדי למחוק את התמלילים של פרויקט ואת המצב הקשור אליהם מוקדם יותר, הרץ claude project purge. אם תמחק סשן רקע באמצעות claude rm <id>, התמליל שלו יישאר על הדיסק וימשיך להיות זמין דרך claude --resume.

#מתן שם לספריית הפרויקט בעצמך

כברירת מחדל, Claude Code גוזר את שם ה-<project> מנתיב ספריית העבודה המלא. כדי לבחור את השם בעצמך, הגדר את CLAUDE_CODE_PROJECT_DIR_NAME לצד CLAUDE_CONFIG_DIR. אז שומר Claude Code את תמלילי אותו סשן ואת auto memory תחת השם שלך. הדבר מתאים למערכת מארחת המטמיעה את Claude Code ומקצה לכל סשן ספריית הגדרות משלו. דורש את Claude Code v2.1.234 ומעלה.

לדוגמה, הפעלה זו שומרת את הנתונים של דייר A תחת הנתיב /srv/tenant-a ומכנה את ספריית הפרויקט שלו בשם work:

CLAUDE_CONFIG_DIR=/srv/tenant-a CLAUDE_CODE_PROJECT_DIR_NAME=work claude

‏Claude Code כותב את תמלילי הסשן לנתיב /srv/tenant-a/projects/work/ ואת ה-auto memory שלו לנתיב /srv/tenant-a/projects/work/memory/, ללא תלות בספריית העבודה.

שלושה כללים חלים כאשר אתה מגדיר זאת:

• הגדר גם את CLAUDE_CONFIG_DIR: השם אינו משתנה בהתאם לספריית העבודה, ולכן תחת ברירת המחדל ~/.claude הוא היה ממזג את התמלילים ואת ה-auto memory של כל הפרויקטים לספרייה אחת. Claude Code מתעלם מ-CLAUDE_CODE_PROJECT_DIR_NAME כאשר CLAUDE_CONFIG_DIR אינו מוגדר.
• השתמש ב-1 עד 64 אותיות, ספרות, מקפים או קווים תחתונים: אל תשתמש בשם התקן של Windows כגון con. Claude Code מתעלם מכל ערך אחר ומשתמש בשם הנגזר.
• הגדר זאת בסביבת המעטפת (shell) שמפעילה את claude: ‏Claude Code קורא זאת פעם אחת בעת ההפעלה מסביבה זו, ולכן בלוק env בקובץ הגדרות אינו יכול להגדיר זאת.

לאחר שנתת שם לספריית הפרויקט של ספריית הגדרות, המשך להפעיל עם אותו שם. אם תפעיל את Claude Code עם אותו CLAUDE_CONFIG_DIR אך ללא CLAUDE_CODE_PROJECT_DIR_NAME, הוא יקרא ויכתוב שוב אל הספרייה הנגזרת. הסשנים שנשמרו תחת השם שלך נשארים על הדיסק: לחץ על Ctrl+A בבורר הסשנים כדי להציג סשנים מכל ספריית פרויקט תחת אותה ספריית הגדרות, כולל זו שקובעה, ובכל דרך שבה תפעיל, הפקודה claude --resume <session-id> תמצא סשן שנשמר תחת כל אחד מהשמות.

#ראה גם

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

• Worktrees: הרצת סשנים מקבילים ומבודדים בענפים נפרדים
• נקודות ביקורת: החזרת קוד ושיחה לאחור לנקודה מוקדמת יותר
• חלון הקשר: מה ממלא את ההקשר ומה שורד דחיסה
• מצב לא אינטראקטיבי: התנהגות סשנים תחת claude -p