📘 תיעוד 19

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

התקן והגדר את הרחבת Claude Code עבור VS Code. קבל סיוע קידוד מבוסס AI עם תצוגת הבדלים מוטבעת (inline diffs), אזכורי @ (@-mentions), סקירת תוכניות וקיצורי מקשים.

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

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

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

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

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

טיפ: ההרחבה כוללת עותק משלה של ה-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.

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

הערה: אם ההרחבה אינה מופיעה לאחר ההתקנה, הפעל מחדש את VS Code או הרץ את "Developer: Reload Window" מלוח הפקודות (Command Palette).

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

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

1. פתיחת חלונית Claude Code: בכל רחבי VS Code, סמל הניצוץ (Spark) מציין את Claude Code: <img src="https://mintcdn.com/claude-code/c5r9_6tjPMzFdDDT/images/vs-code-spark-icon.svg?fit=max&auto=format&n=c5r9_6tjPMzFdDDT&q=85&s=3ca45e00deadec8c8f4b4f807da94505" alt="Spark icon" style={{display: "inline", height: "0.85em", verticalAlign: "middle"}} width="16" height="16" data-path="images/vs-code-spark-icon.svg" />

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

   

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

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

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

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

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

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

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

3. שליחת הנחיה (prompt): בקש מ-Claude לעזור עם הקוד או הקבצים שלך, בין אם מדובר בהסבר על אופן הפעולה של משהו, ניפוי שגיאות בבעיה, או ביצוע שינויים.

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

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

   

4. סקירת שינויים: מה שתראה תלוי ב-מצב ההרשאות המוצג בתחתית תיבת ההנחיות:

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

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

     

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

טיפ: הרץ את "Claude Code: Open Walkthrough" מלוח הפקודות (Command Palette) לסיור מודרך ביסודות.

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

תיבת ההנחיות תומכת במספר תכונות:

• מצבי הרשאה (Permission modes): לחץ על מחוון המצב בתחתית תיבת ההנחיות כדי להחליף מצבי הרשאה. בתוכניות Pro, Max ו-Team, מצב Auto הוא מצב הרשאת ברירת המחדל המובנה להתחלה. ראה כיצד ההרחבה בוחרת את מצב הרשאת הפתיחה למידע על מה שמשנה זאת, ועל כל מצב הרשאה שהמחוון מציע.
  • Auto: מסווג סוקר את רוב הפעולות במקום לשאול אותך. ראה מצב auto למידע על מה שהוא סוקר וחוסם.
  • Manual: ‏Claude מבקש רשות לפני עריכת קבצים ורוב פקודות המעטפת (shell).
  • Plan: ‏Claude מתאר מה הוא יעשה וממתין לאישור לפני ביצוע שינויים. VS Code פותח אוטומטית את התוכנית כמסמך Markdown מלא שבו תוכל להוסיף הערות מוטבעות כדי לתת משוב לפני ש-Claude מתחיל.
  • Edit automatically: ‏Claude מבצע עריכות מבלי לבקש רשות.
