מדריך קלוד קוד בעברית
לאתר הראשי כל המדריכים קלאודפלייר קלוד דסקטופ גרוק CLI גרוק בוט MCP קרסור וואטסאפ OpenClaw n8n בענן n8n בהתקנה עצמית

תיעוד 66

אבטחה ואמון בתוספים

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

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

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

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

[!NOTE]

המקרים האלה מכוסים בדפים אחרים:

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

#הבינו מה תוסף יכול לעשות

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

  • Hooks: ה-hooks של תוסף רצים כפקודות מעטפת בנקודות במחזור החיים של Claude Code, למשל לפני או אחרי קריאת כלי.
  • Monitors: ה-monitors של תוסף רצים כפקודות מעטפת ברקע ש-Claude Code מפעיל בעצמו כשהסשן מתחיל, כשטוענים מחדש תוספים, או בפעם הראשונה ש-skill בעל שם רץ.
  • Mods: ה-mod של תוסף מריץ JavaScript בתוך Claude Code עם ההרשאות שלכם. כדי לרשום מה mod עושה לפני שמתקינים אותו, ראו החליטו אם לסמוך על mod.
  • שרתי MCP ו-LSP: Claude Code מתחבר לשרתי MCP שתוסף מופעל מצהיר עליהם ונותן ל-Claude את הכלים שלהם. שרת MCP מסוג stdio רץ כתהליך ש-Claude Code מפעיל במחשב. Claude Code גם מפעיל את שרתי השפה שהתוסף מצהיר עליהם.
  • תיקיית bin/: Claude Code מוסיף את תיקיית bin/ של כל תוסף מופעל ל-PATH של המעטפת של כלי Bash, כך שפקודות Bash של Claude יכולות להריץ כל קובץ הפעלה שם. פקודה ש-Claude מריץ עם כלי PowerShell מקבלת את התיקיות האלה ב-PATH כשהיא רצה מחוץ ל-sandbox, ולא כשהיא רצה בתוכו.
  • Skills, commands, and agents: אלה נכנסים להקשר של Claude כהוראות, ולכן הם משפיעים על מה ש-Claude עושה עם הכלים שכבר יש לו.
  • Updates: כשעדכון אוטומטי מופעל ל-marketplace שממנו התקנתם תוסף, Claude Code מעדכן את התוסף ברקע, כך שהקבצים שבדקתם יכולים להשתנות בדיסק. ב-מתי עדכון אוטומטי רץ יש את התזמון. כדי להפעיל או לכבות עדכון אוטומטי לכל marketplace, ראו שמרו על תוספים מעודכנים.

כללי ההרשאות וה-sandbox של Claude Code מכסים את קריאות הכלים ש-Claude מבצע, ולא את הקוד שתוסף מריץ בעצמו:

  • Hooks, monitors, ותהליכי שרת: command hooks ו-monitors הם פקודות מעטפת שרצות עם הרשאות המשתמש המלאות שלכם. Claude Code מריץ hooks, monitors, שרתי MCP, שרתי LSP, והתהליכים ש-mod מפעיל מחוץ ל-sandbox.
  • קריאות הכלים של Claude: קריאה לאחד מכלי ה-MCP של התוסף, ופקודת Bash שמריצה קובץ הפעלה מ-bin/ של התוסף, הן קריאות כלים, ולכן כללי ההרשאות חלים עליהן. למה ש-mod יכול לעשות לקריאת כלי, ראו החליטו אם לסמוך על mod.

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

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

#זהו את ה-marketplace של Anthropic לפי שם

שם של marketplace ממקם אותו באחת משלוש דרגות: רשמי, קהילה, או צד שלישי. Claude Code מקבל את השמות הרשמיים ואת שמות הקהילה רק ל-marketplace שמקורם במאגרי github.com/anthropics/, ולכן marketplace של צד שלישי לא יכול להציג את עצמו כ-marketplace של Anthropic. marketplace שעמית או הארגון שלכם מפרסם הוא צד שלישי.

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

