Wat zijn Claude Code plugins en wat kosten ze?

Wat een Claude Code-plugin is

Een Claude Code-plugin is één map met componenten die Claude Code als één geheel laadt en beheert. Deze componenten zijn skills, agents, hooks, MCP-servers, LSP-servers en achtergrondmonitors. Het installeren van een plugin voegt alle onderdelen in één keer toe onder één naam, en het uitschakelen ervan verwijdert ze op dezelfde wijze.

Een plugin geeft de agent geen mogelijkheden die deze nog niet had. Elk onderdeel in een plugin is iets dat u handmatig kunt schrijven in een .claude/-map. De plugin is de verpakkingslaag: een manier om die onderdelen te versien, aan vijftien mensen te overhandigen en later bij te werken zonder iedereen te vragen bestanden te kopiëren. Dat is het hele idee, en de meeste verwarring over plugins ontstaat door de verwachting dat ze een nieuw soort functionaliteit bieden.

Het optionele manifest op .claude-plugin/plugin.json geeft de plugin een naam, en die naam wordt een namespace. Een skill in een plugin genaamd commit-commands wordt aangeroepen als /commit-commands:commit, waardoor twee plugins elk een skill genaamd commit kunnen bevatten zonder dat de een de ander overschrijft. Plugin-agents worden op dezelfde manier gescopeerd in de @-vermeldingslijst, als plugin-name:agent-name.

Plugin, skill, MCP server of rules-bestand

Deze vier termen worden vaak door elkaar gebruikt alsof ze met elkaar concurreren. Dat is niet het geval en het is nuttig om de grenzen eenmalig te verduidelijken.

• Een skill is één instructie-eenheid die Claude laadt wanneer de taak daarom vraagt. Zie wat een Agent Skill precies is.
• Een MCP server is een afzonderlijk proces dat tools via een protocol aan de agent aanbiedt; dit is vaak een netwerkservice die u zelf beheert.
• Een rules-bestand zoals CLAUDE.md is projectcontext die bij de start van een sessie wordt ingelezen en op alles van toepassing is.
• Een plugin is een container die skills, agents, hooks en MCP server-definities kan bevatten, aangevuld met een versienummer en een distributiekanaal.

De vraag die een plugin beantwoordt is dus niet "wat kan de agent doen". De vraag is "hoe distribueer ik dit naar mijn team en hoe update ik het volgende maand". Als u moet kiezen tussen de eerste drie, behandelt de vergelijking tussen skills, MCP servers en rules-bestanden die beslissing in detail. Als het MCP-gedeelte voor u van belang is, behandelt het draaien van uw eigen MCP servers op een VPS de hostingkant.

Waar plugins zich bevinden en wat ze bevatten

Een plugin die vanuit een marketplace wordt geïnstalleerd, wordt gekopieerd naar een lokale cache op ~/.claude/plugins/cache in plaats van uitgevoerd vanaf de locatie waar deze werd gekloond. Elke geïnstalleerde versie krijgt een eigen map. Wanneer u een update uitvoert of de plugin verwijdert, wordt de map van de oude versie gemarkeerd als verweesd en na ongeveer twee weken verwijderd. Hierdoor blijft een sessie die de oude versie al heeft geladen, functioneren in plaats van halverwege een taak te falen.

Omdat het pad bij elke update wijzigt, mag een plugin zijn eigen locatie nooit hardcoden. Hooks en MCP-configuraties binnen een plugin gebruiken ${CLAUDE_PLUGIN_ROOT}, wat wordt omgezet naar de huidige installatiemap. Statusgegevens die een update moeten overleven, worden opgeslagen in ${CLAUDE_PLUGIN_DATA}, wat wordt omgezet naar een stabiele map onder ~/.claude/plugins/data/.

Alleen de map van de plugin zelf wordt naar de cache gekopieerd, wat een gevolg heeft waar gebruikers vaak pas laat achter komen. Een pad dat buiten de root van de plugin wijst, zoals ../shared-utils, werkt tijdens de ontwikkeling met een lokaal pad, maar werkt niet meer na installatie omdat die bestanden nooit zijn gekopieerd.

De structuur ziet er als volgt uit.

my-plugin/
├── .claude-plugin/
│   └── plugin.json
├── skills/
│   └── code-review/
│       └── SKILL.md
├── agents/
├── hooks/
│   └── hooks.json
├── .mcp.json
└── bin/

Alleen plugin.json hoort in .claude-plugin/ te staan. Al het overige bevindt zich in de root van de plugin. Het plaatsen van skills/ of hooks/ in .claude-plugin/ is de meest voorkomende reden waarom een plugin wel correct installeert, maar vervolgens niets doet: Claude Code zoekt naar deze mappen in de root, vindt er geen, en laadt een plugin zonder componenten.

