📘 תיעוד 88

איתור תקלות בתוספים

תיקון שגיאות תוספים ב-Claude Code. מצאו את ההודעה המדויקת שראיתם, מקובצת לפי שלב, מהמקום שבו /plugin רץ ועד התקנה ומדיניות ארגון.

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

כשהודעה מציינת תוסף או marketplace, הערך מציג מציין מקום כמו <name> במקום השם.

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

[!NOTE]

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

• למה scopes, המטמון והקדימות מתנהגים כפי שהם מתנהגים: קראו הפניה לטעינת תוספים
• חיפוש דגל, שדה או פקודה: השתמשו בהפניה לפקודות תוספים, בהפניה למניפסט, או בהפניה ל-marketplace
• הודעת hooks module not loaded או hooks module did not load: התוסף הוא mod, אז קראו ה-mod לא נטען

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

#מצאו איפה /plugin רץ

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

#/plugin isn't available in this environment

הקלדתם /plugin במקום שאינו סשן טרמינל של Claude Code, ו-Claude השיב בשורה הזאת במקום לפתוח משהו.

מקבלים את התשובה הזאת בסשן שאין בו טרמינל לציור לוח /plugin: מצב לא אינטראקטיבי עם claude -p, ה-Agent SDK, לשונית Code באפליקציית הדסקטופ של Claude, לוח התוסף של VS Code, והדפדפן ב-claude.ai/code.

בלוח התוסף של VS Code, רק שורת /plugin עם משהו אחריה, כמו /plugin install <plugin>@<marketplace>, מקבלת את התשובה הזאת. /plugin או /plugins שהוקלדו לבד פותחים את תיבת הדו שיח Manage plugins.

התקינו את התוסף מהמשטח שבו אתם נמצאים:

• אפליקציית הדסקטופ של Claude, סשן מקומי או SSH: השתמשו בלשונית Desktop app תחת התקנת תוסף
• תוסף VS Code: השתמשו בלשונית VS Code תחת התקנת תוסף
• Claude Code באינטרנט, או סשן ענן בדסקטופ: לסשן ענן אין דפדפן תוספים. ראו את לשונית Cloud session תחת התקנת תוסף לגבי מה שסשן ענן טוען
• טרמינל שיש לכם גישה אליו: הריצו claude והקלידו שם /plugin, או הריצו claude plugin install <plugin>@<marketplace> במעטפת בלי להתחיל סשן

כשהתקנה מטרמינל עובדת, /plugin מדפיס סיכום התקנה שמתחיל ב-✓ Installed <plugin>. ו-claude plugin install מדפיס Successfully installed plugin: <plugin>@<marketplace>.

#zsh: no such file or directory: /plugin

הקלדתם /plugin ... בהנחיית מעטפת, והמעטפת דיווחה שאין קובץ בשם /plugin. Bash מדווח bash: /plugin: No such file or directory.

/plugin היא פקודה שמקלידים בתוך סשן Claude Code, לא בהנחיית המעטפת. התחילו סשן והקלידו שם את אותה פקודה:

claude

אחר כך, בהנחיית Claude Code:

/plugin install <plugin>@<marketplace>

התקנה מוצלחת מדפיסה סיכום שמתחיל ב-✓ Installed <plugin>. אם ההתקנה עצמה נכשלת אחר כך, ההודעה שלה נמצאת תחת הוספת marketplace או התקנת תוסף.

כדי להתקין מהמעטפת בלי להתחיל סשן, הריצו claude plugin install <plugin>@<marketplace>.

#The term '/plugin' is not recognized as the name of a cmdlet

הקלדתם /plugin ... בהנחיית PowerShell, ו-/plugin היא פקודה של Claude Code, לא תוכנית. Bash ו-Zsh מדווחים על הצורה שלהם של השגיאה הזאת.

השתמשו באחת מהאפשרויות האלה:

• הריצו claude, ואז הקלידו /plugin בהנחיית Claude Code
• הריצו claude plugin install <plugin>@<marketplace> ב-PowerShell בלי להתחיל סשן

#claude: command not found אחרי claude plugin ...

הרצתם claude plugin install ... במעטפת, והמעטפת לא מצאה את claude בכלל. ב-Windows ההודעה היא 'claude' is not recognized as the name of a cmdlet או 'claude' is not recognized as an internal or external command.

הסיבה אינה פקודת התוסף. עקבו אחרי אימות ה-PATH, ואז נסו שוב את פקודת התוסף.

#Unknown command ואיותי פקודות שלא קיימים

הקלדתם פקודת תוסף שראיתם במקום כלשהו וקיבלתם Unknown command: /<name> בסשן, או error: unknown command '<name>' או error: unknown option '<flag>' מהבינארי claude במעטפת.

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

האיותים האלה נראים שגויים אבל עובדים:

• claude plugins הוא כינוי של claude plugin
• claude plugin remove הוא כינוי של claude plugin uninstall
• /plugins ו-/marketplace בסשן פותחים את אותו לוח כמו /plugin

#הוספת marketplace

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

#Marketplace "claude-plugins-official" not found

הרצתם /plugin install <plugin>@claude-plugins-official בסשן, ו-Claude Code דיווח שאין לו marketplace בשם הזה.

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

• כשמדיניות חוסמת את המקור
• כש-CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL מוגדר
• אחרי ניסיון שנכשל וממתין לניסיון חוזר

פקודות המעטפת claude plugin אף פעם לא רושמות אותו בשבילכם.

הוסיפו אותו, ואז נסו שוב את ההתקנה:

/plugin marketplace add anthropics/claude-plugins-official

Claude Code מדפיס Successfully added marketplace: claude-plugins-official, ו-/plugin marketplace list מציג את ה-marketplace עם המקור שלו.

לכל שם marketplace אחר בהודעה הזו, ראו Marketplace "<name>" not found.

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

#Marketplace "<name>" not found

הרצתם /plugin install בסשן ו-Claude Code דיווח שאין לו marketplace בשם הזה. שתי צורות של הפקודה מגיעות להודעה הזו:

• /plugin install <plugin>@<name>: שורת ההתקנה, לעתים קרובות שורה שמישהו שלח לכם, מציינת marketplace שעדיין לא הוספתם. שאר הרשומה הזו מכסה איך למצוא אותו ולהוסיף אותו.
• /plugin install <source> עם נתיב, URL, או owner/repo: הצורה הזו מדווחת על ההודעה במקום להתקין, גם עבור מקור שכבר הוספתם. כדי להתקין ממקור בפקודה אחת, ראו הוספת marketplace והתקנה בפקודה אחת.

אם השם מתחיל ב-claudeai-, ה-marketplace מתארח ב-claude.ai, ומוסיפים אותו לפי שם מהמעטפת עם claude plugin marketplace add --claudeai <name>. ראו הוספת marketplace מ-claude.ai.

לכל שם אחר, שורת התקנה מציינת marketplace אבל לא אומרת איפה ה-marketplace מתארח, ול-Claude Code אין אינדקס שבו אפשר לחפש שם של marketplace. בקשו ממי ששלח את השורה את המקור של ה-marketplace, שהוא owner/repo ב-GitHub, כתובת URL של git, או נתיב. אחר כך הוסיפו את ה-marketplace והריצו שוב את שורת ההתקנה.

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

אם כבר הוספתם את ה-marketplace, בדקו את האיות מול /plugin marketplace list.

#Invalid marketplace source format

הרצתם /plugin marketplace add <source>, claude plugin marketplace add <source>, או claude plugin install <plugin> --marketplace <source>, ו-Claude Code ענה Invalid marketplace source format. Try: owner/repo, https://..., or ./path.

Claude Code מקבל מקור באחת מהצורות האלה:

• קיצור owner/repo של GitHub
• כתובת URL של https:// או http://
• כתובת URL של SSH בצורת user@host:path
• נתיב מקומי שמתחיל ב-./, ../, /, או ~

שם חשוף כמו claude-plugins-official לא תואם לאף אחת מהן. גם שם מארח חשוף כמו marketplace.anthropic.com לא תואם.

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

/plugin marketplace add anthropics/claude-plugins-official

Claude Code מדפיס Successfully added marketplace: <name> כשההוספה מצליחה.

#'<source>' is not a valid GitHub owner/repo shorthand

העברתם מקור עם קו נטוי שאינו owner/repo, כמו github.com/owner/repo או נתיב gitlab.example.com/group/project. Claude Code סירב לו עם ההודעה הזו ורשימת צורות מקובלות.

הקיצור owner/repo מיועד רק ל-GitHub וחייב לעמוד בכללי השמות של GitHub, ולכן שם מארח או מקטע נתיב נוסף נכשלים. העבירו את המקור בצורה שתואמת למקום שבו ה-marketplace מתארח:

• מאגר על כל מארח: כתובת ה-URL המלאה לשכפול
• קובץ marketplace.json מתארח: כתובת ה-https:// שלו
• checkout מקומי: ./path או נתיב מוחלט

לדוגמה, כדי להוסיף את ה-marketplace הרשמי לפי כתובת ה-URL לשכפול, בסשן:

/plugin marketplace add https://github.com/anthropics/claude-plugins-official.git

הוספה מוצלחת מדפיסה Successfully added marketplace: <name>.

#Invalid git URL

הוספתם marketplace, התקנתם תוסף, או הרצתם עדכון מכתובת git, והפקודה נכשלה עם Invalid git URL בהודעה שלה.