• מודל (Model): בחר Switch model… מתפריט הפקודות כדי להחליף מודל באמצע ההפעלה. תוכל גם ללחוץ על שם המודל בתחתית תיבת ההנחיות כדי לפתוח את אותו בורר. כאשר המודל הנוכחי תומך ב-רמות מאמץ (effort levels), הבורר מציג גם שורת Effort ולחצן שם המודל מציג את הרמה שנבחרה. לחצן שם המודל ושורת ה-Effort דורשים את Claude Code v2.1.257 ומעלה.
• תפריט פקודות (Command menu): לחץ על / או הקלד / כדי לפתוח את תפריט הפקודות. האפשרויות כוללות צירוף קבצים, החלפת מודלים והפעלת חשיבה מורחבת (extended thinking). המקטע Customize מספק גישה לשרתי MCP, פקודות, סגנונות פלט (output styles), הוקים (hooks), זיכרון, הרשאות ותוספים (plugins). פריטים עם סמל מסוף נפתחים במסוף המשולב.
  • כדי לעיין בפקודות כגון /usage או /remote-control, בחר ב-Slash commands במקטע Customize. תיבת דו שיח מציגה אותן עם תיבת סינון. בחר אחת כדי להריץ אותה. הקלדת / בתיבת ההנחיות עדיין מציעה פקודות מוטבעות. דורש את Claude Code v2.1.257 ומעלה.
  • בחר ב-Output styles במקטע Customize כדי לבחור סגנון פלט, כולל הסגנונות המותאמים אישית שלך. דורש את Claude Code v2.1.257 ומעלה. כדי ליצור סגנון מותאם אישית במקום זאת, בחר ב-Build a custom style מתפריט Output styles. ‏Claude Code כותב את קובץ הסגנון עבורך ברמת הפרויקט או ברמת המשתמש. דורש את Claude Code v2.1.261 ומעלה.
  • בחר ב-Hooks במקטע Customize כדי להציג את ההוקים שנטענו בהפעלה, מקובצים לפי אירוע. תוכל להוסיף, לערוך או להסיר הוקים שנשמרו בקובצי ההגדרות שלך ברמת המשתמש, הפרויקט וההגדרות המקומיות. הוקים ממקורות אחרים, כגון הגדרות מנוהלות או תוספים, הם לקריאה בלבד. דורש את Claude Code v2.1.269 ומעלה.
  • בחר ב-Permissions במקטע Customize כדי להציג את כללי ההרשאות של ההפעלה, מקובצים ל-Allow,‏ Ask ו-Deny. תוכל להוסיף כללים להגדרות המשתמש, הפרויקט או ההגדרות המקומיות שלך ולהסיר כללים שנשמרו שם. כללים ממקורות אחרים, כגון הגדרות מנוהלות או אישורים שניתנו עבור הפעלה זו בלבד, הם לקריאה בלבד. דורש את Claude Code v2.1.269 ומעלה.
  • המקטע 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, המסתיר קריאות לכלים (tool calls), תוצאות כלים וחשיבה מאחורי שורות הניתנות להרחבה, ומשאיר רק את ההנחיות שלך ואת התשובות של Claude. הפעל או כבה אותו שם, באמצעות Ctrl+Option+F (ב-Mac) או Ctrl+Alt+F (ב-Windows/Linux), או מלוח הפקודות באמצעות Claude Code: Toggle Focus view. השינוי חל על כל הפעלה פתוחה ונשמר על פני הפעלות. דורש את Claude Code v2.1.221 ומעלה. רשימת המשימות (to-do list) העדכנית ביותר של Claude נשארת גלויה, וכך גם הטקסט שעליו נשאלת שאלה ממתינה מצד Claude: הדבר דורש את Claude Code v2.1.225 ומעלה. בזמן ש-Claude מריץ תת-סוכנים (subagents), שורות התקדמות חיות עם הפעילות האחרונה שלהם מופיעות תחת קבוצת קריאות הכלים שהפעילה אותם. הדבר דורש את Claude Code v2.1.269 ומעלה.
  • כדי לדווח על תקלה, לחץ על Report a problem בתחתית התפריט, או הקלד /bug או /feedback עם תיאור אופציונלי שממלא מראש את הדיווח. כאשר אתה שולח את הדיווח ואתה מחובר ל-Anthropic בחיבור ישיר (first-party), ‏Claude Code שולח אותו ל-Anthropic. בספק צד שלישי, או ללא אישורי Anthropic, תיבת הדו שיח עדיין נפתחת, אך שליחה תציג שגיאה ולא תשלח דבר: בניגוד לפקודת /bug של ה-CLI, ההרחבה אינה כותבת ארכיון מקומי. דורש את Claude Code v2.1.229 ומעלה. אם מדיניות הארגון שלך מכבה משוב על המוצר, Report a problem אינו מופיע בתפריט, והפקודות /bug ו-/feedback מציגות הודעה: Feedback is turned off by your organization's policy or this environment's settings. במקום לפתוח את הדיווח.
