📘 תיעוד 4

Claude Code Desktop ב-WSL

הרצת סשנים של Code בתוך הפצת WSL 2 ב-Windows

ב-Windows, לשונית Code יכולה להריץ סשן בתוך הפצת WSL 2 במקום על Windows עצמה. תהליך Claude Code של הסשן, הכלים שלו ו-git רצים כולם בתוך ההפצה, באמצעות שרשרת הכלים של Linux ונתיבי Linux מקוריים, אותה סביבה שהפרויקט שלך מיועד אליה.

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

#דרישות

• Windows 10 או 11 עם WSL 2. WSL 1 אינו נתמך.
• לפחות הפצה אחת מותקנת (לדוגמה, Ubuntu).
• git מותקן בתוך ההפצה.

#התחלת סשן WSL

1. בחירת הפצה

   התחל סשן חדש בלשונית Code ופתח את בורר הסביבה מתחת לתיבת ההנחיה, או מעליה בפריסה הקודמת. הפצות WSL 2 המותקנות שלך מופיעות תחת WSL. בחר אחת.

2. בחירת תיקייה

   הסשן מתחיל בתיקיית הבית של ההפצה. השתמש בבורר התיקיות כדי לבחור תיקיית פרויקט. העיון מתבצע בתוך ההפצה, עם נתיבי Linux כמו /home/you/project.

3. מתן אמון בתיקייה

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

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

#מה עובד בסשן WSL

סשנים מקבילים, שיחות צד, סקירת diff חזותית, סטטוס של ענף ושל בקשת משיכה, ו-worktrees כולם עובדים, ומגובים על ידי git ושרשרת הכלים שבתוך ההפצה. "Open in editor" פותח את VS Code המחובר להפצה דרך Remote - WSL.

אם תכונה של Desktop אינה זמינה או מוגבלת בסשן WSL, בדוק אם היא אחת מאלה:

• מסוף ומחברים: ייתכן שהסשן חסר את המסוף המשולב, מחברים, או את שניהם. ראה אם המסוף או המחברים אינם זמינים.
• תוספים: לא זמינים בסשני WSL
• עריכת קבצים: אפשר לצפות בקבצים בחלונית הקבצים אבל אי אפשר לערוך אותם שם, אז בקש מ-Claude לבצע את השינויים
• קבצים מצורפים: אם תפריט + מציג Add image במקום Add files or photos, אפשר לצרף רק תמונות. ראה הוספת קבצים והקשר להנחיות.

#אם המסוף או המחברים אינם זמינים

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

• חשבון Claude: שתי התכונות מושקות בנפרד. בחר Help > Check for Updates…, ואם תכונה עדיין חסרה אחרי העדכון, אין מה לעשות.
• ספק צד שלישי: סשני WSL לא מקבלים את המסוף או את המחברים, ועדכון Desktop לא משנה את זה

#מכשירים מנוהלים

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