Claude Code בודק כל כתובת git לפני שהוא מריץ את git. הוא מסרב לכתובת שהפרוטוקול שלה לא נתמך. הוא גם מסרב לכתובת ש-git יכול לקרוא כאילו היא מציינת שרת או תיקייה שונים מאלה שהכתובת מציגה.

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

סירוב שאומר במקום זאת is blocked by enterprise policy מגיע מההגדרות של הארגון שלכם. ראו מקור marketplace חסום על ידי מדיניות ארגונית.

#Path does not exist: <path>

העברתם נתיב מקומי ל-marketplace add, ושום דבר לא קיים בנתיב הזה. נתיב יחסי מחושב מול התיקייה הנוכחית שלכם.

בדקו את הנתיב המחושב בהודעה. אחר כך הריצו את הפקודה מהתיקייה שממנה הנתיב היחסי מתחיל, או העבירו נתיב מוחלט לתיקיית ה-marketplace. הוספה מוצלחת מדפיסה Successfully added marketplace: <name>.

Claude Code מקבל תיקייה שמכילה .claude-plugin/marketplace.json, או נתיב לקובץ .json. נתיב לכל קובץ אחר נכשל עם File path must point to a .json file (marketplace.json).

#Marketplace file not found at <path>/.claude-plugin/marketplace.json

Claude Code שכפל או הוריד את ה-marketplace אבל לא מצא marketplace.json בנתיב הצפוי בתוכו. פקודת ההוספה מדווחת על זה כ-Failed to add marketplace: Marketplace file not found at ....

מיקום ברירת המחדל הוא .claude-plugin/marketplace.json בשורש המאגר, ו-הפניית marketplace מפרטת את המיקומים המקובלים.

התיקון שונה לבעלים ולכל השאר:

• אתם הבעלים של ה-marketplace: שימו את הקובץ במיקום הזה והוסיפו מחדש את ה-marketplace
• מישהו אחר מארח אותו: בקשו מהבעלים את המקור המדויק שהם מפרסמים

#Cannot add marketplace "<name>": Claude Code cannot install plugins from a marketplace with this name

הוספתם marketplace, וה-name בקובץ marketplace.json שלו אינו תקין כחלק שאחרי @ ב-plugin id כמו my-plugin@my-marketplace. Claude Code מסרב להוספה ולא רושם דבר.

שאר ההודעה מציין את הכלל לשם. בדוגמה הזו, _internal שובר את הכלל כי הוא מתחיל ב-_:

Cannot add marketplace "_internal": Claude Code cannot install plugins from a marketplace with this name. Each part of a plugin id (plugin@marketplace) may use only the letters a-z and A-Z, digits, ".", "_" and "-", and must start with a letter or digit. The name is set by "name" in the marketplace's marketplace.json; ask its maintainer to change it.

תנו ל-marketplace שם שמתאים לכלל הזה, ואז הוסיפו אותו שוב:

• אתם הבעלים של ה-marketplace: שנו את name ב-marketplace.json, לדוגמה ל-internal-tools
• מישהו אחר מארח אותו: בקשו מהבעלים לשנות את השם

לפני v2.1.295, Claude Code דיווח על ההוספה בדוגמה הזו כמוצלחת.

#Cannot add marketplace "<name>": Claude Code reserves this name and cannot register a marketplace under it

הוספתם marketplace, וה-name בקובץ marketplace.json שלו הוא אחד משמות המאפיינים שיש לכל אובייקט JavaScript, כמו constructor, toString, או valueOf. Claude Code שומר את השמות האלה, ולכן הוא מסרב להוספה ולא רושם דבר. שמות שמורים מפרט אותם.

בדוגמה הזו, ה-marketplace נקרא constructor:

Cannot add marketplace "constructor": Claude Code reserves this name and cannot register a marketplace under it. The name is set by "name" in the marketplace's marketplace.json; ask its maintainer to change it.

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

תנו ל-marketplace שם אחר, ואז הוסיפו אותו שוב:

• אתם הבעלים של ה-marketplace: שנו את name ב-marketplace.json
• מישהו אחר מארח אותו: בקשו מהבעלים לשנות את השם

לפני v2.1.296, הוספה של marketplace כזה נכשלה עם שגיאה פנימית במקום ההודעה הזו.

#SSH authentication failed או HTTPS authentication failed

הוספתם או עדכנתם marketplace ממאגר git, והשכפול נכשל עם Failed to clone marketplace repository: ואחריו אחת מהשורות האלה.

קודם בדקו את המאגר עצמו: owner/repo עם שגיאת כתיב, מאגר שלא קיים, או מאגר פרטי שאי אפשר לראות גם מסתיימים בהודעה הזו. פתחו את כתובת ה-URL של המאגר בדפדפן, או הריצו git ls-remote <url> במסוף, כדי לאשר שהוא קיים ויש לכם גישה.

אם המאגר נכון, הסיבה היא אישורים. Claude Code מכבה את ההנחיות של git ואת תוכניות askpass, כולל אחת שמוגדרת ב-GIT_ASKPASS, ומריץ SSH במצב batch. כש-git צריך להציג הנחיה, שגיאת השכפול כוללת fatal: Cannot prompt because user interactivity has been disabled, terminal prompts disabled, או fatal: unable to get password from user. רק אישורים ש-git יכול לקבל בלי הנחיה או תוכנית askpass מצליחים:

• SSH: ssh -T git@<host> חייב להצליח בלי לבקש passphrase, והמארח כבר חייב להיות ב-known_hosts
• HTTPS: ה-credential helper שלכם חייב להחזיק token עבור המארח. עבור GitHub, הריצו gh auth login ו-gh auth setup-git. עבור מארח אחר, שמרו personal access token ב-credential helper של git. כדי לבדוק, בטלו את GIT_ASKPASS במסוף והריצו git -c core.askPass= ls-remote <url>.

אחרי שהבדיקה לפרוטוקול שלכם מצליחה בלי הנחיה, הריצו שוב את ההוספה או העדכון. הוספה מוצלחת מדפיסה Successfully added marketplace: <name>. עדכון מוצלח מדפיס Successfully updated marketplace: <name> מהמעטפת, או ✔ Updated 1 marketplace בסשן.

כדי ש-Claude Code ידלג על SSH עבור מקורות owner/repo של GitHub, הגדירו CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1. בלעדיו, Claude Code משכפל את המקורות האלה דרך SSH כשמפתח SSH עבור github.com נראה מוגדר, וחוזר ל-HTTPS כששכפול ה-SSH נכשל.

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

#SSH host key is not in your known_hosts file

הוספתם marketplace דרך SSH ממארח שמעולם לא התחברתם אליו, והשכפול נכשל עם השורה הזו ורמז ssh -T git@<host>. עבור מארח שהמפתח שלו השתנה, ההודעה היא SSH host key has changed עם רמז ssh-keygen -R <host> במקום.

Claude Code משכפל עם StrictHostKeyChecking=yes, ולכן הוא מסרב למארח שהמפתח שלו עדיין לא אושר, במקום לאשר את המפתח אוטומטית. התחברו פעם אחת מהמסוף כדי לאשר את ה-fingerprint, ואז נסו שוב:

ssh -T [email protected]

עבור מאגר ציבורי, הוסיפו את ה-marketplace לפי כתובת ה-https:// שלו כדי להימנע מ-SSH לגמרי.

#Command 'git' not found or is in an unsafe location

ב-Windows, הוספתם marketplace ו-Claude Code דיווח Failed to clone marketplace repository: Command 'git' not found or is in an unsafe location (current directory).

Claude Code מחפש את git ב-PATH שלכם ומסרב להריץ אחד שנמצא רק בתיקייה הנוכחית. כדי לתקן, התקינו את Git ונסו שוב:

1. התקינו את Git for Windows

   התקינו את Git for Windows כך ש-git יהיה ב-PATH.

2. פתחו מסוף חדש

   פתחו מסוף חדש כדי שה-PATH המעודכן יחול.

3. אשרו ש-git רץ

   אשרו ש-git --version מדפיס גרסה.

4. נסו שוב את ההוספה

   הריצו שוב את פקודת marketplace add.

#Git clone timed out after 120s

הוספתם או עדכנתם marketplace, וזה נכשל עם Git clone timed out after 120s, ואחריו רמז להגדיר CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS.

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

Bash או Zsh

export CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS=300000

PowerShell

$env:CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS = "300000"

אחר כך נסו שוב באותה מעטפת.

אם המאגר הוא monorepo, הגבילו את ה-checkout לתיקיות שאתם מציינים עם claude plugin marketplace add <source> --sparse <paths>.

אם למאגר יש תת-מודולים גדולים של git, עדכנו את Claude Code. ב-v2.1.295 ואילך, Claude Code מביא רק את תת-המודולים שמחזיקים קובצי תוסף. גרסאות קודמות מביאות כל תת-מודול, וזה יכול לנצל את 120 השניות לבד.

#עדכוני marketplace ממשיכים להיכשל במצב לא מקוון

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

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

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

Bash או Zsh

export CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=1

PowerShell

$env:CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE = "1"

כשהמשתנה מוגדר, Claude Code מדלג על השכפול מחדש רק עבור checkout שכבר מכיל .claude-plugin/marketplace.json. marketplace שמעולם לא שוכפל או שהשכפול שלו נעצר באמצע עדיין מקבל את ניסיון השכפול, אז הוסיפו אותו פעם אחת בזמן חיבור לרשת.

עבור פריסה לא מקוונת לגמרי, מלאו מראש את תיקיית התוספים בזמן בניית התמונה עם CLAUDE_CODE_PLUGIN_SEED_DIR, לפי זריעת קונטיינרים ו-CI.