Het manifest zelf is klein.

{
  "name": "my-first-plugin",
  "description": "A greeting plugin to learn the basics",
  "version": "1.0.0"
}

Een Claude Code-plugin installeren

De installatie bestaat uit twee stappen, waarbij de eerste stap niets installeert. U voegt een marketplace toe, wat een catalogus van plugins is, en vervolgens installeert u individuele plugins vanuit die catalogus. De officiële marketplace van Anthropic, claude-plugins-official, wordt automatisch voor u geregistreerd wanneer u Claude Code voor de eerste keer interactief opstart. Andere marketplaces voegt u zelf toe.

/plugin marketplace add anthropics/claude-code
/plugin install commit-commands@claude-code-plugins

Let op dat de repository anthropics/claude-code is, terwijl de marketplace de naam claude-code-plugins draagt. De naam is afkomstig uit het catalogusbestand in de repository, niet van het repository-pad. Lees daarom de naam van de marketplace af van het Marketplaces-tabblad in /plugin voordat u een installatiecommando typt.

Lees na de installatie de samenvattingsregel. Plugin is now active. betekent dat de componenten in deze sessie zijn geladen. Run /reload-plugins to activate. betekent dat dit niet het geval is en dat u dat commando moet uitvoeren. Als /reload-plugins waarschuwt dat het de conversatie opnieuw zou inlezen, voer het dan opnieuw uit als /reload-plugins --force. Controleer vervolgens of de plugin daadwerkelijk aanwezig is: /plugin toont deze onder het Installed-tabblad, /help somt de vaardigheden op onder Custom commands, en alles wat niet kon worden geladen, verschijnt onder het Errors-tabblad met de bijbehorende reden.

Bij de installatie wordt gevraagd om een scope; de scope bepaalt wie de plugin ontvangt. De user-scope is voor u, in elk project. De project-scope schrijft de plugin naar de .claude/settings.json van de repository onder enabledPlugins, zodat iedereen die de repository kloont, de plugin krijgt aangeboden. De local-scope is voor u, alleen in deze repository.

Gebruik voor een script, een Dockerfile of elke sessie waar geen interactief paneel beschikbaar is, de shell-vorm. Deze installeert standaard in de user-scope, tenzij u --scope meegeeft.

claude plugin install commit-commands@claude-code-plugins --scope project
claude plugin list

claude plugin install wordt uitgevoerd buiten een sessie; een sessie die al geopend is, ziet de nieuwe plugin dus pas nadat u /reload-plugins uitvoert of een nieuwe sessie start.

Het beheer van wat u heeft geïnstalleerd volgt op beide plekken hetzelfde patroon. /plugin list toont wat er is geïnstalleerd en accepteert --enabled of --disabled. /plugin disable name@marketplace schakelt een plugin uit zonder deze te verwijderen, /plugin enable schakelt deze weer in en /plugin uninstall verwijdert de plugin. De slash-commando-vormen openen het plugin-paneel om de wijziging door te voeren; daarom zijn de claude plugin ... shell-equivalenten de juiste keuze voor scripts.

Om een marketplace aan een heel team aan te bieden, plaatst u deze in de .claude/settings.json van het project. Leden krijgen de vraag om de marketplace te installeren zodra zij de repository-map vertrouwen.

{
  "extraKnownMarketplaces": {
    "my-team-tools": {
      "source": {
        "source": "github",
        "repo": "your-org/claude-plugins"
      }
    }
  }
}

Terwijl u uw eigen plugin bouwt, kunt u de marketplace volledig overslaan. claude --plugin-dir ./my-plugin laadt een map voor die sessie, /reload-plugins verwerkt uw wijzigingen zonder herstart en claude plugin validate ./my-plugin controleert het manifest, de vaardigheid, de agent-frontmatter en hooks/hooks.json voordat iemand anders deze ziet.

Wat kost een Claude Code plugin?

Het mechanisme is gratis. Sinds augustus 2026 zijn er geen kosten verbonden aan het toevoegen van een marketplace, het installeren van een plugin of het ingeschakeld houden ervan. De officiële en community-marketplaces zijn openbare git-repositories en een plugin is een map met tekstbestanden.

Wat een plugin kost, zijn tokens, en tokens zijn de eenheid waarin uw abonnementsverbruik of uw API-factuur wordt gemeten. Deze kosten ontstaan op drie verschillende manieren en gedragen zich verschillend.