דרגהאילו marketplace
רשמישמות ה-marketplace הרשמיים, למשל claude-plugins-official
קהילהclaude-community, claude-plugins-community, ו-healthcare
צד שלישיכל marketplace אחר

כשקטלוג claude-community מצמיד תוסף ל-commit SHA, וזה מה שהוא עושה כמעט לכל רשומה, Claude Code מסרב להתקין commit אחר.

#שמות marketplace רשמיים

שמות ה-marketplace האלה מרכיבים את הדרגה הרשמית:

  • claude-plugins-official
  • claude-code-marketplace
  • claude-code-plugins
  • anthropic-marketplace
  • anthropic-plugins
  • agent-skills
  • anthropic-agent-skills
  • life-sciences
  • knowledge-work-plugins
  • claude-for-legal
  • claude-for-financial-services
  • financial-services-plugins
  • first-party-plugins
  • claude-tag-plugins

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

#בדקו תוסף לפני שמתקינים אותו

לפני שמתקינים תוסף, הסתכלו מה הוא מוסיף ומאיפה הוא מגיע.

1. בדקו את מקור ה-marketplace

במעטפת, הריצו claude plugin marketplace list כדי להדפיס את המקור שממנו כל marketplace נוסף, למשל מאגר GitHub או תיקייה.

2. קראו את חלונית הפרטים

בסשן של Claude Code, הריצו /plugin ובחרו את התוסף. חלונית הפרטים מציגה מקטע Will install שמפרט את הפקודות, הסוכנים, ה-skills, ה-hooks, ושרתי MCP ו-LSP של התוסף. לתוסף שאין ל-Anthropic נתוני רכיבים מפורסמים עבורו, המקטע מציג את מה שרשומת ה-marketplace מצהירה, או הערה: Components will be discovered at installation לתוסף שמאוחסן בתוך ה-marketplace, או Component summary not available for remote plugin לתוסף שמביאים ממקום אחר.

3. קראו את המקור של התוסף

בחלונית הפרטים, בחרו ב-Open homepage או ב-View on GitHub מתחת לאפשרויות ההתקנה. אם החלונית לא מציעה אף אחד מהם, פתחו את מאגר ה-marketplace שמצאתם בשלב הראשון. מצאו שם את תיקיית התוסף. מקטע Will install מראה ש-hook קיים אבל לא מה הוא מריץ, ולכן קראו את הקבצים האלה בתיקיית התוסף:

  • hooks/hooks.json: הפקודה שכל hook מריץ
  • .mcp.json: הפקודה או ה-URL של כל שרת
  • bin/: כל קובץ בתיקייה

4. רשמו מה התוסף מכיל

שכפלו את המאגר שמחזיק את תיקיית התוסף, ואז הריצו claude --plugin-dir <plugin directory> plugin details <plugin name> במעטפת כדי לראות מה Claude Code מוצא בו. הפקודה קוראת את קבצי התוסף בלי להתחיל סשן ומדפיסה Component inventory שמפרט את ה-skills והפקודות של התוסף, סוכנים, hooks עם האירוע של כל hook, ושרתי MCP ו-LSP.

אחרי שמתקינים תוסף, הריצו claude plugin details <plugin name> במעטפת כדי להדפיס את אותו Component inventory עבור העותק המותקן תחת ~/.claude/plugins/cache/<marketplace>/<plugin>/<version>/.

#הסירו תוסף שכבר אינכם סומכים עליו