#הוספת marketplace נכשלת על מארח GitHub Enterprise Server

הוספתם marketplace מכתובת URL של GitHub Enterprise Server (GHES) וקיבלתם שגיאת מדיניות, או שהוספתם אותו מ-claude.ai וקיבלתם שגיאת גישה ל-GitHub.

שני המקרים נמצאים בדף GHES:

• שגיאת מדיניות פירושה שהארגון שלכם הגביל מקורות marketplace ומנהל צריך להוסיף hostPattern עבור המארח
• שגיאת גישה ל-GitHub ב-claude.ai פירושה שחשבון GitHub Enterprise שלכם עדיין לא מחובר

#התקנת תוסף

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

#Plugin "<name>" not found in marketplace "<marketplace>"

הרצת את /plugin install <name>@<marketplace> או את claude plugin install <name>@<marketplace>, ושם התוסף אינו נמצא בעותק של קטלוג השוק הזה שנמצא במחשב שלך.

claude plugin install במעטפת מדפיס את אותה הודעה כשעדיין לא הוספת את השוק כלל. אם claude plugin marketplace update <marketplace> עונה אז Marketplace '<marketplace>' not found, הוסף את השוק קודם.

#not found in marketplace עם רמז לרענון

הרמז אומר Your local copy may be out of date , try claude plugin marketplace update <marketplace> או The marketplace couldn't be refreshed (...). Claude Code לא רענן את השוק לפני החיפוש, למשל כשאתה לא מחובר, ולכן העותק שלך של הקטלוג עשוי להיות לא מעודכן. רענן עם שם השוק, ואז התקן שוב:

/plugin marketplace update <marketplace>

claude plugin marketplace update מדפיס Successfully updated marketplace: <name>, ו-/plugin marketplace update מציג ✔ Updated 1 marketplace. אם ההתקנה החוזרת מדפיסה את אותה הודעה, בדוק את השם כפי שמתאר not found in marketplace בלי רמז. מתי Claude Code מרענן שוק לפני התקנה מפרט את המקרים האחרים שבהם הרענון לא רץ.

#not found in marketplace בלי רמז

השם הוא הבעיה הסבירה ביותר. פתח את /plugin, עבור אל Discover, והעתק את השם מהרשימה.

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

#Plugin "<name>" not found in any marketplace

הרצת את /plugin install <name> בלי @marketplace, ואין שוק רשום שיש בו את התוסף הזה. claude plugin install <name> מדווח Plugin "<name>" not found in any configured marketplace.

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

/plugin install <name>@<marketplace>

כשההתקנה מצליחה, אתה רואה ✓ Installed <plugin>. בסשן, או Successfully installed plugin: <plugin>@<marketplace> מ-claude plugin install.

אם אינך יודע איזה שוק מציג את התוסף, הרץ את /plugin marketplace list עבור השווקים שיש לך, ועיין ב-Discover ב-/plugin עבור שם התוסף.

#Plugin '<name>@<marketplace>' is already installed globally

הרצת את /plugin install עבור תוסף שכבר מותקן בהיקף משתמש או על ידי הגדרות מנוהלות, ו-Claude Code סירב עם Use '/plugin' to manage existing plugins. אם הקלדת את שם התוסף בלי @<marketplace>, ההודעה משמיטה את globally.

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

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

claude plugin install במעטפת מדפיס הודעה אחרת. עבור תוסף שכבר מותקן בהיקף היעד, הוא מדפיס Plugin "<name>@<marketplace>" is already installed (scope: user) ויוצא עם קוד 0. אם תיקיית המטמון שלו חסרה, אותה פקודה מורידה אותו מחדש.

#"<plugin>" was not installed: it would share its folder with "<other>"

התקנת תוסף דרך claude plugin install, /plugin, או הצעת התקנה בסשן, ו-Claude Code סירב לו עם השורה הזו, או עם would share its saved data with.

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

ההודעה מציינת את הדרך החוצה:

• התוסף האחר מותקן: ההודעה אומרת Only one of the two can be installed. ומציינת את הפקודה claude plugin uninstall, או את שלב ההסרה ב-/plugin, שמסיר את התוסף האחר. הרץ אותו, ואז התקן שוב. לגבי מה שההסרה מוחקת ושומרת, ראה מה הסרה מוחקת ושומרת.
• שני המזהים מגיעים בהתקנה אחת, למשל תוסף ותלות שהוא צריך: שום סדר התקנה לא עוזר. רק מתחזק של השוק שמציג את שני התוספים יכול לתקן זאת, על ידי שינוי שם של אחד מהם. כשהשניים מגיעים משווקים שונים, מתחזק של כל אחד מהם יכול.

#This plugin uses a source type your Claude Code version does not support

התקנת תוסף שרשומת השוק שלו משתמשת בסוג מקור שהגרסה הזו של Claude Code לא יכולה להביא, ו-Claude Code עצר עם ההודעה הזו ועם Update Claude Code and try again.

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

#Plugin archive integrity check failed

התקנת תוסף שמופץ כארכיון zip, ו-Claude Code סירב לו עם השורה הזו ועם The archive was not installed. רשומת השוק של התוסף משתמשת במקור archive עם נעיצה של sha256, ותמצית הקובץ שהורד לא תואמת לנעיצה.

ההודעה המלאה נראית כך:

Plugin archive integrity check failed for https://artifacts.example.com/claude-plugins/my-plugin.zip: expected sha256 6bfa50e3d2e00c052b46abe51fff89346ac803e45771f76dcf6df1ab74cca5e1, got ac52220c0914ef8ca6a602e4a7362f88d30fb021110f72a6d15b68c3fe7df2b7. The archive was not installed. Verify the sha256 in the marketplace entry, or that the URL serves the intended file.

התיקון שונה עבור המפרסם ועבור המתקין:

• אתה מפרסם את התוסף: חשב מחדש את התמצית של הקובץ המדויק שה-URL מגיש ועדכן את sha256 ברשומת השוק. השתמש ב-shasum -a 256 my-plugin.zip, או ב-Get-FileHash -Algorithm SHA256 my-plugin.zip ב-PowerShell
• אתה מתקין את התוסף: הרץ את /plugin marketplace update <name> בסשן כדי לרענן את הקטלוג למקרה שהרשומה תוקנה, ואז נסה שוב את ההתקנה. אם התמציות עדיין לא מסכימות אחרי הרענון, שאל את בעל השוק איזה קובץ הם נעצו לפני ההתקנה

#An npm plugin source must name a registry package

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

"github:acme/formatter" was not installed: it is not an http or https link. An npm plugin source must name a registry package (name or name@version) or link to a tarball file. For a plugin in a git repository, use a "github", "url" or "git-subdir" source.

בעל השוק צריך לשנות את הרשומה:

• אם זה אתה: שנה את package לערך שהפניית מקור תוסף npm מקבלת, או העבר את הרשומה למקור github, url או git-subdir
• אם זה לא אתה: דווח על ההודעה לבעל השוק

#Marketplace "<name>" is registered from an untrusted source

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

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

ההודעה המלאה מציינת את השם השמור ואת התיקון:

Marketplace "claude-community" is registered from an untrusted source: The name 'claude-community' is reserved for official Anthropic marketplaces. Only repositories from 'github.com/anthropics/' can use this name. To fix it, remove the marketplace and re-add it from the official source.

התיקון שונה עבור משתמשים ועבור מפרסמים:

• אתה משתמש בשוק: במעטפת, הרץ את claude plugin marketplace remove <name>, ואז הוסף את השוק שוב מהמאגר הרשמי github.com/anthropics
• אתה מפרסם שוק של צד שלישי שהשתמש בשם לפני שהוא הפך לשמור: שנה את שמו ובקש ממשתמשים להוסיף אותו מחדש מהמקור שלך

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

#Marketplace "<name>" is added but ignored

לשוק יש רשומה ב-~/.claude/plugins/known_marketplaces.json, אבל הרשומה נכשלה בבדיקה ש-Claude Code מריץ בכל פעם שהוא קורא את הקובץ, ולכן השוק והתוספים שהותקנו ממנו מפסיקים להיטען. במעטפת, claude plugin list מדווח על כל תוסף מושפע עם שורה שמציינת את הסיבה ואת התיקון:

Marketplace team-tools is added but ignored. Its location is on a network drive, has "." or ".." in its path, or couldn't be checked. Re-add the marketplace (one added from a folder or file must be re-added from a copy on this computer), or, to trust a folder on a network drive, declare it under extraKnownMarketplaces in user or managed settings.

בסשן, לשונית Errors של /plugin שמה את שם השוק במרכאות, מסיימת את השורה אחרי הסיבה, ומציגה את התיקון בשורה שמתחתיה.

המשפט אחרי is added but ignored מציין את הבדיקה שהרשומה נכשלה בה:

• Its location is on a network drive, has "." or ".." in its path, or couldn't be checked, או אותו משפט לגבי The folder or file it was added from: תיקיית השוק, או הנתיב המקומי שממנו הוא נוסף, נמצאת במיקום רשת, יש בה מקטע . או .. בנתיב, או שלא ניתן היה לבדוק אותה
• Its git URL can't be used: <reason> או Its URL can't be read as an https:// or http:// address: כתובת ה-URL של המקור שנרשמה ברשומה היא כתובת ש-Claude Code מסרב לשכפל או להביא ממנה
• Its source doesn't match its extraKnownMarketplaces entry in user or managed settings: הרשומה לא תואמת להצהרת extraKnownMarketplaces באותו שם

