claude plugin (claude plugins) în Claude Code CLI

Extensibilitate și MCP Claude Code 2.1+

Instalează și gestionează plugin-uri Claude Code din shell sau din scripturi, fără panoul /plugin: install, uninstall, enable, disable, update, list și marketplace.

Sintaxă & invocare
claude plugin <subcomandă> [opțiuni]   (alias: claude plugins)

Ce face claude plugin (claude plugins)

claude plugin rulează din shell, în afara unei sesiuni, și face aceleași operații ca panoul /plugin. claude plugins este alias. Toate subcomenzile ies cu 0 la succes și 1 la eșec. Un argument <plugin> este numele plugin-ului sau nume@marketplace; forma calificată e necesară când două marketplace-uri oferă același nume.

Subcomenzi: install (alias i), uninstall (aliasuri remove, rm), enable, disable, update, list, details, configure, prune (alias autoremove), init (alias new), validate, tag, test și eval. Opțiunea --scope primește user, project sau local și numește fișierul de setări în care se scrie; update acceptă și managed.

claude plugin marketplace gestionează sursele: add (repository GitHub owner/repo, URL git, fișier marketplace.json găzduit sau cale locală), list, update și remove. Rulează claude plugin --help ca să vezi subcomenzile din versiunea ta, și claude plugin <subcomandă> --help pentru toate opțiunile.

Sintaxă și opțiuni

Opțiune / Parametru Descriere
install <plugin> Instalează un plugin dintr-un marketplace adăugat.
-s, --scope <scope> Unde se scrie: user (implicit), project sau local.
uninstall <plugin> Elimină plugin-ul dintr-un scope.
enable / disable <plugin> Activează sau dezactivează un plugin fără să-l dezinstaleze.
update <plugin> Actualizează la ultima versiune oferită de marketplace; se încarcă în sesiunea următoare sau după /reload-plugins.
list [--json] Plugin-urile instalate, cu versiune, scope și stare.
details <nume> Componentele plugin-ului și costul estimat în tokeni.
init <nume> [--with ...] Creează un plugin nou în ~/.claude/skills/<nume>/.
validate <cale> Validează un manifest de plugin sau de marketplace, cu cod de ieșire util în CI.
marketplace add <sursă> Adaugă un marketplace și îl declară într-un fișier de setări.
marketplace update [nume] Reîmprospătează unul sau toate marketplace-urile din sursă.
marketplace remove <nume> Elimină declarația unui marketplace (alias rm).

Exemple practice de terminal

Exemplul 1: Instalarea unui plugin pentru tot proiectul

Cu --scope project, plugin-ul ajunge la toți cei care clonează proiectul.

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

Ieșire în terminal

Successfully installed plugin: formatter@my-marketplace (scope: project)

Exemplul 2: Adăugarea unui marketplace partajat cu proiectul

claude plugin marketplace add your-org/your-marketplace --scope project

Ieșire în terminal

Successfully added marketplace: your-marketplace (declared in project settings)

Exemplul 3: Un plugin nou, cu fișiere de start pentru skill-uri și hook-uri

claude plugin init my-helper --with skills hooks

Greșeli frecvente și bune practici

  • Elimini un marketplace ca să-l reîmprospătezi. Din ultimul scope care îl declară, remove îi șterge cache-ul și dezinstalează toate plugin-urile instalate din el; folosește claude plugin marketplace update.
  • Rulezi install fără terminal (TTY) pentru un plugin care afișează o comandă de instalare. Instalarea este refuzată cu cod 1; rulează din terminalul tău cu -y. Când Claude rulează comanda prin unealta Bash, -y este ignorat.

Comenzi înrudite