📘 תיעוד 65

תוספי בינה לקוד

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

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

כל תוסף מחבר את Claude Code לשרת שפה עבור שפה אחת דרך Language Server Protocol (LSP). אתם מתקינים את התוסף משוק התוספים הרשמי של Anthropic ואת הקובץ הבינארי של שרת השפה במחשב שלכם.

[!NOTE]

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

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

אם כבר ראיתם חלון LSP plugin recommendation, ראו קבלה או דחייה של חלון ההמלצה כדי לדעת מה כל בחירה עושה.

#התקנת תוסף בינה לקוד

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

1. התקנת הקובץ הבינארי של שרת השפה

מצאו את השפה שלכם בטבלה למטה והתקינו את הקובץ הבינארי בשורה שלה. אם השפה שלכם לא ברשימה, ראו הוספת שפה בלי תוסף רשמי.

Anthropic מתחזקת כל תוסף בטבלה חוץ מ-liquid-lsp, ש-Shopify מתחזקת ושוק התוספים הרשמי מציג.

כדי למצוא את הפקודה שמתקינה את הקובץ הבינארי, עקבו אחרי הקישור של התוסף בטבלה אל קובץ ה-README שלו. עבור TypeScript, הפקודה הזו היא npm install -g typescript-language-server typescript.

אחרי שמתקינים את הקובץ הבינארי, אשרו שהוא ב-PATH של המעטפת שממנה אתם מפעילים את claude, למשל עם which typescript-language-server, או Get-Command typescript-language-server ב-PowerShell.

2. התקנת התוסף

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

/plugin install typescript-lsp@claude-plugins-official

הודעת אישור אומרת אם התוסף פעיל עכשיו או שצריך /reload-plugins. אם ההתקנה נכשלת עם Marketplace "claude-plugins-official" not found, ראו את רשומת פתרון הבעיות לשגיאה הזו. כדי לשלוט איפה התוסף מותקן, או כדי להריץ את ההתקנה מהמעטפת במקום מתוך Claude Code, ראו התקנת תוספים.

3. אישור שהשרת עולה

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

• מופיעה שורת אבחון: Found N new diagnostic issues in M files (ctrl+o to expand) מתחת לעריכה שהכניסה את השגיאה אומר שהשרת עלה.
• לא מופיעה שורת אבחון: הריצו /plugin ופתחו את הלשונית Errors. שורה שכתוב בה Executable not found in $PATH: "<binary>" מציינת את הקובץ הבינארי להתקנה. אם בלשונית אין שורה כזו, ראו פתרון בעיות בבינה לקוד.

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

#מה קלוד מקבל

כששרת שפה רץ, קלוד מקבל אבחון וניווט בקוד:

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

#קריאת האבחון בעצמכם

אחרי שקלוד עורך קובץ שהשרת מטפל בו, השיחה מציגה רק את הסיכום Found N new diagnostic issues. כדי לקרוא את הבעיות עצמן, לחצו Ctrl+O.

#קבלה או דחייה של חלון ההמלצה

אם קובץ בינארי של שרת שפה כבר נמצא ב-PATH שלכם והתוסף שמשתמש בו לא מותקן, Claude Code מציע להתקין עבורכם את התוסף בחלון שכותרתו LSP plugin recommendation.

#מתי חלון ההמלצה מופיע

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

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

#מענה לחלון ההמלצה

חלון LSP plugin recommendation מציין את התוסף ומציע את הבחירות האלה:

• Yes, install: Claude Code מתקין את התוסף עבור חשבון המשתמש שלכם ומדפיס <plugin> installed · restart to apply. התחילו סשן חדש כדי לטעון את השרת.
• No, not now: החלון נסגר, וסשן מאוחר יותר יכול להציע את התוסף שוב. לחיצה על Esc עושה את אותו דבר.
• Never for this plugin: החלון מפסיק להופיע עבור התוסף הזה ועדיין מופיע עבור אחרים.
• Disable all LSP recommendations: החלון מפסיק להופיע עבור כל שפה.

אם לא בוחרים אפשרות, Claude Code סוגר את החלון אחרי 30 שניות וסופר את זה כהתעלמות. הספירה נשמרת בין סשנים. אחרי חמישה חלונות שהתעלמו מהם, Claude Code מפסיק להמליץ על תוספים, כמו בחירה ב-Disable all LSP recommendations.

#החזרת ההמלצות

חלון LSP plugin recommendation מפסיק להופיע אחרי שבוחרים Disable all LSP recommendations או מתעלמים ממנו חמש פעמים.

• מושבת או שהתעלמו חמש פעמים: כדי להחזיר אותו בכל אחד מהמקרים, הסירו את המפתחות lspRecommendationDisabled ו-lspRecommendationIgnoredCount מ-~/.claude.json, קובץ התצורה של Claude Code עצמו.
• Never for this plugin: אם בחרתם Never for this plugin ואתם רוצים שהתוסף יוצע שוב, הסירו את המזהה name@marketplace שלו מהרשימה lspRecommendationNeverPlugins באותו קובץ.

#פתרון בעיות בבינה לקוד

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

• שרת השפה לא עולה: אתם רואים Executable not found in $PATH בלשונית Errors של /plugin, או שקלוד אף פעם לא מדווח אבחון עבור השפה.
• שימוש גבוה בזיכרון: השימוש בזיכרון עולה בזמן שהשרת מאנדקס את הפרויקט.
• אבחון חיובי שגוי ב-monorepo: האבחון מדווח על ייבוא כלא פתור כשהוא כן פתור.

#הוספת שפה בלי תוסף רשמי

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

1. כתבו תוסף עם קובץ .lsp.json שמציין את פקודת השרת ואת סיומות הקבצים שהוא מטפל בהן.
2. אחר כך טענו את התוסף עם --plugin-dir או פרסמו אותו לשוק תוספים.

לשדות של הקובץ ולדוגמה מעובדת, ראו שרתי LSP ברכיבי תוסף.

#צעדים הבאים

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