• שאלות צד (Side questions): הקלד /btw ולאחריו שאלה כדי לשאול על ההפעלה שלך מבלי להוסיף לשיחה. התשובה נפתחת בחלונית לצד הצ'אט, שבה תוכל לשאול שאלות המשך. השרשור שורד טעינות מחדש של החלון. ‏Claude Code שומר את 20 חילופי הדברים החדשים ביותר ומסיים את תוקפם של שרשורים מאוחסנים בהתאם ללוח הזמנים של cleanupPeriodDays, כל עוד Claude Code יכול לקבוע בבטחה את תקופת השימור. כדי לנקות שרשור, לחץ על סמל פח האשפה בחלונית. דורש את Claude Code v2.1.227 ומעלה.
• מחוון הקשר (Context indicator): תיבת ההנחיות מציגה כמה מחלון ההקשר של Claude נמצא בשימוש. Claude מבצע דחיסה (compact) באופן אוטומטי בעת הצורך, או שתוכל להריץ את /compact ידנית.
• שעון מטמון הנחיות (Prompt cache clock): סמל שעון ליד מחוון ההקשר מעריך כמה זמן נותר ל-מטמון ההנחיות (prompt cache) של השיחה לפני שיפוג תוקפו. הוא סופר לאחור מ-אורך החיים של המטמון העומד על חמש דקות או שעה אחת, וכל תגובה המשתמשת במטמון מפעילה מחדש את הספירה לאחור. מלבד דחיסה, הפעולות הפוסלות את המטמון אינן מאפסות את השעון, כך שהוא עדיין יכול להציג דקות שנותרו לאחר החלפת מודלים.
  • עד לסיום הספירה לאחור, הסמל מציג את הדקות שנותרו, כגון 12m.
  • כאשר הספירה לאחור מסתיימת, הדקות נעלמות והסמל הופך לאדום, או לצבע השגיאה של ערכת הנושא שלך, עד לתגובה הבאה. תוקף המטמון כנראה פג, לכן צפה לתגובה איטית ויקרה יותר להודעה הבאה שלך בזמן שהמטמון נבנה מחדש. אם אורך החיים של חמש הדקות ממשיך לפוג בין ההודעות שלך, ראה בחירת ה-TTL בעצמך.
  • מיד לאחר ש-השיחה נדחסת, הסמל הופך גם הוא לאדום ללא דקות עד לתגובה הבאה, מכיוון שהמטמון עדיין אינו מכסה את השיחה הדחוסה.
• מפת סוכנים (Agent map): כאשר השיחה כוללת תת-סוכנים, ספירת סוכנים כגון 2 agents מופיעה בתחתית תיבת ההנחיות. הנקודה שלה מציגה האם תת-סוכן כלשהו עובד או ממתין להרשאה שלך. לחץ על ספירת הסוכנים כדי לפתוח את מפת הסוכנים, המציגה את תת-הסוכנים של השיחה כעץ תחת הסוכן הראשי, כל אחד עם הסטטוס שלו, הזמן שחלף וכמות האסימונים (tokens). לחץ על תת-סוכן כדי לראות את ההנחיה ואת קריאות הכלים שלו, לפתוח את התמליל (transcript) שלו לקריאה בלבד, או לעצור אותו בזמן פעולתו. דורש את Claude Code v2.1.269 ומעלה.
• חשיבה מורחבת (Extended thinking): מאפשר ל-Claude להקדיש זמן רב יותר להסקת מסקנות בבעיות מורכבות. הפעל אותו דרך תפריט הפקודות (/). תהליך ההסקה של Claude מופיע בשיחה כבלוקים מכווצים: לחץ על בלוק כדי לקרוא אותו, או הקש Ctrl+O כדי להרחיב או לכווץ כל בלוק חשיבה בהפעלה. ראה חשיבה מורחבת לפרטים.
• קלט מרובה שורות (Multi-line input): הקש Shift+Enter כדי להוסיף שורה חדשה מבלי לשלוח. הדבר פועל גם בתיבת קלט הטקסט החופשי "Other" של תיבות דו שיח לשאלות.

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

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

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

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

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

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

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

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

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

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

