🛠️ פרק 3

עבודה יומיומית ותהליכי פיתוח

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

הפרק מרכז תבניות מעשיות לפיתוח יומיומי. להנחיות כלליות יותר על כתיבת פרומפטים וניהול הקשר, מומלץ לעיין במדריך שיטות העבודה המומלצות (Best practices).

הנושאים המכוסים בפרק זה:

• תבניות פרומפטים לחקר קוד, תיקון באגים, שיפור מבנה הקוד, בדיקות, יצירת PRs ותיעוד.
• חידוש שיחות קודמות וניהול סשנים כדי שמשימה תוכל להתפרס על פני מספר ישיבות.
• הרצת סשנים מקבילים באמצעות worktrees כדי שעריכות מקבילות לא יתנגשו.
• תכנון לפני עריכה כדי לסקור שינויים לפני שהם נכתבים לדיסק.
• האצלת מחקר לסוכני משנה (subagents) כדי לשמור על חלון הקשר ראשי נקי.
• הזרמת פלט לקלוד בסקריפטים (piping) עבור CI ועיבוד באצ'.

#תבניות פרומפטים לתהליכים נפוצים

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

#הבנת מאגרי קוד חדשים

להגדרת קלוד קוד במונורפו או במאגר קוד גדול, ראה את המדריך למונורפו ומאגרים גדולים.

#קבלת סקירה מהירה של מאגר הקוד

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

1. ניווט לתיקיית השורש של הפרויקט: החלף את /path/to/project בנתיב לפרויקט שלך.

cd /path/to/project 

2. הפעלת קלוד קוד:

claude 

3. בקשת סקירה כללית ברמה גבוהה:

give me an overview of this codebase

4. צלילה עמוקה יותר לרכיבים ספציפיים:

explain the main architecture patterns used here

what are the key data models?

how is authentication handled?

טיפים:

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

#איתור קוד רלוונטי

נניח שעליך לאתר קוד הקשור לתכונה או לפונקציונליות מסוימת:

1. בקש מקלוד למצוא קבצים רלוונטיים:

find the files that handle user authentication

2. קבל הקשר על האופן שבו רכיבים פועלים יחד:

how do these authentication files work together?

3. הבנת זרימת הביצוע:

trace the login process from front-end to database

טיפים:

• היה ספציפי לגבי מה שאתה מחפש.
• השתמש במונחים מתוך הדומיין של הפרויקט.
• התקן תוסף תבונת קוד (code intelligence plugin) עבור שפת הפיתוח שלך כדי לתת לקלוד יכולת ניווט מדויקת של "go to definition" וכן "find references".

#תיקון באגים ביעילות

נניח שנתקלת בהודעת שגיאה ועליך לאתר את המקור שלה ולתקן אותו:

1. שתף את השגיאה עם קלוד:

I'm seeing an error when I run npm test

2. בקש המלצות לתיקון:

suggest a few ways to fix the @ts-ignore in user.ts

3. החל את התיקון:

update user.ts to add the null check you suggested

טיפים:

• מסור לקלוד את הפקודה לשחזור הבעיה וקבלת stack trace.
• ציין את כל השלבים לשחזור השגיאה.
• עדכן את קלוד אם השגיאה מופיעה לסירוגין או באופן עקבי.

#שיפור מבנה הקוד (Refactoring)

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

1. זיהוי קוד ישן לצורך ארגון מחדש:

find deprecated API usage in our codebase

2. קבלת המלצות לארגון מחדש:

suggest how to refactor utils.js to use modern JavaScript features

3. החלת השינויים בצורה בטוחה:

refactor utils.js to use ES2024 features while maintaining the same behavior

4. אימות השינויים:

run tests for the refactored code

טיפים:

• בקש מקלוד להסביר את היתרונות של הגישה המודרנית.
• בקש שהשינויים ישמרו על תאימות לאחור בעת הצורך.
• בצע refactoring במנות קטנות הניתנות לבדיקה.

#עבודה עם בדיקות

נניח שעליך להוסיף בדיקות עבור קוד שאינו מכוסה:

1. זיהוי קוד שאינו נבדק:

find functions in NotificationsService.swift that are not covered by tests

2. יצירת שלד הבדיקות:

add tests for the notification service

3. הוספת מקרי בדיקה משמעותיים:

add test cases for edge conditions in the notification service

4. הרצת הבדיקות ואימותן:

run the new tests and fix any failures

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

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

#יצירת Pull Requests

ניתן ליצור pull requests על ידי פנייה ישירה לקלוד ("create a pr for my changes"), או להנחות אותו צעד אחר צעד:

1. סיכום השינויים שלך:

summarize the changes I've made to the authentication module

2. יצירת ה-pull request:

create a pr

3. סקירה וליטוש:

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 שקלוד יצר לפני הגשתו, ובקש מקלוד להדגיש סיכונים או שיקולים אפשריים.

