תיעוד 4

קלוד קוד דסקטופ ב-WSL

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

לפי התיעוד הרשמי, נבדק ב-17.8.2026.

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

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

#דרישות

Windows 10 או 11 עם WSL 2. WSL 1 לא נתמך.
לפחות הפצה אחת מותקנת (למשל אובונטו).
git מותקן בתוך ההפצה.

#התחלת סשן WSL

בחירת הפצה מתחילים סשן חדש בלשונית Code ופותחים את בורר ה-Environment. הפצות WSL 2 המותקנות מופיעות במקטע WSL. בוחרים אחת.
בחירת תיקייה הסשן מתחיל בתיקיית הבית של ההפצה. משתמשים בבורר התיקיות כדי לבחור תיקיית פרויקט. הגלישה מתבצעת בתוך ההפצה, עם נתיבי לינוקס כמו /home/you/project.
אמון בתיקייה הסשן הראשון בתיקייה מציג את דיאלוג האמון בתיקיית העבודה. נותנים אמון לפי הפצה ולפי תיקייה. תיקייה שסומכים עליה בהפצה אחת אינה מהימנה בהפצה אחרת, וגם לא באותו נתיב בוינדוס.

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

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

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

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

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

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

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