Cum să creezi pluginuri Claude Code: ghid pas cu pas

Claude Code acoperă din start majoritatea sarcinilor de dezvoltare, dar fiecare echipă are fluxuri specifice pe care setările implicite nu le acoperă. Poate vrei o comandă personalizată care să genereze scheletul componentelor în structura preferată de compania ta, sau rularea automată a linting-ului înainte de fiecare commit, sau acces rapid la documentația unui framework pe care îl folosești constant.

Pluginurile Claude Code îți permit să adaugi singur aceste funcții. Poți instala pluginuri create de comunitate sau îți poți crea propriile pluginuri.

Dacă ești nou în instrumentul de codare agentic al Anthropic, îți recomand să începi cu Ghidul pentru Claude Code sau cursul Introduction to Claude Models. Acest tutorial presupune că ai instalat Claude Code și l-ai folosit pentru sarcini de bază.

La final, vei ști cum să:

• Găsești și instalezi pluginuri din directorul Anthropic și din surse din comunitate
• Înțelegi cele trei tipuri de componente pe care le pot conține pluginurile
• Alegi tipul potrivit pentru cazuri de utilizare diferite
• Construiești și partajezi propriile pluginuri

Pentru o prezentare generală a capabilităților celui mai nou model Anthropic, consultă ghidul nostru despre Claude Sonnet 5.

TL;DR

• Pluginurile Claude Code împachetează skills, servere MCP și hooks în pachete partajabile pe care le instalezi cu claude plugin add

• Skills se încarcă la cerere (~100 de tokeni fiecare); serverele MCP preîncarcă definițiile de tool-uri (reduce prin Tool Search); hooks rulează ca scripturi shell cu cost zero de tokeni

• Folosește skills pentru cunoștințe și fluxuri, servere MCP pentru acces la API-uri externe și hooks pentru reguli care trebuie să ruleze de fiecare dată

• Construiește un plugin cu trei fișiere: un manifest .claude-plugin/plugin.json, un director skills/ și un fișier de instrucțiuni SKILL.md

Ce sunt pluginurile Claude Code?

Un plugin este un pachet care adună laolaltă una sau mai multe extensii Claude Code pentru partajare și instalare ușoară. În loc să copiezi manual fișiere de configurare între mașini sau colegi, poți împacheta totul într-un plugin și îl poți distribui ca pe o singură unitate.

Pluginurile pot conține trei tipuri de componente:

• Skills: Comenzi personalizate pe care le invoci cu /skill-name sau prompturi conștiente de context pe care Claude le folosește automat când sunt relevante

• Servere MCP: Conexiuni la servicii externe și API-uri care îi oferă lui Claude acces la date pe care altfel nu le-ar avea

• Hooks: Scripturi shell care rulează automat la anumite evenimente, de exemplu înainte ca un fișier să fie editat sau după un commit

Un plugin poate conține doar unul dintre acestea sau poate combina mai multe care lucrează împreună. Un plugin de „deployment” ar putea include un skill /deploy pentru deploy manual, un server MCP care verifică starea mediului de staging și un hook care rulează testele înainte de executarea oricărei comenzi de deploy.

Fișierul manifest plugin.json definește ce conține un plugin. Specifică ce skills, servere MCP și hooks să fie instalate, împreună cu metadate precum numele pluginului, versiunea și autorul. Când instalezi un plugin, Claude Code citește acest manifest și configurează fiecare componentă în locația corectă.

Acest format de împachetare înseamnă că nu trebuie să înțelegi structura internă a fișierelor extensiilor Claude Code. Instalezi pluginul și totul ajunge unde trebuie.

Găsirea și instalarea pluginurilor Claude Code

Majoritatea pluginurilor se găsesc în două locuri. Directorul oficial al Anthropic de la claude.com/plugins include pluginuri create de Anthropic, contribuții din comunitate verificate și extensii populare terțe. Fiecare listare arată ce componente conține pluginul, informații de compatibilitate și instrucțiuni de instalare.

A doua sursă este GitHub:

După ce ai găsit un plugin dorit, comanda de instalare depinde de unde se află:

# From the official directory
claude plugin add @anthropic/deploy-helper
 
# From a GitHub repository
claude plugin add github:username/repo-name
 
# From a local directory (useful during development)
claude plugin add ./my-plugin

După ce ai instalat câteva pluginuri, vei vrea să le urmărești. Comanda plugin se ocupă de listare, actualizare și eliminare:

# List all installed plugins
claude plugin list
 
# Update a specific plugin to the latest version
claude plugin update @anthropic/deploy-helper
 
# Update all plugins
claude plugin update --all
 
# Remove a plugin
claude plugin remove @anthropic/deploy-helper

O decizie pe care o vei lua în timpul instalării este aria de aplicare (scope). Pluginurile pot exista în două locuri: la nivel de utilizator se instalează în ~/.claude/plugins/ și funcționează în toate proiectele tale, iar la nivel de proiect se instalează în .claude/plugins/ în cadrul unui anumit repository.

Implicit este nivelul utilizator. Pentru a instala un plugin doar pentru proiectul curent, adaugă flagul --project:

claude plugin add @anthropic/deploy-helper --project

Pluginurile la nivel de proiect au sens când extensia este legată de un anumit cod de bază. 

Un plugin care cunoaște procesul de deployment al companiei tale își are locul în acel proiect. Un plugin care formatează codul după preferințele tale personale aparține nivelului utilizator. Când un plugin există la ambele niveluri, versiunea de proiect are prioritate, permițând echipelor să impună configurații specifice proiectului în timp ce dezvoltatorii își păstrează active pluginurile personale în alte părți.

Alegerea tipului potrivit de plugin Claude Code

Cele trei tipuri de componente au scopuri diferite și consumă tokeni din fereastra de context în moduri diferite. Înțelegerea acestor compromisuri te ajută să alegi corect pentru fiecare sarcină.

Skills vs servere MCP: compromisul de tokeni

Serverele MCP preîncarcă fiecare definiție de tool în fereastra de context la startul sesiunii. Fiecare tool are nevoie de nume, descriere și schema completă a parametrilor, ceea ce în mod tipic înseamnă 100–300 de tokeni per tool. O configurație cu cinci servere consumă aproximativ 55.000 de tokeni înainte să tastezi măcar un caracter:

• GitHub: 35 de tool-uri
•  Slack: 11 tool-uri
• Sentry: 5 tool-uri
• Grafana: 5 tool-uri
• Splunk: 2 tool-uri

O analiză a constatat că setările cu 7+ servere consumă peste 67.000 de tokeni, adică o treime din fereastra ta de context de 200K dispărută înainte de a începe conversația.

Skills abordează altfel, prin dezvăluire progresivă. La startul sesiunii, Claude vede doar numele fiecărui skill și o descriere scurtă din frontmatter-ul YAML, cam 100 de tokeni per skill. 

Instrucțiunile complete se încarcă doar când Claude stabilește că skillul este relevant pentru sarcina curentă. Fișierele de referință se încarcă doar când sunt cerute explicit. Iar scripturile nu intră niciodată în fereastra de context; Claude le rulează extern, iar înapoi vine doar outputul.

Anthropic a adresat acest dezechilibru la final de 2025 cu Tool Search, o funcție care aduce încărcarea la cerere pentru serverele MCP. 

În loc să preîncarce fiecare definiție de tool, Claude Code detectează când descrierile tool-urilor ar consuma mai mult de 10% din contextul disponibil și comută pe încărcare la cerere. 

Testele interne au arătat că utilizarea contextului a scăzut de la ~134.000 de tokeni la ~5.000 de tokeni pentru biblioteci mari de tool-uri. Acuratețea selecției de tool-uri a crescut, de asemenea, Opus 4 sărind de la 49% la 74% și Opus 4.5 de la 79,5% la 88,1% în evaluări MCP.

Iată cum să alegi între ele.

