Zum Hauptinhalt springen
Diese Seite listet Fehlermeldungen und Symptome für Claude Code-Plugins und für Marktplätze auf – die Kataloge, aus denen Claude Code Plugins installiert. Jeder Eintrag gibt die Ursache, eine Lösung und das, was Sie sehen, sobald die Lösung funktioniert. Wenn eine Meldung ein Plugin oder einen Marktplatz benennt, zeigt der Eintrag einen Platzhalter wie <name> statt dessen an. Verwenden Sie diese Seite, ob Sie Plugins installieren, sie erstellen, einen Marktplatz hosten oder Plugins für eine Organisation verwalten.
Diese Fälle werden auf anderen Seiten behandelt:
Suchen Sie nach der genauen Meldung, die Sie gesehen haben. Jede Meldung wird unter der Phase aufgelistet, die sie erzeugt, was nicht immer der Befehl ist, den Sie ausgeführt haben. Zum Beispiel kann eine Installation fehlschlagen, weil ein Marktplatz fehlt, daher wird diese Meldung unter Einen Marktplatz hinzufügen aufgelistet.

​
Finden Sie, wo /plugin ausgeführt wird

/plugin ist ein Befehl, den Sie in einer laufenden Claude Code-Terminalsitzung eingeben, und er öffnet ein interaktives Panel. Die Einträge in diesem Abschnitt behandeln die Orte, an denen Sie ihn eingeben können, aber er kann nicht ausgeführt werden, und die Befehlsschreibweisen, die nicht vorhanden sind.

​
/plugin isn't available in this environment

Sie haben /plugin irgendwo anders als in einer Claude Code-Terminalsitzung eingegeben, und Claude hat stattdessen diese Zeile geantwortet, ohne etwas zu öffnen. Sie erhalten diese Antwort in einer Sitzung, die kein Terminal zum Zeichnen des /plugin-Panels hat: nicht-interaktiver Modus mit claude -p, das Agent SDK, die Code-Registerkarte der Claude-Desktop-App, das VS Code-Erweiterungspanel und der Browser unter claude.ai/code. Im VS Code-Erweiterungspanel erhält nur eine /plugin-Zeile mit etwas danach, wie /plugin install <plugin>@<marketplace>, diese Antwort. /plugin oder /plugins allein eingegeben öffnet den Dialog Plugins verwalten. Installieren Sie das Plugin von der Oberfläche, auf der Sie sich befinden:
  • Claude-Desktop-App, lokale oder SSH-Sitzung: verwenden Sie die Registerkarte Desktop-App unter Ein Plugin installieren
  • VS Code-Erweiterung: verwenden Sie die Registerkarte VS Code unter Ein Plugin installieren
  • Claude Code im Web oder eine Desktop-Cloud-Sitzung: eine Cloud-Sitzung hat keinen Plugin-Browser. Siehe die Registerkarte Cloud-Sitzung unter Ein Plugin installieren, um zu sehen, was eine Cloud-Sitzung lädt
  • Ein Terminal, auf das Sie Zugriff haben: führen Sie claude aus und geben Sie dort /plugin ein, oder führen Sie claude plugin install <plugin>@<marketplace> in Ihrer Shell aus, ohne eine Sitzung zu starten
Wenn eine Terminal-Installation funktioniert, druckt /plugin eine Installationszusammenfassung, die mit ✓ Installed <plugin>. beginnt, und claude plugin install druckt Successfully installed plugin: <plugin>@<marketplace>.

​
zsh: no such file or directory: /plugin

Sie haben /plugin ... an einer Shell-Eingabeaufforderung eingegeben, und die Shell hat gemeldet, dass keine Datei namens /plugin vorhanden ist. Bash meldet bash: /plugin: No such file or directory. /plugin ist ein Befehl, den Sie in einer Claude Code-Sitzung eingeben, nicht an der Shell-Eingabeaufforderung. Starten Sie eine Sitzung und geben Sie dort denselben Befehl ein:
Dann an der Claude Code-Eingabeaufforderung:
Eine erfolgreiche Installation druckt eine Zusammenfassung, die mit ✓ Installed <plugin>. beginnt. Wenn die Installation selbst dann fehlschlägt, befindet sich ihre Meldung unter Einen Marktplatz hinzufügen oder Ein Plugin installieren. Um von der Shell aus ohne Starten einer Sitzung zu installieren, führen Sie stattdessen claude plugin install <plugin>@<marketplace> aus.

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

Sie haben /plugin ... an einer PowerShell-Eingabeaufforderung eingegeben, und /plugin ist ein Claude Code-Befehl, kein Programm. Bash und Zsh melden ihre eigene Form dieses Fehlers. Verwenden Sie stattdessen eine dieser Optionen:
  • Führen Sie claude aus, geben Sie dann /plugin an der Claude Code-Eingabeaufforderung ein
  • Führen Sie claude plugin install <plugin>@<marketplace> in PowerShell aus, ohne eine Sitzung zu starten

​
claude: command not found nach claude plugin ...

Sie haben claude plugin install ... in Ihrer Shell ausgeführt, und die Shell konnte claude überhaupt nicht finden. Unter Windows lautet die Meldung 'claude' is not recognized as the name of a cmdlet oder 'claude' is not recognized as an internal or external command. Die Ursache liegt nicht am Plugin-Befehl. Folgen Sie Ihren PATH überprüfen, und versuchen Sie dann den Plugin-Befehl erneut.

​
Unknown command und Befehlsschreibweisen, die nicht vorhanden sind

Sie haben einen Plugin-Befehl eingegeben, den Sie irgendwo gesehen haben, und erhielten Unknown command: /<name> in einer Sitzung oder error: unknown command '<name>' oder error: unknown option '<flag>' vom claude-Binär in Ihrer Shell. Mehrere Befehlsschreibweisen sind im Umlauf, die es in Claude Code nicht gibt. Die folgende Tabelle ordnet jede davon dem tatsächlichen Befehl zu. Die Plugin-Befehlsreferenz listet die Unterbefehle und ihre Flags auf. Diese Schreibweisen sehen falsch aus, funktionieren aber:
  • claude plugins ist ein Alias von claude plugin
  • claude plugin remove ist ein Alias von claude plugin uninstall
  • /plugins und /marketplace in einer Sitzung öffnen dasselbe Panel wie /plugin

​
Einen Marktplatz hinzufügen

Ein Marktplatz ist ein Katalog, den Sie Claude Code aus einem Git-Repository, einer URL oder einem lokalen Pfad hinzufügen. Diese Einträge behandeln die Meldungen, die Sie erhalten, wenn das Hinzufügen fehlschlägt oder eine spätere Aktualisierung fehlschlägt.

​
Marketplace "claude-plugins-official" not found

Sie haben /plugin install <plugin>@claude-plugins-official in einer Sitzung ausgeführt, und Claude Code hat gemeldet, dass es keinen Marktplatz mit diesem Namen hat. Der offizielle Marktplatz ist auf diesem Computer noch nicht registriert. Claude Code registriert ihn normalerweise selbst beim ersten Mal, wenn Sie eine interaktive Terminalsitzung starten. Er ist noch nicht ausgeführt worden, wenn Sie Claude Code nur über die VS Code-Erweiterung verwendet haben, und er überspringt oder verschiebt diesen Schritt:
  • Wenn eine Richtlinie die Quelle blockiert
  • Wenn CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL gesetzt ist
  • Nach einem fehlgeschlagenen Versuch, der auf eine Wiederholung wartet
Die claude plugin-Shell-Befehle registrieren ihn nie für Sie. Fügen Sie ihn hinzu, und versuchen Sie dann die Installation erneut:
Claude Code druckt Successfully added marketplace: claude-plugins-official, und /plugin marketplace list zeigt den Marktplatz mit seiner Quelle. Für jeden anderen Marktplatznamen in dieser Meldung siehe Marketplace "<name>" not found. Dieselbe Zeichenkette erscheint auch in der Registerkarte /plugin Errors, der Liste der Ladefehler des Panels, wenn ein Plugin in Ihren Einstellungen einen Marktplatz benennt, den Sie nicht hinzugefügt haben.

​
Marketplace "<name>" not found

Sie haben /plugin install in einer Sitzung ausgeführt und Claude Code hat gemeldet, dass es keinen Marktplatz mit diesem Namen hat. Zwei Formen des Befehls führen zu dieser Meldung:
  • /plugin install <plugin>@<name>: die Installationszeile, oft eine, die jemand Ihnen gesendet hat, benennt einen Marktplatz, den Sie nicht hinzugefügt haben. Der Rest dieses Eintrags behandelt das Finden und Hinzufügen.
  • /plugin install <source> mit einem Pfad, einer URL oder owner/repo: Diese Form meldet die Meldung statt zu installieren, auch für eine Quelle, die Sie bereits hinzugefügt haben. Um von einer Quelle in einem Befehl zu installieren, siehe Einen Marktplatz hinzufügen und in einem Befehl installieren.
Wenn der Name mit claudeai- beginnt, wird der Marktplatz auf claude.ai gehostet, und Sie fügen ihn nach Name aus Ihrer Shell mit claude plugin marketplace add --claudeai <name> hinzu. Siehe Einen Marktplatz von claude.ai hinzufügen. Für jeden anderen Namen benennt eine Installationszeile einen Marktplatz, sagt aber nicht, wo der Marktplatz gehostet wird, und Claude Code hat keinen Index, um einen Marktplatznamen darin nachzuschlagen. Fragen Sie denjenigen, der die Zeile gesendet hat, nach der Quelle des Marktplatzes, die ein GitHub owner/repo, eine Git-URL oder ein Pfad ist. Dann fügen Sie den Marktplatz hinzu und führen Sie die Installationszeile erneut aus. Ein Marktplatz, den jemand Ihnen sendet, ist von Drittanbietern, daher überprüfen Sie das Plugin, bevor Sie es installieren. Wenn Sie den Marktplatz bereits hinzugefügt haben, überprüfen Sie die Schreibweise gegen /plugin marketplace list.

​
Invalid marketplace source format

Sie haben /plugin marketplace add <source>, claude plugin marketplace add <source> oder claude plugin install <plugin> --marketplace <source> ausgeführt, und Claude Code hat Invalid marketplace source format. Try: owner/repo, https://..., or ./path geantwortet. Claude Code akzeptiert eine Quelle in einer dieser Formen:
  • Ein GitHub owner/repo-Kurzbefehl
  • Eine https://- oder http://-URL
  • Eine user@host:path-SSH-URL
  • Ein lokaler Pfad, der mit ./, ../, / oder ~ beginnt
Ein bloßer Name wie claude-plugins-official passt zu keinem davon. Auch nicht ein bloßer Hostname wie marketplace.anthropic.com. Geben Sie die Quelle in einer der akzeptierten Formen erneut ein:
Claude Code druckt Successfully added marketplace: <name>, wenn das Hinzufügen funktioniert.

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

Sie haben eine Quelle mit einem Schrägstrich übergeben, die nicht owner/repo ist, wie github.com/owner/repo oder ein gitlab.example.com/group/project-Pfad. Claude Code hat sie mit dieser Meldung und einer Liste akzeptierter Formen abgelehnt. Der owner/repo-Kurzbefehl ist nur für GitHub und muss GitHubs Benennungsregeln befolgen, daher schlägt ein Hostname oder ein zusätzliches Pfadsegment fehl. Übergeben Sie die Quelle in der Form, die dem Ort entspricht, an dem der Marktplatz gehostet wird:
  • Ein Repository auf einem beliebigen Host: die vollständige Clone-URL
  • Eine gehostete marketplace.json: ihre https://-URL
  • Ein lokaler Checkout: ./path oder ein absoluter Pfad
Um beispielsweise den offiziellen Marktplatz durch seine Clone-URL hinzuzufügen, in einer Sitzung:
Ein erfolgreiches Hinzufügen druckt Successfully added marketplace: <name>.

​
Invalid git URL