כש-(see the debug log) בא אחרי is added but ignored במקום סיבה, Claude Code מסרב לשם השוק, למשל איות אחר של שם שמור. יומן הדיבוג מציין את הרשומה.

מה לעשות:

• עקוב אחר התיקון בהודעה. במעטפת, הרץ את claude plugin marketplace remove <name>, ואז הוסף את השוק שוב ממקור נתמך או מנתיב מקומי והתקן מחדש את התוספים שלו, שהפקודה remove מסירה. פקודת ההסרה פועלת על רשומה שהתעלמו ממנה
• כדי להשאיר שוק במיקום רשת, הצהר עליו תחת extraKnownMarketplaces בהגדרות המשתמש או בהגדרות המנוהלות שלך. הצהרה ב-.claude/settings.json או ב-.claude/settings.local.json של מאגר לא נספרת
• עבור מקור ששונה מהצהרת ההגדרות שלו, הוסף מחדש את השוק מהמקור המוצהר או שנה את ההצהרה. claude plugin marketplace add מסרב לאותה אי התאמה. ראה את רשומת Cannot add marketplace התואמת
• עבור שם שנדחה, הסר את השוק, באמצעות הפקודה אחרי Remove it: כשהשורה נותנת אחת. הוספה מחדש תחת אותו שם נדחית שוב

לפני v2.1.286, יהיה אשר יהיה הסיבה, claude plugin list דיווח על שוק כזה כ-Marketplace <name> not found, ולשונית Errors של /plugin דיווחה עליו כ-Marketplace "<name>" is registered but was refused (see the debug log). הסיבה הופיעה רק ביומן הדיבוג. ב-v2.1.286, משפטי הסיבה והתיקון השתמשו בניסוח אחר, למשל Its recorded location is network-shaped or unclassifiable (never probed).

#Plugin <name> has a corrupt manifest file או has an invalid manifest file

Claude Code הביא את התוסף, ואז נכשל בקריאת .claude-plugin/plugin.json שלו. במעטפת, ה-<name> בשורה הזו יכול להיות שם של תיקייה זמנית. הקידומת Failed to install plugin "<name>@<marketplace>" נושאת את השם האמיתי של התוסף. הניסוח אומר איזו בדיקה נכשלה:

• corrupt manifest file, ואחריו JSON parse error:: הקובץ אינו JSON תקין
• invalid manifest file, ואחריו Validation errors:: הקובץ מנותח אבל נכשל בסכמה, למשל name: Invalid input עבור שדה חובה חסר

claude plugin install מדווח על כל אחת מהן כ-Failed to install plugin "<name>@<marketplace>": ויוצא עם קוד 1.

מחבר התוסף צריך לתקן את הקובץ, ולא ניתן להתקין את התוסף עד אז:

• אם זה אתה: הרץ את claude plugin validate <plugin-directory> במעטפת כדי לראות את אותה שגיאה עם הנתיב הבעייתי, ואז תקן את הקובץ
• אם זה לא אתה: דווח על ההודעה לבעל השוק

#Plugin directory not found at path: <path>

לשונית Errors ב-/plugin מציגה זאת עבור תוסף מופעל שהשוק שלו מציג אותו לפי נתיב יחסי, למשל ./plugins/my-plugin, כשאין תיקייה בנתיב הזה בתוך השוק. אם אתה מתחזק את השוק, תקן את נתיב source של הרשומה או שחזר את התיקייה. אחרת, דווח על ההודעה לבעל השוק.

Marketplace directory not found at path: <path> אומר שתיקיית השוק עצמה חסרה במקום זאת. עבור שוק שהוספת מנתיב מקומי, התיקייה הזו הועברה או נמחקה. שחזר אותה, או הסר את השוק והוסף אותו שוב מהמיקום החדש שלו.

#No plugins available או No marketplaces configured

פתחת את /plugin ולשונית Discover ריקה, או ש-claude plugin marketplace list הדפיס No marketplaces configured.

אין שוק רשום, ולכן אין קטלוג להציג. בסשן, הוסף את השוק הרשמי, anthropics/claude-plugins-official:

/plugin marketplace add anthropics/claude-plugins-official

Claude Code מדפיס Successfully added marketplace: claude-plugins-official, ו-Discover מציג את התוספים שלו. הדף שווקי Anthropic מפרט את השווקים האחרים שאפשר להוסיף.

#Marketplace "<name>" is already added from a different source

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

ההודעה המלאה נראית כך:

Marketplace "acme-tools" is already added from a different source (github:acme/plugins). To use this source instead, remove that marketplace first with /plugin marketplace remove acme-tools.

בחר איזה מקור אתה רוצה:

• השוק שכבר הוספת: התקן ממנו לפי שם עם /plugin install <plugin>@<name>
• המקור החדש: הרץ את /plugin marketplace remove <name>, ואז נסה שוב את ההתקנה

#Cannot add marketplace "<name>": its source doesn't match its extraKnownMarketplaces entry in user or managed settings

הוספת marketplace, והשדה name בקובץ marketplace.json שלו כבר מופיע ברשומת extraKnownMarketplaces בהגדרות המשתמש או בהגדרות המנוהלות. המקור שציינת שונה מזה שהרשומה מציינת, ולכן Claude Code מסרב להוספה ולא רושם דבר.

שני מקורות תואמים כשיש להם אותו type ואותו ערך בכל שדה. רשומה שמגדירה ref שלא העברת נחשבת שונה. רשומת github נחשבת שונה גם כשנתת את המאגר ככתובת https://github.com/, כי Claude Code רושם את הכתובת הזו כמקור git. עשה אחד מאלה:

• השתמש במקור המוצהר: Claude Code רושם marketplaces שמוצהרים בהגדרות בעצמו, אז קודם הרץ /plugin marketplace list בסשן. אם הרשימה מציגה את השם, ה-marketplace כבר רשום ואין מה להוסיף.

  אם הרשימה לא מציגה אותו, הוסף אותו עם המקור כתוב כמו שהרשומה כותבת אותו. עבור רשומה שאובייקט ה-source שלה הוא { "source": "github", "repo": "acme-corp/claude-plugins", "ref": "v1.2.0" }, הרץ את זה:

  העתק

  /plugin marketplace add acme-corp/claude-plugins#v1.2.0

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

לפני v2.1.287, ההודעה הייתה Cannot add marketplace "<name>": its network source differs from the one declared for it in settings (kind, target, or a fetch-shaping field such as headers / ref / path / sparsePaths).

#Failed to install: <plugin> (<reason>)

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

חלק מהסיבות, כמו פלט של git אחרי clone שנכשל, מציגות רק את השורה הראשונה שלהן. כשסיבה כזו קוצרה, הסיכום מסתיים ב-Installing a plugin from its details (Enter) in /plugin shows its full error.

מה לעשות תלוי בשאלה אם הסיכום קיצר את הסיבה:

• תקן את מה שהסיבה בסוגריים מציינת
• כשהסיבה קוצרה, הרץ /plugin, בחר את התוסף בלשונית Discover, ולחץ Enter כדי להתקין אותו מפרטי התוסף. אם ההתקנה נכשלת שם, תצוגת הפרטים מציגה את השגיאה כולה

#Could not move the new copy of this plugin version into <path>

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

Could not move the new copy of this plugin version into /home/user/.claude/plugins/cache/acme-tools/formatter/1.2.0: the new copy or the version folder stayed busy while the install ran (ENOTEMPTY) , usually a scanner still reading the freshly downloaded files, another program using that folder, or another process re-creating it. The previously installed copy was moved back. Run the install again once other Claude Code sessions or programs using that folder have finished.

ההודעה אומרת מה קרה לעותק שהותקן קודם, וזה אומר לך אם התוסף עדיין עובד:

• The previously installed copy was moved back: הגרסה שהייתה לך עדיין מותקנת
• had to be removed first, was not moved back, או could not be moved back: גרסת התוסף הזו לא מותקנת עד שהתקנה מצליחה
• אין משפט כזה: לא היה עותק קודם, אז הגרסה עדיין לא מותקנת

ב-Windows, כשתוכנית אחרת מחזיקה את העותק המותקן עצמו, ההודעה אומרת במקום זאת שהעותק could not be replaced וש-It was not replaced and the new copy was discarded, כך שהגרסה שהייתה לך עדיין מותקנת.

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

כדי לתקן את ההתקנה:

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

#שגיאות תלויות

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

• במהלך ההתקנה: הסירוב חוזר כהודעת השגיאה של ההתקנה
• כשהתוסף נטען: הבעיה מופיעה ב-claude plugin list ובלשונית Errors של /plugin, ו-Claude Code משאיר את התוסף המושפע מושבת עד שתפתור את זה

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

כדי לראות את אלה באופן תכנותי, הרץ claude plugin list --json במעטפת. תוספים עם בעיות נושאים שדה errors עם ההודעות ושדה errorDetails עם type לכל אחת: שלוש השורות הראשונות הן dependency-unsatisfied והרביעית היא dependency-version-unsatisfied.

#תוסף מותקן אבל לא עובד

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

#התוסף לא מופיע או שה-skills שלו לא מוצגים

התקנת תוסף והקלדת / בציפייה ל-skills שלו, או ביקשת מ-Claude להשתמש בו, ושום דבר לא קרה.

בדוק את מצב התוסף לפני שאתה משנה משהו:

1. אשר שהתוסף מותקן ומופעל

   הרץ /plugin ופתח את Installed. אשר שהתוסף מופיע ברשימה ומופעל. claude plugin list במעטפת מדפיס את אותה רשימה עם הגרסה, ה-scope ו-Status: ✔ enabled של כל תוסף.

