📘 תיעוד 19

שימוש ב-Claude Code ב-VS Code

התקן והגדר את תוסף Claude Code עבור VS Code. קבל סיוע כתיבת קוד מבוסס בינה מלאכותית עם diffs מוטבעים, אזכורי @, סקירת תוכניות וקיצורי מקלדת.

תוסף VS Code מספק ממשק גרפי מקורי ל-Claude Code, שמשולב ישירות ב-IDE. זו הדרך המומלצת להשתמש ב-Claude Code ב-VS Code.

עם התוסף אפשר:

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

#דרישות מוקדמות

לפני ההתקנה, ודא שיש לך:

• VS Code בגרסה 1.94.0 או חדשה יותר
• חשבון Anthropic: כל מנוי Claude בתשלום (Pro, Max, Ultra, Team או Enterprise) או חשבון Claude Console מתאים, ואין צורך במפתח API. נכנסים עם החשבון הזה בפתיחה הראשונה של התוסף. אם הגישה ל-Claude היא דרך ספק צד שלישי כמו Amazon Bedrock או Google Cloud's Agent Platform, ראה שימוש בספקי צד שלישי להוראות הגדרה.

[!TIP]

התוסף כולל עותק משלו של ה-CLI (ממשק שורת פקודה) עבור לוח הצ'אט. כדי להריץ את claude במסוף המשולב של VS Code, צריך גם התקנת CLI עצמאית. ראה תוסף VS Code מול Claude Code CLI לפרטים.

#התקנת התוסף

לחץ על הקישור של ה-IDE כדי להתקין ישירות:

• התקנה עבור VS Code
• התקנה עבור Cursor

או ב-VS Code, לחץ Cmd+Shift+X (Mac) או Ctrl+Shift+X (Windows/Linux) כדי לפתוח את תצוגת Extensions, חפש "Claude Code" ולחץ Install.

[!NOTE]

חנויות התוספים הן תוכנות של צד שלישי, ש-Anthropic לא מאשרת, לא מתחזקת ולא מבקרת. Anthropic שולחת תוספים לפרסום ב-Visual Studio Marketplace וב-Open VSX Registry.

מספר הגרסה של התוסף הוא גרסת Claude Code שהוא כולל. לדוגמה, תכונה שדורשת Claude Code v2.1.286 או חדש יותר צריכה גרסה 2.1.286 או חדשה יותר של התוסף, שתצוגת Extensions מציגה.

Claude Code רץ גם בעורכים ובמכולות אחרים:

• פיצולים אחרים של VS Code: התוסף מותקן גם בפיצולים כמו Devin Desktop או Kiro. חפש "Claude Code" בתצוגת Extensions של העורך, או התקן מ-Open VSX Registry.
• עורכים שלא יכולים להתקין את התוסף: התקן את ה-CLI והרץ את claude במסוף המשולב של העורך. ה-CLI עובד בכל מסוף.
• מכולות פיתוח: כדי להריץ את Claude Code בתוך מכולת פיתוח, ראה מכולות פיתוח.

[!NOTE]

אם התוסף לא מופיע אחרי ההתקנה, הפעל מחדש את VS Code או הרץ "Developer: Reload Window" מלוח הפקודות.

#תחילת העבודה

אחרי ההתקנה אפשר להתחיל להשתמש ב-Claude Code דרך הממשק של VS Code:

1. פתיחת לוח Claude Code

   בכל VS Code, סמל Spark מסמן את Claude Code:

   הדרך המהירה ביותר לפתוח את Claude היא ללחוץ על סמל Spark ב-Editor Toolbar (הפינה הימנית העליונה של העורך). הסמל מופיע רק כשיש קובץ פתוח.

   

   דרכים נוספות לפתוח את Claude Code:

   • Activity Bar: לחץ על סמל Spark בסרגל הצד השמאלי כדי לפתוח את רשימת הסשנים. לחץ על סשן כלשהו כדי לפתוח אותו במיקום המועדף, או התחל סשן חדש. הסמל הזה תמיד גלוי ב-Activity Bar.
   • Command Palette: Cmd+Shift+P (Mac) או Ctrl+Shift+P (Windows/Linux), הקלד "Claude Code" ובחר אפשרות כמו "Open in New Tab"
   • Status Bar: לחץ על ✻ Claude Code בפינה הימנית התחתונה של החלון. זה עובד גם כשאין קובץ פתוח.

   אפשר לגרור את לוח Claude כדי למקם אותו בכל מקום ב-VS Code. ראה התאמה אישית של תהליך העבודה לפרטים.

2. כניסה

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

   אם מופיע מאוחר יותר Not logged in · Please run /login, התוסף פותח מחדש את מסך הכניסה אוטומטית. אם הוא לא מופיע, טען מחדש את החלון מלוח הפקודות עם Developer: Reload Window.

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

   אחרי הכניסה מופיעה רשימת משימות Learn Claude Code. עבור על כל פריט בלחיצה על Show me, או סגור אותה עם ה-X. כדי לפתוח אותה שוב מאוחר יותר, בטל את הסימון של Hide Onboarding בהגדרות VS Code תחת Extensions > Claude Code.