Sie haben einen Marktplatz hinzugefügt, ein Plugin installiert oder eine Aktualisierung von einer Git-Adresse ausgeführt, und der Befehl ist mit Invalid git URL in seiner Meldung fehlgeschlagen. Claude Code überprüft jede Git-Adresse, bevor Git ausgeführt wird. Es weigert sich, eine Adresse zu akzeptieren, deren Protokoll es nicht unterstützt. Es weigert sich auch, eine Adresse zu akzeptieren, die Git als Benennung eines anderen Servers oder Ordners als dem, den die Adresse zeigt, lesen könnte. Der Text nach der Adresse benennt, was zu ändern ist. Schreiben Sie die Adresse wie in der Meldung angegeben um und führen Sie den Befehl erneut aus. Eine Ablehnung, die stattdessen is blocked by enterprise policy sagt, kommt von den Einstellungen Ihrer Organisation. Siehe Marktplatzquelle wird durch Unternehmensrichtlinie blockiert.

​
Path does not exist: <path>

Sie haben einen lokalen Pfad an marketplace add übergeben, und es existiert nichts an diesem Pfad. Ein relativer Pfad wird gegen Ihr aktuelles Verzeichnis aufgelöst. Überprüfen Sie den aufgelösten Pfad in der Meldung. Führen Sie dann den Befehl aus dem Verzeichnis aus, von dem der relative Pfad beginnt, oder übergeben Sie einen absoluten Pfad zum Marktplatzverzeichnis. Ein erfolgreiches Hinzufügen druckt Successfully added marketplace: <name>. Claude Code akzeptiert ein Verzeichnis, das .claude-plugin/marketplace.json enthält, oder einen Pfad zu einer .json-Datei. Ein Pfad zu einer anderen Datei schlägt mit File path must point to a .json file (marketplace.json) fehl.

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

Claude Code hat den Marktplatz geklont oder heruntergeladen, aber keine marketplace.json am erwarteten Pfad darin gefunden. Der Befehl zum Hinzufügen meldet ihn als Failed to add marketplace: Marketplace file not found at .... Der Standardort ist .claude-plugin/marketplace.json im Repository-Root, und die Marktplatz-Referenz listet die akzeptierten Orte auf. Die Lösung unterscheidet sich für den Besitzer und für alle anderen:
  • Sie besitzen den Marktplatz: legen Sie die Datei an diesem Ort ab und fügen Sie den Marktplatz erneut hinzu
  • Jemand anderes hostet ihn: fragen Sie den Besitzer nach der genauen Quelle, die er veröffentlicht

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

Sie haben einen Marktplatz hinzugefügt, und der name in seiner marketplace.json ist nicht gültig als der Teil nach @ in einer Plugin-ID wie my-plugin@my-marketplace. Claude Code lehnt das Hinzufügen ab und registriert nichts. Der Rest der Meldung nennt die Regel für den Namen. In diesem Beispiel verstößt _internal gegen die Regel, weil es mit _ beginnt:
Geben Sie dem Marktplatz einen Namen, der dieser Regel entspricht, und fügen Sie ihn dann erneut hinzu:
  • Sie besitzen den Marktplatz: ändern Sie name in marketplace.json, zum Beispiel in internal-tools
  • Jemand anderes hostet ihn: bitten Sie den Besitzer, den Namen zu ändern
Vor v2.1.295 hat Claude Code das Hinzufügen in diesem Beispiel als erfolgreich gemeldet.

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

Sie haben einen Marktplatz hinzugefügt, und der name in seiner marketplace.json ist einer der Member-Namen, die jedes JavaScript-Objekt besitzt, etwa constructor, toString oder valueOf. Claude Code reserviert diese Namen, daher lehnt es das Hinzufügen ab und registriert nichts. Reservierte Namen listet sie auf. In diesem Beispiel heißt der Marktplatz constructor:
Wenn eine Einstellungsdatei den Marktplatz unter extraKnownMarketplaces deklariert, schlägt der Versuch von Claude Code, ihn beim Start hinzuzufügen, auf dieselbe Weise fehl, und die Meldung erscheint auf der Registerkarte Errors in /plugin. Geben Sie dem Marktplatz einen anderen Namen, und fügen Sie ihn dann erneut hinzu:
  • Sie besitzen den Marktplatz: ändern Sie name in marketplace.json
  • Jemand anderes hostet ihn: bitten Sie den Besitzer, den Namen zu ändern
Vor v2.1.296 schlug das Hinzufügen eines solchen Marktplatzes mit einem internen Fehler statt dieser Meldung fehl.

​
SSH authentication failed oder HTTPS authentication failed

Sie haben einen Marktplatz aus einem Git-Repository hinzugefügt oder aktualisiert, und der Clone ist mit Failed to clone marketplace repository: gefolgt von einer dieser Zeilen fehlgeschlagen. Überprüfen Sie zunächst das Repository selbst: ein falsch geschriebenes owner/repo, ein Repository, das nicht vorhanden ist, oder ein privates Repository, das Sie nicht sehen können, endet auch in dieser Meldung. Öffnen Sie die Repository-URL in Ihrem Browser, oder führen Sie git ls-remote <url> in Ihrem Terminal aus, um zu bestätigen, dass es vorhanden ist und Sie Zugriff haben. Wenn das Repository richtig ist, liegt die Ursache bei den Anmeldedaten. Claude Code deaktiviert die Eingabeaufforderungen und askpass-Programme von Git, einschließlich eines in GIT_ASKPASS festgelegten, und führt SSH im Batch-Modus aus. Wenn Git eine Eingabe anfordern muss, enthält der Fehler des Clones fatal: Cannot prompt because user interactivity has been disabled, terminal prompts disabled oder fatal: unable to get password from user. Nur Anmeldedaten, die Git ohne Eingabeaufforderung oder askpass-Programm erhalten kann, führen zum Erfolg:
  • SSH: ssh -T git@<host> muss ohne Aufforderung für eine Passphrase erfolgreich sein, und der Host muss bereits in known_hosts sein
  • HTTPS: Ihr Credential Helper muss ein Token für den Host enthalten. Für GitHub führen Sie gh auth login und gh auth setup-git aus. Für einen anderen Host speichern Sie ein persönliches Zugriffstoken in Ihrem Git-Credential Helper. Zum Testen heben Sie GIT_ASKPASS in Ihrem Terminal auf und führen git -c core.askPass= ls-remote <url> aus.
Sobald die Prüfung für Ihr Protokoll ohne Eingabeaufforderung erfolgreich ist, führen Sie das Hinzufügen oder die Aktualisierung erneut aus. Ein erfolgreiches Hinzufügen druckt Successfully added marketplace: <name>. Eine erfolgreiche Aktualisierung druckt Successfully updated marketplace: <name> aus Ihrer Shell oder ✔ Updated 1 marketplace in einer Sitzung. Um Claude Code zu veranlassen, SSH für GitHub owner/repo-Quellen zu überspringen, setzen Sie CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1. Ohne sie klont Claude Code diese Quellen über SSH, wenn ein SSH-Schlüssel für github.com konfiguriert aussieht, und fällt auf HTTPS zurück, wenn der SSH-Clone fehlschlägt. Für das, was Hintergrund-Auto-Updates mit Ihren Anmeldedaten können und nicht können, siehe Was Hintergrund-Auto-Update mit Anmeldedaten macht.

​
SSH host key is not in your known_hosts file

Sie haben einen Marktplatz über SSH von einem Host hinzugefügt, zu dem Sie sich noch nie verbunden haben, und der Clone ist mit dieser Zeile und einem ssh -T git@<host>-Hinweis fehlgeschlagen. Für einen Host, dessen Schlüssel sich geändert hat, lautet die Meldung SSH host key has changed mit einem ssh-keygen -R <host>-Hinweis statt dessen. Claude Code klont mit StrictHostKeyChecking=yes, daher weigert es sich, einen Host zu akzeptieren, dessen Schlüssel Sie noch nicht akzeptiert haben, anstatt den Schlüssel automatisch zu akzeptieren. Verbinden Sie sich einmal von Ihrem Terminal aus, um den Fingerabdruck zu akzeptieren, und versuchen Sie es dann erneut:
Für ein öffentliches Repository fügen Sie den Marktplatz stattdessen durch seine https://-URL hinzu, um SSH ganz zu vermeiden.

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

Unter Windows haben Sie einen Marktplatz hinzugefügt und Claude Code hat Failed to clone marketplace repository: Command 'git' not found or is in an unsafe location (current directory) gemeldet. Claude Code sucht nach git auf Ihrem PATH und weigert sich, einen zu führen, der nur im aktuellen Verzeichnis gefunden wird. Um es zu beheben, installieren Sie Git und versuchen Sie es erneut:
1

Installieren Sie Git für Windows

Installieren Sie Git für Windows, damit git auf Ihrem PATH ist.
2

Öffnen Sie ein neues Terminal

Öffnen Sie ein neues Terminal, damit der aktualisierte PATH angewendet wird.
3

Bestätigen Sie, dass Git ausgeführt wird

Bestätigen Sie, dass git --version eine Version druckt.
4

Versuchen Sie das Hinzufügen erneut

Führen Sie den Befehl marketplace add erneut aus.

​
Git clone timed out after 120s

Sie haben einen Marktplatz hinzugefügt oder aktualisiert, und es ist mit Git clone timed out after 120s fehlgeschlagen, gefolgt von einem Hinweis zum Setzen von CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS. Das Klonen eines Marktplatzes und das erneute Klonen zum Aktualisieren erhält standardmäßig 120 Sekunden. Für ein großes Repository oder eine langsame Verbindung erhöhen Sie das Limit. Der Wert ist in Millisekunden:
Versuchen Sie es dann in derselben Shell erneut. Wenn das Repository ein Monorepo ist, begrenzen Sie den Checkout auf die Verzeichnisse, die Sie mit claude plugin marketplace add <source> --sparse <paths> benennen. Wenn das Repository große Git-Submodule enthält, aktualisieren Sie Claude Code. Ab v2.1.295 ruft Claude Code nur die Submodule, die Plugin-Dateien enthalten, ab. Frühere Versionen rufen jedes Submodul ab, was allein schon die 120 Sekunden aufbrauchen kann.

​
Marktplatz-Updates schlagen offline immer fehl

Sie arbeiten in einer Umgebung, in der der Git-Host des Marktplatzes nicht erreichbar ist, und jede Sitzung wiederholt eine fehlgeschlagene Aktualisierung im Hintergrund. Ihr vorhandener Checkout des Marktplatzes bleibt an Ort und Stelle und der Start wird nicht verzögert. Jede Sitzung überprüft Claude Code für einen Marktplatz mit Auto-Update an den Git-Host des Marktplatzes im Hintergrund auf neue Commits. Wenn diese Überprüfung den Host nicht erreichen kann, versucht sie, den Marktplatz erneut zu klonen, und offline schlägt dieser Clone auch fehl. Setzen Sie diese Variable, um den Re-Clone-Versuch zu überspringen und den vorhandenen Checkout zu verwenden, wenn die Überprüfung den Host nicht erreichen kann:
Mit der gesetzten Variable überspringt Claude Code den Re-Clone nur für einen Checkout, der bereits .claude-plugin/marketplace.json enthält. Ein Marktplatz, der nie geklont wurde oder dessen Clone auf halbem Weg stoppte, erhält immer noch den Clone-Versuch, daher fügen Sie ihn einmal online hinzu. Für eine vollständig offline-Bereitstellung füllen Sie stattdessen das Plugins-Verzeichnis zur Image-Build-Zeit mit CLAUDE_CODE_PLUGIN_SEED_DIR vor, nach Seed-Container und CI.

​
Marktplatz-Hinzufügen schlägt auf einem GitHub Enterprise Server-Host fehl

Sie haben einen Marktplatz von einer GitHub Enterprise Server (GHES)-URL hinzugefügt und erhielten einen Richtlinienfehler, oder Sie haben ihn von claude.ai hinzugefügt und erhielten einen GitHub-Zugriffsfehler. Beide Fälle befinden sich auf der GHES-Seite:

​
Ein Plugin installieren

Sie haben einen Marktplatz hinzugefügt und eine Installation ausgeführt, und die Installation hat mit einer Meldung statt mit der Installation von etwas gestoppt. Diese Einträge behandeln diese Meldungen. Sie behandeln auch die zugehörigen Meldungen, die später in der Registerkarte /plugin Errors oder als leere Registerkarte Discover erscheinen, wenn ein Plugin oder sein Marktplatz nicht gefunden, gelesen oder vertraut werden kann.

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