2. קרא את לשונית Errors

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

3. טען מחדש אם התקנת במהלך הסשן הזה

   אם התוסף מותקן וללא שגיאות אבל התקנת אותו במהלך הסשן הזה, הרץ /reload-plugins. הוא מדפיס Reloaded: עם ספירות של תוספים, skills, agents, hooks ו-servers. כשמשהו נכשל הוא מוסיף N errors during load. Run /plugin for details.

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

• תוסף שאתה בונה: ראה התוסף נטען אבל ה-skills שלו חסרים
• תוסף שמישהו אחר פרסם: פתח את Installed ב-/plugin ופתח את חלונית הפרטים של התוסף, שמפרטת מה התוסף מכיל. תוסף שלא מציין שם skills אין לו מה להציע כשאתה מקליד /

#Run /reload-plugins to apply.

סיכום ההתקנה ב-/plugin הסתיים ב-Run /reload-plugins to apply. במקום Plugin is now active. הודעת Plugins changed. Run /reload-plugins to activate. יכולה להופיע מעל השורת הקלט באותו זמן.

Claude Code לא הפעיל את התוסף במהלך ההתקנה, או כי הפעלה שלו הייתה מבטלת את מטמון ה-prompt, או כי ניסיון ההפעלה נכשל.

אין צורך להקליד את הפקודה. הפאנל נסגר ו-Claude Code מריץ עבורך את /reload-plugins, או מעמיד אותה בתור עד שהתשובה שמוזרמת מסתיימת.

קרא את מה שהטעינה מחדש מדפיסה:

• Reloaded: עם ספירות של תוספים, skills, agents, hooks ו-servers: התוסף פעיל עכשיו. כשמשהו נכשל בטעינה, השורה מוסיפה N errors during load. Run /plugin for details.
• This reload changes MCP tools (...) , your next message will re-read the whole conversation instead of using the cache. Run /reload-plugins --force to apply.: הטעינה מחדש הייתה מוסיפה או מסירה שרת MCP של תוסף, או את הכלי LSP, ומבטלת את מטמון ה-prompt. במקרה של LSP השורה מתחילה ב-This reload adds the LSP tool או This reload removes the LSP tool. הרץ אותה עם --force כדי להפעיל את התוסף בכל זאת, או התחל סשן חדש

לפני v2.1.268, התקנה שלא הופעלה במהלך ההתקנה נשארה ממתינה עד שהרצת /reload-plugins בעצמך.

לפני v2.1.246, ספירת ה-skills בסיכום הזה כללה רק רשומות commands/ של תוסף, כך שטעינה מחדש יכלה לטעון skills של SKILL.md של תוסף ועדיין לדווח 0 skills.

#The packages it lists are not installed או were not installed, because ...

/plugin ו-claude plugin list מציגים אחת מההערות האלה על תוסף שהתקנת התלויות שלו לא השאירה תיקיית node_modules. התוסף נטען, אבל החלקים שזקוקים לחבילות החסרות עשויים לא לעבוד.

• are not installed: ההתקנה יכולה לרוץ עבור התוסף הזה אבל לא הסתיימה, למשל כי היא נכשלה או עברה את הזמן. כדי לנסות שוב את ההתקנה, הרץ את פקודת claude plugin update שההערה נותנת, במעטפת, או עדכן את התוסף מ-/plugin

  העתק

  claude plugin update formatter@my-marketplace

  אם הניסיון החוזר נכשל, הפלט נותן את הסיבה. כש-CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC מוגדר, claude plugin update ו-/plugin מדלגים על הניסיון החוזר ומדווחים שהתוסף בגרסה האחרונה שלו.

• were not installed, because ...: ההתקנה לא יכולה לרוץ עבור התוסף הזה, וההערה מציינת את הסיבה, כמו קובץ נעילה של Yarn, pnpm או bun.lockb, או קובץ נעילה שמנהל החבילות שלו לא מותקן במחשב הזה. עדכון התוסף לא מתקין את החבילות כל עוד הסיבה הזו עומדת. אם הסיבה היא קובץ הנעילה, מחבר התוסף צריך להחליף אותו. אם זה מנהל חבילות חסר, התקן אותו, ואז עדכן את התוסף

#Plugin "<name>" not cached at <path>

לשונית Errors מציגה את השורה הזו עם ההנחיה Run /plugin to refresh the plugin cache. ל-Claude Code יש רשומת התקנה עבור התוסף, אבל התיקייה שהרשומה מצביעה עליה חסרה, למשל אחרי שניקית את המטמון.

התקן מחדש את התוסף מהמעטפת. claude plugin install <name>@<marketplace> מוריד מחדש תוסף שתיקיית ההתקנה שלו חסרה אף על פי שהרשומה שלו קיימת:

claude plugin install <name>@<marketplace>

ואז הרץ /reload-plugins בסשן שלך. רשומת לשונית Errors נעלמת והתוסף חוזר תחת Installed.

#installed_plugins.json holds a record under "<id>" that this version of Claude Code cannot read

ההודעה מופיעה בצורות האלה:

• claude plugin list: מדפיס אותה כ-Note:
• claude plugin install, uninstall ו-update: מסרבים עם Plugin "<name>" was not installed:, Plugin "<name>" was not uninstalled:, או Plugin "<name>" was not updated:, ואחריהם אותו טקסט
• --json על כל אחת משלוש הפקודות האלה: שורת התוצאה נושאת את אותו message ו-failureCode: "install_records_unreadable"
• כמה רשומות כאלה: ההודעה היא holds records under
• הקובץ כולו מכריז על פורמט שהגרסה הזו לא מכירה: ההודעה היא installed_plugins.json is in a format (version <N>) that this version of Claude Code does not know במקום זאת

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

כל עוד הרשומה שם, הגרסה הזו לא כותבת מחדש את הקובץ, כך שהרשומה לא אובדת.

קח את האפשרויות של ההודעה לפי הסדר:

1. עדכן את Claude Code עם claude update.
2. אם אי אפשר לעדכן, הסר את התוסף שצוין עם גרסת Claude Code שכתבה את הרשומה.
3. אם אף אחת מהאפשרויות לא עוזרת, מחק את הרשומה מ-installed_plugins.json ידנית, ואז הפעל מחדש את Claude Code או הרץ /reload-plugins.

#installed_plugins.json could not be read and was rebuilt

claude plugin list מדפיס את ההערה הזו, עם הנתיב של קובץ שנשמר בשם installed_plugins.unreadable.<date>.<hash>.kept, כל עוד הקובץ הזה יושב ליד installed_plugins.json.

קובץ installed_plugins.json שאינו JSON תקין, או שאינו רשימת תוספים, לא יכול לומר מה התקנת.

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

#install records under names that no version of Claude Code can use were removed from installed_plugins.json

claude plugin list מדפיס את ההערה הזו, עם הנתיב של עותק בשם installed_plugins.set-aside.<date>.<hash>.json, כל עוד העותק הזה יושב ליד installed_plugins.json. ההערה מסתיימת ב-Nothing needs doing about these copies.

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

Claude Code מעתיק את הרשומות הבלתי שמישות לקובץ ה-.set-aside ומסיר אותן מהרשימה. Claude Code אף פעם לא קורא את העותקים בחזרה, והעותקים מתיישנים לפי לוח הזמנים של cleanupPeriodDays.

#does not load (...), so Claude Code ignores the whole file

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

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

האזהרה באה אחרי שורת ההצלחה של claude plugin install, enable, disable, או claude plugin marketplace add במעטפת:

⚠ /home/user/.claude/settings.json does not load (its "permissions" is not valid), so Claude Code ignores the whole file, including anything this command wrote there. Fix the file, then run this command again if its change is missing. If a newer Claude Code wrote the file, update Claude Code instead.

הטקסט בסוגריים מציין את השגיאה:

• its "<key>" is not valid: ההגדרה המצוטטת מחזיקה ערך ש-Claude Code לא מקבל. חפש את ההגדרה ב-הפניית ההגדרות עבור הערכים שהיא מקבלת. כשיותר מערך אחד נכשל, הטקסט מציין את ההגדרה הראשונה וסופר את האחרות, כמו ב-its "permissions" and 1 other value are not valid.
• it is not a JSON object: הרמה העליונה של הקובץ אינה אובייקט JSON, כמו קובץ שהרמה העליונה שלו היא מערך.

#מושבת ב-~/.claude/settings.json אבל עדיין נטען

הגדרתם תוסף ל-false ב-~/.claude/settings.json, והשורה שלו ב-claude plugin list או ב-/plugin מציגה את ההודעה הזו ואחריה את המקור שמפעיל אותו, למשל , project settings enable it, which overrides your user setting. ערך true במקור בעל הקדימות הגבוהה יותר דורס את הגדרת המשתמש שלכם.

כדי לוותר במחשב שלכם על תוסף שהפרויקט מפעיל, הגדירו את המזהה ל-false ב-.claude/settings.local.json, שהקדימות שלו גבוהה יותר מקובץ הפרויקט. למקורות האחרים שההודעה יכולה לציין, ראו מושבת בהגדרות המשתמש אבל עדיין נטען.

אם claude plugin list מסמן את התוסף כ-required by your org, אין קובץ הגדרות מעורב: הארגון שלכם מסמן את התוסף המסונכרן הזה כנדרש ב-claude.ai, והוא נטען גם אם השבתתם אותו קודם. ראו תוספים שמסונכרנים מ-claude.ai.

#Plugin "<name>" is enabled in project settings but isn't installed here