3. שליחת הנחיה

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

   [!TIP]

   Claude רואה אוטומטית את הטקסט שנבחר. לחץ Option+K (Mac) / Alt+K (Windows/Linux) כדי להוסיף גם הפניה של אזכור @ (כמו @file.ts#5-10) להנחיה.

   הנה דוגמה לשאלה על שורה מסוימת בקובץ:

   

4. סקירת שינויים

   בדוק את מצב ההרשאות שמוצג בתחתית תיבת ההנחיה:

   • במצב Auto או Edit automatically, Claude עורך את רוב הקבצים בסביבת העבודה בלי לבקש.

   • במצב Manual, כש-Claude רוצה לערוך קובץ, הוא מציג השוואה זה לצד זה של המקור ושל השינויים המוצעים, ואז מבקש הרשאה. אפשר לקבל, לדחות, או לומר ל-Claude מה לעשות במקום. אם עורכים את התוכן המוצע ישירות בתצוגת ה-diff לפני הקבלה, Claude מקבל הודעה ששינית אותו כדי שלא יניח שהקובץ תואם להצעה המקורית שלו.

     

   כדי לסקור עריכה מוצעת שינוי אחד בכל פעם, השתמש בכפתורים Accept this change ו-Reject this change מתחת לכל שינוי ב-diff. דחיית שינוי מחזירה אותו בתוכן המוצע. קבלה מסמנת אותו כנבדק. סקירה לפי שינוי דורשת Claude Code v2.1.275 או חדש יותר.

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

   אותן פעולות זמינות במיקום הסמן מתפריט ההקשר של העורך ומלוח הפקודות בשם Claude Code: Accept Change at Cursor ו-Claude Code: Reject Change at Cursor.

   לרעיונות נוספים על מה שאפשר לעשות עם Claude Code, ראה תהליכי עבודה נפוצים.

   [!TIP]

   הרץ "Claude Code: Open Walkthrough" מלוח הפקודות לסיור מודרך ביסודות.

#שימוש בתיבת ההנחיה

תיבת ההנחיה תומכת בכמה תכונות:

• מצבי הרשאה: לחצו על מחוון המצב בתחתית תיבת ההנחיה כדי להחליף מצבי הרשאה. ב-Claude Code v2.1.283 או חדש יותר, Auto הוא מצב ההרשאה ההתחלתי המובנה, ובגרסאות קודמות רק בתוכניות Pro, Max, Ultra ו-Team. ראו איך התוסף בוחר את מצב ההרשאה ההתחלתי לגבי מה שמשנה את זה, ולגבי כל מצב הרשאה שהמחוון מציע.

  • Auto: מסווג בודק את רוב הפעולות במקום לשאול אתכם. ראו מצב auto לגבי מה שהוא בודק ומה הוא חוסם.

  • Manual: Claude מבקש הרשאה לפני עריכות קבצים ולפני רוב פקודות המעטפת.

  • Plan: Claude מתאר מה הוא יעשה וממתין לאישור לפני ביצוע שינויים. VS Code פותח אוטומטית את התוכנית כמסמך Markdown מלא, שבו אפשר להוסיף הערות בתוך השורה כדי לתת משוב לפני ש-Claude מתחיל.

    אפשר גם להקליד /plan בתיבת ההנחיה. נדרש Claude Code v2.1.280 או חדש יותר.

    • /plan: עובר למצב תוכנית. אם כבר נמצאים במצב תוכנית, מוצגת התוכנית הנוכחית.
    • /plan עם משימה, למשל /plan fix the auth bug: עובר למצב תוכנית ומתחיל לתכנן את המשימה.
    • /plan open: כשכבר נמצאים במצב תוכנית, פותח את קובץ התוכנית בעורך.

  • Edit automatically: Claude מבצע עריכות בלי לבקש.

• מודל: בחרו Switch model… מתפריט הפקודות כדי להחליף מודל באמצע הסשן. אפשר גם ללחוץ על שם המודל בתחתית תיבת ההנחיה כדי לפתוח את אותו בורר. ב-Claude Code v2.1.284 או חדש יותר, הקלדת /model לבדה בתיבת ההנחיה פותחת גם היא את הבורר.

  כשהמודל הנוכחי תומך ברמות מאמץ, הבורר מציג גם שורת Effort וכפתור שם המודל מציג את הרמה שנבחרה. כשבוחרים רמה שאינה max, Claude Code שומר אותה עבור המודל הנוכחי כברירת המחדל, תחת modelSettings בהגדרות המשתמש. max חל על הסשן הנוכחי בלבד. כפתור שם המודל ושורת Effort דורשים Claude Code v2.1.257 או חדש יותר.

  כשזרימות עבודה דינמיות מופעלות והמודל הנוכחי תומך בזה, מתג Ultracode מופיע מתחת לשורת Effort. הפעילו אותו כדי ש-Claude יתכנן זרימת עבודה לכל משימה מהותית בסשן הזה, ברמת המאמץ שנבחרה. כשהוא פועל, כפתור שם המודל מציג · Ultracode אחרי הרמה. המתג דורש Claude Code v2.1.284 או חדש יותר.

• תפריט פקודות: לחצו על / או הקלידו / כדי לפתוח את תפריט הפקודות. האפשרויות כוללות צירוף קבצים והחלפת מודלים.

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

  • כדי לעיין בפקודות כמו /usage או /remote-control, בחרו Slash commands במקטע Customize. תיבת דו שיח מציגה אותן עם תיבת סינון. בחרו אחת כדי להריץ אותה. הקלדת / בתיבת ההנחיה עדיין מציעה פקודות בתוך השורה. נדרש Claude Code v2.1.257 או חדש יותר.

    הקלדת /skills פותחת גם היא את תיבת הדו שיח הזו. כל שורת skill מציגה את הנראות שלה, למשל On או Name only. לחצו על הנראות כדי לשנות אותה, חוץ משורות שמסומנות locked, כמו skills של תוספים. קיצור הדרך /skills ובקרי הנראות דורשים Claude Code v2.1.280 או חדש יותר.

  • בחרו Output styles במקטע Customize כדי לבחור סגנון פלט, כולל הסגנונות המותאמים אישית שלכם. נדרש Claude Code v2.1.257 או חדש יותר.

    כדי ליצור סגנון מותאם אישית, בחרו Build a custom style מתפריט Output styles. Claude Code כותב עבורכם את קובץ הסגנון ברמת הפרויקט או ברמת המשתמש. נדרש Claude Code v2.1.261 או חדש יותר.

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

  • בחרו Permissions במקטע Customize כדי לראות את כללי ההרשאה של הסשן, מקובצים ל-Allow, Ask ו-Deny. אפשר להוסיף כללים להגדרות המשתמש, הפרויקט או ההגדרות המקומיות, ולהסיר כללים שנשמרו שם. כללים ממקורות אחרים, כמו הגדרות מנוהלות או אישורים שניתנו לסשן הזה בלבד, הם לקריאה בלבד. נדרש Claude Code v2.1.269 או חדש יותר.

  • בחרו Memory במקטע Customize כדי להפעיל או לכבות זיכרון אוטומטי. כשהאפשרות פעילה, אפשר גם לעיין בזיכרונות ש-Claude שמר ולחשוף את התיקיות ששומרות אותם במנהל הקבצים. נדרש Claude Code v2.1.274 או חדש יותר.

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

  • בחרו Instructions במקטע Customize כדי לערוך את קובצי CLAUDE.md ש-Claude קורא. בחרו קובץ כדי לפתוח אותו בעורך. אם הקובץ עדיין לא קיים, Claude Code יוצר אותו קודם. נדרש Claude Code v2.1.274 או חדש יותר.

  • בחרו Status במקטע Customize, או הקלידו /status, כדי לבדוק את גרסת Claude Code של הסשן, החשבון, המודל ופרטי שרתי MCP. נדרש Claude Code v2.1.280 או חדש יותר.

  • בחרו Sandbox במקטע Customize, או הקלידו /sandbox, כדי לראות אם פקודות Bash של Claude רצות בארגז חול. אפשר להחליף את מצב ארגז החול ולהוסיף שם פקודות מוחרגות. נדרש Claude Code v2.1.280 או חדש יותר.

  • בחרו Claude in Chrome במקטע Customize, או הקלידו /chrome, כדי לבדוק ולנהל את החיבור של Claude in Chrome. שניהם דורשים התחברות עם חשבון claude.ai. נדרש Claude Code v2.1.280 או חדש יותר.

  • בחרו Export conversation במקטע Context, או הקלידו /export, כדי להעתיק את השיחה כטקסט רגיל או לשמור אותה בקובץ. הוסיפו שם קובץ, למשל /export notes.txt, כדי לדלג על תיבת הדו שיח ולבחור איפה לשמור את הקובץ. נדרש Claude Code v2.1.280 או חדש יותר.

  • מקטע Settings כולל את Enable Remote Control for all sessions, שמגדיר את remoteControlAtStartup כדי לקבוע אם סשנים אינטראקטיביים חדשים מתחברים ל-Remote Control אוטומטית. נדרש Claude Code v2.1.203 או חדש יותר.

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

  • מקטע Settings כולל גם את Focus view, שמסתיר קריאות לכלים, תוצאות כלים וחשיבה מאחורי שורות שאפשר להרחיב, ומשאיר את ההנחיות שלכם ואת התשובות של Claude. אפשר להחליף את המצב שם, באמצעות Ctrl+Option+F (Mac) / Ctrl+Alt+F (Windows/Linux), או מלוח הפקודות באמצעות Claude Code: Toggle Focus view. השינוי חל על כל סשן פתוח ונשמר בין סשנים. נדרש Claude Code v2.1.221 או חדש יותר.

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

  • כדי להתנתק מחשבון Anthropic, בחרו Sign out במקטע Settings, או הקלידו /logout. אצל ספק צד שלישי, התפריט לא מציע אף אחת מהאפשרויות. נדרש Claude Code v2.1.277 או חדש יותר.

  • כדי לדווח על באג, לחצו על Report a problem בתחתית התפריט, או הקלידו /bug או /feedback עם תיאור אופציונלי שממלא מראש את הדיווח. כששולחים את הדיווח ומחוברים ל-Anthropic בחיבור צד ראשון, Claude Code שולח אותו ל-Anthropic. נדרש Claude Code v2.1.229 או חדש יותר.

    אצל ספק צד שלישי, או בלי פרטי גישה של Anthropic, לא נשלח דבר. תיבת הדו שיח אומרת זאת לפני שכותבים. השליחה שומרת את הדיווח כארכיון מקומי תחת ~/.claude/feedback-bundles/, עם השחרה של תבניות מוכרות של מפתחות API ואסימונים. שמירת הדיווח במחשב דורשת Claude Code v2.1.284 או חדש יותר.

    אחרי שהדיווח נשמר, האישור מציין את שם הקובץ וכולל כפתור Show folder. שלחו את הקובץ לנציג חשבון Anthropic שלכם או צרפו אותו לבקשת תמיכה.

    אם מדיניות הארגון מכבה משוב על המוצר, Report a problem לא מופיע בתפריט, ו-/bug ו-/feedback מציגים הודעה Feedback is turned off by your organization's policy or this environment's settings. במקום לפתוח את הדיווח. ב-Claude Code v2.1.284 או חדש יותר, אם מגדירים את משתנה הסביבה DISABLE_FEEDBACK_COMMAND או CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC, גם אז המשוב כבוי ופתיחת הדיווח מציגה את ההודעה הזו.

• שאלות צד: הקלידו /btw ואחריו שאלה כדי לשאול על הסשן בלי להוסיף לשיחה. התשובה נפתחת בחלונית ליד הצ'אט, שם אפשר לשאול שאלות המשך. נדרש Claude Code v2.1.227 או חדש יותר.

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

• העתקת תשובה: רחפו מעל תשובה ולחצו על Copy response כדי להעתיק אותה ללוח, או הקלידו /copy כדי להעתיק את התשובה האחרונה. /copy 2 מעתיק את התשובה שלפני האחרונה. נדרש Claude Code v2.1.277 או חדש יותר.

• סימניות: רחפו מעל תשובה ולחצו על Bookmark response כדי לשמור אותה, או לחצו על Remove bookmark בתשובה שמורה כדי להסיר אותה.

  כדי לעיין בתשובות שמורות, פתחו את חלונית Bookmarks. אפשר ללחוץ על סמל הסימניה בראש חלונית Claude Code, לבחור Bookmarks במקטע Context של תפריט הפקודות, או להקליד /bookmarks. נדרש Claude Code v2.1.286 או חדש יותר.

• קבצים ש-Claude שולח לכם: כשהסשן מחובר ל-Remote Control ו-Claude שולח לכם קבצים באמצעות כלי SendUserFile, השיחה מציגה שורה כמו Sent report.md, chart.png. לחצו על שם קובץ כדי לפתוח אותו בעורך. השורה נשארת גלויה ב-Focus view. נדרש Claude Code v2.1.295 או חדש יותר.

  קובץ מופיע כנתיב מלא שאי אפשר ללחוץ עליו, למשל \\server\share\report.md, כשהנתיב שלו מציין מארח רשת. Claude Code לא מקשר את הקובץ הזה כי פתיחה שלו הייתה יוצרת קשר עם המארח, וב-Windows יכולה לשלוח את פרטי הגישה של Windows למארח הזה.

• מחוון הקשר: תיבת ההנחיה מציגה כמה מחלון ההקשר של Claude נמצא בשימוש. Claude דוחס אוטומטית כשצריך, או שאפשר להריץ /compact ידנית.

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

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

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

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

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

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

  ב-Claude Code v2.1.286 או חדש יותר, כשלוחצים על Stop או על Esc, התור הנוכחי מסתיים. סוכני רקע ממשיכים לרוץ עד שהם מסיימים או עד שעוצרים אותם מהמפה.

• חשיבה מורחבת: מאפשרת ל-Claude להשקיע יותר זמן בהסקה על בעיות מורכבות. כדי לכבות אותה או להפעיל אותה מחדש, השתמשו במתג Thinking במקטע Model של תפריט הפקודות (/). במודלים שבהם אי אפשר לכבות חשיבה, אין בתפריט מתג Thinking והחשיבה נשארת פעילה.

  בלוק חשיבה שמציג רק תווית, למשל Thought for 12s, לא כולל טקסט ולא נפתח בלחיצה. כדי לראות סיכומי חשיבה, הגדירו את showThinkingSummaries ל-true ב-~/.claude/settings.json, ואז הריצו Developer: Reload Window מלוח הפקודות.

  בלוקי חשיבה שכבר יש לכם נשארים ריקים. בתשובות שאחרי הטעינה מחדש, לחצו על בלוק או לחצו על Ctrl+O כדי להרחיב את כולם.

• קלט מרובה שורות: לחצו על Shift+Enter כדי להוסיף שורה חדשה בלי לשלוח. זה עובד גם בשדה הטקסט החופשי "Other" בתיבות דו שיח של שאלות.

#הפניה לקבצים ולתיקיות

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

Explain the logic in @auth (fuzzy matches auth.js, AuthService.ts, etc.)
What's in @src/components/ (include a trailing slash for folders)

#קריאת עמודים מסוימים בקובץ PDF

בקובצי PDF גדולים אפשר לבקש מ-Claude לקרוא עמודים מסוימים במקום את כל הקובץ. בקשו עמוד אחד, טווח כמו עמודים 1-10, או טווח פתוח כמו מעמוד 3 ואילך. קריאת עמודים מסוימים דורשת poppler-utils במכונה שבה Claude Code רץ.

#הכללת פלט מסוף בהנחיות

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

#צירוף תמונות וקבצים

• כדי לצרף תמונה, הדביקו אותה מהלוח לתוך תיבת ההנחיה.
• כדי לצרף קבצים, החזיקו את Shift בזמן גרירתם לתוך תיבת ההנחיה.
• כדי להסיר קובץ מצורף מההקשר, לחצו על ה-X שעליו.

#הדבקת טקסט

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

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

• אם מופיעה הודעה כמו Removed 3 invisible characters from the pasted text בזמן ההדבקה, הטקסט נכנס בלי התווים האלה.
• אם מופיעה הודעה על תווים שהוסרו בזמן השליחה, לא נשלח דבר. הטקסט הנקי חוזר לתיבת ההנחיה. שלח שוב כדי לשלוח את הטקסט כפי שהוא מוצג.

#הקשר אוטומטי מהבחירה ומהקובץ הפתוח

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

לחץ על Option+K (Mac) / Alt+K (Windows/Linux) כדי להוסיף אזכור @ עם נתיב הקובץ ומספרי השורות, לדוגמה @app.ts#5-10.

#השארת הבחירה והקובץ הפתוח מחוץ להודעות

כדי למנוע מטקסט נבחר או מהקובץ הפתוח להיכנס להודעות, כבה את ההגדרה המתאימה בהגדרות VS Code:

• טקסט נבחר: כבה את הגדרת Attach Selection. נדרש Claude Code v2.1.300 או חדש יותר. כדי לבטל בחירה אחת, לחץ על X ליד ספירת השורות. הספירה חוזרת כשבוחרים טקסט אחר.
• קובץ פתוח: כבה את הגדרת Attach Open File. נדרש Claude Code v2.1.271 או חדש יותר. הקובץ נשאר בחוץ אלא אם ההודעה כוללת טקסט שבחרת בו.

כדי להוסיף טקסט כאזכור @ כש-Attach Selection כבוי, בחר אותו ולחץ על Option+K ב-Mac או על Alt+K ב-Windows וב-Linux.

שתי ההגדרות חלות גם כשמריצים claude במסוף המשולב של VS Code.

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

בחלונית הצ'אט, התוסף לא מעביר טקסט נבחר מקבצים מסוימים:

• כשהקובץ נמצא בסביבת העבודה ומתאים להגדרות files.exclude או search.exclude, Claude מקבל לכל היותר את נתיב הקובץ ולא את הטקסט שנבחר.
• אותו דבר חל על קובץ ש-git מתעלם ממנו, כל עוד הגדרת search.useIgnoreFiles של VS Code והגדרת respectGitIgnore של התוסף שתיהן פועלות, וזה ברירת המחדל.

המסנן הזה מכסה רק את חלונית הצ'אט. כש-Claude Code רץ במסוף המשולב, Claude יכול לקבל טקסט שנבחר בקבצים האלה. כדי למנוע מ-Claude לקבל שם את תוכן הקובץ, הוסף כלל דחייה של Read.

#מתמטיקת LaTeX בתשובות

חלונית הצ'אט מציגה מתמטיקת LaTeX בתשובות של Claude כנוסחאות מעומדות. עיבוד מתמטיקה דורש Claude Code v2.1.301 או חדש יותר. במצב מסוף, המתמטיקה לא מעומדת. החלונית מעמדת גם מתמטיקת תצוגה וגם מתמטיקה בתוך השורה:

• מתמטיקת תצוגה: בלוק $$ … $$ או \[ … \] בשורה או בשורות משלו, ובלוק קוד מגודר עם math כשפה שלו
• מתמטיקה בתוך השורה: $…$ או \(…\) שנפתחים ונסגרים באותה שורה, כמו $E = mc^2$ או \(a^2 + b^2 = c^2\)

החלונית מנסה להבחין בין מתמטיקה לבין שימושים אחרים באותם תווים, ולכן טקסט כמו $HOME, מחיר כמו $5, או sed 's/\(foo\)/\1/' לא מעומד. גם טקסט בתוך מקטע קוד או בתוך כל בלוק קוד שאינו בלוק math מגודר לא מעומד. אם נוסחה מוצגת כפי שנכתבה כשציפית שהיא תעומד, ראה נוסחה מוצגת כ-LaTeX גולמי.

כשבוחרים ומעתיקים טקסט שכולל נוסחה מעומדת, מקבלים את מקור ה-TeX של הנוסחה בתוך תוחמים $…$ או $$…$$ במקום הסמלים המצוירים. Copy response ו-/copy נותנים את התשובה כפי ש-Claude כתב אותה, כולל מקור ה-TeX.

#חידוש שיחות קודמות

לחץ על כפתור Session history בראש חלונית Claude Code כדי לגשת להיסטוריית השיחות. אפשר לחפש לפי מילת מפתח או לעיין לפי זמן.

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

• כותרות סשן: סשנים חדשים מקבלים כותרות שנוצרו על ידי בינה מלאכותית לפי ההודעה הראשונה.
• שינוי שם וארכיון: רחף מעל סשן כדי לחשוף את הפעולות האלה. שנה שם כדי לתת כותרת תיאורית, או העבר לארכיון כדי להעביר אותו לקבוצת Archived sessions בתחתית הרשימה.
• שיחות חסרות כש-claudeProcessWrapper מוגדר: עדכן את התוסף לגרסה 2.1.304 או חדשה יותר. הרשימה אז כוללת את השיחות שהיו חסרות, יחד עם סשנים ש-claude -p או Agent SDK התחילו בסביבת העבודה הזו.

כברירת מחדל, סשן בלי פעילות במשך 14 ימים עובר אל Archived sessions באופן אוטומטי, אלא אם הוא פתוח, לא נקרא, או בתוך קבוצה. ארכוב אוטומטי דורש Claude Code v2.1.265 או חדש יותר. כדי לשנות את התקופה או לכבות את זה, פתח את הגדרת Archive Inactive Sessions ובחר מספר ימים או Never.

כדי לשחזר סשנים מהארכיון:

• סשן אחד: הרחב את Archived sessions ולחץ על Unarchive session.
• כל הסשנים בארכיון בבת אחת: רחף מעל כותרת Archived sessions ברשימת הסשנים ב-Activity Bar ולחץ על סמל ביטול הארכיון שלה. נדרש Claude Code v2.1.277 או חדש יותר.

לפני v2.1.257, הפעולה הייתה Delete session, שהסתירה סשן בלי דרך לשחזר אותו. סשנים שנמחקו אז מופיעים תחת Archived sessions אחרי השדרוג.

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

• התוסף בוחר את מצב ההרשאה ההתחלתי מתוך claudeCode.initialPermissionMode או מבחירה שעוברת משיחה קודמת
• מוגדר אצלך claudeCode.claudeProcessWrapper
• כלל דחייה מסיר את הכלי ExitPlanMode

#השיחה עדיין פתוחה במקום אחר

כדי להמשיך בחלון הזה כשהודעה אומרת שהשיחה עדיין פתוחה במקום אחר, לחץ על Open here anyway אחרי הצעד שמתאים למקרה שלך:

• אין לך שום דבר אחר פתוח: תהליך Claude מלפני שהתוסף הופעל מחדש עשוי עדיין להחזיק את השיחה פתוחה. התהליך הזה בדרך כלל מסתיים מעצמו בתוך כ-10 דקות, אז המתן זמן זה ואז לחץ. אם לוחצים לפני שהוא מסתיים, השיחה פתוחה בשני מקומות עד שהוא מסתיים.
• השיחה פתוחה אצלך במקום אחר: סגור אותה שם קודם, לדוגמה על ידי יציאה מ-claude במסוף או סגירת הלשונית שלה בחלון VS Code אחר

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

This conversation is still open somewhere else. Using it in two places at once can mix up its messages. If the extension restarted recently, a Claude process from before the restart may still be finishing. It usually ends on its own within about 10 minutes. This notice stays until you choose Open here anyway.

כש-claudeProcessWrapper מוגדר, התוסף מדלג על הבדיקה הזו ופותח את השיחה ישירות.

#חידוש סשנים בענן מ-claude.ai

אם מריצים סשנים בענן, אפשר לחדש אותם ישירות ב-VS Code. זה דורש התחברות עם Claude.ai Subscription, לא עם Anthropic Console.

1. פתיחת היסטוריית הסשנים

לחץ על כפתור Session history בראש חלונית Claude Code.

2. בחירת לשונית Web

תיבת הדו-שיח מציגה שתי לשוניות: Local ו-Web. לחץ על Web כדי לראות סשנים מ-claude.ai.

3. בחירת סשן לחידוש

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

[!NOTE]

כשהתיקייה הפתוחה היא מאגר GitHub, לשונית Web מציגה רק סשנים מהמאגר הזה.

כשמחדשים סשן ענן, התוסף מוריד עותק של היסטוריית השיחה. שינויים לא מסתנכרנים בחזרה אל claude.ai.

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

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

#בדיקת חשבון ושימוש

הרץ /usage כדי לפתוח את תיבת הדו-שיח Account & usage

#הדבקת טקסט

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

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

• אם מופיעה הודעה כמו Removed 3 invisible characters from the pasted text בזמן ההדבקה, הטקסט נכנס בלי התווים האלה.
• אם מופיעה הודעה על תווים שהוסרו בזמן השליחה, שום דבר לא נשלח. הטקסט המנוקה חוזר לתיבת ההנחיה. שלחו שוב כדי לשלוח את הטקסט כפי שהוא מוצג.

#הקשר אוטומטי מהבחירה ומהקובץ הפתוח

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

לחצו על Option+K (Mac) / Alt+K (Windows/Linux) כדי להוסיף אזכור @ עם נתיב הקובץ ומספרי השורות, לדוגמה @app.ts#5-10.

#השארת הבחירה והקובץ הפתוח מחוץ להודעות

כדי למנוע מטקסט נבחר או מהקובץ הפתוח להיכנס להודעות, כבו את ההגדרה המתאימה בהגדרות של VS Code:

• טקסט נבחר: כבו את הגדרת Attach Selection. נדרש Claude Code v2.1.300 או חדש יותר. כדי להסיר בחירה אחת, לחצו על X ליד ספירת השורות. הספירה חוזרת כשבוחרים טקסט אחר.
• קובץ פתוח: כבו את הגדרת Attach Open File. נדרש Claude Code v2.1.271 או חדש יותר. הקובץ נשאר בחוץ אלא אם ההודעה כוללת טקסט שבחרתם בתוכו.

כדי להוסיף טקסט כאזכור @ כש-Attach Selection כבוי, בחרו אותו ולחצו על Option+K ב-Mac או על Alt+K ב-Windows וב-Linux.

שתי ההגדרות חלות גם כשמריצים את claude בטרמינל המשולב של VS Code.

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

בחלונית הצ'אט, התוסף מונע טקסט נבחר מכמה קבצים:

• כשהקובץ נמצא בתוך סביבת העבודה ומתאים להגדרות files.exclude או search.exclude, Claude מקבל לכל היותר את נתיב הקובץ ולא את הטקסט שנבחר.
• אותו דבר חל על קובץ ש-git מתעלם ממנו, כל עוד ההגדרה search.useIgnoreFiles של VS Code והגדרת respectGitIgnore של התוסף שתיהן פועלות, וזו ברירת המחדל.

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

#מתמטיקה ב-LaTeX בתשובות

חלונית הצ'אט מציגה מתמטיקה ב-LaTeX בתשובות של Claude כנוסחאות מסודרות. עיבוד מתמטיקה דורש Claude Code v2.1.301 או חדש יותר. במצב טרמינל, מתמטיקה לא מסודרת. החלונית מסדרת גם מתמטיקה לתצוגה וגם מתמטיקה בשורה:

• מתמטיקה לתצוגה: בלוק $$ … $$ או \[ … \] בשורה או בשורות משלו, ובלוק קוד מגודר עם math כשפה שלו
• מתמטיקה בשורה: $…$ או \(…\) שנפתח ונסגר באותה שורה, כמו $E = mc^2$ או \(a^2 + b^2 = c^2\)

החלונית מנסה להבדיל מתמטיקה משימושים אחרים באותם תווים, ולכן טקסט כמו $HOME, מחיר כמו $5, או sed 's/\(foo\)/\1/' לא מסודר. גם טקסט בתוך מקטע קוד או בתוך כל בלוק קוד מלבד בלוק math מגודר לא מסודר. אם נוסחה מוצגת כפי שנכתבה כשציפיתם שהיא תהיה מסודרת, ראו נוסחה מוצגת כ-LaTeX גולמי.

כשבוחרים ומעתיקים טקסט שכולל נוסחה מסודרת, מקבלים את מקור ה-TeX של הנוסחה במפרידים $…$ או $$…$$ במקום את הסמלים המצוירים. העתקת תשובה ו-/copy נותנים את התשובה כפי ש-Claude כתב אותה, כולל מקור ה-TeX.

#חידוש שיחות קודמות

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

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

• כותרות סשן: סשנים חדשים מקבלים כותרות שנוצרות על ידי AI לפי ההודעה הראשונה.
• שינוי שם והעברה לארכיון: רחפו מעל סשן כדי לחשוף את הפעולות האלה. שנו שם כדי לתת כותרת תיאורית, או העבירו לארכיון כדי להעביר אותו לקבוצה סשנים בארכיון בתחתית הרשימה.
• שיחות חסרות כש-claudeProcessWrapper מוגדר: עדכנו את התוסף לגרסה 2.1.304 או חדשה יותר. הרשימה אז כוללת את השיחות שחסרו, יחד עם סשנים ש-claude -p או ה-Agent SDK התחילו בסביבת העבודה הזו.

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

כדי לשחזר סשנים מהארכיון:

• סשן אחד: הרחיבו את סשנים בארכיון ולחצו על הוצאת סשן מהארכיון.
• כל הסשנים בארכיון בבת אחת: רחפו מעל הכותרת סשנים בארכיון ברשימת הסשנים בסרגל הפעילות ולחצו על סמל ההוצאה מהארכיון שלה. נדרש Claude Code v2.1.277 או חדש יותר.

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

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

• התוסף בוחר את מצב ההרשאה ההתחלתי מ-claudeCode.initialPermissionMode או מבחירה שעוברת משיחה קודמת
• הגדרתם את claudeCode.claudeProcessWrapper
• כלל דחייה מסיר את הכלי ExitPlanMode

#השיחה עדיין פתוחה במקום אחר

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

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

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

This conversation is still open somewhere else. Using it in two places at once can mix up its messages. If the extension restarted recently, a Claude process from before the restart may still be finishing. It usually ends on its own within about 10 minutes. This notice stays until you choose Open here anyway.

כש-claudeProcessWrapper מוגדר, התוסף מדלג על הבדיקה הזו ופותח את השיחה ישירות.

#חידוש סשנים בענן מ-claude.ai

אם מריצים סשנים בענן, אפשר לחדש אותם ישירות ב-VS Code. זה דורש התחברות עם Claude.ai Subscription, לא Anthropic Console.

1. פתיחת היסטוריית הסשנים

לחצו על כפתור היסטוריית סשנים בראש חלונית Claude Code.

2. בחירת לשונית Web

תיבת הדו-שיח מציגה שתי לשוניות: Local ו-Web. לחצו על Web כדי לראות סשנים מ-claude.ai.

3. בחירת סשן לחידוש

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

[!NOTE]

כשהתיקייה הפתוחה היא מאגר GitHub, לשונית Web מציגה רק סשנים מהמאגר הזה.

כשמחדשים סשן בענן, התוסף מוריד עותק של היסטוריית השיחה. השינויים לא מסתנכרנים בחזרה אל claude.ai.

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

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

#בדיקת חשבון ושימוש

הריצו את /usage כדי לפתוח את תיבת הדו-שיח Account & usage, שמציגה את החשבון המחובר ואת השימוש. נתוני השימוש תואמים לאופן ההתחברות:

• תוכנית claude.ai: פסי שימוש למגבלות התוכנית, כמו הסשן הנוכחי והשבוע.

  תיבת הדו-שיח גם מפרטת מה תורם למגבלות התוכנית:

  • המלצות: שינויים מוצעים, אחד בכל שורה, כמו Trim ~/code/api/CLAUDE.md · 49k tokens per request

  • כפתור תיקון: כדי ש-Claude Code יחיל את ההמלצות שהוא יכול, לחצו על הכפתור שמתחתיהן, כמו Fix both. כדי ללמוד על אילו שורות הכפתור פועל ומה קורה אחר כך בסשן, ראו החלת המלצות עם קיצור התיקון. נדרש Claude Code v2.1.305 או חדש יותר.

    הכפתור לא מוצג בזמן ש-Remote Control מחובר. אם אזהרה אומרת The usage fix wasn’t fully sent. Open usage and try again. אחרי ש-Remote Control התחבר, נתקו את Remote Control לפני שמנסים שוב.

  • שיוך: טבלאות של כמה שימוש הגיע מכל skill, subagent, plugin ושרת MCP

  השתמשו במתג Day ו-Week כדי לעבור בין 24 השעות האחרונות ל-7 הימים האחרונים. הנתונים משוערים ומחושבים מסשנים מקומיים במחשב הזה, ולכן שימוש ממכשירים אחרים או מ-claude.ai לא נכלל.

• התחברויות אחרות: כשמגבלות התוכנית לא חלות על ההתחברות, כמו אצל ספק צד שלישי או עם מפתח API, מקטע Usage מציג את העלות ואת שימוש הטוקנים של הסשן עצמו. ה-/usage של ה-CLI מציג את אותם סכומים בבלוק Session שלו. רשימת הסשנים בסרגל הפעילות גם מציגה את הסכומים של הסשן הפעיל תחת הכותרת Account & usage. נדרש Claude Code v2.1.277 או חדש יותר.

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

#חזרה אחורה עם נקודות ביקורת

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

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

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

#התאם את תהליך העבודה

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

#בחר איפה Claude נמצא

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

• Secondary sidebar: הצד הימני של החלון. משאיר את Claude גלוי בזמן שכותבים קוד.
• Primary sidebar: סרגל הצד השמאלי עם סמלים ל-Explorer, ל-Search וכן הלאה.
• Editor area: פותח את Claude כלשונית לצד הקבצים. שימושי למשימות צד.

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

כדי שהתוסף יפסיק לנעול קבוצות, כבה את ההגדרה Lock Editor Groups. קבוצות שכבר נעולות נשארות נעולות עד שמבטלים את הנעילה שלהן. ההגדרה דורשת Claude Code v2.1.274 או חדש יותר.

[!TIP]

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

#המשך שיחות אחרי טעינה מחדש

אחרי שמריצים Developer: Reload Window או מפעילים מחדש את VS Code, בדוק איפה השיחה הייתה פתוחה:

• לשונית עורך: השיחה חוזרת עם הלשונית שלה.
• סרגל צד: השיחה חוזרת אם נשלחה בה הודעה או ש-Claude הגיב בה ב-10 הדקות האחרונות. אם היא לא חוזרת, חדש את השיחה מ-היסטוריית סשנים.

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

#שלבים שנקטעו אחרי טעינה מחדש

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

#כיבוי המשך אחרי טעינה מחדש

כדי ש-Claude לא ימשיך שלב שנקטע אחרי טעינה מחדש, פתח את ההגדרה Continue After Reload ובטל את הסימון.

אם מגדירים את CLAUDE_CODE_RESUME_INTERRUPTED_TURN או כל משתנה CLAUDE_CODE_RESUME_ אחר בסביבה של VS Code או בהגדרה environmentVariables, אין לזה השפעה בלוח. הסיבה היא שהתוסף מסיר את המשתנים האלה לפני שהוא מפעיל את הסשנים של הלוח.

#שיחה לא נפתחה מחדש

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

“Fix the login bug” was not reopened. It did not finish opening the last 2 times, and opening it again may stop Claude Code from responding here.

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

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

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

השתמש ב-Open in New Tab או ב-Open in New Window מלוח הפקודות כדי להתחיל שיחות נוספות. לכל שיחה יש היסטוריה והקשר משלה, וכך אפשר לעבוד על משימות שונות במקביל.

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

#ארגן סשנים בקבוצות

ברשימת הסשנים ב-Activity Bar אפשר לאסוף סשנים קשורים לקבוצות בעלות שם שאפשר לקפל. דורש Claude Code v2.1.229 או חדש יותר.

• קיבוץ או ביטול קיבוץ של סשן: לחץ לחיצה ימנית על סשן כדי ליצור ממנו קבוצה, להעביר אותו לקבוצה קיימת, או להוציא אותו מהקבוצה שלו. כל סשן שייך לקבוצה אחת בכל פעם, ולכן העברה לקבוצה אחרת מוציאה אותו מהראשונה.
• העברת כמה סשנים בבת אחת: לחיצת Cmd (Mac) / לחיצת Ctrl (Windows/Linux) על כל סשן, או לחיצת Shift כדי לבחור טווח, ואז לחיצה ימנית על הבחירה.
• קיבוץ סשן מהלשונית שלו: הרץ Claude Code: Add Session Tab to Group מלוח הפקודות, ואז בחר או צור קבוצה. דורש Claude Code v2.1.257 או חדש יותר.
• שינוי שם או מחיקת קבוצה: לחץ לחיצה ימנית על כותרת קבוצה. מחיקת קבוצה מסירה רק את הקבוצה, והסשנים שלה חוזרים לרשימה הלא מקובצת.

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

#סנן את רשימת הסשנים

כדי לצמצם רשימת סשנים ארוכה ב-Activity Bar, השתמש בשני פקדי הסינון בראש הרשימה. דורש Claude Code v2.1.271 או חדש יותר. סשנים בארכיון לא מופיעים בזמן שאחד מהמסננים פועל.

• Active: הפעל את המתג הזה כדי להציג רק סשנים שצריכים את הקלט שלך, שעובדים, או שלא נקראו, וגם את הסשן בלשונית Claude שהייתה בפוקוס לאחרונה.
• סינון לפי סטטוס: לחץ על סמל המשפך, ואז סמן Needs input, Working או Completed כדי להציג סשנים בכל אחד מהמצבים האלה. סמן Open או Closed כדי לצמצם לפי השאלה אם סשן פתוח. סשן נחשב פתוח כשיש לו לשונית בחלון הזה, או כשהוא רץ בתהליך Claude Code אחר במחשב הזה, למשל בטרמינל.

כש-Active פועל ומסמנים סטטוס, Open או Closed, הרשימה מציגה גם כל סשן שתואם לסימונים. המסננים שהוגדרו נשמרים אחרי טעינות מחדש של החלון.

#עבור למצב טרמינל

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

אפשר גם ללחוץ Cmd+, ב-Mac או Ctrl+, ב-Windows/Linux כדי לפתוח את הגדרות VS Code, לעבור אל Extensions > Claude Code, ולסמן Use Terminal.

#ניהול plugins

תוסף VS Code כולל ממשק גרפי להתקנה ולניהול של plugins. הקלד /plugins בתיבת הפרומפט כדי לפתוח את הממשק Manage plugins.

#התקנת plugins

תיבת הדו-שיח של ה-plugins מציגה שתי לשוניות: Plugins ו-Marketplaces.

בלשונית Plugins:

• Installed plugins מופיעים למעלה עם מתגים להפעלה או לכיבוי.
  • אם מכבים plugin שקובץ .claude/settings.json המשותף של הפרויקט מפעיל, התוסף שואל קודם: Disable for me מכבה רק עבורך, ו-Disable for everyone משנה את הקובץ המשותף.
  • plugin שנכשל בטעינה מציג סיבה קצרה בשורה שלו. לחץ על הסיבה כדי לראות מה אפשר לעשות, כולל העתקת הודעת השגיאה המלאה לחיפוש ב-Troubleshoot plugins.
• Available plugins מ-marketplaces שהוגדרו מופיעים למטה
• חיפוש כדי לסנן plugins לפי שם או תיאור
• לחץ Install על כל plugin זמין

כשמתקינים plugin, בחר את היקף ההתקנה:

• Install for you: זמין בכל הפרויקטים שלך (היקף user)
• Install for this project: משותף עם משתפי הפעולה בפרויקט (היקף project)
• Install locally: רק עבורך, רק במאגר הזה (היקף local)

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

שדות טקסט רגישים מוסתרים, וסוד שנשמר קודם מציג (unchanged). השאר את השדה ריק כדי לשמור את הערך השמור. אחרי שמירת שינויים, הסשנים הפתוחים טוענים מחדש את ה-plugins שלהם, והדו-שיח מציג Restart Claude to apply plugin changes.

#הסרת plugins

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

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

• plugin שקובץ .claude/settings.json המשותף של הפרויקט מפעיל: בחר Disable for me, שמשאיר את ה-plugin מותקן עבור משתפי הפעולה, או Uninstall for everyone, שמסיר את התקנת הפרויקט עם --keep-data, כך שתיקיית הנתונים השמורים של ה-plugin נשארת. אם ה-plugin כבר כובה עבורך, סמל הפח מסיר את ההתקנה שלך בלי השאלה.
• אחרת, ההתקנה האחרונה של plugin עם נתונים שמורים: בחר אם לשמור או למחוק את הנתונים. Keep הוא ברירת המחדל

#שיתוף קישור להתקנת plugin

כדי לשלוח מישהו ישר להתקנת plugin מסוים, תן לו את כתובת ה-URL של install-plugin של התוסף. פתיחתה מפעילה או ממקדת את VS Code, פותחת את לוח Claude Code, ופותחת את דו-שיח Manage plugins על בחירת ההיקף של ה-plugin הזה. שום דבר לא מותקן עד שהאדם בוחר היקף. אם ה-marketplace של ה-plugin עדיין לא מוגדר ב-Claude Code שלו, הדו-שיח קודם מבקש להוסיף אותו.

vscode://anthropic.claude-code/install-plugin?plugin=code-review&marketplace=anthropics/claude-plugins-official

כתובת ה-URL מקבלת שני פרמטרי query:

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

• שם plugin: לכל היותר 100 תווים, מתחיל באות או בספרה של ASCII, ובשאר משתמש רק באותיות ASCII, בספרות, ב-., ב-_ וב--.
• מקור marketplace: רק הצורות שהפרמטר marketplace מציין, ולכן לא נתיב מקומי, לא כתובת http://, ולא שם ה-marketplace, כמו claude-plugins-official. כתובת URL של https:// לא יכולה להכיל שם משתמש, סיסמה או מחרוזת query.
• Git ref: כדי לנעוץ את ה-marketplace לענף או לתג, צרף את ה-ref למקור אחרי %23, הצורה המקודדת של #, כמו ב-marketplace=owner/repo%23v1.0. קישור עם # לא מקודד נכשל. marketplaces בארגון GitHub בשם anthropics אי אפשר לנעוץ בקישור.

מי שפותח קישור שמפר את הכללים האלה רואה שגיאה שמתחילה ב-Invalid plugin installation URL. לוח Claude Code והדו-שיח לא נפתחים, ושום דבר לא מותקן. אם אי אפשר לשים את שם ה-plugin או את ה-marketplace בקישור, אמור לאנשים להוסיף את ה-marketplace בלשונית Marketplaces ואז להתקין את ה-plugin מלשונית Plugins.

המקרים האלה מסתיימים בהודעה בדו-שיח במקום בבחירת ההיקף:

• ה-marketplace לא מציג plugin בשם הזה: הדו-שיח מדווח שה-plugin לא נמצא. בדוק את ערך plugin מול הרישום של ה-marketplace.
• ה-plugin כבר מותקן: הדו-שיח אומר זאת, ושום דבר לא משתנה.
• marketplace אחר עם אותו שם כבר נוסף: הדו-שיח אומר שה-marketplace של הקישור לא נוסף, ושום דבר לא מותקן.

ב-README של GitHub, ב-issues, ובחלק ממארחי Markdown אחרים מוסרים קישורים שהסכמה שלהם אינה http או https, ולכן קישור vscode:// שם מוצג כטקסט רגיל. שים את כתובת ה-URL בבלוק קוד אצל המארחים האלה, כפי ש-הקישור מוצג כטקסט רגיל במקום להיות לחיץ מתאר עבור קישורים מסוג claude-cli://.

#ניהול marketplaces

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

• הזן מאגר GitHub, כתובת URL או נתיב מקומי כדי להוסיף marketplace חדש
• לחץ על סמל הרענון כדי לעדכן את רשימת ה-plugins של marketplace
• לחץ על סמל הפח כדי להסיר marketplace. ההסרה מסירה כל plugin שהתקנת ממנו, ולכן אישור מציין קודם את ה-plugins האלה

שינויי plugins שנעשים בדו-שיח חלים מיד על סשני Claude Code הפתוחים בחלון VS Code הזה.

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

[!NOTE]

התוסף מנהל plugins על ידי הרצת אותן פקודות כמו ה-CLI. plugins ו-marketplaces שמגדירים בתוסף זמינים גם ב-CLI, ולהפך.

למידע נוסף על מערכת ה-plugins, ראה Plugins ו-Plugin marketplaces.

#plugins שמציירים בלוח

plugin שמכיל mod יכול לצייר בלוח הצ'אט. ציור דורש גרסת תוסף 2.1.299 או חדשה יותר. סשן שלא מושך feature flags, למשל סשן ב-Amazon Bedrock, צריך 2.1.304 או חדש יותר. מ-plugin כזה אפשר לראות:

• חלונית ליד השיחה או מעל תיבת הפרומפט
• toast או שורת סטטוס מעל תיבת הפרומפט
• הודעה או קריאת כלי שמצוירות בדרך של ה-plugin עצמו

כש-plugin שהותקן מוסיף או משנה משהו בלוח, תווית מציינת אותו, בביטויים כמו אלה:

• From the token-chart plugin: ה-plugin צייר או הדפיס את זה, או שהכרטיס הזה הוא ה-plugin ששואל אותך משהו
• Edited by the token-chart plugin: ה-plugin שינה משהו ש-Claude Code מצייר, למשל קריאת כלי
• Prompt from the token-chart plugin: ה-plugin שלח את ההודעה הזו בשמך

כדי ש-plugin יפסיק לצייר, כבה את ה-plugin ב-דו-שיח ה-plugins.

#אוטומציה של משימות דפדפן עם Chrome

חבר את Claude לדפדפן Chrome כדי לבדוק אפליקציות web, לנפות באגים עם יומני console, ולאוטמט תהליכי דפדפן בלי לצאת מ-VS Code. זה דורש את התוסף Claude in Chrome בגרסה 1.0.36 או חדשה יותר.

הקלד @browser בתיבת הפרומפט ואחריו את מה ש-Claude צריך לעשות:

@browser go to localhost:3000 and check the console for errors

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

Claude פותח לשוניות חדשות למשימות דפדפן ומשתף את מצב ההתחברות של הדפדפן, ולכן הוא יכול לגשת לכל אתר שכבר מחוברים אליו.

למידע נוסף על עבודה עם הדפדפן, ראה:

• הפעלת Chrome כברירת מחדל: שכל סשן יתחבר לדפדפן כשהוא מתחיל, בלי להקליד @browser
• בקשות הרשאה בסשנים של VS Code: מתי Claude Code שואל לפני פעולת דפדפן
• שימוש ב-Claude Code עם Chrome: הוראות הגדרה, הרשימה המלאה של היכולות, ופתרון בעיות

#עבודה עם git

Claude Code משתלב עם git כדי לעזור בתהליכי בקרת גרסאות ישירות ב-VS Code. בקשו מ-Claude לבצע commit לשינויים, ליצור pull requests, או לעבוד בין ענפים. כדי להפעיל את Claude ב-worktree מבודד עם קבצים וענף משלו, ראו הפעלת סשנים מקבילים עם worktrees.

#יצירת commits ו-pull requests

Claude יכול לבצע stage לשינויים, לכתוב הודעות commit, וליצור pull requests על בסיס העבודה שלכם:

commit my changes with a descriptive message
create a pr for this feature
summarize the changes I've made to the auth module

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

#פתיחה מחדש של שיחה שעברה ל-worktree

בשיחה שנפתחה מחדש, הבאנר This session is in worktree אומר שספריית העבודה של השיחה היא ה-worktree ששמו מופיע שם, ולא התיקייה שהחלון הזה פתח. כדי לפתוח את ה-worktree בחלון VS Code חדש, לחצו על Open worktree בבאנר.

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

#הרצת עבודה ברקע

שלחו פקודה ארוכה או subagent לרקע, ואז בדקו אותם מתיבת הפרומפט.

#העברת פקודה רצה או subagent לרקע

כשפקודה או subagent משאירים את Claude בהמתנה יותר ממה שאתם רוצים, לחצו על Run in background מתחת לקריאת הכלי שלו בשיחה. נדרש Claude Code v2.1.287 או חדש יותר.

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

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

#הפעולה Run in background חסרה מתחת ל-subagent

כברירת מחדל ב-VS Code, subagents לא מציגים את הפעולה הזו. כדי לראות למה עבור subagent אחד, פתחו את הכרטיס שלו ב-מפת הסוכנים וקראו את השורה Spawned by:

• Spawned by the main agent: ה-subagent התחיל ברקע, כך ש-Claude לא ממתין לו ואין צורך לעשות דבר. כדי ש-Claude ימתין ל-subagents במקום זאת, ראו תנו ל-Claude להמתין ל-subagent.
• Spawned by מציין subagent אחר: הפעולה מופיעה רק עבור subagents שהסוכן הראשי הפעיל, ולא עבור nested subagent ש-subagent אחר ממתין לו. כדי לסיים את ה-nested subagent מוקדם, לחצו על Stop agent בכרטיס שלו. ה-subagent הממתין ממשיך בלי התוצאה הזו.

#מעקב אחרי תהליכי רקע

הקלידו /tasks בתיבת הפרומפט כדי לפתוח את מפת הסוכנים, שמפרטת את משימות הרקע של הסשן, כמו שרת פיתוח ש-Claude השאיר רץ כפקודת shell ברקע. לחצו על משימה כדי לפתוח את הכרטיס שלה, שם אפשר לעצור אותה. נדרש Claude Code v2.1.277 או חדש יותר.

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

#צפייה בקריאות הכלים של subagent ברקע

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

#פקודות וקיצורי דרך של VS Code

כדי לפתוח את Command Palette, לחצו על Cmd+Shift+P ב-Mac או Ctrl+Shift+P ב-Windows/Linux. הקלידו "Claude Code" שם כדי לראות את כל פקודות VS Code הזמינות להרחבת Claude Code.

חלק מהקיצורים תלויים באיזה פאנל "focused" (מקבל קלט מקלדת). כשהסמן בקובץ קוד, העורך בפוקוס. כשהסמן בתיבת הפרומפט של Claude, Claude בפוקוס. השתמשו ב-Cmd+Esc / Ctrl+Esc כדי לעבור ביניהם.

[!NOTE]

אלה פקודות VS Code לשליטה בהרחבה. לא כל פקודות Claude Code המובנות זמינות בהרחבה. ראו הרחבת VS Code מול Claude Code CLI לפרטים.

#פתיחת לשונית VS Code מכלים אחרים

ההרחבה רושמת מטפל URI ב-vscode://anthropic.claude-code/open. השתמשו בו כדי לפתוח לשונית Claude Code חדשה מהכלים שלכם: כינוי shell, bookmarklet בדפדפן, או כל סקריפט שיכול לפתוח URL. אם VS Code עדיין לא רץ, פתיחת ה-URL מפעילה אותו קודם. אם VS Code כבר רץ, ה-URL נפתח בחלון שנמצא כרגע בפוקוס.

הפעילו את המטפל באמצעות פותח כתובות ה-URL של מערכת ההפעלה.

macOS

open "vscode://anthropic.claude-code/open"

Linux

xdg-open "vscode://anthropic.claude-code/open"

הפקודה xdg-open מגיעה מחבילת xdg-utils. אם ה-shell מדווח שהיא לא נמצאה, ראו xdg-open is not found on Linux.

Windows

ב-PowerShell:

Start-Process "vscode://anthropic.claude-code/open"

ב-cmd.exe, start מתייחס לארגומנט המצוטט הראשון שלו ככותרת חלון, לכן העבירו כותרת ריקה לפני ה-URL:

start "" "vscode://anthropic.claude-code/open"

המטפל מקבל שני פרמטרי query אופציונליים:

לדוגמה, כדי לפתוח לשונית שמולאה מראש ב-"review my changes":

vscode://anthropic.claude-code/open?prompt=review%20my%20changes

ההרחבה מטפלת גם ב-vscode://anthropic.claude-code/install-plugin, שפותח את תיבת הדו-שיח של תוספים על תוסף אחד. כדי להפעיל סשן טרמינל במקום לשונית VS Code, השתמשו במטפל claude-cli:// של ה-CLI. ראו הפעלת סשנים מקישורים.

#הגדרת הגדרות

אתם מגדירים את ההרחבה בשני מקומות, הגדרות ההרחבה של VS Code וקובץ ההגדרות של Claude Code:

• הגדרות הרחבה ב-VS Code: שולטות בהתנהגות ההרחבה בתוך VS Code. פתחו עם Cmd+, (Mac) או Ctrl+, (Windows/Linux), ואז עברו אל Extensions > Claude Code. אפשר גם להקליד / ולבחור General config… כדי לפתוח הגדרות.
• הגדרות Claude Code ב-~/.claude/settings.json: משותפות בין ההרחבה ל-CLI. השתמשו בהן לפקודות מותרות, משתני סביבה, hooks ושרתי MCP. עם Claude Code v2.1.283 או חדש יותר, אפשר גם להשתמש בהן כקלט אחד למצב ההרשאות שבו שיחות מתחילות. בגרסאות קודמות, אפשר לעשות זאת רק בתוכניות Pro, Max, Ultra ו-Team. החלפת מצבי הרשאה מפרט את הסדר. ראו הגדרות לפרטים.

[!TIP]

הוסיפו "$schema": "https://json.schemastore.org/claude-code-settings.json" ל-settings.json כדי לקבל השלמה אוטומטית ואימות בשורה לכל ההגדרות הזמינות ישירות ב-VS Code.

#הגדרות הרחבה

VS Code קורא את initialPermissionMode מהגדרות המשתמש ומתעלם מערכי workspace. לפני v2.1.225, VS Code הגדיר את ההגדרה כברירת מחדל ל-default והחיל ערכי workspace.

#שימוש בספקים צד שלישי

כברירת מחדל, Claude Code מתחבר ישירות ל-API של Anthropic. אם הארגון שלך משתמש ב-Amazon Bedrock, ב-Google Cloud's Agent Platform או ב-Microsoft Foundry כדי לגשת ל-Claude, הגדר את התוסף להשתמש בספק שלך:

1. כיבוי בקשת ההתחברות

פתח את ההגדרה Disable Login Prompt וסמן את התיבה.

אפשר גם ללחוץ על Cmd+, ב-Mac או על Ctrl+, ב-Windows/Linux כדי לפתוח את הגדרות VS Code, לחפש "Claude Code login", ולסמן את Disable Login Prompt.

2. הגדרת הספק

עקוב אחרי מדריך ההגדרה של הספק שלך:

• Claude Code on Amazon Bedrock
• Claude Code on Google Cloud's Agent Platform
• Claude Code on Microsoft Foundry

המדריכים האלה מכסים הגדרה של הספק ב-~/.claude/settings.json, מה שמבטיח שההגדרות משותפות בין תוסף VS Code לבין ה-CLI.

אצל ספק צד שלישי, התוסף לא מציע תכונות שדורשות חשבון claude.ai, כמו פסי שימוש בתוכנית, הכתבה קולית, ולשונית Web עבור הפעלות ענן. למה שתיבת הדו-שיח Account & usage מציגה בהתחברויות האלה, ראה בדיקת חשבון ושימוש.

התחברות claude.ai שנשארה מ-/login קודם נשארת בלי שימוש: התוסף לא שולח אותה עם אף בקשה.

#שימוש בקורא מסך

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

תמיכה בקורא מסך בלוח הצ'אט דורשת Claude Code v2.1.236 או גרסה מאוחרת יותר.

במהלך שיחה, התוסף מכריז על:

• תשובות של Claude: התוסף מכריז על כל תשובה פעם אחת, כשהיא מושלמת, ונשאר שקט בזמן שהטקסט זורם פנימה. קורא המסך קורא בלוקי קוד כסיכום של מספר שורות, קורא קישורים לפי התווית שלהם, וקורא טבלאות תא אחר תא. התשובה המלאה נשארת קריאה בתמליל.
• בקשות הרשאה ושאלות: התוסף מכריז על בקשה כשהנחיית ההרשאה מופיעה, ומציין את שם הכלי ש-Claude רוצה להשתמש בו. הוא מכריז באותו אופן כש-Claude שואל אותך שאלה וכש-Claude מסיים תוכנית ומחכה לסקירה שלך.
• שינויי סטטוס: התוסף מכריז כש-Claude מתחיל לעבוד, כש-Claude מוכן לקלט שלך, וכש-Claude Code מתחיל לדחוס את השיחה. אם אתה שולח הנחיה בזמן שה-hooks של SessionStart של ההפעלה עדיין רצים, קורא המסך אומר גם "Running start-up hooks."
• הודעות בתור: כשאתה שולח הודעה בזמן ש-Claude עובד, התוסף מכריז "Message queued." עבור ההודעה הזאת.
• שגיאות והנחיות מודל: התוסף מכריז על שגיאות בשיחה, ומכריז כשמופיעה הנחיית הסכמה לקרדיטי שימוש או הנחיית בקשה שסומנה.

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

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

#שימוש בלוח הצ'אט מהמקלדת

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

בתוך תור, קורא המסך מכריז על מי ההודעה שאתה נמצא עליה כשאתה נע בתוכה:

• ההודעות שלך: "You"
• ההודעות של Claude: "Claude"
• שלבי כלים: "Claude" ועוד שם הכלי, למשל "Claude, Bash"
• בלוקי חשיבה: "Claude, thinking"

מכיוון שהתוסף חושף את התמליל כאזור מתויג, אפשר גם להעביר את המיקוד לתמליל עצמו עם Tab ולקרוא אותו בקצב שלך. כדי להעביר את המיקוד להודעה החדשה ביותר או להנחיית הרשאה ממתינה, הרץ את Claude Code: Focus last message מלוח הפקודות.

כשאפשרות בהנחיית הרשאה שומרת כלל הרשאה או גישה לתיקייה, התווית שלה מסתיימת בציון המקום שבו האישור נשמר, למשל "all projects" או "this session". כדי לשנות את היעד:

• כשהאפשרות הזאת במיקוד, לחץ על מקש החץ Left או Right. התוסף מכריז על כל יעד כשאתה עובר אליו. מקשי החצים דורשים Claude Code v2.1.268 או גרסה מאוחרת יותר.
• לחץ על היעד בתווית.

#תוסף VS Code מול Claude Code CLI

Claude Code זמין גם כתוסף VS Code (לוח גרפי) וגם כ-CLI (ממשק שורת פקודה בטרמינל). חלק מהתכונות זמינות רק ב-CLI. אם אתה צריך תכונה שקיימת רק ב-CLI, הרץ את claude בטרמינל המשולב של VS Code. זה דורש את התקנת ה-CLI העצמאית: התוסף לא מוסיף את claude ל-PATH שלך. ראה הרצת CLI ב-VS Code.

#הרצת CLI ב-VS Code

כדי להשתמש ב-CLI תוך כדי שנשארים ב-VS Code, לחץ על Ctrl+` ב-Windows/Linux או על Cmd+` ב-Mac כדי לפתוח את הטרמינל המשולב, ואז הרץ את claude. הפעלת claude לא מתקינה את התוסף. בלעדיו, /ide בטרמינל המשולב מדווח "No available IDEs detected" ו-/status מציג את ה-IDE כ-"Not connected".

כדי לקבל תכונות כמו צפייה ב-diff ושיתוף אבחון, חבר את ה-CLI לתוסף מהטרמינל המשולב או מטרמינל חיצוני:

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

התקנת התוסף לא שמה את claude ב-PATH של המעטפת שלך. התוסף כולל עותק פרטי של ה-CLI עבור לוח הצ'אט שלו, אבל הקלדת claude בטרמינל דורשת את התקנת ה-CLI העצמאית. הרץ את ההתקנה פעם אחת והפקודות בדף הזה, כולל claude mcp add ו-claude --resume, עובדות בכל טרמינל. אם claude עדיין לא נמצא אחרי ההתקנה, אמת את ה-PATH שלך.

#מעבר בין התוסף ל-CLI

התוסף וה-CLI חולקים את אותה היסטוריית שיחות. כדי להמשיך שיחה מהתוסף ב-CLI, הרץ את claude --resume בטרמינל. זה פותח בורר אינטראקטיבי שבו אפשר לחפש ולבחור את השיחה שלך.

#חיבור לכלים חיצוניים עם MCP

שרתי MCP (Model Context Protocol) נותנים ל-Claude גישה לכלים חיצוניים, למסדי נתונים ול-API.

כדי לנהל שרתי MCP בלי לצאת מ-VS Code, הקלד /mcp בלוח הצ'אט. מתיבת הדו-שיח שנפתחת, אפשר:

• להוסיף שרתים
• להסיר שרתים שנשמרו בהיקף local, user או project
• להפעיל או להשבית שרתים
• להתחבר מחדש לשרת
• לנהל אימות OAuth

הוספה והסרה של שרתים בתיבת הדו-שיח דורשות Claude Code v2.1.261 או גרסה מאוחרת יותר.

אפשר גם להריץ את claude mcp add בטרמינל המשולב של VS Code (Ctrl+` או Cmd+`). תיבת הדו-שיח ופקודת הטרמינל נשמרות לאותה הגדרת MCP, ושינויים מכל אחת מהן נכנסים לתוקף בשיחות שמתחילים אחר כך. הדוגמה הבאה מוסיפה את שרת ה-MCP המרוחק של GitHub, שמאמת עם אסימון גישה אישי שמועבר ככותרת:

claude mcp add --transport http github https://api.githubcopilot.com/mcp/ \
  --header "Authorization: Bearer YOUR_GITHUB_PAT"

החלף את YOUR_GITHUB_PAT באסימון הגישה האישי שלך. הפקודה claude mcp add שומרת את ההגדרה בלי לאמת פרטי אימות, כך שערך מציין מקום מתקבל כאן אבל השרת נכשל בחיבור אחר כך. כדי לאמת את החיבור, התחל שיחה חדשה, הקלד /mcp, ובדוק שהשרת מציג Connected. שרת עם פרטי אימות שגויים מציג Failed.

אחרי ההגדרה, בקש מ-Claude להשתמש בכלים (למשל, "Review PR #456").

[!NOTE]

כדי למצוא שרתים לחיבור, ראה מציאה ובנייה של שרתי MCP.

#שרת ה-MCP המובנה של ה-IDE

כשהתוסף פעיל, הוא מריץ שרת MCP מקומי שה-CLI מתחבר אליו אוטומטית. דרך השרת הזה, ה-CLI:

• פותח diffs במציג ה-diff המקורי של VS Code
• קורא את הבחירה הנוכחית שלך עבור אזכורי @
• מבקש מ-VS Code להריץ תאים כשאתה עובד במחברת Jupyter

השרת נקרא ide והוא מוסתר מ-/mcp כי אין מה להגדיר. אם הארגון שלך משתמש ב-hook מסוג PreToolUse כדי לאפשר רשימת כלים של MCP, תצטרך לדעת שהוא קיים.

הקשר של בחירה וקובץ פתוח. בזמן חיבור, ה-CLI כולל את הבחירה הנוכחית בעורך ואת הנתיב של הקובץ הפעיל כהקשר בכל הנחיה שאתה שולח. התמליל מציג שורה ⧉ Selected N lines from <file> כשזה קורה. המקרים האלה משנים את ההקשר:

• הגדרת Attach Selection כבויה: ה-CLI לא כולל את הבחירה שלך כהקשר.
• הגדרת Attach Open File כבויה: ה-CLI כולל את נתיב הקובץ הפעיל רק כשהוא גם כולל בחירה.
• הודעות בתור: אם אתה שם הודעה בתור בזמן ש-Claude עובד, היא שומרת את הבחירה שהייתה לך כשלחצת Enter, בלי קשר למה שאתה בוחר אחר כך.
• קבצים רגישים: כדי להחריג קובץ רגיש כמו .env, הוסף כלל דחייה של Read עבור הנתיב שלו. כלל דחייה תואם מונע גם מהטקסט שנבחר וגם מהודעת הקובץ הפתוח של הקובץ הזה להגיע ל-Claude.

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

• תעבורה: ws:// לא מוצפן. מכיוון שהשקע הוא loopback בלבד, כל תהליך שיכול ללכוד את התעבורה יכול גם לקרוא את האסימון מקובץ הנעילה, ולכן TLS לא היה מוסיף הגנה.
• אסימון אימות: כל הפעלה של התוסף יוצרת אסימון אימות אקראי חדש וכותבת אותו לקובץ נעילה ב-~/.claude/ide/<port>.lock. ה-CLI חייב להציג את האסימון ככותרת X-Claude-Code-Ide-Authorization כדי להתחבר.
• הרשאות קובץ נעילה: לקובץ הנעילה יש הרשאות 0600 בתיקייה עם הרשאות 0700, כך שרק המשתמש שמריץ את VS Code יכול לקרוא אותו. אם CLAUDE_CONFIG_DIR מוגדר, קובץ הנעילה נכתב אל $CLAUDE_CONFIG_DIR/ide/ במקום זאת.

כלים שחשופים למודל. השרת מארח תריסר כלים, אבל רק שניים גלויים למודל. השאר הם RPC פנימי שה-CLI משתמש בו לממשק שלו, כמו פתיחת diffs, קריאת בחירות, ושמירת קבצים. הם מסוננים החוצה לפני שרשימת הכלים מגיעה ל-Claude.

אבחון בלוח הצ'אט. בלוח הצ'אט, עם Claude Code v2.1.285 או גרסה מאוחרת יותר, Claude קורא את לוח Problems של VS Code דרך שרת מובנה נפרד בשם claude-vscode. Claude יכול לבקש ממנו את השגיאות והאזהרות הנוכחיות בקובץ אחד, או בכל קובץ שיש ל-VS Code אבחון עבורו.

hooks וכללי הרשאה רואים את כלי האבחון של לוח הצ'אט כ-mcp__claude-vscode__getDiagnostics. כדי לכסות אבחון גם ב-CLI וגם בלוח הצ'אט, ציין את mcp__ide__getDiagnostics ואת mcp__claude-vscode__getDiagnostics ב-hook או בכלל שלך.

דוגמת settings.json הזאת דוחה את שני הכלים:

{
  "permissions": {
    "deny": [
      "mcp__ide__getDiagnostics",
      "mcp__claude-vscode__getDiagnostics"
    ]
  }
}

כלל דחייה של Read לא מכסה אף אחד מהכלים, אז חסום אותם לפי שם עם כלל דחייה כמו בדוגמה.

הרצת Jupyter תמיד שואלת קודם. mcp__ide__executeCode לא יכול להריץ שום דבר בשקט. כל קריאה עוברת את השלבים האלה:

1. הקוד מוכנס כתא חדש בסוף המחברת הפעילה.
2. VS Code גולל את התא אל תוך התצוגה.
3. Quick Pick מקורי מבקש ממך Execute או Cancel.

ביטול, או סגירת הבורר עם Esc, מחזיר שגיאה ל-Claude ושום דבר לא רץ. הכלי גם מסרב לחלוטין כשאין מחברת פעילה, כשתוסף Jupyter (ms-toolsai.jupyter) לא מותקן, או כשה-kernel אינו Python.

[!NOTE]

אישור ה-Quick Pick נפרד מ-hooks של PreToolUse. רשומה ברשימת ההיתר עבור mcp__ide__executeCode מאפשרת ל-Claude להציע הרצה של תא. ה-Quick Pick בתוך VS Code הוא מה שמאפשר לו באמת להריץ.

#תיקון בעיות נפוצות

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

#התוסף לא מותקן

• ודאו שיש לכם גרסה תואמת של VS Code (1.94.0 או חדשה יותר)
• בדקו של-VS Code יש הרשאה להתקין תוספים
• נסו להתקין ישירות מ-Visual Studio Marketplace

#סמל Spark לא נראה

סמל Spark מופיע ב-Editor Toolbar (פינה ימנית עליונה של העורך) כשיש קובץ פתוח. אם אינכם רואים אותו:

1. פתחו קובץ: הסמל דורש שקובץ יהיה פתוח. תיקייה פתוחה בלבד לא מספיקה.
2. בדקו את גרסת VS Code: נדרשת 1.94.0 או חדשה יותר. בדקו תחת Help > About
3. הפעילו מחדש את VS Code: הריצו "Developer: Reload Window" מלוח הפקודות
4. השביתו תוספים מתנגשים: השביתו זמנית תוספי AI אחרים (Cline, Continue וכו')
5. בדקו אמון בסביבת העבודה: התוסף לא עובד ב-Restricted Mode

לחלופין, לחצו על ✻ Claude Code ב-Status Bar בפינה הימנית התחתונה של החלון. זה עובד גם בלי קובץ פתוח. אפשר גם להשתמש ב-Command Palette (Cmd+Shift+P / Ctrl+Shift+P) ולהקליד "Claude Code".

#Cmd+Esc לא עושה כלום ב-macOS

ב-macOS Tahoe ומעלה, קיצור הדרך של Game Overlay במערכת קשור כברירת מחדל ל-Cmd+Esc ומיירט את הלחיצה לפני שהיא מגיעה ל-VS Code. כדי לשחרר את הקיצור:

1. פתחו את System Settings
2. עברו אל Keyboard, ואז Keyboard Shortcuts, ואז Game Controllers
3. נקו את תיבת הסימון של Game Overlay

לחלופין, קשרו את התוסף למקש אחר: פתחו את עורך קיצורי המקלדת של VS Code (Cmd+K Cmd+S), חפשו Claude Code: Focus input, והקצו קישור חדש.

#Ctrl+J מוסיף שורה חדשה בתיבת ההנחיה

כדי ש-Ctrl+J יפסיק להוסיף שורה חדשה בתיבת ההנחיה, בטלו את קישור המקש בקובץ keybindings.json של Claude Code. התוסף קורא את הקובץ הזה בגרסה 2.1.309 או חדשה יותר, אז עדכנו תוסף ישן יותר קודם בתצוגת Extensions.

הדוגמה הזו היא הקובץ כולו עם הרשומה האחת שמבטלת את קישור המקש, "ctrl+j": null בבלוק Chat:

{
  "bindings": [
    {
      "context": "Chat",
      "bindings": {
        "ctrl+j": null
      }
    }
  ]
}

הקובץ נמצא בתיקיית התצורה של Claude Code, שהיא ~/.claude אלא אם העברתם אותה עם CLAUDE_CONFIG_DIR. הסתכלו בתיקייה הזו ובצעו את הצעד שמתאים למה שמצאתם:

• עדיין אין keybindings.json: צרו אותו עם בדיוק התוכן של הדוגמה
• יש keybindings.json בלי בלוק Chat: הוסיפו את בלוק Chat מהדוגמה למערך bindings ברמה העליונה, בכל מיקום
• יש בלוק Chat בלי שורת "ctrl+j": הוסיפו "ctrl+j": null ל-bindings של הבלוק הזה
• יש בלוק Chat שכבר יש בו שורת "ctrl+j": שנו את הערך של השורה הזו ל-null

אחרי שתשמרו את הקובץ, לחיצה על Ctrl+J בתיבת ההנחיה לא מוסיפה שורה חדשה.

אם Ctrl+J עדיין מוסיף שורה בתיבת ההנחיה, הריצו את שתי הפקודות האלה מלוח הפקודות לפי הסדר:

1. Developer: Reload Window, ואז לחצו שוב על Ctrl+J בתיבת ההנחיה
2. Claude Code: Show Logs, ואז חפשו אזהרה שכוללת Ctrl+J in the chat input still inserts a newline. תקנו את הבעיה שהיא מדווחת בקובץ שהיא מציינת, שמרו את הקובץ, ולחצו שוב על Ctrl+J.

אם ביומן אין אזהרה כזו, בדקו שהקובץ נמצא בתיקיית התצורה של Claude Code ושבלוק Chat שלו מגדיר את "ctrl+j" ל-null. דווחו על הבעיה אם Ctrl+J עדיין מוסיף שורה.

#לוח Claude Code ריק או לא הצליח להיטען

אם לוח Claude Code נפתח אבל לא מציג כלום, אפילו לא את תיבת ההנחיה, עדכנו את התוסף ל-v2.1.309 או חדש יותר בתצוגת Extensions. ואז הריצו Developer: Reload Window מלוח הפקודות. אם אז אתם רואים הודעת Claude Code couldn’t load, עבדו לפי הצעדים שהיא מפרטת לפי הסדר.

אם הלוח עדיין לא נטען, פתחו את יומן התוסף ודווחו על הבעיה עם עותק שלו:

• עדיין ריק ב-v2.1.309 או חדש יותר: פתחו את היומן עם Claude Code: Show Logs מלוח הפקודות
• הצעדים בהודעה לא עזרו: לחצו על Show logs בהודעה כדי לפתוח את היומן

#שיחה שחודשה ריקה בהתחלה

כשאתם מחדשים שיחה קודמת או כשאחת חוזרת אחרי טעינה מחדש, ההודעות שלה יכולות להישאר ריקות בזמן שתהליך Claude Code של השיחה מתחיל. אחרי בערך שנייה, Waiting for your plugins… מופיע במרחב הריק.

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

#הלוח מפסיק להגיב בכל פעם שטעינה מחדש פותחת מחדש שיחה

אם כל הלוח קורס, קופא, או מציג רק Something went wrong בכל פעם שאתם טוענים מחדש והשיחה שלכם חוזרת, עדכנו את התוסף ל-v2.1.301 או חדש יותר. ואז טענו מחדש את החלון או הפעילו מחדש את VS Code שוב. אחרי שהשיחה נכשלת לסיים את הפתיחה פעמיים ברצף, אתם מקבלים במקומה צ'אט חדש, עם הודעה שהיא לא נפתחה מחדש.

#נוסחה מוצגת כ-LaTeX גולמי

אם אף מתמטיקה בתשובות של Claude לא מסודרת, בדקו את גרסת התוסף בתצוגת Extensions, כי עיבוד מתמטי דורש גרסה 2.1.301 או חדשה יותר. אם אתם משתמשים במצב טרמינל, שלא מסדר מתמטיקה בשום גרסה, בטלו את הסימון של ההגדרה Use Terminal כדי ש-Claude Code ייפתח בלוח הצ'אט.

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

• הנוסחה היא בשורה והלוח לא מתייחס אליה כמתמטיקה: בקשו מ-Claude לשלוח אותה שוב כבלוק $$ בשורות משלו. הלוח משאיר נוסחה בשורה כפי שנכתבה כשהטקסט בין המפרידים $…$ שלה:
  • הוא יותר מחשבון פשוט ועדיין אין בו תו כמו =, +, או ^ שמסמן אותו כמתמטיקה, כמו ב-$O(n log n)$
  • מתחיל בספרה ואין בו תו כזה, כמו ב-$30$ וב-$1/N$
  • יש בו רווחים בתוך סימני הדולר, כמו ב-$ x^2 $
  • ארוך מ-60 תווים
  • מפוצל על פני שתי שורות. נוסחת \(…\) שמפוצלת על פני שתי שורות גם היא לא מסודרת.
• לנוסחה יש שגיאת תחביר TeX: בקשו מ-Claude לכתוב אותה מחדש עם תיקון השגיאה.
• הנוסחה מגדירה מאקרו: נוסחה עם הגדרת מאקרו כמו \newcommand או \def מוצגת כפי שנכתבה. בקשו מ-Claude לכתוב אותה מחדש בלי המאקרו.
• הנוסחה מכילה % שלא עבר escape: בקשו מ-Claude לכתוב אותה מחדש עם \% לסימן אחוז.
• הנוסחה גדולה מדי: נוסחה ארוכה מ-8,192 תווים, או כזו שהפלט המסודר שלה יהיה גדול בהרבה ממקור ה-TeX שלה, מוצגת כפי שנכתבה. בקשו מ-Claude לפצל אותה לנוסחאות קטנות יותר או לכתוב אותה בצורה דחוסה יותר.
• הנוסחה באה אחרי כמות גדולה של מתמטיקה: בתוך בלוק טקסט אחד בתשובה, הלוח מסדר נוסחאות לפי הסדר עד גבול. נוסחה מאוחרת יותר שתעבור את הגבול מוצגת כפי שנכתבה. בקשו מ-Claude לשלוח שוב לבד את הנוסחה שאתם צריכים.

#הכתבה או לשונית Web נכשלות מאחורי פרוקסי שבודק TLS

כשהכתבה או לשונית Web נכשלות עם שגיאת אישור כמו unable to get local issuer certificate, הגדירו את NODE_EXTRA_CA_CERTS בבלוק env של ~/.claude/settings.json. הגדירו אותו לנתיב של קובץ PEM עם אישור CA השורש של הפרוקסי שלכם, שצוות ה-IT יכול לתת לכם. הכשל מופיע על כפתור המיקרופון או לשונית Web, או ביומנים:

• הכתבה: כפתור המיקרופון מציג את טקסט השגיאה אחרי Dictation error: WebSocket error:.
• לשונית Web: הלשונית שמפרטת הפעלות ענן מציגה Remote server is not connected בלי טקסט השגיאה. כדי לקרוא אותו ביומנים:
  1. הריצו Claude Code: Show Logs מ-לוח הפקודות כדי לפתוח את ערוץ הפלט Claude VSCode.
  2. לחצו על Reconnect בלשונית והמתינו עד שהיא מפסיקה להציג Connecting….
  3. חפשו בערוץ את Error fetching remote sessions: או Failed to fetch organization UUID:, ואז קראו את טקסט השגיאה אחרי הקידומת הזו בשורה התואמת החדשה ביותר.
• אזהרת יומן: אזהרה שמציינת an authority that Claude Code does not trust מדווחת על שגיאת אישור. מאחורי פרוקסי שבודק TLS, הגדירו את NODE_EXTRA_CA_CERTS ב-env ב-~/.claude/settings.json. גרסאות לפני v2.1.309 לא רושמות את האזהרה הזו.

התיקון הזה דורש גרסת תוסף 2.1.307 או חדשה יותר, אז עדכנו את התוסף קודם. ואז הגדירו את NODE_EXTRA_CA_CERTS לנתיב המלא של קובץ האישור, כתוב בלי ~. לנתיב Windows, כתבו כל לוכסן הפוך פעמיים ב-settings.json, כמו ב-C:\\certs\\example-ca.pem.

[!NOTE]

בחלון שמחובר ל-WSL, למארח SSH, ל-dev container, או למערכת אחרת, שמרו את קובץ האישור וערכו את ~/.claude/settings.json במערכת הזו, לא במחשב המקומי שלכם.

הדוגמה הזו מציינת קובץ אישור בנתיב Linux או macOS /etc/ssl/certs/example-ca.pem:

{
  "env": {
    "NODE_EXTRA_CA_CERTS": "/etc/ssl/certs/example-ca.pem"
  }
}

שמרו את settings.json, ואז התחילו הקלטה או לחצו שוב על Reconnect. אם השגיאה חוזרת, פתחו את ערוץ הפלט עם Claude Code: Show Logs וחפשו בו את use the CA certificates file. אזהרה כזו נותנת את הסיבה שהתוסף לא יכול להשתמש בקובץ שלכם ואומרת איפה הוא קרא את הנתיב. ואז מצאו כל מקום שבו הגדרתם את NODE_EXTRA_CA_CERTS בטבלה הזו ועשו את מה שהשורה שלה אומרת:

#Claude Code אף פעם לא מגיב

אם Claude Code לא מגיב להנחיות שלכם:

1. בדקו את חיבור האינטרנט: ודאו שיש לכם חיבור אינטרנט יציב
2. התחילו שיחה חדשה: נסו להתחיל שיחה חדשה כדי לראות אם הבעיה נמשכת
3. נסו את ה-CLI: הריצו claude מהטרמינל כדי לראות אם אתם מקבלים הודעות שגיאה מפורטות יותר

אם הבעיות נמשכות, פתחו issue ב-GitHub עם פרטים על השגיאה.

#הסרת התוסף

כדי להסיר את תוסף Claude Code:

1. לחצו Cmd+Shift+X ב-Mac או Ctrl+Shift+X ב-Windows/Linux כדי לפתוח את תצוגת Extensions
2. חפשו "Claude Code"
3. לחצו על Uninstall

התוסף נשאר מוסר כשאתם מפעילים claude. אם אתם מריצים /ide מטרמינל חיצוני בזמן ש-VS Code פועל, Claude Code מתקין אותו מחדש. כדי לעצור את זה, הגדירו את autoInstallIdeExtension ל-false ב-~/.claude.json, או כבו את Auto-install IDE extension ב-/config מהטרמינל המשולב. אפשר גם להגדיר את משתנה הסביבה CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL ל-1.

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

ב-macOS:

rm -rf ~/Library/"Application Support"/Code/User/globalStorage/anthropic.claude-code

ב-Linux:

rm -rf ~/.config/Code/User/globalStorage/anthropic.claude-code

ב-Windows, ב-PowerShell:

Remove-Item -Recurse -Force "$env:APPDATA\Code\User\globalStorage\anthropic.claude-code"

לעזרה נוספת, ראו את מדריך פתרון הבעיות.

#הצעדים הבאים

עכשיו כש-Claude Code מוגדר ב-VS Code:

• חקרו תהליכי עבודה נפוצים כדי להפיק את המרב מ-Claude Code
• הגדירו שרתי MCP כדי להרחיב את היכולות של Claude עם כלים חיצוניים. הוסיפו ונהלו אותם עם /mcp בלוח הצ'אט.
• הגדירו את הגדרות Claude Code כדי להתאים פקודות מותרות, hooks ועוד. ההגדרות האלה משותפות בין התוסף ל-CLI.
• עיינו באמצעי האבטחה ובשימוש בנתונים של Claude Code