Wat zijn Claude Code plugins en wat kosten ze?
Ontdek hoe Claude Code plugins werken, waar u ze installeert en wat de kosten zijn. Het gebruik van het mechanisme is gratis, u betaalt enkel voor de gebruikte tokens.
Wat een Claude Code plugin is
Een Claude Code plugin is één map met componenten die Claude Code als één geheel laadt en beheert. De belangrijkste onderdelen zijn skills, agents, hooks, MCP servers, LSP servers en achtergrondmonitors. Een plugin kan ook commando's, outputstijlen, thema's, workflows en een bin/ map met uitvoerbare bestanden bevatten. 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 doorgaans geen mogelijkheden die deze nog niet had. Skills, agents, hooks en MCP servers zijn allemaal zaken die u handmatig in een .claude/ map kunt schrijven. De uitzonderingen zijn language servers voor code-intelligentie en mods, die Claude Code alleen vanuit een plugin laadt. Voor al het overige fungeert de plugin als verpakkingslaag: een manier om die onderdelen te versien, aan vijftien mensen te verstrekken en later bij te werken zonder iedereen te vragen bestanden te kopiëren. Dat is het hele concept, en de meeste verwarring over plugins ontstaat doordat men verwacht dat ze een nieuw soort functionaliteit bieden.
Het optionele manifest in .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 gescoped in de @-mention lijst, 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 aan de agent blootstelt via een protocol; dit is vaak een netwerkservice die u zelf beheert.
- Een rules-bestand zoals
CLAUDE.mdis projectcontext die aan het begin van een sessie wordt gelezen en op alles van toepassing is. - Een plugin is een map met skills, agents, hooks, MCP servers of andere componenten die Claude Code als één geheel installeert en laadt. Het optionele manifest geeft de plugin een naam en kan een versie, beschrijving en andere metadata toevoegen. Distributie maakt geen deel uit van de plugin: een marketplace is een afzonderlijke catalogus die plugins vermeldt en aangeeft waar elke plugin kan worden opgehaald.
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
De meeste marketplace-plugins worden gekopieerd naar een lokale cache op ~/.claude/plugins/cache, met een aparte map voor elke geïnstalleerde versie. Plugins met relatieve paden in een marketplace die u vanaf een lokaal pad heeft toegevoegd, worden op hun huidige locatie geladen. Plugins die als command-source in de link-modus staan, worden geladen via koppelingen naar hun bronmap. Wanneer u een gekopieerde plugin bijwerkt of 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. Opschoning vindt alleen plaats zolang er ten minste één plugin-installatie geregistreerd staat; nadat u uw laatste plugin heeft verwijderd, blijven verweesde mappen staan totdat u een nieuwe plugin installeert.
Omdat het pad van een gekopieerde plugin bij elke update wijzigt, mag een plugin zijn eigen locatie nooit hardcoden. Hooks en MCP-configuraties binnen een plugin gebruiken ${CLAUDE_PLUGIN_ROOT}, dat wordt omgezet naar de huidige installatiemap. Statusgegevens die een update moeten overleven, worden opgeslagen in ${CLAUDE_PLUGIN_DATA}, dat wordt omgezet naar een stabiele map onder ~/.claude/plugins/data/.
Bij een gekopieerde plugin wordt alleen de eigen map van de plugin naar de cache gekopieerd, met uitzondering van symlink-doelen elders in dezelfde marketplace, die op hun plek worden gekopieerd. Een script dat een pad buiten de plugin-root leest, zoals ../shared-utils, werkt terwijl u ontwikkelt met een lokaal pad, maar faalt zodra de plugin naar de cache wordt gekopieerd, omdat die bestanden nooit zijn meegekopieerd. Een componentpad dat op die manier in plugin.json is gedeclareerd, faalt nog eerder: Claude Code weigert elk componentpad dat buiten de plugin-root valt, ook tijdens de ontwikkeling, met een path escapes plugin directory-fout.
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 plugin-root. 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 ze niet 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"
}Hoe installeert u een Claude Code-plugin
De installatie bestaat uit twee stappen, waarvan de eerste 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 voor u geregistreerd wanneer u Claude Code voor de eerste keer interactief start, tenzij een beheerd beleid of CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL dit blokkeert. Andere marketplaces voegt u zelf toe.
/plugin marketplace add anthropics/claude-plugins-official
/plugin install commit-commands@claude-plugins-officialDe naam van de marketplace is afkomstig uit het catalogusbestand in de repository, niet uit het repository-pad. Lees daarom de naam van de marketplace af van het tabblad Marketplaces in /plugin voordat u een installatiecommando typt. De oude claude-code-plugins-marketplace in anthropics/claude-code is verouderd; gebruik claude-plugins-official voor nieuwe installaties. Bestaande plugins uit die oude marketplace worden bijgewerkt vanuit de officiële repository, dus u hoeft commit-commands niet opnieuw te installeren om van marketplace te wisselen.
Lees na de installatie de samenvattingsregel. Plugin is now active. betekent dat de componenten in deze sessie zijn geladen. Run /reload-plugins to apply. betekent dat ze niet tijdens de installatie zijn geactiveerd; het paneel sluit en Claude Code voert die herlaadactie voor u uit. Als de herlaadactie waarschuwt dat het gesprek opnieuw wordt ingelezen, blijft de plugin in de wachtrij staan en voert u deze opnieuw uit als /reload-plugins --force. Controleer daarna of de plugin daadwerkelijk aanwezig is: /plugin toont deze onder het tabblad Installed, het typen van / toont de vaardigheden als /plugin-name:skill-name, en alles wat niet kon worden geladen, verschijnt onder het tabblad Errors met de reden.
Bij de installatie wordt gevraagd om een scope, en de scope bepaalt wie de plugin krijgt. User-scope is voor u, in elk project. Project-scope schrijft de plugin naar de .claude/settings.json van de repository onder enabledPlugins, waardoor deze wordt ingeschakeld voor iedereen die de repository kloont. Het downloadt de plugin niet voor hen: elke medewerker installeert deze nog steeds eenmaal op zijn eigen machine, bijvoorbeeld met claude plugin install name@marketplace --scope project, tenzij het marketplace-item een relatief pad is of een seed-directory deze al bevat. 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 naar de user-scope, tenzij u --scope meegeeft. Op een machine waar nog niemand een interactieve sessie heeft geopend, is de officiële marketplace niet geregistreerd, dus voeg deze eerst toe.
claude plugin marketplace add anthropics/claude-plugins-official
claude plugin install commit-commands@claude-plugins-official --scope project
claude plugin listclaude plugin install wordt buiten een sessie uitgevoerd, dus een sessie die al open is, ziet de nieuwe plugin 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 toe te passen; 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, of voert u eenmaal claude plugin marketplace add your-org/claude-plugins --scope project uit en commit u het bestand dat wordt geschreven. Claude Code registreert de marketplace voor elk lid 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 het ziet. Een marketplace is ook niet vereist om een plugin te delen: u kunt iemand de map of een .zip ervan sturen om te laden met --plugin-dir, hoewel zij geen updates ontvangen totdat u een nieuw exemplaar verstuurt.
Wat kost een Claude Code-plugin?
Het mechanisme zelf is gratis. Per november 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 niets meer dan een map met tekstbestanden.
Wat een plugin daadwerkelijk kost, zijn tokens. Tokens zijn de eenheid waarin uw abonnementsverbruik of uw API-factuur wordt gemeten. Welke van deze twee wordt belast, hangt af van hoe u voor de tool betaalt. Wat Claude Code kost per abonnement zet de abonnementsvormen naast de API-tarieven per token. Deze kosten ontstaan op drie verschillende manieren, die elk een ander effect hebben.
Kosten voor permanente context. Elke ingeschakelde plugin voegt de namen en beschrijvingen van zijn skills, agents en commando's die Claude zelfstandig kan aanroepen toe aan uw context. Dit deel wordt bij elke beurt van de sessie opnieuw ingelezen, ongeacht of er iets wordt uitgevoerd. Niet elk onderdeel kost tokens: een hook wordt uitgevoerd door de harness en voegt niets toe aan de context van het model. Voorafgaand aan de installatie toont de /plugin-detailweergave een Will install-sectie met een overzicht van de commando's, skills, agents, hooks en MCP- en LSP-servers die u gaat toevoegen. Voor een plugin uit de officiële marketplace van Anthropic wordt ook een Context cost-sectie getoond met Every turn- en When invoked-schattingen, mits u de plugin opent via de naam in de marketplace of vanuit het Marketplaces-tabblad in plaats van vanuit de Discover-lijst. Lees beide. Een plugin uit uw eigen of een externe marketplace heeft geen Context cost-sectie, maar u hoeft niet handmatig te schatten: claude plugin details name in uw shell toont een Always-on-tokengetal en een uitsplitsing per onderdeel voor elke geladen plugin, inclusief degene die u meegeeft met --plugin-dir. U kunt dus een repository klonen en claude --plugin-dir ./that-plugin plugin details that-plugin uitvoeren voordat u iets installeert. Dit getal houdt geen rekening met MCP-servers. Een plugin die een MCP-server bundelt, is meestal het zwaarst omdat tooldefinities omvangrijk zijn, al worden deze definities bij modellen die MCP-toolzoekopdrachten ondersteunen uitgesteld totdat een tool nodig is. Voer /context uit in een sessie met de plugin ingeschakeld en lees de MCP tools-regel om te zien wat ze toevoegen.
Kosten voor aanroepen. Het uitvoeren van een skill van een plugin voegt de instructies toe aan het gesprek, dus u betaalt alleen voor de inhoud van de skill wanneer deze wordt gebruikt. De inhoud is echter het goedkope deel; wat de skill de agent opdraagt te doen, hoeft dat niet te zijn: de Depth Tree-methode van de unlazy-skill verbruikt bijna al zijn tokens aan de extra passes die het afdwingt voordat de agent een taak als voltooid mag markeren, niet aan het bestand dat u heeft geïnstalleerd. Een agent werkt anders. Een subagent voert een eigen gesprek met een eigen systeemprompt en cache, beginnend zonder cache-hits. Een plugin waarvan de workflow agents start, kost daarom aanzienlijk meer dan de contextschatting suggereert.
Kosten voor cache. Het in- of uitschakelen van een plugin halverwege een sessie kan ertoe leiden dat het volgende verzoek uw volledige gesprek opnieuw moet verwerken. Skills, commando's, agents, hooks, 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 de rest nog steeds uit de cache leest. De uitzonderingen zijn een plugin die een MCP-server levert en een code-intelligence-plugin, waarvan de language server Claude de LSP-tool geeft. Voor MCP hangt het af van tool-search: als de tools worden uitgesteld, 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 waarom /reload-plugins waarschuwt en weigert wanneer een wijziging in MCP-tools of de LSP-tool de cache zou verbreken, tenzij u --force meegeeft.
U kunt dit monitoren in plaats van gokken. Elke API-respons rapporteert cache_read_input_tokens en cache_creation_input_tokens, en een aangepaste statusbalk die live tokenverbruik toont maakt beide inzichtelijk. Een gezonde sessie leest veel meer dan dat deze creëert. Als het creëren beurt na beurt hoog blijft, verandert er iets in uw prefix bij elke beurt. Voor een breder beeld van wat het venster vult, zie hoe u het Claude Code-contextvenster beheert en wat die aantallen tokens daadwerkelijk betekenen.
Eén stukje onderhoud verdient zichzelf terug. Het Installed-tabblad groepeert via de marketplace geïnstalleerde plugins die u ten minste 14 dagen en 10 sessies niet heeft gebruikt onder een Not used recently-kop, met een Last used-regel in de detailweergave. De kop sluit beheerde plugins en plugins in de seed-directory uit, evenals plugins met een thema, outputstijl, monitor of workflow; een LSP-server telt als gebruikt wanneer deze diagnostische gegevens levert of een verzoek voor codenavigatie beantwoordt. Wanneer strictKnownMarketplaces is geconfigureerd, verschijnen de kop noch de Last used:-regel. Die plugins kosten u nog steeds opstarttijd en context bij elke sessie. Schakel ze uit of verwijder ze. De goedkopere gewoonte is om selectief te zijn vóór installatie: welke skills van Matt Pocock de moeite waard zijn om te installeren doorloopt een collectie van 27 skills en scheidt de weinige die een individuele ontwikkelaar nodig heeft van de skills die alleen renderen in een team.
Een plugin draait met uw rechten
De documentatie van Anthropic is hierover duidelijk: een plugin die u installeert, kan willekeurige code uitvoeren op uw machine met uw gebruikersrechten. Dit is geen hypothetisch scenario. De hooks van een plugin voeren shell-commando's uit bij sessiegebeurtenissen, inclusief voor en na tool-aanroepen. De bin/-directory wordt toegevoegd aan de PATH van de Bash-tool zolang de plugin is ingeschakeld. De stdio MCP-servers zijn processen die de plugin start, en een mod voert JavaScript uit binnen Claude Code zelf. Hooks, monitors, serverprocessen en mod-processen draaien buiten de sandbox van Claude Code; de permissieregels blijven echter van toepassing op de tool-aanroepen die Claude doet.
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-sleutels, deploy-tokens, een cloud CLI-sessie en toegang tot de Docker-socket. "Willekeurige code als uw gebruiker" betekent in dat geval de volledige machine. Als Claude Code op een VPS draait, lees dan hoe u Claude Code veilig op een VPS draait 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. Andere omgevingen lopen tegen dezelfde beperkingen aan op dezelfde gehuurde server. Daarom zijn de DeepSeek Harness-plugins die het installeren waard zijn grotendeels gericht op uitgavenlimieten, permissieregels voor tools en injectiescans, in plaats van op nieuwe functionaliteiten.
Er bestaan wel degelijk vangrails en het is nuttig om te weten welke. Een plugin met projectbereik is afkomstig uit de repository en niet van u persoonlijk. Deze wordt pas geladen nadat u de workspace vertrouwt, de MCP-servers vereisen nog steeds goedkeuring per server en de achtergrondmonitors worden helemaal niet geladen. Agents die door plugins worden meegeleverd, mogen geen hooks, MCP-servers of een permissiemodus declareren. Wanneer marketplace-plugins naar de cache worden gekopieerd, worden symlinks die naar buiten de marketplace wijzen overgeslagen. Een gekopieerde plugin kan dus geen willekeurige hostbestanden ophalen via die links.
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. Wat u heeft beoordeeld, kan later veranderen: automatische updates staan standaard aan voor de officiële marketplaces van Anthropic, behalve voor knowledge-work-plugins en first-party-plugins, en staan uit voor externe marketplaces die via de bron zijn toegevoegd. Waar automatische updates aanstaan, werkt Claude Code de bestanden van de plugin op de achtergrond bij.
FAQ
Kosten Claude Code-plugins 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 net als bij andere contexten wordt verrekend met uw abonnement of API-tegoed. Een plugin voegt bij elke beurt permanente context toe, voegt extra context toe wanneer een van de vaardigheden of agents wordt aangeroepen, en kan een kostbare, niet-gecachte beurt afdwingen als de plugin een MCP-server levert waarvan de tools in het prompt-voorvoegsel worden geladen. Voor een plugin in de officiële marketplace van Anthropic toont de /plugin detailweergave een Context cost schatting voordat u deze installeert; voor elke andere plugin toont claude plugin details name de permanente tokenkosten zodra deze is geïnstalleerd of geladen met --plugin-dir.
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, meestal een versie en meestal een marketplace om deze vanuit te installeren, hoewel het ook gedeeld kan worden als een map of een .zip die mensen laden met --plugin-dir. Schrijf een zelfstandige skill in .claude/ wanneer deze voor u en dit project bedoeld is. Een skill met één doel, zoals Ponytail, die de agent aanzet tot de kleinst mogelijke wijziging die werkt, is hiervan het duidelijkste voorbeeld: één bestand met één regel erin, totdat de dag komt dat uw team deze ook wil gebruiken. Maak er een plugin van wanneer andere mensen deze nodig hebben en de skill in de loop van de tijd moet worden bijgewerkt. Plugin-skills hebben een namespace, waardoor een skill binnen een plugin wordt aangeroepen als /plugin-name:skill-name in plaats van /skill-name.
Mijn plugin is geïnstalleerd, maar de skills verschijnen niet. Wat is er mis?
Controleer eerst het installatieoverzicht. Als daar Run /reload-plugins to apply. stond, voert Claude Code die herlaadactie uit wanneer het paneel sluit. Als de herlaadactie waarschuwt dat het gesprek opnieuw wordt gelezen, 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/ in .claude-plugin/, waar Claude Code niet naar deze bestanden zoekt. Onthoud dat plugin-skills een namespace hebben, dus u zoekt naar /plugin-name:skill-name wanneer u / typt. Als het een plugin van iemand anders is en deze zonder foutmelding laadt, open dan het detailvenster op het Installed tabblad: een plugin die daar geen skills vermeldt, heeft er geen te bieden. Als het Errors tabblad aangeeft dat de plugin niet is gecachet, ontbreekt de installatiemap. Installeer deze dan opnieuw vanuit uw shell met claude plugin install name@marketplace en voer /reload-plugins uit.
Kan ik plugins installeren zonder het interactieve paneel?
Ja. Gebruik het shell-commando claude plugin install name@marketplace, dat installeert in de gebruikersomgeving, 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. In een sessie zonder interactieve terminal worden wijzigingen aan plugin-MCP-servers in de volgende sessie doorgevoerd.
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 is grotendeels wat er gebeurt. Een plugin kan shell-commando's uitvoeren via hooks, uitvoerbare bestanden toevoegen aan de PATH van de Bash-tool en MCP-servers starten, allemaal met de rechten van uw gebruiker. Anthropic controleert of verifieert de inhoud van plugins van derden niet. Installeer alleen vanuit bronnen die u kunt lezen, controleer de Will install lijst voordat u bevestigt en wees strenger op een server dan op een laptop, aangezien het account op een server meestal sleutels en tokens bevat die diefstal waard zijn.