כרטיסיית Errors מציגה את השורה הזו עבור תוסף שקובץ .claude/settings.json של הפרויקט מפעיל, עם ההנחיה Run claude plugin install <name>@<marketplace> --scope project to install it for this project.

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

claude plugin install <name>@<marketplace> --scope project

אחרי שמריצים /reload-plugins בסשן, הרשומה בכרטיסיית Errors נעלמת והתוסף מופיע תחת Installed.

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

#תוסף נשאר מותקן אחרי plugin uninstall ב-Windows

ב-Windows מריצים claude plugin uninstall בהיקף project או local והפקודה מדווחת על הצלחה, אבל claude plugin list או /plugin עדיין מציגים את התוסף.

installed_plugins.json החזיק שתי רשומות התקנה של התוסף עבור תיקיית הפרויקט, וכל אחת מאייתת את נתיב התיקייה אחרת, והסרת התקנה אחת מסירה אחת מהן. כדי לבדוק, הריצו claude plugin list --json במעטפת. לשורה שנותרה של התוסף יש projectPath שמאיית את התיקייה אחרת מהמקום שבו הרצתם את הסרת ההתקנה, למשל c:\work\app עבור C:\work\app.

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

claude plugin uninstall <name>@<marketplace> --scope project

אחר כך הריצו שוב claude plugin list --json כדי לאשר שהשורה נעלמה.

לפני v2.1.295, ההרצה השנייה נכשלת עם Plugin "<name>" is not installed in project scope. הריצו claude update, ואז הריצו שוב את הסרת ההתקנה.

#תוסף שהותקן ממאגר git מציג גרסה unknown

Version: unknown ב-claude plugin list יכול להיות ש-Claude Code לא הצליח לקרוא את ה-commit שהוא משתמש בו כגרסה של תוסף שמקורו ב-git. לתוסף יכול להיות מאגר משלו, או שהוא נמצא בתוך marketplace שמתארח ב-git.

הריצו את הפקודות האלה במעטפת, והחליפו את formatter@my-marketplace בשורת name@marketplace של התוסף מ-claude plugin list:

1. עדכון Claude Code

עדכון Claude Code ל-v2.1.302 או חדש יותר, שמשכפל בפורמט שאפשר לקרוא ממנו את ה-commit:

claude update

2. עדכון ה-marketplace

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

claude plugin marketplace update my-marketplace

3. עדכון התוסף

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

claude plugin update formatter@my-marketplace

4. בדיקת הגרסה

בדקו את שורת Version: לערך כמו מזהה commit בן 12 תווים:

claude plugin list

claude plugin update משנה בלוק של היקף אחד בכל הרצה. עבור בלוק שעדיין מציג unknown, הריצו שוב עם ערך Scope: של הבלוק הזה:

claude plugin update formatter@my-marketplace --scope project

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

#Failed to load hooks from <path> ו-hooks שלא מופעלים

ה-hooks של תוסף לא רצים, או שאחד חוסם פעולה. או שכרטיסיית Errors מציגה כשל טעינה עבורם, ה-hooks נטענים ורואים הודעות <Event> hook error או שגיאת חסימה בתמליל, או ש-hook נטען בלי שגיאה ולעולם לא מופעל.

#hooks נכשלים בטעינה

כרטיסיית Errors מציגה אחת מההודעות האלה:

• Failed to load hooks from <path>: <reason>: hooks/hooks.json אינו JSON תקין או נכשל בסכמת ה-hooks. הסיבה מציינת את שגיאת הפענוח או האימות. תקנו את הקובץ. כדי לתפוס בעיית תחביר JSON ב-hooks/hooks.json לפני פרסום התוסף, הריצו claude plugin validate <plugin-directory> במעטפת
• hooks path not found: <path>: שדה hooks במניפסט מציין קובץ שלא קיים בנתיב הזה יחסית לשורש התוסף. תקנו את הנתיב או הוסיפו את הקובץ
• hooks path escapes plugin directory: <path>: ראו הנתיב יוצא מספריית התוסף

#הודעות hook error בתמליל

הודעה בצורה ... hook error: Failed with non-blocking status code: <stderr> אומרת שה-hook רץ והפקודה שלו נכשלה. לדוגמה, Stop hook error: Failed with non-blocking status code: /bin/sh: node: command not found אומרת שהמעטפת ש-Claude Code הפעיל לא מצאה את node. התקינו אותו, או ודאו שהוא ב-PATH של הטרמינל שממנו מפעילים את claude.

אם ה-stderr מציג את נתיב התוסף חתוך ברווח, פקודת ה-shell-form של ה-hook משתמשת ב-${CLAUDE_PLUGIN_ROOT} מחוץ למירכאות ונתיב ההתקנה מכיל רווח. עטפו את המשתנה במירכאות כפולות או השתמשו ב-exec form. כדי למצוא את המשתנה בלי מירכאות, הריצו claude plugin validate על ספריית התוסף וחפשו את אזהרת המירכאות.

אם ההודעה היא Failed to run: Plugin directory does not exist: <path>, ראו Plugin directory does not exist.

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

#hook של תוסף חוסם קריאת כלי או פרומפט

hook שיוצא עם קוד 2 חוסם את הפעולה שהוא רץ עבורה. כש-hook של תוסף חוסם כך וה-stderr שלו הוא הודעת החסימה, השגיאה מסתיימת ב-This hook comes from the <plugin> plugin. כדי שתדעו איזה תוסף להשבית או לתקן. לפני v2.1.281, השגיאה לא נקבה בשם התוסף.

אם ההודעה הזו מציגה את נתיב התוסף חתוך ברווח, החילו את התיקון ל-${CLAUDE_PLUGIN_ROOT} בלי מירכאות.

#hook נטען אבל אף פעם לא מופעל

אם hook נטען בלי שגיאה אבל אף פעם לא מופעל, קודם הריצו /plugin בסשן ופתחו את פרטי התוסף. הערה שם שמתחילה ב-Its hooks.json hooks do not run אומרת שתוסף מופעל אחר עם אותו שם רשם את ה-hooks שלו, ו-Hooks כששני תוספים מופעלים חולקים שם אומר איזה עותק זה ואיך להחליף. אחרת, בדקו את הגדרת ה-hook ואז צפו בו רץ:

1. בדיקת שם האירוע

שמות אירועים תלויי רישיות, אז אשרו שהשם שלכם תואם בדיוק, לדוגמה PostToolUse.

2. בדיקת ה-matcher

אשרו שה-matcher של ה-hook תואם לשם הכלי.

3. הפעלת האירוע בכוונה

עבור hook מסוג PostToolUse, בקשו מ-Claude לערוך קובץ.

4. קריאת יומן הדיבוג

פתחו את יומן הדיבוג, שרושם אילו hooks תאמו. hook שרץ מופיע שם עם קוד היציאה שלו.

#Plugin directory does not exist: <path>

הריצו /reload-plugins בשורת Claude Code קודם, למרות שההודעה אומרת להתקין מחדש. hook של תוסף נכשל עם Failed to run: Plugin directory does not exist: <path> (<plugin> , run /plugin to reinstall), וה-hook לא רץ, כשהספרייה שממנה הסשן טען את ה-hooks של התוסף נעלמה מהדיסק. Plugin directory not found at path: <path> היא הודעה אחרת, על רשומת marketplace.

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

• Reloaded: בלי שורת שגיאות: ה-hooks של התוסף כבר לא מצביעים על הספרייה החסרה
• N errors during load. Run /plugin for details.: פתחו את כרטיסיית Errors ב-/plugin ועקבו אחרי הרשומה בדף הזה עבור ההודעה שהיא מציגה
• שורה שמסתיימת ב-Run /reload-plugins --force to apply.: שום דבר לא נטען מחדש, וה-hooks ממשיכים להיכשל. הריצו /reload-plugins --force בשורת Claude Code

#Invalid MCP server config for "<server>" ושרתי MCP שלא מתחילים

תוסף אורז שרת MCP, וכרטיסיית Errors מציגה Invalid MCP server config for "<server>": <error>, או שהשרת רשום אבל /mcp אף פעם לא מציג אותו כמחובר.

#Invalid MCP server config for "<server>": <error>

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

• Missing environment variables: <names>: הגדירו את המשתנים האלה במעטפת שממנה מפעילים את Claude Code, ואז התחילו סשן חדש
• URL is unset or invalid: אפשרות ${user_config.*} שה-URL משתמש בה לא מוגדרת. הריצו /plugin configure <plugin> כדי להגדיר אותה
• has an invalid MCP url או headersHelper for MCP server '<server>' references ${user_config.*}: התצורה של התוסף עצמו אשמה. תקנו את url או headersHelper בתצורת ה-MCP של התוסף, או דווחו למחבר התוסף אם התוסף אינו שלכם. למקרה headersHelper יש רשומה משלו תחת plugin command references user_config

#Bundled MCP server "<name>" was not started: it needs configuration

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

בחרו את התוסף בכרטיסיית Installed של /plugin ובחרו Configure כדי לספק את הערכים. אחרי השמירה, /plugin מציג Configuration saved. ונסגר, ו-Claude Code טוען מחדש תוספים כמתואר תחת ניהול תוספים מותקנים. השרת מתחיל ברגע שהטעינה מחדש הזו חלה. לפני v2.1.285, Claude Code דילג על השרת בלי להציג את השורה הזו.

#השרת מוגדר אבל אף פעם לא מתחבר

הריצו /mcp כדי לראות את מצב השרת. כשהשרת תקין, /mcp מציג אותו כמחובר.