במעטפת, הריצו claude plugin uninstall <plugin> עם ה---scope שבו התקנתם אותו. אחר כך בדקו מה ההסרה הסירה ומה היא השאירה:

  • נתונים מתמידים: כברירת מחדל, כשזה היה ה-scope האחרון שבו התוסף היה מותקן, ההסרה גם מוחקת את תיקיית הנתונים המתמידים של התוסף. לגבי --keep-data ולמקרים האחרים שבהם היא נשארת, ראו plugin uninstall.
  • קבצים במטמון: קבצי התוסף נשארים בדיסק תחת ~/.claude/plugins/cache/ במשך 14 ימים לפני שסריקת רקע מסירה אותם. אחרי שמסירים את התוסף האחרון, תיקיות יתומות נשארות עד שמתקינים תוסף אחר. כדי למחוק את הקבצים עכשיו, הסירו בעצמכם את תיקיית התוסף תחת ~/.claude/plugins/cache/<marketplace>/<plugin>/.
  • ה-marketplace: אם גם אינכם סומכים על הבעלים של ה-marketplace, הסירו גם את ה-marketplace, וזה מסיר כל תוסף שהתקנתם ממנו.

#זהו מתי Claude Code מסרב או מזהיר

חלונית הפרטים שפותחים מלשונית Discover או Marketplaces ב-/plugin מציגה את אותה אזהרת אמון לכל תוסף. Claude Code מסרב במקום להזהיר במקרים כמו אלה תחת מקורות marketplace לא מהימנים ובדיקות שלמות שנכשלו.

#אזהרת אמון לפני ההתקנה

האזהרה נקראת אותו דבר מכל marketplace שהתוסף מגיע ממנו:

Make sure you trust a plugin before installing, updating, or using it. Anthropic does not control what MCP servers, files, or other software are included in plugins and cannot verify that they will work as intended or that they won't change. See each plugin's homepage for more information.

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

#מקורות marketplace לא מהימנים ובדיקות שלמות שנכשלו

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

  • מקור marketplace לא מהימן: כש-marketplace משתמש בשם רשמי או בשם קהילה אבל המקור שלו מחוץ ל-github.com/anthropics/, Claude Code מפסיק לטעון את ה-marketplace ואת התוספים שהתקנתם ממנו. השגיאה היא Marketplace is registered from an untrusted source.
  • שלמות ארכיון: כשרשומת marketplace מצמידה מקור archive ל-digest של sha256 וה-digest של הקובץ שהורד לא תואם אותו, Claude Code מסרב להתקנה. השגיאה היא Plugin archive integrity check failed.

הצמדת sha256 נפרדת מהצמדת commit SHA של קטלוג הקהילה, שבוחרת את ה-commit של git ל-checkout.

#אכפו בקרות תוספים לארגון

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

  • רשימת היתר או רשימת חסימה למקורות marketplace
  • הפעלה כפויה של תוספים
  • כיבוי הדגלים --plugin-dir ו---plugin-url והמשתנה CLAUDE_CODE_PLUGIN_DIRS
  • הגבלת hooks לאלה מההגדרות המנוהלות ומתוספים שהופעלו בכפייה
  • עצירת טעינה ב-Claude Code של תוספים מחשבונות claude.ai של חברים, עם syncClaudeAiPlugins

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

#מצאו תוספים בטלמטריה

אם הארגון מייצא את אירועי OpenTelemetry של Claude Code ל-backend שלו, דרגות ה-marketplace קובעות אילו שמות תוספים מופיעים שם:

  • אירוע טעינת תוסף: האירוע מדווח שמות תוסף ו-marketplace בדרגה הרשמית כפי שהם. בדרגות הקהילה וצד שלישי, plugin.name ו-marketplace.name הם המחרוזת המילולית third-party אלא אם מגדירים OTEL_LOG_TOOL_DETAILS=1.
  • היקף תוסף: plugin.scope של אירוע הטעינה עדיין מדווח מאיפה התוסף הגיע, למשל org לתוסף שההגדרות המנוהלות מפעילות או user-local לכל תוסף אחר של צד שלישי. אירוע טעינת התוסף מפרט כל ערך.
  • אירוע התקנת תוסף: אלא אם מגדירים OTEL_LOG_TOOL_DETAILS=1, האירוע משמיט את שדות השם לתוספים שאינם רשמיים במקום לדווח third-party.
  • Claude Code Analytics API: Claude Code מדווח תוספים מהדרגות הרשמית והקהילה לפי שם ומדווח כל תוסף אחר כ-third-party.

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