#טיפול בתיעוד

נניח שעליך להוסיף או לעדכן תיעוד עבור הקוד שלך:

1. זיהוי קוד ללא תיעוד:

find functions without proper JSDoc comments in the auth module

2. יצירת התיעוד:

add JSDoc comments to the undocumented functions in auth.js

3. סקירה ושיפור:

improve the generated documentation with more context and examples

4. אימות התיעוד:

check if the documentation follows our project standards

טיפים:

• הגדר את סגנון התיעוד הרצוי (כגון JSDoc, docstrings ועוד).
• בקש דוגמאות בתוך התיעוד.
• בקש תיעוד עבור ממשקי API ציבוריים, ממשקים ולוגיקה מורכבת.

#עבודה בפתקים ובתיקיות שאינן קוד

קלוד קוד עובד בכל תיקייה. הפעל אותו בתוך מאגר פתקים (notes vault), תיקיית תיעוד או כל אוסף של קובצי Markdown כדי לחפש, לערוך ולארגן מחדש תוכן בדיוק באותו אופן שבו היית עובד עם קוד.

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

#עבודה עם תמונות

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

1. הוספת תמונה לשיחה: ניתן להשתמש בכל אחת מהשיטות הבאות:
   1. גרירה ושחרור של תמונה אל חלון קלוד קוד.
   2. העתקת תמונה והדבקתה ב-CLI באמצעות Ctrl+V, או באמצעות Alt+V ב-Windows וב-WSL.
   3. מסירת נתיב התמונה לקלוד, לדוגמה: "Analyze this image: /path/to/your/image.png".
2. בקשה מקלוד לנתח את התמונה:

What does this image show?

Describe the UI elements in this screenshot

Are there any problematic elements in this diagram?

3. שימוש בתמונות כהקשר:

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?

4. קבלת הצעות קוד מתוך תוכן חזותי:

Generate CSS to match this design mockup

What HTML structure would recreate this component?

טיפים:

• השתמש בתמונות כאשר תיאור מילולי עלול להיות לא ברור או מסורבל.
• כלול צילומי מסך של שגיאות, עיצובי ממשק משתמש או דיאגרמות לצורך הקשר טוב יותר.
• ניתן לעבוד עם מספר תמונות בשיחה אחת.
• ניתוח תמונות עובד עם דיאגרמות, צילומי מסך, מוקאפים ועוד.
• כאשר קלוד מתייחס לתמונות (למשל [Image #1]), לחץ Cmd+Click (ב-Mac) או Ctrl+Click (ב-Windows/Linux) על הקישור כדי לפתוח את התמונה במציג ברירת המחדל שלך.

#אזכור קבצים ותיקיות

השתמש ב-@ כדי לכלול במהירות קבצים או תיקיות מבלי להמתין שקלוד יקרא אותם בעצמו:

1. אזכור קובץ בודד:

Explain the logic in @src/utils/auth.js

פעולה זו כוללת את תוכן הקובץ המלא בשיחה. 2. אזכור תיקייה:

What's the structure of @src/components?

3. אזכור משאבי 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").

#הרצת קלוד לפי לוח זמנים

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

טיפ: בעת כתיבת פרומפטים למשימות מתוזמנות, הגדר במפורש כיצד נראית הצלחה ומה יש לעשות עם התוצאות. המשימה רצה באופן אוטונומי, ולכן אינה יכולה לשאול שאלות הבהרה. לדוגמה: "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.ai/code ותוסף VS Code מנהלים כל אחד היסטוריית שיחות נפרדת משלו. מדריך זה מתמקד בממשק ה-CLI.

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

claude --continue

פקודה זו פותחת מחדש את השיחה האחרונה בתיקייה הנוכחית. אם עדיין אין כזו, היא מדפיסה את ההודעה No conversation found to continue ויוצאת.

#נקודות כניסה לחידוש שיחה

קלוד קוד משמיט מבורר הסשנים ומפקודת claude --continue שיחות שנוצרו באמצעות claude -p או באמצעות ה-Agent SDK. עדיין ניתן לחדש סשן כזה על ידי העברת מזהה הסשן שלו: claude --resume <session-id>.

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

#סשנים ברקע בעת הרצת continue

claude --continue פותחת סשן רקע שהסתיים, אך אינה פותחת סשן שעדיין רץ ברקע. פתיחת סשן רקע שהסתיים דורשת את גרסה 2.1.257 של קלוד קוד ומעלה.

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

#חידוש לפי מזהה סשן מכל תיקייה

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

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

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

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

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

• היסטוריית שיחה: היסטוריה מלאה, כולל קריאות כלים ותוצאותיהן. כלי שעדיין היה בריצה כשהתהליך הקודם הסתיים, למשל בעת קריסה, אינו מסיים את ריצתו ואינו מורץ שוב בעת החידוש. קלוד ממשיך ללא הפלט שלו.
• מודל: הסשן ממשיך במודל שבו השתמש. המודל אינו משוחזר אם הוא הוצא משימוש (retired), אם אינו מורשה בהגדרת availableModels, כאשר הדגל --model או משתנה סביבה ממשפחת ANTHROPIC_MODEL בוחרים מודל בעת ההפעלה, או בספקים המשתמשים במזהי פריסה ייעודיים לספק (כמו Amazon Bedrock, Google Cloud Agent Platform, Microsoft Foundry).
• סוכן (Agent): סשן שהתחיל עם הדגל --agent או הגדרת agent ממשיך כאותו סוכן ושומר על הגבלות הכלים והמודל שלו. ניתן להעביר --agent בעת החידוש כדי לבחור סוכן אחר. קלוד קוד מחפש את הסוכן בשני מקומות: בתיקייה המקורית של הסשן (בתנאי שניתן אמון ב-workspace), ולאחר מכן בתיקייה שממנה מחדשים, כך שסוכן ברמת פרויקט נטען גם כשמחדשים מתיקייה אחרת. אם קלוד קוד אינו מוצא את הסוכן באף אחד מהמקומות, הסשן מתחדש עם כלי ברירת המחדל ומציג אזהרה המציינת את שם הסוכן.
• מצב הרשאות (Permission mode): כאשר מחדשים מהטרמינל באמצעות claude --continue, claude --resume <session-id>, או claude --resume <name> (כאשר השם תואם לסשן יחיד), ללא -p, קלוד קוד משחזר את מצב ההרשאות שבו היה הסשן, למעט המקרים המפורטים להלן. ניתן להעביר --permission-mode או --dangerously-skip-permissions כדי לדרוס את המצב המשוחזר.
• יעד פעיל (Active goal): יעד שהיה פעיל כשהסשן הסתיים ממשיך לפעול. מונה התורות, הטיימר וחישוב צריכת הטוקנים מתאפסים.
• משימות מתוזמנות: משימות שטרם פגו משוחזרות. משימות Bash ומעקב ברקע אינן משוחזרות.

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

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

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

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

שחזור מצב תכנון בנתיב הלא אינטראקטיבי ובתוסף VS Code דורש את גרסה 2.1.246 של קלוד קוד ומעלה.

#תנאים לחידוש במצב תכנון עם claude -p

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

1. העברת את הדגל --permission-prompt-tool, כדי שקלוד קוד יוכל להציג את התוכנית לאישור.
2. לא העברת את הדגלים --permission-mode או --dangerously-skip-permissions.
3. לא העברת את הדגל --fork-session.
4. ההרצה אינה מופעלת דרך ערוצים (channels).

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

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

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

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

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

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

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

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

מקשי קיצור לשינוי היקף החיפוש:

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

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

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

התנהגות בעת בחירת סשן מתוך הבורר:

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

#חידוש לפי שם סשן

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

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

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

#הרצת סשנים מקבילים באמצעות worktrees

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

claude --worktree feature-auth

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

במאגר ללא קומיטים, הפקודה נכשלת עם הודעת השגיאה: Failed to resolve base branch "HEAD": git rev-parse failed

לפרטים על ניקוי, קובץ .worktreeinclude ותמיכה במערכות בקרת תצורה שאינן Git, ראה את תיעוד worktrees. כדי לנטר סשנים מקבילים ממסך אחד במקום מטרמינלים נפרדים, ראה סוכני רקע (background agents).

#תכנון לפני עריכה

עבור שינויים שברצונך לבדוק לפני שהם נכתבים לדיסק, עבור למצב תכנון (plan mode). קלוד קורא קבצים ומציע תוכנית, אך אינו מבצע עריכות בפועל עד לאישורך. שורת המצב מציגה ⏸ plan mode on כאשר מצב תכנון פעיל.

claude --permission-mode plan

ניתן גם ללחוץ על Shift+Tab באמצע סשן עד ששורת המצב מציגה ⏸ plan mode on. לתהליך האישור ועריכת התוכנית בעורך הטקסט שלך, ראה את תיעוד מצב תכנון.

#האצלת מחקר לסוכני משנה

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

use a subagent to investigate how our auth system handles token refresh

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

#הזרמת פלט לקלוד בסקריפטים

הפעל את קלוד באופן לא אינטראקטיבי עבור תהליכי CI, עבור pre-commit hooks או עבור עיבוד באצ' (batch processing). קלט ופלט סטנדרטיים (stdin ו-stdout) עובדים בדיוק כמו בכל כלי Unix.

git log --oneline -20 | claude -p "summarize these recent commits"

לפורמטים של פלט, דגלי הרשאות ותבניות fan-out, ראה את תיעוד מצב לא אינטראקטיבי (Non-interactive mode).