כדי לקרוא את השגיאה שהשרת הדפיס בזמן ההפעלה, הריצו claude --debug ופתחו את היומן ב-~/.claude/debug/<session-id>.txt. הדגל --debug לא מדפיס לטרמינל.

[!NOTE]

כשחיבור ל-שרת stdio של תוסף נכשל פחות מ-15 דקות לפני שהרצתם claude --debug, Claude Code לא מפעיל את השרת. בסשן החדש, בחרו Reconnect מתפריט השרת ב-/mcp כדי להפעיל אותו, ואז פתחו את היומן.

רשומת שרת ב-.mcp.json שנכשלת בסכמה לא מופיעה בכרטיסיית Errors. Claude Code משמיט את השרת הזה ורושם Invalid MCP server config for <server> in <path> רק ביומן הדיבוג הזה. כדי למצוא את הרשומה בלי לטעון את התוסף, הריצו claude plugin validate במעטפת על ספריית התוסף, והפקודה מדווחת עליה כשגיאה.

לפני v2.1.281, claude plugin validate לא בדק את .mcp.json.

#השרת עובד עם --plugin-dir אבל נכשל אחרי התקנה

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

Claude Code מעתיק תוסף מותקן למטמון שלו, ולכן נתיב שעובד רק מספריית המקור נשבר. כתבו נתיבים בתוך התוסף עם ${CLAUDE_PLUGIN_ROOT}.

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

#שרת שפה לא מתחיל, משתמש ביותר מדי זיכרון, או מדווח על אבחנות שגויות

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

#שרת שפה לא מתחיל

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

כרטיסיית Errors של /plugin מציגה את הכשל עם הסיבה שלו, למשל Executable not found in $PATH: "<binary>", ו-claude --debug רושם אותו כ-LSP server <name> failed to start: <reason>.

התקינו את הקובץ הבינארי ואשרו שהוא ב-PATH של הטרמינל שממנו מפעילים את claude, לדוגמה עם which typescript-language-server. אחר כך התחילו סשן חדש.

#שרת שפה משתמש ביותר מדי זיכרון

שרתי שפה כמו rust-analyzer ו-pyright מאנדקסים את כל הפרויקט. השביתו את התוסף עם /plugin disable <plugin> בסשן והסתמכו על כלי החיפוש המובנים של Claude.

#אבחנות חיוביות שגויות ב-monorepo

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

#בניית תוסף

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

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

• hook שלא מופעל: ראה hooks שלא מופעלים
• שרת MCP שלא עולה: ראה שרתי MCP שלא עולים

#commands path not found: <path>

לשונית Errors מציגה commands path not found: <absolute path> עם ההנחיה Check that the path in your manifest or marketplace config is correct. אותה הודעה מופיעה עבור skills, agents ו-hooks.

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

[!NOTE]

לפני v2.1.299, ההודעה הזו יכלה להופיע בהפעלה על שורה שמסומנת בתגית כגון synced[0]. השורה הזו מיועדת לתוסף שמסונכרן מ-claude.ai. היא הופיעה כשסשן אחר של Claude Code במחשב עדכן את התוסף רגעים לפני כן והזיז את הקבצים שלו. כדי לטעון את התוסף, הפעל מחדש את Claude Code. כדי שההודעה לא תופיע מהסיבה הזו, עדכן ל-v2.1.299 או חדש יותר.

נתיבים במניפסט יחסיים לשורש התוסף ומתחילים ב-./. נתיב שנפתר מחוץ לשורש התוסף מדווח במקום זאת כ-<component> path escapes plugin directory ומושמט.

#--plugin-dir בשורש שוק לא טוען את התוספים תחת plugins/

הפעלת claude --plugin-dir <path> ואין שגיאה, אבל ה-skills, ה-agents וה-hooks של התוסף לא שם.

--plugin-dir מקבל את תיקיית השורש של התוסף, זו שמכילה את .claude-plugin/plugin.json ואת תיקיות הרכיבים כגון skills/. אם מפנים אותו לשורש שוק במקום, Claude Code לא קורא את marketplace.json, ולכן תוסף תחת plugins/ לא נטען, ואין שגיאה. לפני v2.1.281, Claude Code טען שורש שוק כתוסף ריק אחד ששמו כשם התיקייה הזו. כוון את הדגל אל תיקיית התוסף עצמה:

claude --plugin-dir ./my-marketplace/plugins/my-plugin

אחר כך פתח את Installed ב-/plugin, שם חלונית הפרטים של התוסף מפרטת את הרכיבים שלו.

#קבצים שהתוסף מפנה אליהם מחוץ לתיקייה שלו לא נמצאים

תוסף עובד מתיקיית המקור שלו עם --plugin-dir אבל נכשל אחרי התקנה, עם שגיאות על נתיב כגון ../shared-utils.

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

#${CLAUDE_PLUGIN_ROOT} מציג לוכסנים קדמיים ב-Windows

ב-Windows, hook של תוסף שרץ דרך Git Bash מקבל את ${CLAUDE_PLUGIN_ROOT} כ-C:/Users/you/... ולא כ-C:\Users\you\..., וסקריפט שציפה ללוכסנים הפוכים נשבר.

כש-Git Bash מותקן, hook בצורת shell רץ דרך Git Bash כברירת מחדל. עבור hook שרץ דרך Git Bash, Claude Code מעביר את הנתיב עם לוכסנים קדמיים כדי ש-Bash לא יקרא לוכסנים הפוכים כ-escapes. פקודות מובנות של Bash, כלי MSYS וקובצי הפעלה מקוריים של Windows כולם מקבלים את הצורה הזו.

אם הסקריפט צריך לוכסנים הפוכים, עבור את ה-hook לאחת הצורות ששומרות נתיבים מקוריים, כפי שמתואר תחת צורת exec וצורת shell:

• hook בצורת exec, שמפעיל את התהליך ישירות עם מערך args
• hook עם "shell": "powershell"

#התוסף נטען אבל ה-skills שלו חסרים

התוסף רשום תחת Installed בלי שגיאות, אבל ה-skills שלו לא מוצעים כשמקלידים /.

Skills נטענים מ-skills/ בשורש התוסף ופקודות מ-commands/ בשורש התוסף. רק plugin.json שייך בתוך .claude-plugin/, ותיקיית skills/ בתוך .claude-plugin/ לא נסרקת. העבר את התיקיות לשורש התוסף והרץ /reload-plugins. אחר כך, חלונית הפרטים של התוסף ב-/plugin מפרטת את ה-skills, והקלדת / מציעה אותם.

כל skill הוא תיקייה שמכילה SKILL.md. רשומת skills במניפסט שמצביעה על קובץ SKILL.md ולא על התיקייה שלו מדווחת כ-path is a file; skills entries must be directories containing SKILL.md.

#skill נטען אבל Claude אף פעם לא מפעיל את ה-skill

ה-skill של התוסף רץ כשמקלידים את הפקודה /<plugin>:<skill> שלו, אבל Claude אף פעם לא מפעיל אותו בתגובה לבקשה רגילה.

בדוק את הסיבות האלה לפי הסדר:

• ה-skill מגדיר disable-model-invocation: true: ה-skill של התבנית ב-יצירת התוסף הראשון מגדיר אותו. הסר את השורה מ-skill שאתה רוצה ש-Claude יפעיל בעצמו. שליטה במי שמפעיל skill מכסה את השדה
• התיאור לא תואם לאופן שבו אנשים שואלים: עבור על הבדיקות ב-skill לא מופעל
• התיאור נחתך: כשמותקנים skills רבים, Claude Code מקצר תיאורים כדי להתאים לתקציב התווים של הרשימה, וזה יכול להסיר את מילות המפתח ש-Claude צריך כדי להתאים בקשה. ראה תיאורי skill נחתכים

כדי למדוד באיזו תדירות ה-skill מופעל על פני פרומפטים מציאותיים, במקום לבדוק אחד בכל פעם, כתוב מקרה eval עם grader מסוג tool_used: Skill והרץ אותו עם claude plugin eval אחרי כל שינוי בתיאור.

#<directory> is not a plugin or skill folder מ-claude plugin eval init

הרצת claude plugin eval init מתיקייה שאינה שורש של תוסף, כגון תיקיית הבית או שורש של מאגר ששומר את התוסף בתת תיקייה. init כותב את הסוויטה תחת תיקיית העבודה, ולכן הוא עוצר במקום ליצור תיקיית evals/ שהתוסף לעולם לא יראה.

עבור לשורש התוסף, התיקייה שמחזיקה את .claude-plugin/plugin.json או את SKILL.md של ה-skill, והרץ את הפקודה שוב. כדי לבנות את שלד הסוויטה במקום אחר בכוונה, העבר --eval-dir. ראה בדיקת תוספים עם evals.

#תיבת הדו שיח userConfig אף פעם לא מופיעה

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

האם ההתקנה מבקשת את הערכים תלוי במקום שבו מריצים אותה:

• /plugin install בסשן, או לשונית Discover ב-/plugin: תיבת הדו שיח היא חלק מההתקנה האינטראקטיבית הזו
• תיבת הדו שיח Manage plugins של תוסף VS Code: מבקשת אפשרויות שלא הוגדרו כטופס אחרי ההתקנה. לפני v2.1.285, התקנה שם לא הציגה טופס אפשרויות, לכן הגדר את הערכים מסשן מסוף עם /plugin configure <plugin>@<marketplace>
• claude plugin install במעטפת: אף פעם לא מבקש ערכי userConfig. הוא שומר כל ערכי --config KEY=VALUE שמעבירים, וכשאפשרויות נשארות לא מוגדרות הוא מדפיס N userConfig options not yet set , run /plugin configure <plugin>@<marketplace> in Claude Code, or pass --config KEY=VALUE. כשאחת מהאפשרויות שלא הוגדרו היא נדרשת, (M required) בא אחרי not yet set.

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