Sie haben /plugin install <name>@<marketplace> oder claude plugin install <name>@<marketplace> ausgeführt, und der Plugin-Name befindet sich nicht in der Kopie des Katalogs dieses Marktplatzes auf Ihrem Computer. claude plugin install in Ihrer Shell druckt dieselbe Meldung, wenn Sie den Marktplatz überhaupt nicht hinzugefügt haben. Wenn claude plugin marketplace update <marketplace> dann Marketplace '<marketplace>' not found antwortet, fügen Sie den Marktplatz zuerst hinzu.

​
not found in marketplace mit einem Aktualisierungshinweis

Der Hinweis lautet Your local copy may be out of date — try claude plugin marketplace update <marketplace> oder The marketplace couldn't be refreshed (...). Claude Code hat den Marktplatz vor der Suche nicht aktualisiert, z. B. wenn Sie offline sind, daher kann Ihre Kopie des Katalogs veraltet sein. Aktualisieren Sie mit dem Namen des Marktplatzes und installieren Sie dann erneut:
claude plugin marketplace update druckt Successfully updated marketplace: <name>, und /plugin marketplace update zeigt ✔ Updated 1 marketplace. Wenn die wiederholte Installation dieselbe Meldung druckt, überprüfen Sie den Namen wie not found in marketplace ohne Hinweis beschreibt. Wenn Claude Code einen Marktplatz vor einer Installation aktualisiert listet die anderen Fälle auf, in denen die Aktualisierung nicht ausgeführt wird.

​
not found in marketplace ohne Hinweis

Der Name ist das wahrscheinlichste Problem. Öffnen Sie /plugin, gehen Sie zu Discover, und kopieren Sie den Namen aus der Liste. Vor v2.1.232 aktualisierte Claude Code den benannten Marktplatz nur nach dem Lookup-Fehler und nur, wenn Auto-Update dafür aktiviert war.

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

Sie haben /plugin install <name> ohne @marketplace ausgeführt, und kein registrierter Marktplatz hat dieses Plugin. claude plugin install <name> meldet Plugin "<name>" not found in any configured marketplace. Ohne einen Marktplatznamen durchsucht claude plugin install die Kataloge, die es bereits hat, und aktualisiert sie nicht zuerst, und /plugin install aktualisiert nur Marktplätze, die Auto-Update aktiviert haben. Benennen Sie den Marktplatz, und Claude Code aktualisiert ihn vor der Suche nach dem Plugin:
Wenn die Installation funktioniert, sehen Sie ✓ Installed <plugin>. in einer Sitzung oder Successfully installed plugin: <plugin>@<marketplace> von claude plugin install. Wenn Sie nicht wissen, welcher Marktplatz das Plugin auflistet, führen Sie /plugin marketplace list für die Marktplätze aus, die Sie haben, und durchsuchen Sie Discover in /plugin nach dem Plugin-Namen.

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

Sie haben /plugin install für ein Plugin ausgeführt, das bereits im Benutzerbereich oder durch verwaltete Einstellungen installiert ist, und Claude Code hat mit Use '/plugin' to manage existing plugins. abgelehnt. Wenn Sie den Plugin-Namen ohne @<marketplace> eingegeben haben, lässt die Meldung globally weg. Das Plugin ist bereits in jedem Projekt verfügbar, daher gibt es nichts hinzuzufügen. Um seinen Bereich zu ändern, ihn zu aktivieren oder zu deaktivieren oder ihn zu konfigurieren, öffnen Sie /plugin und gehen Sie zu Installed. Ein Plugin, das nur im Projekt- oder lokalen Bereich installiert ist, löst diese Meldung nicht aus. Claude Code lässt Sie es auch im Benutzerbereich installieren, daher ist es in anderen Projekten verfügbar. claude plugin install in Ihrer Shell druckt eine andere Meldung. Für ein Plugin, das bereits im Zielbereich installiert ist, druckt es Plugin "<name>@<marketplace>" is already installed (scope: user) und beendet mit 0. Wenn sein Cache-Verzeichnis fehlt, lädt derselbe Befehl es erneut herunter.

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

Sie haben ein Plugin durch claude plugin install, /plugin oder einen Installationsvorschlag in einer Sitzung installiert, und Claude Code hat es mit dieser Zeile oder mit would share its saved data with abgelehnt. Die ID des abgelehnten Plugins und die ID eines installierten Plugins werden dem gleichen Ordner auf der Festplatte zugeordnet: Sie sind gleich, sobald . und @ als - geschrieben werden. Auf macOS und Windows werden IDs, die sich nur in Großbuchstaben unterscheiden, auch dem gleichen Ordner zugeordnet. Die Installation beider würde die Dateien eines Plugins in den Ordner des anderen Plugins legen, daher lehnt Claude Code ab und das installierte Plugin behält seine Dateien. Die Meldung benennt den Ausweg:
  • Das andere Plugin ist installiert: die Meldung sagt Only one of the two can be installed. und benennt den claude plugin uninstall-Befehl oder den Deinstallationsschritt in /plugin, der das andere Plugin entfernt. Führen Sie ihn aus, und installieren Sie dann erneut. Für das, was die Deinstallation entfernt, siehe Was eine Deinstallation löscht und behält.
  • Beide IDs kommen in einer Installation an, wie ein Plugin und eine Abhängigkeit, die es benötigt: keine Installationsreihenfolge hilft. Nur ein Verwalter des Marktplatzes, der die beiden Plugins auflistet, kann es beheben, indem er einen von ihnen umbenennt. Wenn die beiden aus verschiedenen Marktplätzen kommen, kann ein Verwalter von einem von ihnen es beheben.

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

Sie haben ein Plugin installiert, dessen Marktplatz-Eintrag einen Quellentyp verwendet, den diese Version von Claude Code nicht abrufen kann, und Claude Code hat mit dieser Meldung und Update Claude Code and try again. gestoppt. Aktualisieren Sie Claude Code, und versuchen Sie dann die Installation erneut. Quellentypen befinden sich in der Marktplatz-Referenz.

​
Plugin archive integrity check failed

Sie haben ein Plugin installiert, das als ZIP-Archiv verteilt wird, und Claude Code hat es mit dieser Zeile und The archive was not installed. abgelehnt. Der Marktplatz-Eintrag des Plugins verwendet eine archive-Quelle mit einem sha256-Pin, und der Digest der heruntergeladenen Datei stimmt nicht mit dem Pin überein. Die vollständige Meldung sieht so aus:
Die Lösung unterscheidet sich für den Herausgeber und den Installer:
  • Sie veröffentlichen das Plugin: berechnen Sie den Digest der genauen Datei, die die URL bereitstellt, neu und aktualisieren Sie den sha256 im Marktplatz-Eintrag. Verwenden Sie shasum -a 256 my-plugin.zip oder Get-FileHash -Algorithm SHA256 my-plugin.zip in PowerShell
  • Sie installieren das Plugin: führen Sie /plugin marketplace update <name> in einer Sitzung aus, um den Katalog zu aktualisieren, falls der Eintrag korrigiert wurde, und versuchen Sie dann die Installation erneut. Wenn die Digests nach der Aktualisierung immer noch nicht übereinstimmen, fragen Sie den Marktplatz-Besitzer, welche Datei er vor der Installation gepinnt hat

​
An npm plugin source must name a registry package

Ein Plugin, dessen Marktplatz-Eintrag eine npm-Quelle verwendet, konnte nicht installiert, aktualisiert oder geladen werden, und die Meldung enthält diesen Satz. Claude Code hat den package-Wert des Eintrags geprüft, bevor etwas abgerufen wurde, und ihn abgelehnt. Die Meldung nennt den Wert und den Grund:
Der Besitzer des Marktplatzes muss den Eintrag ändern:
  • Wenn das Sie sind: ändern Sie package in einen Wert, den die Referenz zur npm-Plugin-Quelle akzeptiert, oder stellen Sie den Eintrag auf eine github-, url- oder git-subdir-Quelle um
  • Wenn das nicht Sie sind: melden Sie die Meldung dem Marktplatz-Besitzer

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

Ein Marktplatz, den Sie früher hinzugefügt haben, hat das Laden gestoppt, und so auch seine Plugins. Diese Zeile erscheint in der Registerkarte /plugin Errors oder bei der nächsten Aktualisierung. Der Marktplatz ist unter einem Namen registriert, der für offizielle Anthropic-Marktplätze reserviert ist, aber seine registrierte Quelle ist kein anthropics-GitHub-Repository. Reservierte Namen werden jedes Mal neu überprüft, wenn ein Marktplatz geladen oder aktualisiert wird, daher laden der Marktplatz und die von ihm installierten Plugins nicht mehr. Die vollständige Meldung benennt den reservierten Namen und die Lösung:
Die Lösung unterscheidet sich für Benutzer und Herausgeber:
  • Sie verwenden den Marktplatz: führen Sie in Ihrer Shell claude plugin marketplace remove <name> aus, fügen Sie dann den Marktplatz erneut aus dem offiziellen github.com/anthropics-Repository hinzu
  • Sie veröffentlichen einen Drittanbieter-Marktplatz, der den Namen vor seiner Reservierung verwendet hat: benennen Sie ihn um und bitten Sie Benutzer, ihn von Ihrer Quelle erneut hinzuzufügen
Vor v2.1.205 überprüfte Claude Code den Namen nur, wenn Sie den Marktplatz hinzufügten, daher behielt ein Eintrag, der vor seiner Reservierung registriert wurde, das Laden bei.

​
Marketplace "<name>" is added but ignored

Der Marketplace hat einen Eintrag in ~/.claude/plugins/known_marketplaces.json, aber der Eintrag hat eine Prüfung nicht bestanden, die Claude Code bei jedem Lesen dieser Datei ausführt, sodass der Marketplace und die daraus installierten Plugins nicht mehr geladen werden. In Ihrer Shell meldet claude plugin list jedes betroffene Plugin mit einer Zeile, die den Grund und die Lösung nennt:
In einer Sitzung setzt die Registerkarte /plugin Errors den Marketplace-Namen in Anführungszeichen, beendet die Zeile nach dem Grund und zeigt die Lösung in der Zeile darunter. Der Satz nach is added but ignored nennt die Prüfung, die der Eintrag nicht bestanden hat:
  • Its location is on a network drive, has "." or ".." in its path, or couldn't be checked oder derselbe Satz über The folder or file it was added from: Das Verzeichnis des Marketplace oder der lokale Pfad, von dem er hinzugefügt wurde, befindet sich an einem Netzwerkspeicherort, enthält ein .- oder ..-Segment im Pfad oder konnte nicht geprüft werden
  • Its git URL can't be used: <reason> oder Its URL can't be read as an https:// or http:// address: Die gespeicherte Quell-URL des Eintrags ist eine, von der Claude Code das Klonen oder Abrufen verweigert
  • Its source doesn't match its extraKnownMarketplaces entry in user or managed settings: Der Eintrag stimmt nicht mit der gleichnamigen extraKnownMarketplaces-Deklaration überein
Wenn (see the debug log) anstelle eines Grundes auf is added but ignored folgt, lehnt Claude Code den Namen des Marketplace ab, etwa bei einer anderen Schreibweise eines reservierten Namens. Das Debug-Log nennt den Eintrag. Vorgehensweise:
  • Folgen Sie der Lösung in der Meldung. Führen Sie in Ihrer Shell claude plugin marketplace remove <name> aus, fügen Sie den Marketplace dann erneut aus einer unterstützten Quelle oder einem lokalen Pfad hinzu und installieren Sie seine Plugins neu, die der Befehl zum Entfernen deinstalliert. Der Befehl zum Entfernen funktioniert auch bei einem ignorierten Eintrag
  • Um einen Marketplace an einem Netzwerkspeicherort beizubehalten, deklarieren Sie ihn unter extraKnownMarketplaces in Ihren Benutzereinstellungen oder verwalteten Einstellungen; eine Deklaration in der .claude/settings.json oder .claude/settings.local.json eines Repositorys zählt nicht
  • Bei einer Quelle, die von ihrer Deklaration in den Einstellungen abweicht, fügen Sie den Marketplace aus der deklarierten Quelle erneut hinzu oder ändern Sie die Deklaration. claude plugin marketplace add lehnt dieselbe Abweichung ab; siehe den entsprechenden Cannot add marketplace-Eintrag
  • Bei einem abgelehnten Namen entfernen Sie den Marketplace, und zwar mit dem Befehl nach Remove it:, sofern die Zeile einen angibt; ein erneutes Hinzufügen unter demselben Namen wird wieder abgelehnt