Kosten voor permanente context. Wat een plugin toevoegt, bevindt zich in uw context en wordt bij elke beurt van de sessie opnieuw gelezen. Voorafgaand aan de installatie toont de /plugin detailweergave een Context cost schatting in tokens, plus een Will install sectie met een overzicht van de commando's, skills, agents, hooks en MCP- en LSP-servers die u gaat toevoegen. Lees beide. Plugins van lokale of aangepaste marketplaces leveren deze gegevens mogelijk niet aan; in dat geval moet u zelf een schatting maken. Een plugin die een MCP-server bundelt, is meestal het zwaarst omdat tooldefinities groot zijn, hoewel deze definities bij modellen die MCP-tool-search ondersteunen, worden uitgesteld totdat een tool nodig is.

Kosten voor aanroepen. Het uitvoeren van de skill van een plugin voegt de instructies toe aan het gesprek, dus u betaalt alleen voor de skill-body wanneer deze wordt gebruikt. Een agent werkt anders. Een subagent voert een eigen gesprek met een eigen systeemprompt en eigen cache, beginnend zonder cache-hits. Een plugin waarvan de workflow agents genereert, kost daarom aanzienlijk meer dan de contextschatting suggereert.

Kosten voor cache. Het in- of uitschakelen van een plugin tijdens een sessie kan het volgende verzoek dwingen om uw volledige gesprek opnieuw te verwerken. Skills, commando's, agents, hooks, LSP-servers, monitors en thema's doen dit nooit: wat zij toevoegen wordt achter de bestaande geschiedenis geplaatst, waardoor het volgende verzoek betaalt voor de nieuwe inhoud en alles daarvoor nog steeds uit de cache leest. De uitzondering is een plugin die een MCP-server levert. Als de tools worden uitgesteld door tool-search, blijft de cache behouden. Als ze in het prompt-prefix worden geladen, leest het volgende verzoek het volledige gesprek opnieuw als ongecachte invoer. Dat is precies de reden waarom /reload-plugins waarschuwt en in dat geval weigert totdat u --force doorgeeft.

U kunt dit monitoren in plaats van gissen. Elke API-respons rapporteert cache_read_input_tokens en cache_creation_input_tokens, en een aangepaste statusregel die live tokenverbruik toont zet beide voor u in beeld. Een gezonde sessie leest veel meer dan dat deze creëert. Als het creëren beurt na beurt hoog blijft, verandert er elke beurt iets in uw prefix. Voor een breder beeld van wat het venster vult, zie hoe u het Claude Code contextvenster beheert en wat die tokentellingen daadwerkelijk betekenen.

Eén stukje onderhoud verdient zichzelf terug. Het Installed tabblad groepeert plugins die u ten minste twee weken niet hebt gebruikt onder een Not used recently kop, met een Last used regel in de detailweergave. Die plugins kosten u bij elke sessie nog steeds opstarttijd en context. Schakel ze uit of verwijder ze.

Een plugin draait met uw rechten

De documentatie van Anthropic is hierover zeer duidelijk: plugins en marketplaces zijn componenten die u in hoge mate moet vertrouwen, aangezien ze willekeurige code op uw machine kunnen uitvoeren met uw gebruikersrechten. Dit is geen hypothetisch risico. De hooks van een plugin voeren shell-commando's uit bij sessiegebeurtenissen, waaronder voor en na tool-aanroepen. De bin/-directory van een plugin wordt toegevoegd aan de PATH van de Bash-tool zolang de plugin is ingeschakeld. De MCP-servers van de plugin zijn processen die door de plugin zelf worden gestart. Niets hiervan is afgeschermd van uw gebruikersaccount.

Op een laptop is dat risico beperkt tot wat uw desktopgebruiker kan bereiken. Op een server is dat meestal niet het geval. Het account dat de agent uitvoert, beschikt vaak over SSH-keys, deploy-tokens, een actieve cloud CLI-sessie en toegang tot de Docker-socket. "Willekeurige code als uw gebruiker" betekent in dat geval toegang tot de gehele machine. Als Claude Code op een VPS draait, lees dan hoe u Claude Code veilig op een VPS uitvoert voordat u iets installeert, en hoe u inloggegevens buiten bereik van een agent houdt voordat u een plugin installeert die communiceert met een externe dienst.