• כותרות הפעלה: הפעלות חדשות מקבלות כותרות שנוצרו על ידי AI בהתבסס על ההודעה הראשונה שלך.
• שינוי שם והעברה לארכיון: רחף מעל הפעלה כדי לחשוף פעולות אלו. שנה שם כדי לתת לה כותרת תיאורית, או העבר לארכיון כדי להעביר אותה לקבוצת Archived sessions בתחתית הרשימה.

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

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

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

• ההרחבה בוחרת את מצב הרשאת הפתיחה מתוך claudeCode.initialPermissionMode או מתוך בחירה שממשיכה משיחה קודמת
• הגדרת את claudeCode.claudeProcessWrapper

#המשך הפעלות ענן מ-Claude.ai

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

1. פתיחת היסטוריית הפעלות: לחץ על לחצן Session history בראש חלונית Claude Code.
2. בחירת לשונית Web: תיבת הדו שיח מציגה שתי לשוניות: Local ו-Web. לחץ על Web כדי לראות הפעלות מ-claude.ai.
3. בחירת הפעלה להמשך: עיין בהפעלות הענן שלך או חפש בהן. לחץ על הפעלה כלשהי כדי להוריד אותה ולהמשיך את השיחה מקומית.

הערה: רק הפעלות ענן שהופעלו עם מאגר GitHub מופיעות בלשונית Web. המשך הפעלה טוען את היסטוריית השיחה מקומית: שינויים אינם מסונכרנים בחזרה ל-claude.ai.

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

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

תיבת הדו שיח מפרטת גם מה תורם למגבלות התוכנית שלך. היא מסמנת התנהגויות שאחראיות ל-10% או יותר מהשימוש האחרון, כגון החמצות מטמון (cache misses), הקשר ארוך, והפעלות עתירות תת-סוכנים או מקביליות גבוהה, כל אחת עם טיפ לצמצומה. טבלאות ייחוס מציגות כמה שימוש הגיע מכל מיומנות (skill), תת-סוכן, תוסף ושרת MCP.

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

#התאמת זרימת העבודה שלך

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

#בחירת המיקום של Claude

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

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

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

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

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

#הרצת מספר שיחות

השתמש ב-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 ומעלה.
• שינוי שם או מחיקה של קבוצה: לחץ באמצעות לחצן העכבר הימני על כותרת הקבוצה. מחיקת קבוצה מסירה רק את הקבוצה, וההפעלות שבה חוזרות לרשימה ללא קבוצה.

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

#מעבר למצב מסוף

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

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

#ניהול תוספים (plugins)

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

#התקנת תוספים

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

בלשונית Plugins:

• Installed plugins מופיעים בחלק העליון עם מתגי הפעלה/כיבוי כדי להפעיל או להשבית אותם
• Available plugins מחנויות התוספים המוגדרות שלך מופיעים למטה
• חיפוש לסינון תוספים לפי שם או תיאור
• לחץ על Install בכל תוסף זמין

כאשר אתה מתקין תוסף, בחר את טווח ההתקנה (installation scope):

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

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

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

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

ה-URL מקבל שני פרמטרים של שאילתה (query parameters):

שני מקרים מסתיימים בהודעה בתיבת הדו שיח במקום בבחירת הטווח:

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

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

#ניהול חנויות תוספים

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

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

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

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

למידע נוסף על מערכת התוספים, ראה תוספים ו-חנויות תוספים.

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

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

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

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

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

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

להוראות הגדרה, הרשימה המלאה של היכולות ופתרון בעיות, ראה שימוש ב-Claude Code עם Chrome.

#פקודות וקיצורי מקשים ב-VS Code

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

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

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

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