Vor v2.1.286 meldete claude plugin list einen solchen Marketplace unabhängig vom Grund als Marketplace <name> not found, und die Registerkarte /plugin Errors meldete ihn als Marketplace "<name>" is registered but was refused (see the debug log). Der Grund erschien nur im Debug-Log. In v2.1.286 verwendeten die Sätze zu Grund und Lösung eine andere Formulierung, etwa Its recorded location is network-shaped or unclassifiable (never probed).

​
Plugin <name> has a corrupt manifest file oder has an invalid manifest file

Claude Code hat das Plugin abgerufen, konnte dann aber seine .claude-plugin/plugin.json nicht lesen. In der Shell kann der <name> in dieser Zeile ein temporärer Verzeichnisname sein; das Präfix Failed to install plugin "<name>@<marketplace>" trägt den echten Namen des Plugins. Die Formulierung sagt, welche Überprüfung fehlgeschlagen ist:
  • corrupt manifest file, gefolgt von JSON parse error:: die Datei ist kein gültiges JSON
  • invalid manifest file, gefolgt von Validation errors:: die Datei wird geparst, schlägt aber das Schema fehl, wie name: Invalid input für ein fehlendes erforderliches Feld
claude plugin install meldet entweder als Failed to install plugin "<name>@<marketplace>": und beendet mit Code 1. Der Autor des Plugins muss die Datei beheben, und das Plugin kann nicht installiert werden, bis dies geschieht:
  • Wenn das Sie sind: führen Sie claude plugin validate <plugin-directory> in Ihrer Shell aus, um denselben Fehler mit dem fehlerhaften Pfad zu sehen, und beheben Sie dann die Datei
  • Wenn das nicht Sie sind: melden Sie die Meldung dem Marktplatz-Besitzer

​
Plugin directory not found at path: <path>

Die Registerkarte Errors in /plugin zeigt dies für ein aktiviertes Plugin, das sein Marktplatz durch einen relativen Pfad auflistet, wie ./plugins/my-plugin, wenn kein Verzeichnis an diesem Pfad im Marktplatz vorhanden ist. Wenn Sie den Marktplatz verwalten, korrigieren Sie den source-Pfad des Eintrags oder stellen Sie den Ordner wieder her. Andernfalls melden Sie die Meldung dem Marktplatz-Besitzer. Marketplace directory not found at path: <path> bedeutet stattdessen, dass das eigene Verzeichnis des Marktplatzes fehlt. Für einen Marktplatz, den Sie von einem lokalen Pfad hinzugefügt haben, wurde dieses Verzeichnis verschoben oder gelöscht. Stellen Sie es wieder her, oder entfernen Sie den Marktplatz und fügen Sie ihn von seinem neuen Ort erneut hinzu.

​
No plugins available oder No marketplaces configured

Sie haben /plugin geöffnet und die Registerkarte Discover ist leer, oder claude plugin marketplace list hat No marketplaces configured gedruckt. Kein Marktplatz ist registriert, daher gibt es keinen Katalog zum Anzeigen. Fügen Sie in einer Sitzung den offiziellen Marktplatz anthropics/claude-plugins-official hinzu:
Claude Code druckt Successfully added marketplace: claude-plugins-official, und Discover listet seine Plugins auf. Die Seite Anthropic-Marktplätze listet die anderen Marktplätze auf, die Sie hinzufügen können.

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

Sie haben mit --marketplace <source> im Installationsbefehl eine neue Marktplatz-Quelle angegeben, in einer Sitzung oder aus Ihrer Shell. Der Katalog, den Claude Code von dieser Quelle abgerufen hat, hat denselben Namen wie ein Marktplatz, den Sie bereits von einer anderen Quelle hinzugefügt haben. Claude Code behält den vorhandenen Marktplatz bei, anstatt ihn zu ersetzen, und das Plugin wird nicht installiert. Die vollständige Meldung sieht so aus:
Wählen Sie, welche Quelle Sie möchten:
  • Der Marktplatz, den Sie bereits hinzugefügt haben: installieren Sie von ihm nach Name mit /plugin install <plugin>@<name>
  • Die neue Quelle: führen Sie /plugin marketplace remove <name> aus, und versuchen Sie dann die Installation erneut

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

Sie haben einen Marketplace hinzugefügt, und der name in seiner marketplace.json hat bereits einen extraKnownMarketplaces-Eintrag in Ihren Benutzereinstellungen oder verwalteten Einstellungen. Die von Ihnen angegebene Quelle unterscheidet sich von der, die dieser Eintrag nennt, daher lehnt Claude Code das Hinzufügen ab und registriert nichts. Zwei Quellen stimmen überein, wenn sie denselben Typ und in jedem Feld denselben Wert haben. Ein Eintrag, der einen ref setzt, den Sie nicht übergeben haben, gilt als abweichend. Ein github-Eintrag gilt ebenfalls als abweichend, wenn Sie das Repository als https://github.com/-URL angegeben haben, weil Claude Code diese URL als git-Quelle speichert. Gehen Sie auf eine dieser Arten vor:
  • Verwenden Sie die deklarierte Quelle: Claude Code registriert in den Einstellungen deklarierte Marketplaces selbstständig, führen Sie daher zuerst /plugin marketplace list in einer Sitzung aus. Wenn die Liste den Namen zeigt, ist der Marketplace bereits registriert, und es gibt nichts hinzuzufügen. Wenn die Liste ihn nicht zeigt, fügen Sie ihn mit der Quelle hinzu, und zwar so geschrieben, wie der Eintrag sie angibt. Für einen Eintrag, dessen source-Objekt { "source": "github", "repo": "acme-corp/claude-plugins", "ref": "v1.2.0" } ist, führen Sie Folgendes aus:
  • Verwenden Sie die neue Quelle: bearbeiten Sie oder entfernen Sie den extraKnownMarketplaces-Eintrag, und fügen Sie den Marktplatz erneut hinzu. Wenn verwaltete Einstellungen ihn deklarieren, fragen Sie Ihren Administrator
Vor v2.1.287 lautete die Meldung 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>)

Sie haben Plugins zum Installieren im Menü /plugin ausgewählt, keines von ihnen wurde installiert, und das Menü hat sich mit dieser Zusammenfassung dessen geschlossen, was fehlgeschlagen ist. Einige Gründe, wie die Ausgabe von Git nach einem fehlgeschlagenen Clone, zeigen nur ihre erste Zeile. Wenn ein solcher Grund gekürzt wurde, endet die Zusammenfassung mit Installing a plugin from its details (Enter) in /plugin shows its full error. Was zu tun ist, hängt davon ab, ob die Zusammenfassung den Grund gekürzt hat:
  • Beheben Sie, was der Grund in Klammern benennt
  • Wenn der Grund gekürzt wurde, führen Sie /plugin aus, wählen Sie das Plugin auf der Registerkarte Discover aus, und drücken Sie Enter, um es von seinen Details aus zu installieren. Wenn die Installation dort fehlschlägt, zeigt die Detailansicht den ganzen Fehler

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

Wenn Sie ein Plugin installieren, lädt Claude Code eine frische Kopie seiner Dateien herunter und verschiebt sie in den Ordner dieser Version im Plugin-Cache. Diese Meldung bedeutet, dass die Verschiebung fehlgeschlagen ist, normalerweise weil ein anderes Programm den Ordner verwendete, während die Installation ausgeführt wurde. Der Dateisystem-Code erscheint in Klammern:
Die Meldung sagt, was mit der Kopie geschah, die vor der Installation installiert wurde, was Ihnen sagt, ob das Plugin immer noch funktioniert:
  • The previously installed copy was moved back: die Version, die Sie hatten, ist immer noch installiert
  • had to be removed first, was not moved back oder could not be moved back: diese Plugin-Version ist nicht installiert, bis eine Installation erfolgreich ist
  • Kein solcher Satz: es gab keine frühere Kopie, daher ist die Version noch nicht installiert
Unter Windows, wenn ein anderes Programm die installierte Kopie selbst hält, sagt die Meldung stattdessen, dass diese Kopie could not be replaced ist und dass It was not replaced and the new copy was discarded, daher ist die Version, die Sie hatten, immer noch installiert. Eine Left on disk-Liste benennt beiseite gelegte Ordner im Cache. Eine spätere Installation dieser Version oder eine Plugin-Cache-Bereinigung entfernt sie, daher müssen Sie sie nicht löschen. Um die Installation zu beheben:
  • Schließen Sie andere Claude Code-Sitzungen, Editoren und Terminals, die den Plugin-Ordner unter ~/.claude/plugins/cache verwenden, und führen Sie die Installation erneut aus
  • Wenn die Meldung sagt, die Berechtigungen des Plugin-Cache-Ordners zu überprüfen, stellen Sie Ihre Schreibberechtigung auf dem Ordner wieder her, den sie benennt, und geben Sie Speicherplatz frei, und führen Sie die Installation erneut aus

​
Abhängigkeitsfehler

Ein Plugin, das Abhängigkeiten deklariert, kann nicht installiert werden oder installiert und bleibt deaktiviert, wenn eine Abhängigkeit nicht erfüllt werden kann. Die Meldung erreicht Sie zur Installationszeit oder zur Ladezeit:
  • Während der Installation: die Ablehnung kommt als Fehlermeldung der Installation zurück
  • Wenn das Plugin geladen wird: das Problem erscheint in claude plugin list und der Registerkarte /plugin Errors, und Claude Code hält das betroffene Plugin deaktiviert, bis Sie es beheben
Die Tabelle listet jede Meldung und ihre Lösung auf. Um Abhängigkeiten als Autor zu deklarieren, siehe Plugin-Abhängigkeiten. Um diese programmgesteuert zu sehen, führen Sie claude plugin list --json in Ihrer Shell aus. Plugins mit Problemen tragen ein errors-Feld mit den Meldungen und ein errorDetails-Feld mit einem type für jede: die ersten drei Zeilen sind dependency-unsatisfied und die vierte ist dependency-version-unsatisfied.

​
Plugin installiert, aber funktioniert nicht

Die Installation war erfolgreich, aber die Skills, Hooks oder Server des Plugins tun nichts. Beginnen Sie mit Plugin wird nicht angezeigt oder seine Skills werden nicht angezeigt, was Ihnen sagt, wo Claude Code das meldet, was es geladen hat, und passen Sie dann die Meldung an.

​
Plugin wird nicht angezeigt oder seine Skills werden nicht angezeigt

Sie haben ein Plugin installiert und / eingegeben, um seine Skills zu erwarten, oder Claude gebeten, es zu verwenden, und nichts ist passiert. Überprüfen Sie den Status des Plugins, bevor Sie etwas ändern:
1

Bestätigen Sie, dass das Plugin installiert und aktiviert ist

Führen Sie /plugin aus und öffnen Sie Installed. Bestätigen Sie, dass das Plugin aufgelistet und aktiviert ist. claude plugin list in Ihrer Shell druckt dieselbe Liste mit der Version, dem Bereich und dem Status: ✔ enabled jedes Plugins.
2

Lesen Sie die Registerkarte Errors

Öffnen Sie die Registerkarte Errors im gleichen Panel. Jeder Eintrag paart eine Meldung mit einer Anleitung. Die meisten Meldungen im Rest dieses Abschnitts stammen aus dieser Registerkarte.
3

Laden Sie erneut, wenn Sie während dieser Sitzung installiert haben