Skills se potrivesc cel mai bine când vrei ca Claude să aibă acces la cunoștințe sau fluxuri pe care le poate aplica cu judecată. Un skill care descrie checklist-ul echipei tale pentru code review se încarcă atunci când Claude face review, dar Claude decide în continuare cum aplică fiecare punct în funcție de context. 

Skills au sens și pentru operațiuni care au nevoie de scripturi pentru calcule grele, deoarece codul scriptului rămâne în afara ferestrei de context.

Serverele MCP se potrivesc cel mai bine când Claude are nevoie de date în timp real din servicii externe precum mesaje Slack, PR-uri GitHub sau interogări de bază de date. Sunt și alegerea potrivită când mai mulți agenți AI au nevoie de aceleași tool-uri sau când ai nevoie de caracteristici enterprise precum loguri de audit și permisiuni explicite.

Multe setări le combină pe ambele: skills oferă „cum” și „când” prin instrucțiuni în limbaj natural, în timp ce serverele MCP gestionează apelurile efective către API.

Skills Claude Code populare care merită instalate

• Superpowers (tutorialul nostru): peste 20 de fluxuri testate în producție pentru TDD, debug și planificare structurată
• frontend-design: Îi indică lui Claude să evite estetica generică și să ia decizii de design curajoase
• mcp-builder: Ghid pentru crearea de servere MCP pentru a integra API-uri externe
•  webapp-testing: Testează aplicații web locale folosind Playwright pentru verificarea UI
•  skill-creator: Instrument interactiv care te ghidează în construirea de skill-uri noi

Servere MCP populare care merită conectate

• Context7: Căutare de documentație în timp real, specifică versiunii
• GitHub: Căutare în repository, gestionare PR, urmărire issue-uri
• Playwright: Automatizare de browser folosind arbori de accesibilitate în loc de capturi de ecran
• Supabase: Interogări de bază de date cu conștientizare Row Level Security
• Sentry: Monitorizare erori și performanță direct în editorul tău

Poți citi și ghidul nostru despre cele mai bune servere MCP remote.

Hooks: stratul determinist

Hooks sunt în afara dezbaterii dintre skills și MCP. În timp ce skills și serverele MCP sunt orientate spre Claude (Claude decide când le folosește), hooks sunt orientate spre sistem. Ele se declanșează la evenimente precum PreToolUse sau PostToolUse, rulând scripturi shell înainte sau după ce Claude ia acțiuni specifice. Claude nu are niciun cuvânt de spus dacă un hook rulează.

Acest lucru face ca Hooks să fie alegerea corectă când ceva trebuie să se întâmple fără excepție: linting înainte de fiecare commit, blocarea scrierilor în directoare protejate, logarea fiecărei comenzi bash sau rularea testelor înainte de orice deployment.

Această dezvoltatoare recomandă hooks de tip „block-at-submit” în loc de „block-at-write”. Blocarea lui Claude în mijlocul sarcinii derutează agentul și produce rezultate mai slabe. Echipa ei folosește un hook PreToolUse care învelește Bash(git commit) și verifică existența unui fișier temporar care apare doar dacă testele trec. Fără fișier, fără commit. Agentul își termină treaba, apoi validarea se întâmplă la final.

Hooks nu adaugă cost de tokeni deoarece rulează ca scripturi shell în afara ferestrei de context.

Hooks Claude utile de configurat

• ESLint/Prettier la editare: Formatare automată a fișierelor după ce Claude le scrie
• Poartă de test la commit: Blochează commit-urile dacă testele nu trec
• Căi protejate: Previne scrierile în directoarele migrations, configs sau vendor
• Notificare la finalizare: Trimite alerte Slack sau desktop când sarcinile lungi se termină
• Backup al transcriptului: Salvează istoricul conversației înainte să ruleze compactarea

Cum să-ți construiești propriile pluginuri Claude Code

Când un skill trăiește în directorul tău personal .claude/, doar tu îl poți folosi. Împachetarea lui ca plugin îți permite să-l partajezi cu colegii sau să-l refolosești între proiecte.