הההרחבה רושמת מטפל URI בכתובת vscode://anthropic.claude-code/open. השתמש בו כדי לפתוח לשונית Claude Code חדשה מתוך כלי העבודה שלך: כינוי מעטפת (shell alias), סימנייה בדפדפן (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. אם המעטפת מדווחת שהיא לא נמצאה, ראה 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 parameters):

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

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

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

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

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

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

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

במהלך שיחה, ההרחבה מקריאה:

• תשובות של Claude: ההרחבה מקריאה כל תשובה פעם אחת, כאשר היא הושלמה, ונשארת שקטה בזמן שהטקסט מוזרם. קורא המסך שלך קורא בלוקי קוד כסיכום מספר שורות, קורא קישורים לפי התווית שלהם, וקורא טבלאות תא אחר תא: התשובה המלאה נשארת קריאה בתמליל (transcript).
• בקשות הרשאה ושאלות: ההרחבה מקריאה בקשה כאשר מופיעה בקשת ההרשאה שלה, ומציינת את הכלי שבו Claude רוצה להשתמש. היא מקריאה באותו אופן כאשר Claude שואל אותך שאלה וכאשר Claude מסיים תוכנית וממתין לסקירה שלך.
• שינויי סטטוס: ההרחבה מקריאה כאשר Claude מתחיל לעבוד, כאשר Claude מוכן לקלט שלך, וכאשר Claude Code מתחיל לדחוס את השיחה.
• שגיאות והנחיות מודל: ההרחבה מקריאה שגיאות בשיחה, ומקריאה כאשר מופיעה בקשת ההסכמה לקרדיטים לשימוש או בקשת בקשה מסומנת (flagged-request).

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

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

#הרחבת VS Code לעומת Claude Code CLI

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

#חזרה לאחור באמצעות נקודות ביקורת (checkpoints)

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

• Fork conversation from here: התחלת ענף שיחה חדש מהודעה זו תוך שמירה על כל שינויי הקוד ללא שינוי
• Rewind code to here: החזרת שינויי הקבצים בחזרה לנקודה זו בשיחה תוך שמירה על היסטוריית השיחה המלאה
• Fork conversation and rewind code: התחלת ענף שיחה חדש והחזרת שינויי הקבצים לנקודה זו

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

#הרצת CLI ב-VS Code

כדי להשתמש ב-CLI תוך כדי הישארות ב-VS Code, פתח את המסוף המשולב (Ctrl+` ב-Windows/Linux או Cmd+` ב-Mac) והרץ את claude. ה-CLI משתלב באופן אוטומטי עם ה-IDE שלך עבור תכונות כמו צפייה בהבדלים (diff viewing) ושיתוף אבחון (diagnostic sharing).

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

אם אתה משתמש במסוף חיצוני, הרץ את /ide בתוך Claude Code כדי לחבר אותו ל-VS Code.

#מעבר בין ההרחבה ל-CLI

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

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

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

#ניטור תהליכי רקע

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

#התחברות לכלים חיצוניים באמצעות MCP

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

כדי לנהל שרתי MCP מבלי לצאת מ-VS Code, הקלד /mcp בחלונית הצ'אט. מתיבת הדו שיח שנפתחת, תוכל להוסיף שרתים, להסיר שרתים שנשמרו ב-טווח המקומי, טווח המשתמש או טווח הפרויקט, להפעיל או להשבית שרתים, להתחבר מחדש לשרת, ולנהל אימות OAuth. הוספה והסרה של שרתים בתיבת הדו שיח דורשת את Claude Code v2.1.261 ומעלה.

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

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").

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

#עבודה עם 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 יוצר תיאורים בהתבסס על שינויי הקוד בפועל ויכול להוסיף הקשר לגבי בדיקות או החלטות יישום.

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

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

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

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

2. הגדרת הספק שלך: פעל לפי מדריך ההגדרה עבור הספק שלך:

   • Claude Code ב-Amazon Bedrock
   • Claude Code ב-Agent Platform של Google Cloud
   • Claude Code ב-Microsoft Foundry

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