Wenn das Plugin installiert und fehlerfrei ist, aber Sie es während dieser Sitzung installiert haben, führen Sie /reload-plugins aus. Es druckt Reloaded: mit Zählungen von Plugins, Skills, Agents, Hooks und Servern. Wenn etwas fehlgeschlagen ist, fügt es N errors during load. Run /plugin for details. hinzu.
Wenn das Plugin ohne Fehler geladen wird und seine Skills immer noch nicht angezeigt werden, unterscheidet sich der nächste Schritt für Ihr eigenes Plugin und für das eines anderen:
  • Ein Plugin, das Sie erstellen: siehe Plugin lädt, aber seine Skills fehlen
  • Ein Plugin, das jemand anderes veröffentlicht hat: öffnen Sie Installed in /plugin und öffnen Sie den Detailbereich des Plugins, der auflistet, was das Plugin enthält. Ein Plugin, das dort keine Skills auflistet, hat keine anzubieten, wenn Sie / eingeben

​
Run /reload-plugins to apply.

Die Installationszusammenfassung in /plugin endete mit Run /reload-plugins to apply. statt Plugin is now active. Gleichzeitig kann über dem Eingabefeld der Hinweis Plugins changed. Run /reload-plugins to activate. erscheinen. Claude Code hat das Plugin während der Installation nicht aktiviert, entweder weil die Aktivierung den Prompt-Cache ungültig machen würde oder weil der Aktivierungsversuch fehlgeschlagen ist. Sie müssen den Befehl nicht eingeben. Das Panel schließt sich und Claude Code führt /reload-plugins für Sie aus, oder reiht es in die Warteschlange, bis die Antwort, die gerade gestreamt wird, endet. Lesen Sie, was dieses Reload druckt:
  • Reloaded: mit Zählungen von Plugins, Skills, Agents, Hooks und Servern: das Plugin ist jetzt aktiv. Wenn etwas nicht geladen werden konnte, fügt die Zeile N errors during load. Run /plugin for details. hinzu.
  • 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.: das Reload würde einen Plugin-MCP-Server hinzufügen oder entfernen, oder das LSP-Tool, und Ihren Prompt-Cache ungültig machen. Für den LSP-Fall beginnt die Zeile mit This reload adds the LSP tool oder This reload removes the LSP tool. Führen Sie es mit --force aus, um das Plugin zu aktivieren, oder starten Sie eine neue Sitzung
Vor v2.1.268 blieb eine Installation, die während der Installation nicht aktiviert wurde, ausstehend, bis Sie /reload-plugins selbst ausgeführt haben. Vor v2.1.246 umfasste die Skills-Zählung in dieser Zusammenfassung nur die commands/-Einträge eines Plugins, daher konnte ein Reload die SKILL.md-Skills eines Plugins laden und immer noch 0 skills melden.

​
The packages it lists are not installed oder were not installed, because ...

/plugin und claude plugin list zeigen einen dieser Hinweise bei einem Plugin, dessen Installation der Abhängigkeiten kein node_modules-Verzeichnis hinterlassen hat. Das Plugin wird geladen, aber die Teile, die die fehlenden Pakete benötigen, funktionieren möglicherweise nicht.
  • are not installed: Die Installation kann für dieses Plugin ausgeführt werden, wurde aber nicht abgeschlossen, zum Beispiel weil sie fehlgeschlagen ist oder eine Zeitüberschreitung aufgetreten ist. Um die Installation erneut zu versuchen, führen Sie den im Hinweis angegebenen Befehl claude plugin update in Ihrer Shell aus, oder aktualisieren Sie das Plugin über /plugin
    Wenn der Wiederholungsversuch fehlschlägt, nennt die Ausgabe die Ursache. Solange CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC gesetzt ist, überspringen claude plugin update und /plugin den Wiederholungsversuch und melden, dass das Plugin auf der neuesten Version ist.
  • were not installed, because ...: Die Installation kann für dieses Plugin nicht ausgeführt werden, und der Hinweis nennt den Grund, etwa eine Lockfile von Yarn, pnpm oder bun.lockb, oder eine Lockfile, deren Paketmanager auf diesem Computer nicht installiert ist. Eine Aktualisierung des Plugins installiert die Pakete nicht, solange dieser Grund besteht. Wenn der Grund die Lockfile ist, muss der Autor des Plugins sie ersetzen. Wenn ein Paketmanager fehlt, installieren Sie ihn und aktualisieren Sie dann das Plugin

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

Die Registerkarte Errors zeigt diese Zeile mit der Anleitung Run /plugin to refresh the plugin cache. Claude Code hat einen Installationsdatensatz für das Plugin, aber das Verzeichnis, auf das der Datensatz zeigt, fehlt, zum Beispiel nachdem Sie den Cache gelöscht haben. Installieren Sie das Plugin erneut von Ihrer Shell. claude plugin install <name>@<marketplace> lädt ein Plugin erneut herunter, dessen Installationsverzeichnis fehlt, obwohl sein Datensatz vorhanden ist:
Führen Sie dann /reload-plugins in Ihrer Sitzung aus. Der Eintrag in der Registerkarte Errors verschwindet und das Plugin ist wieder unter Installed.

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

Die Meldung erscheint in diesen Formen:
  • claude plugin list: druckt sie als Note:
  • claude plugin install, uninstall, und update: lehnen mit Plugin "<name>" was not installed:, Plugin "<name>" was not uninstalled:, oder Plugin "<name>" was not updated: ab, gefolgt vom gleichen Text
  • --json auf einem dieser drei Befehle: die Ergebniszeile trägt die gleiche message und failureCode: "install_records_unreadable"
  • Mehrere solche Datensätze: die Meldung lautet holds records under
  • Die ganze Datei erklärt ein Format, das diese Version nicht kennt: die Meldung lautet installed_plugins.json is in a format (version <N>) that this version of Claude Code does not know statt
Der benannte Datensatz in installed_plugins.json ist gültiges JSON unter einer gültigen Plugin-ID, aber seine Felder werden für diese Version nicht geparst. Höchstwahrscheinlich hat eine andere Version von Claude Code ihn geschrieben, vielleicht eine neuere. Während der Datensatz vorhanden ist, schreibt diese Version die Datei nicht um, daher geht der Datensatz nicht verloren. Nehmen Sie die Optionen der Meldung in Reihenfolge:
  1. Aktualisieren Sie Claude Code mit claude update.
  2. Wenn Sie nicht aktualisieren können, deinstallieren Sie das benannte Plugin mit der Version von Claude Code, die den Datensatz geschrieben hat.
  3. Wenn keines hilft, löschen Sie den Datensatz manuell aus installed_plugins.json, und starten Sie Claude Code neu oder führen Sie /reload-plugins aus.

​
installed_plugins.json could not be read and was rebuilt

claude plugin list druckt diese Notiz mit dem Pfad einer behaltenen Datei namens installed_plugins.unreadable.<date>.<hash>.kept, solange diese Datei neben installed_plugins.json sitzt. Eine installed_plugins.json, die kein gültiges JSON ist, oder keine Liste von Plugins ist, kann nicht sagen, was Sie installiert haben. Öffnen Sie die .kept-Datei, um zu sehen, was die alte Datei aufgezeichnet hat, und installieren Sie die Plugins erneut, die Sie vermissen. Claude Code liest die Datei nie zurück, und die Datei wird nach dem cleanupPeriodDays-Plan gelöscht.

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

claude plugin list druckt diese Notiz mit dem Pfad einer Kopie namens installed_plugins.set-aside.<date>.<hash>.json, solange diese Kopie neben installed_plugins.json sitzt. Die Notiz endet mit Nothing needs doing about these copies. Ein Datensatz in installed_plugins.json saß unter einem Schlüssel, der keine gültige Plugin-ID ist, daher kann keine Version von Claude Code ihn verwenden. Der Rest der Datei wird normal geladen. Claude Code kopiert die unbrauchbaren Datensätze in die .set-aside-Datei und löscht sie aus der Liste. Claude Code liest die Kopien nie zurück, und die Kopien werden nach dem cleanupPeriodDays-Plan gelöscht.

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

Der Befehl hat funktioniert. Die Einstellungsdatei, die die Warnung nennt, enthält einen Fehler, daher ignoriert Claude Code die gesamte Datei, einschließlich allem, was der Befehl dort geschrieben hat, bis Sie den Fehler beheben. Beheben Sie den Fehler, den die Warnung nennt. Für einen Wert, den Claude Code nicht akzeptiert, beschreibt Eine fehlerhafte Einstellungsdatei reparieren, wie das geht. Führen Sie den Befehl dann erneut aus, wenn seine Änderung nicht mehr in der Datei steht. Die Warnung folgt auf die Erfolgszeile von claude plugin install, enable, disable oder claude plugin marketplace add in Ihrer Shell:
Der Text in Klammern nennt den Fehler:
  • its "<key>" is not valid: Die in Anführungszeichen genannte Einstellung enthält einen Wert, den Claude Code nicht akzeptiert. Schlagen Sie die Einstellung in der Einstellungsreferenz nach, um die zulässigen Werte zu finden. Wenn mehr als ein Wert fehlschlägt, nennt der Text die erste Einstellung und zählt die übrigen, wie in its "permissions" and 1 other value are not valid.
  • it is not a JSON object: Die oberste Ebene der Datei ist kein JSON-Objekt, etwa bei einer Datei, deren oberste Ebene ein Array ist.

​
Disabled in ~/.claude/settings.json but still loads

Sie haben ein Plugin in ~/.claude/settings.json auf false gesetzt, und seine Zeile in claude plugin list oder /plugin zeigt diese Meldung gefolgt von der Quelle, die es aktiviert, wie — project settings enable it, which overrides your user setting. Ein true in dieser höheren Prioritätsquelle überschreibt Ihre Benutzereinstellung. Um sich von einem projektaktivierten Plugin auf Ihrem Computer abzumelden, setzen Sie die ID in .claude/settings.local.json auf false, die eine höhere Priorität als die Projektdatei hat. Für die anderen Quellen, die die Meldung benennen kann, siehe Deaktiviert in Benutzereinstellungen, aber lädt immer noch. Wenn claude plugin list das Plugin stattdessen als required by your org markiert, ist keine Einstellungsdatei beteiligt: Ihre Organisation markiert dieses synchronisierte Plugin auf claude.ai als erforderlich, und es lädt, auch wenn Sie es früher deaktiviert haben. Siehe Plugins, die von claude.ai synchronisiert werden.

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

Die Registerkarte Errors zeigt diese Zeile für ein Plugin, das die .claude/settings.json Ihres Projekts aktiviert, mit der Anleitung Run claude plugin install <name>@<marketplace> --scope project to install it for this project. Die Einstellungen eines Repositories können ein Plugin für jeden aktivieren, der es öffnet, aber sie installieren es nicht. Wenn das Plugin aus einer externen Quelle wie einem GitHub-Repository oder einem npm-Paket stammt, lädt Claude Code es nicht herunter, bis Sie es selbst installieren. Führen Sie den Befehl aus der Anleitung in Ihrer Shell aus, und laden Sie dann erneut:
Nachdem Sie /reload-plugins in Ihrer Sitzung ausgeführt haben, ist der Eintrag in der Registerkarte Errors weg und das Plugin ist unter Installed aufgelistet. Wenn Ihre Organisation Plugins für Sie vorinstalliert, tut sie dies stattdessen durch verwaltete Einstellungen. Siehe Plugins vorinstallieren und erforderlich machen.

​
Ein Plugin bleibt unter Windows nach plugin uninstall installiert

Unter Windows führen Sie claude plugin uninstall im Projekt- oder lokalen Geltungsbereich aus, und der Befehl meldet Erfolg, aber claude plugin list oder /plugin listet das Plugin weiterhin auf. installed_plugins.json enthielt zwei Installationsdatensätze des Plugins für den Projektordner, die den Pfad des Ordners jeweils unterschiedlich schreiben, und eine Deinstallation entfernt einen davon. Führen Sie zur Überprüfung claude plugin list --json in Ihrer Shell aus. Die verbleibende Zeile des Plugins hat einen projectPath, der den Ordner anders schreibt als dort, wo Sie die Deinstallation ausgeführt haben, etwa c:\work\app für C:\work\app. Führen Sie denselben Deinstallationsbefehl erneut aus, mit demselben --scope und aus demselben Ordner. Der zweite Durchlauf findet keinen Datensatz unter seiner eigenen Schreibweise des Pfads, daher entfernt er den Datensatz unter der anderen Schreibweise. Für eine Installation im Projekt-Geltungsbereich:
Führen Sie dann erneut claude plugin list --json aus, um zu bestätigen, dass die Zeile verschwunden ist. Vor v2.1.295 schlägt der zweite Durchlauf mit Plugin "<name>" is not installed in project scope fehl. Führen Sie claude update aus und führen Sie die Deinstallation dann erneut aus.

