📘 תיעוד 9

ניהול שיחות

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

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

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

#המשך שיחה

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

#המשך שיחת רקע שרצה

כשהשיחה שממשיכים עם claude --resume או /resume שייכת לשיחת רקע שעדיין רצה, Claude Code פותח את השיחה הרצה עצמה. עם --bg בשורת הפקודה, ההמשך הוא שליחת רקע. לפני v2.1.285, Claude Code סירב ואמר לפתוח את השיחה עם claude attach <id>, או לעצור אותה קודם עם claude stop <id>.

• מהמעטפת: claude --resume <session> מריץ claude attach על השיחה הזו באותו מסוף, במקום לטעון את התמליל עצמו. הנחיה שמעבירים בשורת הפקודה, כמו ב-claude --resume <session> "check the tests too", נשלחת לשיחה כתור הבא שלה תחילה, ו-Claude Code מדפיס Sent your prompt to the background session (<id>); opening it… לפני החיבור. claude -p --resume <session> "prompt" שמוקלד במסוף עושה אותו דבר, כך ש--p לא משאיר את ההרצה הזו לא אינטראקטיבית.

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

  • קלט או פלט בצינור או בהפניה
  • דגלים שמגדירים את השיחה, כמו --permission-mode, --model או --settings
  • דגלים שקוראים את הפלט, כמו --output-format json או --json-schema
  • דגלים שמגבילים את ההרצה או מחזירים אותה לאחור, כמו --max-turns או --max-budget-usd

  עם אחד מאלה, או כשתצוגת הסוכן כבויה, Claude Code לא שולח דבר ויוצא עם סטטוס 1. הוא מדפיס שהשיחה רצה ברקע יחד עם פקודת claude attach <id> שפותחת אותה, או אומר למצוא אותה ב-claude agents כשאי אפשר לקבוע את ה-ID. הוסיפו --fork-session כדי להמשיך עותק של השיחה. כדי להמשיך את השיחה עצמה בשיחה משלכם, עם הדגלים שלכם, הריצו claude stop <id> ואז חזרו על הפקודה.

  הנחיה שמתחילה ב-/ או ב-! לא נשלחת, וגם לא נשלחת שום הנחיה בזמן שהשיחה ממתינה לתשובה שלכם לשאלה. בשני המקרים Claude Code לא פותח את השיחה, וההודעה כוללת Your prompt was not sent to it עם הסיבה.

• מתוך שיחה: /resume מעביר את השיחה הנוכחית לרקע ומחבר את המסוף הזה לשיחה הרצה, ומדפיס Opening "<title>", running in the background (<id>). לחצו ← בהנחיה ריקה כדי לחזור לתצוגת הסוכן, שמציגה גם את השיחה שעזבתם. כשאי אפשר להעביר את השיחה הנוכחית לרקע, למשל כי אתם כבר מחוברים לשיחת רקע או כי שמירת השיחות כבויה, /resume מדפיס את פקודת claude attach להרצה.

#מה שיחה שהמשיכו משחזרת

כש-Claude Code טוען שיחה מהתמליל שלה, השיחה שהמשיכו משחזרת את השיחה יחד עם המצב שנשמר בה:

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

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

#מצב הרשאות בהמשך

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

אם כלל deny מסיר את הכלי ExitPlanMode, Claude לא יכול להציג תוכנית לאישור, ולכן Claude Code לא משחזר מצב plan. השיחה מתחילה במצב ההרשאות שבו שיחה חדשה הייתה מתחילה מאותה שורת פקודה. עם /resume, השיחה ממשיכה במצב ההרשאות הנוכחי שלכם.

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

#המשך במצב plan עם -p

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

• מעבירים --permission-prompt-tool ולא מעבירים --permission-prompts none, כדי ש-Claude Code יוכל להציג את התוכנית לאישור
• לא מעבירים --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 בהנחיה. האומדן לא חל על ההודעה הראשונה בשיחה החדשה. אם האפשרות אומרת ש-Claude יכול לחפש את השיחה הזו, עדיין אפשר להתייחס לעבודה קודמת בשיחה החדשה.

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

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

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

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

#/loop, -p, Agent SDK וסשנים ברקע

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

Claude Code משאיר סשנים שנוצרו עם claude -p או עם Agent SDK מחוץ לבוחר הסשנים ומחוץ ל-claude --continue. עדיין אפשר לחדש סשן כזה על ידי העברת מזהה הסשן אל claude --resume <session-id>. כשמריצים 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 כדי לבחור סשן אחר.

#סשנים ב-worktrees ובפרויקטים אחרים

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

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

#חידוש לפי מזהה סשן או לפי שם

אפשר להריץ claude --resume <session-id> מכל תיקייה, כך שאפשר לחדש סשן שהתחיל במקום אחר או הועבר עם /cd. Claude Code מחפש את המזהה בסדר הזה:

1. תיקיית הפרויקט הנוכחית וה-git worktrees שלה
2. כל פרויקט אחר במחשב הזה

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

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

#תנו שם לסשנים

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

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

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

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

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

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

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

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

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

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

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

#צרו ענף מסשן

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

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

/branch try-streaming-approach

אם משמיטים את השם, Claude Code נותן לענף החדש שם לפי הפרומפט הראשון בשיחה.

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

claude --continue --fork-session

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

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

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

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

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

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

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

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

הרץ /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 שלח למודל, או רשומת מטא-נתונים. פורמט הרשומה פנימי ל-Claude Code ומשתנה בין גרסאות, כך שסקריפטים שמנתחים את הקבצים האלה ישירות יכולים להישבר בכל שחרור. כדי לבנות על נתוני סשן, השתמש ב-/export או בממשקי הסקריפט.

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

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

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

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

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

לדוגמה, ההפעלה הזו שומרת את הנתונים של tenant 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/ ואת הזיכרון האוטומטי שלו אל /srv/tenant-a/projects/work/memory/, תהיה ספריית העבודה אשר תהיה.

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

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

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

#ראה גם

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

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