בספק צד שלישי, ההרחבה אינה מציעה תכונות הדורשות חשבון claude.ai, כגון מעקב אחר שימוש, הכתבה קולית, ולשונית Web עבור הפעלות ענן. התחברות ל-claude.ai שנותרה מ-/login קודם נשארת ללא שימוש: ההרחבה אינה שולחת אותה עם שום בקשה.

#אבטחה ופרטיות

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

כאשר הרשאות עריכה אוטומטית מופעלות, Claude Code יכול לשנות קובצי תצורה של VS Code (כמו settings.json או tasks.json) ש-VS Code עשוי להריץ באופן אוטומטי. כדי להפחית סיכון בעבודה עם קוד לא מהימן:

• הפעל את מצב מוגבל של VS Code (Restricted Mode) עבור סביבות עבודה שאינן מהימנות
• השתמש במצב Manual במקום Edit automatically או Auto עבור עריכות
• סקור שינויים בקפידה לפני אישורם

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

כאשר ההרחבה פעילה, היא מריצה שרת MCP מקומי שאליו ה-CLI מתחבר באופן אוטומטי. כך ה-CLI פותח תצוגות הבדלים (diffs) במציג ההבדלים המקורי של VS Code, קורא את הבחירה הנוכחית שלך עבור אזכורי @, וכאשר אתה עובד במחברת Jupyter, מבקש מ-VS Code להריץ תאים.

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

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

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

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

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

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

הרצה ב-Jupyter תמיד שואלת תחילה. mcp__ide__executeCode אינו יכול להריץ שום דבר באופן שקט. בכל קריאה, הקוד מוכנס כתא חדש בסוף המחברת הפעילה, VS Code גולל אותו לתצוגה, ו-Quick Pick מקורי מבקש ממך לבחור Execute או Cancel. ביטול, או סגירת הבורר באמצעות Esc, מחזיר שגיאה ל-Claude ושום דבר אינו מופעל. הכלי גם מסרב לחלוטין כאשר אין מחברת פעילה, כאשר הרחבת Jupyter (ms-toolsai.jupyter) אינה מותקנת, או כאשר הקרנל אינו Python.

הערה: אישור ה-Quick Pick נפרד מהוקים מסוג PreToolUse. רשומת רשימה לבנה (allowlist) עבור mcp__ide__executeCode מאפשרת ל-Claude להציע הרצת תא: ה-Quick Pick בתוך VS Code הוא מה שמאפשר לו לרוץ בפועל.

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

#ההרחבה אינה מותקנת

• ודא שיש לך גרסה תואמת של VS Code (1.94.0 ומעלה)
• בדוק של-VS Code יש הרשאה להתקין הרחבות
• נסה להתקין ישירות מתוך VS Code Marketplace

#סמל הניצוץ (Spark) אינו גלוי

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

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

לחלופין, אם הגדרת את preferredLocation ל-sidebar, או פתחת את Claude באמצעות Claude Code: Open in Side Bar, לחץ על "✻ 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, והקצה קיצור חדש.

#Claude Code אינו מגיב לעולם

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

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

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

#הסרת התקנת ההרחבה

כדי להסיר את הרחבת Claude Code:

1. פתח את תצוגת ההרחבות (Cmd+Shift+X ב-Mac או Ctrl+Shift+X ב-Windows/Linux)
2. חפש "Claude Code"
3. לחץ על Uninstall

אם תריץ את claude במסוף המשולב של VS Code, ‏Claude Code יתקין מחדש את ההרחבה באופן אוטומטי. כדי לשמור עליה מוסרת, כבה את Auto-install IDE extension ב-/config, או הגדר את autoInstallIdeExtension ל-false. תוכל גם להגדיר את משתנה הסביבה 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 כדי להתאים אישית פקודות מורשות, הוקים ועוד. הגדרות אלו משותפות בין ההרחבה ל-CLI.