claude plugin install my-plugin@my-marketplace --config api_url=https://example.com

כשכל אפשרות מוגדרת, פלט ההתקנה לא נושא שורת not yet set.

כדי לפתוח את תיבת הדו שיח אחר כך, הרץ /plugin configure my-plugin@my-marketplace בסשן. מהמעטפת, claude plugin configure מציג אילו אפשרויות עדיין לא מוגדרות ושומר ערכים שמוזרמים ב-stdin. זה דורש Claude Code v2.1.285 או חדש יותר.

אם מעבירים מפתח --config שהמניפסט לא מצהיר עליו, התוסף עדיין מותקן, והפקודה מדפיסה ⚠ Installed, but --config not applied: --config key "<key>" isn't declared in this plugin's userConfig. ואחריו את המפתחות שהתוסף כן מצהיר עליהם.

עבור תוסף שמגיע עם קובץ חבילת MCPB שמצהיר על user_config משלו, ההודעה נקראת isn't declared in this plugin's userConfig or by its bundled MCP servers. במקום, והמפתחות הידועים כוללים את המפתחות של השרת הזה, כתובים <server>.<key>. חבילה שהמניפסט מפנה אליה לפי URL לא נקראת בזמן ההתקנה, ולכן המפתחות שלה לא מפורטים וההודעה אומרת להגדיר אותה ב-/plugin. הגדרת מפתחות <server>.<key> דורשת Claude Code v2.1.285 או חדש יותר.

#claude plugin validate מדווח על שגיאות

הרצת claude plugin validate <path>, או /plugin validate <path> בסשן, והוא הדפיס Found N errors ו-Validation failed, ואז יצא עם קוד 1.

הוולידטור קורא את המניפסט בנתיב שנותנים לו: .claude-plugin/plugin.json עבור תיקיית תוסף, .claude-plugin/marketplace.json עבור תיקיית שוק, או את שניהם עבור תיקייה שמחזיקה את שניהם. עבור שוק, הוא מקדים בעיות במניפסט של רשומה עצמה באינדקס הרשומה, כ-plugins[1] plugin.json → json: .... לפני v2.1.289, Claude Code אימת תיקייה שמחזיקה את שניהם כשוק בלבד.

הטבלה מכסה את ההודעות שעוצרות את האימות ושתי אזהרות, No frontmatter block found ו-Unknown field '<key>', שעוצרות אותו רק כשמעבירים --strict. אזהרות אחרות, כגון תיאור חסר, לא מפורטות.

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

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

#Plugin <name> has conflicting manifests

התוסף נכשל בטעינה עם Plugin <name> has conflicting manifests: both plugin.json and marketplace entry specify components.

לתוסף יש plugin.json משלו, ורשומת השוק שלו מגדירה strict: false וגם מצהירה על אחד מ-commands, agents, skills, hooks, outputStyles או themes. הסר את השדות האלה מהרשומה, או הגדר strict: true ברשומה כדי ש-Claude Code יוסיף אותם אל plugin.json. ראה מצב strict.

#Warning: No commands found in plugin <name> custom directory

כשהתוסף נטען, יומן claude --debug ב-~/.claude/debug/<session-id>.txt רושם Warning: No commands found in plugin <name> custom directory: <path>. Expected .md files or SKILL.md in subdirectories. שום דבר לא מופיע בסשן או בלשונית Errors.

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

#אירוח שוק

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

#תוספים עם נתיבים יחסיים נכשלים בשווקים מבוססי URL

משתמשים הוסיפו את השוק שלך עם כתובת https://example.com/marketplace.json. התקנות של תוספים ש-source שלהם הוא נתיב יחסי, כמו ./plugins/my-plugin, נכשלות עם its marketplace entry path does not stay inside the marketplace directory. תוספים שכבר הותקנו נכשלים בטעינה עם Plugin source path refused. לשתי ההודעות יש רשומת הפניה לשגיאה.

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

{ "name": "my-plugin", "source": { "source": "github", "repo": "owner/repo" } }

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

#קבצים של תוסף שורש מתת מודול git חסרים אחרי ההתקנה

התוסף שלך נמצא בשורש השוק ומריץ או קורא קובץ מתת מודול git של המאגר. אחרי ההתקנה, התיקייה של תת המודול ריקה. לפני v2.1.295, Claude Code הביא כל תת מודול, ולכן התיקייה הייתה מאוכלסת.

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

כתוב נתיב אל תוך תת המודול במלואו, במקום ש-Claude Code יכול לקרוא אותו, כמו ${CLAUDE_PLUGIN_ROOT}/vendor/tool/run.sh בפקודת hook. אז Claude Code מביא כל תת מודול במאגר עבור התוסף הזה.

#שגיאות אימות של השוק

הרצת claude plugin validate . מתיקיית השוק שלך, והוא דיווח על שגיאות או אזהרות בקובץ השוק עצמו.

claude plugin validate גם מאמת כל רשומה ש-source שלה הוא נתיב מקומי, ומזהיר כשה-version של הרשומה לא תואם למניפסט של התוסף עצמו.

הטבלה מפרטת את ההודעות ברמת השוק. הודעות ברמת הרשומה הן הודעות התוסף תחת claude plugin validate מדווח על שגיאות, עם הקידומת plugins[N] plugin.json →.

לפני v2.1.247, שם שוק שהכיל תווי בקרה או תווי עיצוב דו כיווני דווח רק כ-Marketplace name impersonates an official Anthropic/Claude marketplace.

#חסום על ידי הארגון שלך

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

#Marketplace source '<source>' is blocked by enterprise policy

הרצת /plugin marketplace add, update, או התקנה, ו-Claude Code סירב עם השורה הזו.

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

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

• Allowed sources: <list>: החסימה באה מרשימת ההיתר strictKnownMarketplaces ולא מרשימת החסימה blockedMarketplaces
• No external marketplaces are allowed.: רשימת ההיתר strictKnownMarketplaces ריקה
• Tip: שהקיצור מניח את github.com: רשימת ההיתר מתירה מארח git לפי שם מארח, והקיצור owner/repo שהעברת מצביע על github.com. אם המאגר נמצא במארח הפנימי שלך, הוסף אותו שוב עם כתובת ה-URL המלאה שלו, כמו [email protected]:owner/repo.git

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

#Marketplace "<name>" is not in the allowed marketplace list

לשונית Errors מציגה את השורה הזו, או Marketplace "<name>" is blocked by enterprise policy, עבור שוק שכבר רשום אצלך.

אותן הגדרות מנוהלות שחוסמות מקור שוק חלות בזמן הטעינה. strictKnownMarketplaces לא כולל את השוק הזה, או ש-blockedMarketplaces מציין אותו, ולכן Claude Code מפסיק לטעון אותו ואת התוספים שלו. עבור גרסת רשימת ההיתר, שורת ההנחיה מציגה את המקורות המותרים, או Contact your administrator to configure allowed marketplace sources. עבור גרסת רשימת החסימה כתוב This marketplace source is explicitly blocked by your administrator.

#Plugin "<name>" is blocked by your organization's policy and cannot be installed

התקנה סורבה עם השורה הזו, הפעלה עם אותה שורה שמסתיימת ב-cannot be enabled, או התקנה או עדכון עם הודעה שמציינת את הסיבה: Plugin "<name>" is from marketplace "<marketplace>", which is blocked by your organization's policy, או Plugin "<name>" depends on "<dep>", which is blocked by your organization's policy.

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

#--plugin-dir is disabled by your organization's managed settings (disableSideloadFlags)

הפעלת את claude עם --plugin-dir, --plugin-url, --agents או --mcp-config. Claude Code יצא עם ההודעה הזו ועם Plugins, custom agents, and MCP servers can only be loaded from sources your administrator has approved.

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

הודעה קשורה בלשונית Errors של /plugin היא --plugin-dir copy of "<name>" ignored: plugin is locked by managed settings. הגדרות מנוהלות מפעילות או משביתות את התוסף לפי שם, ו-Claude Code מתעלם מהעותק של --plugin-dir שלך עבורו, כך שהדגל לא יכול לעקוף את המדיניות.

#Plugins from ~/.claude/skills/ are blocked by your organization's managed settings

הרצת claude plugin init או claude plugin enable, והוא נעצר עם השורה הזו. ההודעה מציינת strictKnownMarketplaces or blockedMarketplaces ומבקשת מהמנהל שלך להוסיף {"source":"skills-dir"} ל-strictKnownMarketplaces או להסיר אותו מ-blockedMarketplaces.

המקור skills-dir מייצג תוספים ש-Claude Code טוען מהתיקייה ~/.claude/skills/ שלך. בקש מהמנהל שלך לבצע את השינוי שההודעה מציינת.

#Command-sourced plugins are disabled by your organization's managed settings

התקנת או עדכנת תוסף עם מקור command, והוא נעצר עם השורה הזו ועם The plugin was not installed or updated and its command was not run.

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

#Marketplace '<name>' is seed-managed

הרצת claude plugin marketplace update <name>, והוא נכשל עם Marketplace '<name>' is seed-managed (<dir>) ועם רמז לבקש מהמנהל שלך.

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

כדי לשנות את תוכן השוק, בקש מהאדם שמתחזק את תמונת ה-seed לעדכן אותה. להליך, ראה מכולות seed ו-CI.

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

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