​
Ein aus einem Git-Repository installiertes Plugin zeigt die Version unknown

Version: unknown in claude plugin list kann bedeuten, dass Claude Code den Commit nicht lesen konnte, den es als Version eines Git-basierten Plugins verwendet. Das Plugin kann ein eigenes Repository haben oder sich in einem auf Git gehosteten Marketplace befinden. Führen Sie diese Befehle in Ihrer Shell aus und ersetzen Sie formatter@my-marketplace durch die name@marketplace-Zeile des Plugins aus claude plugin list:
1

Claude Code aktualisieren

Aktualisieren Sie Claude Code auf v2.1.302 oder höher, das in einem Format klont, aus dem es den Commit lesen kann:
2

Den Marketplace aktualisieren

Aktualisieren Sie die Kopie des Marketplace in Claude Code, die den Commit für Plugins innerhalb des Marketplace-Repositorys enthält:
3

Das Plugin aktualisieren

Aktualisieren Sie das Plugin, um seine aufgezeichnete Version neu zu schreiben:
4

Die Version überprüfen

Prüfen Sie, ob die Zeile Version: einen Wert wie eine 12-stellige Commit-ID enthält:
claude plugin update ändert pro Durchlauf den Block eines Geltungsbereichs. Für einen Block, der weiterhin unknown zeigt, führen Sie den Befehl erneut mit dem Scope:-Wert dieses Blocks aus:
Wenn der Block nach dem erneuten Durchlauf weiterhin unknown zeigt, siehe Weitere Hilfe erhalten.

​
Failed to load hooks from <path> und Hooks, die nicht ausgelöst werden

Die Hooks eines Plugins werden nicht ausgeführt, oder einer blockiert eine Aktion. Entweder zeigt die Registerkarte Errors einen Ladefehler dafür, die Hooks laden und Sie sehen <Event> hook error-Hinweise oder einen blockierenden Fehler im Transkript, oder ein Hook lädt ohne Fehler und wird nie ausgelöst.

​
Hooks können nicht geladen werden

Die Registerkarte Errors zeigt eine dieser Meldungen:
  • Failed to load hooks from <path>: <reason>: hooks/hooks.json ist kein gültiges JSON oder schlägt das Hooks-Schema fehl. Der Grund benennt den Parse- oder Validierungsfehler. Beheben Sie die Datei. Um ein JSON-Syntaxproblem in hooks/hooks.json zu fangen, bevor Sie das Plugin veröffentlichen, führen Sie claude plugin validate <plugin-directory> in Ihrer Shell aus
  • hooks path not found: <path>: das Feld hooks des Manifests benennt eine Datei, die nicht an diesem Pfad relativ zum Plugin-Root vorhanden ist. Beheben Sie den Pfad oder fügen Sie die Datei hinzu
  • hooks path escapes plugin directory: <path>: siehe Path escapes plugin directory

​
hook error-Hinweise im Transkript

Ein Hinweis der Form ... hook error: Failed with non-blocking status code: <stderr> bedeutet, dass der Hook ausgeführt wurde und sein Befehl fehlgeschlagen ist. Beispielsweise bedeutet Stop hook error: Failed with non-blocking status code: /bin/sh: node: command not found, dass die Shell, die Claude Code erzeugt hat, node nicht finden konnte. Installieren Sie es, oder stellen Sie sicher, dass es sich auf dem PATH des Terminals befindet, von dem Sie claude starten. Wenn stderr den Pfad des Plugins bei einem Leerzeichen abgeschnitten zeigt, verwendet der Shell-Form-Befehl des Hooks ${CLAUDE_PLUGIN_ROOT} außerhalb von Anführungszeichen und der Installationspfad enthält ein Leerzeichen. Wickeln Sie die Variable in doppelte Anführungszeichen ein oder verwenden Sie exec-Form. Um die unquotierte Variable zu finden, führen Sie claude plugin validate im Plugin-Verzeichnis aus und suchen Sie nach seiner Quoting-Warnung. Wenn der Hinweis Failed to run: Plugin directory does not exist: <path> lautet, siehe Plugin directory does not exist. Für jeden anderen Fehler führen Sie den Befehl des Hooks selbst aus dem Plugin-Verzeichnis aus, um die vollständige Ausgabe zu sehen, oder erfassen Sie den vollständigen stderr mit Debug-Protokollierung.

​
Ein Plugin-Hook blockiert einen Tool-Aufruf oder eine Eingabeaufforderung

Ein Hook, der mit Code 2 beendet wird, blockiert die Aktion, für die er ausgeführt wurde. Wenn ein Plugin-Hook auf diese Weise blockiert und sein stderr die blockierende Meldung ist, endet der Fehler mit This hook comes from the <plugin> plugin., damit Sie wissen, welches Plugin Sie deaktivieren oder beheben müssen. Vor v2.1.281 benannte der Fehler das Plugin nicht. Wenn diese Meldung den Pfad des Plugins bei einem Leerzeichen abgeschnitten zeigt, wenden Sie die unquotierte ${CLAUDE_PLUGIN_ROOT}-Behebung an.

​
Hook lädt, aber wird nie ausgelöst

Wenn ein Hook ohne Fehler geladen wird, aber nie ausgelöst wird, führen Sie zuerst /plugin in Ihrer Sitzung aus und öffnen Sie die Details des Plugins. Ein Hinweis dort, der mit Its hooks.json hooks do not run beginnt, bedeutet, dass stattdessen ein anderes aktiviertes Plugin mit demselben Namen seine Hooks registriert hat. Hooks, wenn zwei aktivierte Plugins denselben Namen haben erklärt, welche Kopie das ist und wie Sie wechseln. Andernfalls überprüfen Sie die Definition des Hooks und beobachten Sie dann seine Ausführung:
1

Überprüfen Sie den Ereignisnamen

Ereignisnamen sind Groß-/Kleinschreibung-empfindlich, daher bestätigen Sie, dass Ihrer genau übereinstimmt, zum Beispiel PostToolUse.
2

Überprüfen Sie den Matcher

Bestätigen Sie, dass der matcher des Hooks dem Tool-Namen entspricht.
3

Lösen Sie das Ereignis absichtlich aus

Für einen PostToolUse-Hook bitten Sie Claude, eine Datei zu bearbeiten.
4

Lesen Sie das Debug-Protokoll

Öffnen Sie das Debug-Protokoll, das aufzeichnet, welche Hooks übereinstimmten. Ein Hook, der ausgeführt wurde, erscheint dort mit seinem Exit-Code.

​
Plugin directory does not exist: <path>

Führen Sie zuerst /reload-plugins im Eingabefeld von Claude Code aus, auch wenn die Meldung zur Neuinstallation auffordert. Ein Hook eines Plugins schlägt mit Failed to run: Plugin directory does not exist: <path> (<plugin> — run /plugin to reinstall) fehl und wird nicht ausgeführt, wenn das Verzeichnis, aus dem Ihre Sitzung die Hooks des Plugins geladen hat, nicht mehr auf dem Datenträger vorhanden ist. Plugin directory not found at path: <path> ist eine andere Meldung, die einen Marketplace-Eintrag betrifft. Das Reload lädt die Hooks des Plugins aus seinem aktuellen Verzeichnis. Der Fehler wird pro Sitzung nur einmal für jedes Hook-Ereignis und jeden Befehl angezeigt, daher bestätigt das Ausbleiben weiterer Meldungen des Hooks nicht, dass das Problem behoben ist. Lesen Sie stattdessen die Ausgabe des Reloads:
  • Reloaded: ohne Fehlerzeile: Die Hooks des Plugins verweisen nicht mehr auf das fehlende Verzeichnis
  • N errors during load. Run /plugin for details.: Öffnen Sie die Registerkarte Errors in /plugin und folgen Sie dem Eintrag auf dieser Seite für die dort angezeigte Meldung
  • Eine Zeile, die mit Run /reload-plugins --force to apply. endet: Es wurde nichts neu geladen, und die Hooks schlagen weiterhin fehl. Führen Sie /reload-plugins --force im Eingabefeld von Claude Code aus

​
Invalid MCP server config for "<server>" und MCP-Server, die nicht starten

Ein Plugin bündelt einen MCP-Server, und die Registerkarte Errors zeigt Invalid MCP server config for "<server>": <error>, oder der Server ist aufgelistet, aber /mcp zeigt ihn nie verbunden.

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

Die Konfiguration des Servers besteht die Schema-Überprüfung, aber Claude Code kann sie für diese Sitzung nicht auflösen. Der Text nach dem Doppelpunkt benennt die Ursache und entscheidet die Lösung:
  • Missing environment variables: <names>: setzen Sie diese Variablen in der Shell, von der Sie Claude Code starten, und starten Sie dann eine neue Sitzung
  • URL is unset or invalid: eine ${user_config.*}-Option, die die URL verwendet, ist nicht gesetzt. Führen Sie /plugin configure <plugin> aus, um sie zu setzen
  • has an invalid MCP url oder headersHelper for MCP server '<server>' references ${user_config.*}: die Konfiguration des Plugins selbst ist schuld. Beheben Sie die url oder headersHelper in der MCP-Konfiguration Ihres Plugins, oder melden Sie es dem Autor des Plugins, wenn das Plugin nicht Ihres ist. Der headersHelper-Fall hat seinen eigenen Eintrag unter Plugin-Befehl referenziert user_config

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

Das Plugin enthält den Server als MCPB-Bundle, das user_config deklariert, und eine erforderliche Einstellung hat noch keinen gespeicherten Wert oder ein gespeicherter Wert schlägt die Validierung des Bundles fehl, daher überspringt Claude Code das Starten des Servers. Der Rest des Plugins funktioniert. Wählen Sie das Plugin auf der Registerkarte Installed von /plugin aus und wählen Sie Configure, um die Werte bereitzustellen. Nachdem Sie speichern, zeigt /plugin Configuration saved. an und schließt sich, und Claude Code lädt Plugins wie unter Installierte Plugins verwalten beschrieben erneut. Der Server startet, sobald dieses Reload angewendet wird. Vor v2.1.285 übersprang Claude Code den Server, ohne diese Zeile anzuzeigen.

​
Server ist konfiguriert, verbindet sich aber nie

Führen Sie /mcp aus, um den Status des Servers zu sehen. Wenn der Server gesund ist, listet /mcp ihn als verbunden auf. Um den Fehler zu lesen, den der Server beim Starten gedruckt hat, führen Sie claude --debug aus und öffnen Sie das Protokoll unter ~/.claude/debug/<session-id>.txt. Das Flag --debug druckt nicht zum Terminal.
Wenn eine Verbindung zum stdio-Server eines Plugins weniger als 15 Minuten vor dem Ausführen von claude --debug fehlgeschlagen ist, startet Claude Code den Server nicht. Wählen Sie in der neuen Sitzung im Menü des Servers in /mcp Reconnect aus, um ihn zu starten, und öffnen Sie dann das Log.
Ein Server-Eintrag in .mcp.json, der das Schema nicht besteht, erscheint nicht in der Registerkarte Errors. Claude Code löscht diesen Server und zeichnet Invalid MCP server config for <server> in <path> nur in diesem Debug-Protokoll auf. Um den Eintrag zu finden, ohne das Plugin zu laden, führen Sie claude plugin validate in Ihrer Shell im Plugin-Verzeichnis aus, das es als Fehler meldet. Vor v2.1.281 überprüfte claude plugin validate nicht .mcp.json.

​
Server funktioniert mit --plugin-dir, schlägt aber nach der Installation fehl