Er zijn wel degelijk vangrails aanwezig en het is nuttig om te weten welke dit zijn. Een plugin met projectbereik is afkomstig uit de repository in plaats van van u persoonlijk; deze wordt pas geladen nadat u de workspace heeft vertrouwd. De MCP-servers vereisen nog steeds goedkeuring per server, de LSP-servers wachten op die vertrouwensstatus en achtergrondmonitors worden in dit geval helemaal niet geladen. Agents die door plugins worden meegeleverd, mogen geen hooks, MCP-servers of een permissiemodus declareren. Marketplace-plugins worden naar de cache gekopieerd, waarbij symlinks die naar locaties buiten de marketplace wijzen worden overgeslagen, zodat een plugin geen willekeurige bestanden van de host kan ophalen.

Niets van dit alles vervangt het controleren van wat u installeert. Controleer de Will install-lijst, geef de voorkeur aan plugins waarvan u de broncode kunt openen en inzien, beheer de plugins van uw team in een marketplace-repository die u zelf beheert, en voer claude plugin validate uit op alles wat u zelf schrijft.

FAQ

Kosten plugins voor Claude Code extra geld?

Nee. Er zijn geen kosten verbonden aan het pluginsysteem, het toevoegen van een marketplace of het installeren van een plugin. De kosten bestaan uit tokenverbruik, dat wordt verrekend met uw abonnement of API-tegoed, net als bij elke andere context. Een plugin voegt bij elke interactie permanente context toe, verbruikt meer tokens wanneer een van de skills of agents wordt aangeroepen, en kan een kostbare, niet-gecachte interactie forceren als de plugin een MCP-server levert waarvan de tools in het prompt-voorvoegsel worden geladen. Het /plugin detailoverzicht toont een Context cost schatting voordat u tot installatie overgaat.

Wat is het verschil tussen een plugin en een skill?

Een skill is een enkele instructie-eenheid. Een plugin is een pakket dat skills, agents, hooks, MCP-servers, LSP-servers en monitors kan bevatten, voorzien van een naam, een versie en een marketplace om deze vanuit te installeren. Schrijf een losstaande skill in .claude/ wanneer deze bedoeld is voor uzelf en het huidige project. Een skill met één specifiek doel, zoals Ponytail, die de agent stuurt naar de kleinst mogelijke wijziging die werkt, is hiervan het duidelijkste voorbeeld: één bestand met één regel, totdat het moment aanbreekt dat uw team deze ook wil gebruiken. Zet een skill om naar een plugin wanneer anderen deze ook nodig hebben en de skill in de loop van de tijd moet worden bijgewerkt. Plugin-skills zijn voorzien van een namespace; een skill binnen een plugin wordt daarom aangeroepen als /plugin-name:skill-name in plaats van /skill-name.

Mijn plugin is geïnstalleerd, maar de skills verschijnen niet. Wat is het probleem?

Controleer eerst het installatieoverzicht. Als daar Run /reload-plugins to activate. stond, zijn de componenten nog niet geladen. Als de herlaadactie waarschuwt dat het gesprek opnieuw wordt ingelezen, voer deze dan opnieuw uit als /reload-plugins --force. Als de plugin is geladen maar niets toont, open dan /plugin en lees het Errors tabblad. De meest voorkomende structurele fout is het plaatsen van skills/, agents/ of hooks/ binnen .claude-plugin/, waar Claude Code niet naar deze bestanden zoekt. Onthoud dat plugin-skills namespaces gebruiken; u zoekt dus naar /plugin-name:skill-name in het Custom commands tabblad van /help. Als laatste redmiddel kunt u rm -rf ~/.claude/plugins/cache uitvoeren, herstarten en opnieuw installeren.

Kan ik plugins installeren zonder het interactieve paneel?

Ja. Gebruik het shell-commando claude plugin install name@marketplace, dat standaard op gebruikersniveau installeert, tenzij u --scope project of --scope local meegeeft. Dit werkt in scripts, images en niet-interactieve omgevingen waar het /plugin paneel niet beschikbaar is. Omdat dit buiten een sessie draait, heeft een reeds geopende sessie /reload-plugins nodig voordat de plugin effect sorteert.

Is het veilig om een plugin te installeren van een marketplace die ik op GitHub heb gevonden?

Behandel dit op dezelfde manier als wanneer u het installatiescript van die repository zelf zou uitvoeren, want dat komt in de praktijk op hetzelfde neer. Een plugin kan shell-commando's uitvoeren via hooks, uitvoerbare bestanden toevoegen aan het PATH van de Bash-tool en MCP-servers starten, en dit alles met uw gebruikersrechten. Anthropic controleert of verifieert de inhoud van plugins van derden niet. Installeer alleen vanuit bronnen die u kunt inzien, controleer de Will install lijst voordat u bevestigt en wees op een server strenger dan op een laptop, aangezien het account daar doorgaans over sleutels en tokens beschikt die waardevol zijn voor kwaadwillenden.