Vom construi un plugin numit session-logger care adaugă o comandă /session-logger:summarize. Când e invocată, Claude revizuiește conversația și adaugă un rezumat structurat în SESSION_LOG.md.

Creează structura pluginului

Pluginurile pot sta oriunde pe filesystem-ul tău. Pentru acest tutorial, vom crea unul în directorul tău home:

cd ~
mkdir -p session-logger/.claude-plugin
mkdir -p session-logger/skills/summarize

Aceasta creează:

~/session-logger/
├── .claude-plugin/
│   └── plugin.json  	# manifest goes here, nowhere else
└── skills/
	└── summarize/   	# folder name becomes the command name
    	└── SKILL.md 	# must be named exactly this

Scrie manifestul

Creează ~/session-logger/.claude-plugin/plugin.json:

{
  "name": "session-logger",
  "description": "Log session summaries to a markdown file",
  "version": "1.0.0"
}

Câmpul name devine prefixul de namespace. Toate comenzile din acest plugin vor începe cu /session-logger:.

Scrie skillul

Creează ~/session-logger/skills/summarize/SKILL.md:

---
description: Log a summary of the current session to SESSION_LOG.md
disable-model-invocation: true
---
 
When invoked, review the conversation and create a summary with these sections:
 
- **Date/time**: Current timestamp
- **Tasks completed**: What was accomplished
- **Files modified**: List of files created or changed
- **Decisions made**: Architectural or implementation choices
- **Open questions**: Unresolved items for future sessions
 
Append the summary to SESSION_LOG.md in the project root. Create the file if it doesn't exist.

Linia disable-model-invocation: true îi spune lui Claude că doar tu poți declanșa acest skill. Fără acest flag, Claude ar putea decide să ruleze comanda autonom dacă i se pare că ajută conversația. Pentru un logger sau un instrument de deployment, de obicei vrei control manual.

Testează local

Navighează la orice proiect în care vrei să folosești pluginul, apoi pornește Claude Code cu flagul --plugin-dir indicând către pluginul tău:

cd ~/your-project
claude --plugin-dir ~/session-logger

Tastează /session-logger:summarize pentru a invoca comanda. Reține că comenzile pluginului nu apar în sugestiile de completare automată până nu tastezi numele complet. Textul devine albastru când Claude Code o recunoaște ca o comandă validă.

După ce ai făcut ceva lucru în sesiune, rulează comanda. Claude revizuiește conversația și adaugă o intrare în SESSION_LOG.md din directorul proiectului tău curent.

Partajează cu alții

Fă push pluginului pe GitHub. Pentru a-l distribui dincolo de clonarea manuală, adaugă-l într-un marketplace de pluginuri. Ghidul de marketplace acoperă crearea propriului marketplace sau trimiterea către unele existente.

Gânduri finale

Pluginurile transformă Claude Code dintr-un asistent generalist într-unul adaptat fluxului tău specific. Loggerul de sesiune pe care l-am construit a durat aproximativ cinci minute și trei fișiere. Majoritatea pluginurilor utile nu sunt mult mai complicate de atât.

Dacă ai urmat pașii, ai acum un plugin funcțional pe mașina ta. Încearcă să-l ajustezi: schimbă formatul rezumatului, adaugă secțiuni noi sau înlocuiește-l cu ceva de care echipa ta are cu adevărat nevoie. Structura rămâne aceeași, fie că construiești un instrument personal rapid, fie ceva ce vei distribui către sute de dezvoltatori.

De asemenea, aruncă o privire peste repository-urile comunității când ai ocazia. Modul în care alții își structurează pluginurile te învață tipare pe care documentația nu le poate surprinde.

Pentru a aprofunda Claude Code, consultă tutorialele noastre despre bune practici Claude Code, cadrul de skill-uri Superpowers, comenzi cu slash pentru sesiuni mai lungi și securitate și permisiuni. Dacă vrei să afli mai multe despre modelele Claude, îți recomand cursul Introduction to Claude Models.