Sie sind der Autor des Plugins, und der Server startet, wenn Sie das Plugin aus seinem Quellverzeichnis mit --plugin-dir laden, schlägt aber fehl, sobald das Plugin installiert ist. Claude Code kopiert ein installiertes Plugin in seinen Cache, daher bricht ein Pfad, der nur aus dem Quellverzeichnis funktioniert. Schreiben Sie Pfade im Plugin mit ${CLAUDE_PLUGIN_ROOT}. Für Pfade, die außerhalb des Plugin-Verzeichnisses reichen, siehe Dateien, die das Plugin außerhalb seines Verzeichnisses referenziert, werden nicht gefunden.

​
Sprachserver startet nicht, verwendet zu viel Speicher oder meldet falsche Diagnosen

Sie haben ein Code-Intelligence-Plugin installiert und Claude sieht keine Diagnosen, oder der Sprachserver verwendet zu viel Speicher oder meldet Fehler, die nicht real sind.

​
Sprachserver startet nicht

Das Plugin verbindet sich mit einem Sprachserver-Binär, das Sie separat installieren, und Claude Code erzeugt es nach Befehlsname von Ihrem PATH. Die Registerkarte /plugin Errors zeigt den Fehler mit seinem Grund, wie Executable not found in $PATH: "<binary>", und claude --debug protokolliert ihn als LSP server <name> failed to start: <reason>. Installieren Sie das Binär und bestätigen Sie, dass es sich auf dem PATH des Terminals befindet, von dem Sie claude starten, zum Beispiel mit which typescript-language-server. Starten Sie dann eine neue Sitzung.

​
Sprachserver verwendet zu viel Speicher

Sprachserver wie rust-analyzer und pyright indizieren das ganze Projekt. Deaktivieren Sie das Plugin mit /plugin disable <plugin> in einer Sitzung und verlassen Sie sich stattdessen auf Claudes integrierte Such-Tools.

​
Falsch-positive Diagnosen in einem Monorepo

Ein Sprachserver, der nicht für den Arbeitsbereich konfiguriert ist, kann ungelöste Importe für interne Pakete melden. Es gibt nichts auf der Claude Code-Seite zu beheben, und die Diagnosen hindern Claude nicht daran, Code zu bearbeiten.

​
Ein Plugin erstellen

Sie entwickeln ein Plugin und laden es mit --plugin-dir oder installieren es von einem lokalen Marktplatz. Diese Einträge behandeln die Fehler, auf die Sie bei der Entwicklung eines Plugins stoßen. Für die Überprüfungen, die nach jeder Änderung ausgeführt werden, siehe Testen und Debuggen. Zwei Fehler, die auch die Benutzer eines Plugins erreichen, haben ihre Einträge unter Plugin installiert, aber funktioniert nicht:

​
commands path not found: <path>

Die Registerkarte Errors zeigt commands path not found: <absolute path> mit der Anleitung Check that the path in your manifest or marketplace config is correct. Dieselbe Meldung erscheint für skills, agents und hooks. Claude Code hat einen Pfad aus Ihrer plugin.json oder Ihrem Marktplatz-Eintrag gegen den Plugin-Root aufgelöst und dort nichts gefunden. Der Pfad in der Meldung ist der absolute Pfad, den es überprüft hat, daher vergleichen Sie ihn mit dem, was auf der Festplatte vorhanden ist. Beheben Sie den Pfad oder erstellen Sie das Verzeichnis, und führen Sie dann /reload-plugins aus.
Vor v2.1.299 konnte diese Meldung beim Start in einer Zeile erscheinen, die mit einem Tag wie synced[0] beschriftet ist. Diese Zeile steht für ein Plugin, das von claude.ai synchronisiert wurde. Sie erschien, wenn eine andere Claude Code-Sitzung auf Ihrem Rechner das Plugin kurz zuvor aktualisiert und seine Dateien verschoben hatte. Um das Plugin zu laden, starten Sie Claude Code neu. Damit die Meldung aus diesem Grund nicht mehr erscheint, aktualisieren Sie auf v2.1.299 oder höher.
Pfade im Manifest sind relativ zum Plugin-Root und beginnen mit ./. Ein Pfad, der außerhalb des Plugin-Root aufgelöst wird, wird stattdessen als <component> path escapes plugin directory gemeldet und wird gelöscht.

​
--plugin-dir in einem Marktplatz-Root lädt die Plugins unter plugins/ nicht

Sie haben claude --plugin-dir <path> gestartet und sehen keinen Fehler, aber die Skills, Agenten und Hooks des Plugins sind nicht da. --plugin-dir nimmt das Plugin-Root-Verzeichnis, das, das .claude-plugin/plugin.json und die Komponentenverzeichnisse wie skills/ enthält. Wenn Sie es stattdessen auf einen Marktplatz-Root zeigen, liest Claude Code nicht marketplace.json, daher lädt ein Plugin unter plugins/ nicht, und Sie sehen keinen Fehler. Vor v2.1.281 lud Claude Code einen Marktplatz-Root als ein leeres Plugin, das nach diesem Verzeichnis benannt ist. Zeigen Sie das Flag auf das Plugin-Verzeichnis selbst:
Öffnen Sie dann Installed in /plugin, wo der Detailbereich des Plugins seine Komponenten auflistet.

​
Dateien, die das Plugin außerhalb seines Verzeichnisses referenziert, werden nicht gefunden

Ein Plugin funktioniert aus seinem Quellverzeichnis mit --plugin-dir, schlägt aber nach der Installation fehl, mit Fehlern über einen Pfad wie ../shared-utils. Claude Code kopiert ein installiertes Plugin in seinen Cache und lädt es von dort, daher zeigt ein Pfad, der außerhalb des eigenen Verzeichnisses des Plugins reicht, auf nichts im Cache. Verschieben Sie die gemeinsamen Dateien in das Plugin-Verzeichnis, oder referenzieren Sie sie durch einen Symlink darin. Für den Ort des Caches und wie Pfade aufgelöst werden, siehe Plugins auf der Festplatte finden.

​
${CLAUDE_PLUGIN_ROOT} zeigt Schrägstriche unter Windows

Unter Windows erhält ein Plugin-Hook, der über Git Bash ausgeführt wird, ${CLAUDE_PLUGIN_ROOT} als C:/Users/you/... statt C:\Users\you\..., und ein Skript, das Backslashes erwartet, bricht. Wenn Git Bash installiert ist, wird ein Shell-Form-Hook standardmäßig über Git Bash ausgeführt. Für einen Hook, der über Git Bash ausgeführt wird, übergibt Claude Code den Pfad mit Schrägstrichen, damit Bash Backslashes nicht als Escape-Zeichen interpretiert. Bash-Builtins, MSYS-Tools und native Windows-Binärdateien akzeptieren alle diese Form. Wenn Ihr Skript Backslashes benötigt, wechseln Sie den Hook zu einer der Formen, die native Pfade behalten, beschrieben unter Exec-Form und Shell-Form:
  • Ein Exec-Form-Hook, der den Prozess direkt mit einem args-Array erzeugt
  • Ein Hook mit "shell": "powershell"

​
Plugin lädt, aber seine Skills fehlen

Ihr Plugin ist unter Installed ohne Fehler aufgelistet, aber seine Skills werden nicht angeboten, wenn Sie / eingeben. Skills laden aus skills/ im Plugin-Root und Befehle aus commands/ im Plugin-Root. Nur plugin.json gehört in .claude-plugin/, und ein skills/-Verzeichnis in .claude-plugin/ wird nicht gescannt. Verschieben Sie die Verzeichnisse zum Plugin-Root und führen Sie /reload-plugins aus. Danach listet der Detailbereich des Plugins in /plugin die Skills auf, und das Eingeben von / bietet sie an. Jeder Skill ist ein Verzeichnis, das SKILL.md enthält. Ein skills-Eintrag im Manifest, der auf eine SKILL.md-Datei statt auf sein Verzeichnis zeigt, wird als path is a file; skills entries must be directories containing SKILL.md gemeldet.

​
Skill lädt, aber Claude ruft den Skill nie auf

Der Skill Ihres Plugins wird ausgeführt, wenn Sie seinen /<plugin>:<skill>-Befehl eingeben, aber Claude ruft ihn nie als Reaktion auf eine einfache Anfrage auf. Überprüfen Sie diese Ursachen in Reihenfolge: Um zu messen, wie oft der Skill über realistische Prompts ausgelöst wird, statt jeden einzeln zu überprüfen, schreiben Sie einen Eval-Fall mit einem tool_used: Skill-Grader und führen Sie ihn mit claude plugin eval nach jeder Beschreibungsänderung aus.

​
<directory> is not a plugin or skill folder von claude plugin eval init

Sie haben claude plugin eval init aus einem Verzeichnis ausgeführt, das kein Plugin-Root ist, wie Ihr Home-Verzeichnis oder der Root eines Repositorys, das das Plugin in einem Unterverzeichnis hält. init schreibt die Suite unter dem Arbeitsverzeichnis, daher stoppt es, statt ein evals/-Verzeichnis zu erstellen, das das Plugin nie sehen würde. Wechseln Sie zum Plugin-Root, dem Verzeichnis, das .claude-plugin/plugin.json oder die SKILL.md des Skills hält, und führen Sie den Befehl erneut aus. Um die Suite absichtlich woanders zu gerüsten, übergeben Sie --eval-dir. Siehe Testen Sie Plugins mit Evals.

​
Der userConfig-Dialog erscheint nie

Ihr Plugin deklariert userConfig-Optionen, aber kein Konfigurationsdialog erscheint, wenn Sie es installieren. Ob die Installation nach den Werten fragt, hängt davon ab, wo Sie sie ausführen:
  • /plugin install in einer Sitzung, oder die Registerkarte Discover in /plugin: der Dialog ist Teil dieser interaktiven Installation
  • Der Verwaltungsdialog für Plugins der VS Code-Erweiterung: fordert nach der Installation ungesetzte Optionen als Formular an. Vor v2.1.285 zeigte die Installation dort kein Optionsformular, daher setzen Sie die Werte aus einer Terminal-Sitzung mit /plugin configure <plugin>@<marketplace>
  • claude plugin install in Ihrer Shell: fragt nie nach userConfig-Werten. Es speichert alle --config KEY=VALUE-Werte, die Sie übergeben, und wenn Optionen ungesetzt bleiben, druckt es N userConfig options not yet set — run /plugin configure <plugin>@<marketplace> in Claude Code, or pass --config KEY=VALUE. Wenn eine der ungesetzten Optionen erforderlich ist, folgt (M required) auf not yet set.
Wenn Sie von der Shell aus installiert haben, übergeben Sie die Werte mit --config, ein Flag pro Option:
Wenn jede Option gesetzt ist, trägt die Installationsausgabe keine not yet set-Zeile. Um den Dialog danach stattdessen zu öffnen, führen Sie /plugin configure my-plugin@my-marketplace in einer Sitzung aus. Von der Shell aus zeigt claude plugin configure, welche Optionen noch ungesetzt sind, und speichert Werte, die auf stdin weitergeleitet werden. Es erfordert Claude Code v2.1.285 oder später. Wenn Sie einen --config-Schlüssel übergeben, den das Manifest nicht deklariert, wird das Plugin immer noch installiert, und der Befehl druckt ⚠ Installed, but --config not applied: --config key "<key>" isn't declared in this plugin's userConfig. gefolgt von den Schlüsseln, die das Plugin deklariert. Für ein Plugin, das eine MCPB-Bundle-Datei mit eigener user_config versendet, lautet die Meldung isn't declared in this plugin's userConfig or by its bundled MCP servers. stattdessen, und die bekannten Schlüssel enthalten die Schlüssel dieses Servers, geschrieben als <server>.<key>. Ein Bundle, das das Manifest per URL referenziert, wird zur Installationszeit nicht gelesen, daher sind seine Schlüssel nicht aufgelistet und die Meldung sagt, es in /plugin zu konfigurieren. Das Setzen von <server>.<key>-Schlüsseln erfordert Claude Code v2.1.285 oder später.

​
claude plugin validate meldet Fehler

Sie haben claude plugin validate <path> ausgeführt, oder /plugin validate <path> in einer Sitzung, und es hat Found N errors und Validation failed gedruckt, dann mit Code 1 beendet. Der Validator liest das Manifest am Pfad, den Sie ihm geben: .claude-plugin/plugin.json für ein Plugin-Verzeichnis, .claude-plugin/marketplace.json für ein Marketplace-Verzeichnis oder beide für ein Verzeichnis, das beide enthält. Für einen Marketplace stellt er Problemen im eigenen Manifest eines Eintrags den Eintragsindex voran, wie plugins[1] plugin.json → json: .... Vor v2.1.289 validierte Claude Code ein Verzeichnis, das beide enthält, nur als Marketplace. Die Tabelle behandelt die Meldungen, die die Validierung stoppen, und zwei Warnungen, No frontmatter block found und Unknown field '<key>', die sie nur stoppen, wenn Sie --strict übergeben. Andere Warnungen, wie eine fehlende Beschreibung, sind nicht aufgelistet. Führen Sie den Befehl erneut aus, nachdem Sie jeden Fehler behoben haben, bis er keine Fehler druckt. plugin.json-Felder befinden sich in der Manifest-Referenz, und Marktplatz-Level-Meldungen befinden sich unter Marktplatz-Validierungsfehler.

​
Plugin <name> has conflicting manifests

Das Plugin kann nicht geladen werden mit Plugin <name> has conflicting manifests: both plugin.json and marketplace entry specify components. Das Plugin hat seine eigene plugin.json, und sein Marktplatz-Eintrag setzt strict: false, während er auch eines von commands, agents, skills, hooks, outputStyles oder themes deklariert. Entfernen Sie diese Felder aus dem Eintrag, oder setzen Sie strict: true im Eintrag, damit Claude Code sie an plugin.json anhängt. Siehe Strict-Modus.

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

Wenn das Plugin geladen wird, protokolliert das claude --debug-Log unter ~/.claude/debug/<session-id>.txt die Meldung Warning: No commands found in plugin <name> custom directory: <path>. Expected .md files or SKILL.md in subdirectories. Nichts erscheint in der Sitzung oder der Registerkarte Errors. Der commands-Pfad im Manifest existiert, hält aber keine .md-Dateien und keine SKILL.md in einem Unterverzeichnis. Fügen Sie die Befehlsdateien hinzu, oder entfernen Sie den Pfad aus dem Manifest.

​
Einen Marktplatz hosten

Sie veröffentlichen einen Marktplatz und ein Benutzer meldet einen Fehler, oder Ihre eigene Validierung schlägt fehl. Diese Einträge sind für den Marktplatz-Besitzer.

​
Plugins mit relativen Pfaden schlagen in URL-basierten Marktplätzen fehl

Benutzer haben Ihren Marktplatz mit einer https://example.com/marketplace.json-URL hinzugefügt. Installationen von Plugins, deren source ein relativer Pfad ist, wie ./plugins/my-plugin, schlagen mit its marketplace entry path does not stay inside the marketplace directory fehl. Bereits installierte Plugins können nicht geladen werden mit Plugin source path refused. Beide Meldungen haben einen Fehler-Referenzeintrag. Wenn ein Benutzer einen URL-basierten Marktplatz hinzufügt, lädt Claude Code nur die marketplace.json-Datei selbst herunter. Es lädt Plugin-Dateien nicht durch relativen Pfad von diesem Server herunter, daher zeigt ein relativer Pfad in einem Eintrag auf ein Verzeichnis, das nie heruntergeladen wurde. Geben Sie jedem Eintrag eine Quelle, die Claude Code selbst abrufen kann, wie ein GitHub-Repository:
Alternativ hosten Sie den Marktplatz in einem Git-Repository und sagen Sie Benutzern, dass sie ihn mit der Repository-URL hinzufügen. Für eine Git-Quelle klont Claude Code das ganze Repository, daher werden relative Pfade aufgelöst. Quellentypen befinden sich in der Marktplatz-Referenz.

​
Dateien eines Root-Plugins aus einem Git-Submodul fehlen nach der Installation

Ihr Plugin befindet sich im Root des Marketplace und führt eine Datei aus einem Git-Submodul des Repositorys aus oder liest sie. Nach der Installation ist das Verzeichnis des Submoduls leer. Vor v2.1.295 hat Claude Code jedes Submodul abgerufen, sodass das Verzeichnis befüllt war. Wenn Claude Code Ihren Marketplace klont, ruft es nur die Submodule ab, die Plugin-Dateien enthalten. Bei einem Plugin im Root entscheidet es anhand der Pfade in der Konfiguration des Plugins und des Textes der Plugin-Dateien. Einen Pfad, den ein Skript erst während der Ausführung zusammensetzt, kann es nicht erkennen. Schreiben Sie einen Pfad in das Submodul vollständig an einer Stelle aus, an der Claude Code ihn lesen kann, etwa ${CLAUDE_PLUGIN_ROOT}/vendor/tool/run.sh in einem Hook-Befehl. Claude Code ruft dann für dieses Plugin jedes Submodul im Repository ab.

​
Marktplatz-Validierungsfehler

Sie haben claude plugin validate . aus Ihrem Marktplatz-Verzeichnis ausgeführt und es hat Fehler oder Warnungen in der Marktplatz-Datei selbst gemeldet. claude plugin validate validiert auch jeden Eintrag, dessen source ein lokaler Pfad ist, und warnt, wenn die version des Eintrags mit der des eigenen Manifests des Plugins nicht übereinstimmt. Die Tabelle listet die Marktplatz-Level-Meldungen auf. Eintrag-Level-Meldungen sind die Plugin-Meldungen unter claude plugin validate meldet Fehler, mit dem Präfix plugins[N] plugin.json →. Vor v2.1.247 wurde ein Marktplatz-Name, der Kontroll- oder bidirektionale Formatierungszeichen enthielt, nur als Marketplace name impersonates an official Anthropic/Claude marketplace gemeldet.

​
Blocked by your organization

Ihre Organisation stellt verwaltete Einstellungen bereit, die Plugins einschränken, und ein Befehl wurde mit einer Richtlinienmeldung abgelehnt. Diese Einträge nennen die Einstellung hinter jeder Ablehnung, damit Sie wissen, worum Sie Ihren Administrator bitten müssen. Informationen für Administratoren finden Sie unter Plugins für Ihre Organisation verwalten.

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

Sie haben /plugin marketplace add, update oder eine Installation ausgeführt, und Claude Code hat mit dieser Zeile abgelehnt. Ihr Administrator hat blockedMarketplaces oder strictKnownMarketplaces in den verwalteten Einstellungen gesetzt, und diese Quelle ist nicht zulässig. Bitten Sie Ihren Administrator, die Quelle zuzulassen, oder fügen Sie eine der zulässigen Quellen hinzu, die in der Meldung aufgeführt sind. Gleichen Sie den Rest der Meldung ab, um zu sehen, welche Art von Richtlinie die Quelle blockiert hat:
  • Allowed sources: <list>: Die Sperre stammt von der Allowlist strictKnownMarketplaces und nicht von der Denylist blockedMarketplaces
  • No external marketplaces are allowed.: Die Allowlist strictKnownMarketplaces ist leer
  • Ein Tip:, dass die Kurzschreibweise github.com annimmt: Die Allowlist erlaubt einen Git-Host anhand des Hostnamens, und die von Ihnen übergebene Kurzschreibweise owner/repo verweist auf github.com. Wenn sich das Repository auf Ihrem internen Host befindet, fügen Sie es erneut mit der vollständigen URL hinzu, z. B. git@your-git-host.com:owner/repo.git
Ein Marketplace, den Sie hinzugefügt haben, bevor die Richtlinie restriktiver wurde, wird ebenfalls nicht mehr aktualisiert, da die Richtlinie bei jeder Aktualisierung angewendet wird.

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

Der Tab Errors zeigt diese Zeile oder Marketplace "<name>" is blocked by enterprise policy für einen Marketplace an, den Sie bereits registriert haben. Dieselben verwalteten Einstellungen, die eine Marketplace-Quelle blockieren, gelten auch beim Laden. strictKnownMarketplaces enthält diesen Marketplace nicht, oder blockedMarketplaces nennt ihn, sodass Claude Code das Laden des Marketplace und seiner Plugins beendet. Bei der Allowlist-Variante zeigt die Hinweiszeile die zulässigen Quellen oder Contact your administrator to configure allowed marketplace sources an. Bei der Denylist-Variante lautet sie This marketplace source is explicitly blocked by your administrator.

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

Eine Installation wurde mit dieser Zeile abgelehnt, eine Aktivierung mit derselben Zeile, die auf cannot be enabled endet, oder eine Installation oder Aktualisierung mit einer Zeile, die den Grund nennt: Plugin "<name>" is from marketplace "<marketplace>", which is blocked by your organization's policy oder Plugin "<name>" depends on "<dep>", which is blocked by your organization's policy. Verwaltete Einstellungen blockieren dieses Plugin, seinen Marketplace oder eine Abhängigkeit, die es benötigt. Fragen Sie Ihren Administrator, welcher Eintrag zutrifft. Eine blockierte Abhängigkeit bedeutet, dass das Plugin erst installiert werden kann, wenn der Marketplace der Abhängigkeit zugelassen ist.

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

Sie haben claude mit --plugin-dir, --plugin-url, --agents oder --mcp-config gestartet. Claude Code wurde mit dieser Meldung und Plugins, custom agents, and MCP servers can only be loaded from sources your administrator has approved. beendet. Ihr Administrator hat disableSideloadFlags in den verwalteten Einstellungen gesetzt, wodurch die Flags ausgeschaltet werden, die Plugins, Agenten und Server aus beliebigen Pfaden laden. Laden Sie das Plugin stattdessen aus einem genehmigten Marketplace, oder bitten Sie Ihren Administrator, die Einstellung zu entfernen. Eine verwandte Meldung im Tab Errors von /plugin lautet --plugin-dir copy of "<name>" ignored: plugin is locked by managed settings. Verwaltete Einstellungen aktivieren oder deaktivieren dieses Plugin anhand des Namens, und Claude Code ignoriert Ihre --plugin-dir-Kopie davon, damit das Flag die Richtlinie nicht überschreiben kann.

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

Sie haben claude plugin init oder claude plugin enable ausgeführt, und der Befehl wurde mit dieser Zeile abgebrochen. Die Meldung nennt strictKnownMarketplaces or blockedMarketplaces und bittet Ihren Administrator, {"source":"skills-dir"} zu strictKnownMarketplaces hinzuzufügen oder aus blockedMarketplaces zu entfernen. Die Quelle skills-dir steht für Plugins, die Claude Code aus Ihrem Verzeichnis ~/.claude/skills/ lädt. Bitten Sie Ihren Administrator, die in der Meldung genannte Änderung vorzunehmen.

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

Sie haben ein Plugin mit einer command-Quelle installiert oder aktualisiert, und der Vorgang wurde mit dieser Zeile und The plugin was not installed or updated and its command was not run. abgebrochen. Ihr Administrator hat disableCommandPluginSources gesetzt, daher weigert sich Claude Code, den vom Marketplace deklarierten Befehl auszuführen, der das Plugin erzeugt. Das Setzen von allowManagedHooksOnly allein hat dieselbe Wirkung, wenn disableCommandPluginSources nicht gesetzt ist. Fragen Sie Ihren Administrator, ob das Plugin aus einem Quelltyp veröffentlicht werden kann, den die Richtlinie zulässt.

​
Marketplace '<name>' is seed-managed

Sie haben claude plugin marketplace update <name> ausgeführt, und der Befehl ist mit Marketplace '<name>' is seed-managed (<dir>) und einem Hinweis fehlgeschlagen, Ihren Admin zu fragen. Ein Betreiber hat diesen Marketplace über CLAUDE_CODE_PLUGIN_SEED_DIR vorab befüllt, und Claude Code behandelt einen per Seed verwalteten Marketplace als schreibgeschützt. Ein gesammeltes marketplace update überspringt ihn und aktualisiert die anderen. Um den Inhalt des Marketplace zu ändern, bitten Sie die Person, die das Seed-Image pflegt, es zu aktualisieren. Das Vorgehen finden Sie unter Seed-Container und CI.

​
Nächste Schritte