Claude Code plugins: Ano ito at magkano ang gastos

Ano ang Claude Code plugin

Ang Claude Code plugin ay isang directory ng mga component na nilo-load at mina-manage ng Claude Code bilang isang unit. Kabilang sa mga component na ito ang skills, agents, hooks, MCP servers, LSP servers, at background monitors. Kapag nag-install ka ng plugin, idinadagdag agad ang lahat ng bahagi nito sa ilalim ng isang pangalan. Kapag dine-disable mo ito, inaalis din ang mga ito sa parehong paraan.

Walang ibinibigay na bagong kakayahan ang plugin sa agent. Ang bawat bahagi sa loob ng plugin ay maaari mong isulat nang manu-mano sa isang .claude/ directory. Ang plugin ang packaging layer: paraan ito para ma-version ang mga bahaging iyon, maipamahagi ang mga ito sa labinlimang tao, at ma-update sa hinaharap nang hindi kailangang hilingin sa lahat na mag-copy ng mga file. Iyon ang buong konsepto. Karamihan sa kalituhan tungkol sa mga plugin ay nagmumula sa pag-aakalang isa itong bagong uri ng capability.

Tinatawag ng optional manifest sa .claude-plugin/plugin.json ang plugin, at nagiging namespace ang pangalang iyon. Ang isang skill sa plugin na tinatawag na commit-commands ay ini-invoke bilang /commit-commands:commit. Dahil dito, maaaring mag-release ang dalawang plugin ng tig-isang skill na tinatawag na commit nang hindi natatabunan ng isa ang isa pa. Pareho rin ang scope ng mga plugin agent sa @-mention list, gaya ng plugin-name:agent-name.

Plugin, skill, MCP server, o rules file

Ginagamit ang apat na terminong ito na parang magkakumpitensya. Hindi sila ganoon, at mahalagang malinaw ang pagkakaiba nila.

• Ang skill ay isang unit ng instruction na nilo-load ni Claude kapag kailangan ito ng task. Tingnan ang kung ano talaga ang Agent Skill.
• Ang MCP server ay isang hiwalay na process na naglalantad ng tools sa agent sa pamamagitan ng protocol. Madalas, network service ito na ikaw mismo ang nagse-set up.
• Ang rules file gaya ng CLAUDE.md ay project context na binabasa sa simula ng session at nalalapat sa lahat.
• Ang plugin ay isang container na maaaring maglaman ng skills, agents, hooks, at mga definition ng MCP server, pati version number at distribution channel.

Kaya ang sinasagot ng plugin ay hindi “ano ang kayang gawin ng agent”. Ang tanong nito ay “paano ko ito ide-deliver sa team ko at ia-update sa susunod na buwan”. Kung pumipili ka sa unang tatlo, detalyadong tinatalakay ng paghahambing ng skills, MCP servers, at rules files ang desisyong iyon. Kung ang MCP ang pangunahing paksa mo, tinatalakay ng pagpapatakbo ng sarili mong MCP servers sa VPS ang bahagi tungkol sa hosting.

Kung saan nakaimbak ang mga plugin at kung ano ang laman ng mga ito

Ang plugin na na-install mula sa isang marketplace ay kinokopya sa local cache na nasa ~/.claude/plugins/cache sa halip na patakbuhin mula sa lokasyon kung saan ito na-clone. May sariling directory ang bawat naka-install na version. Kapag nag-update o nag-uninstall ka, minamarkahan bilang orphaned ang directory ng lumang version at dine-delete pagkalipas ng humigit-kumulang dalawang linggo. Dahil dito, patuloy na gumagana ang session na nakapag-load na ng lumang version sa halip na biglang mag-fail habang tumatakbo ang task.

Dahil nagbabago ang path sa bawat update, hindi dapat i-hardcode ng plugin ang sarili nitong lokasyon. Ginagamit ng hooks at MCP configs sa loob ng plugin ang ${CLAUDE_PLUGIN_ROOT}, na nagre-resolve sa kasalukuyang install directory. Ang state na kailangang manatili pagkatapos ng update ay inilalagay sa ${CLAUDE_PLUGIN_DATA}, na nagre-resolve sa stable directory sa ilalim ng ~/.claude/plugins/data/.

Sariling directory lamang ng plugin ang kinokopya sa cache. May mahalagang epekto ito na kadalasang napapansin lamang sa bandang huli. Ang path na tumuturo sa labas ng plugin root, gaya ng ../shared-utils, ay gumagana habang nagde-develop gamit ang local path ngunit nagfa-fail pagkatapos ng installation dahil hindi nakopya ang mga file na iyon.

Ganito ang layout.

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

plugin.json lamang ang inilalagay sa loob ng .claude-plugin/. Ang lahat ng iba pa ay nasa plugin root. Ang paglalagay ng skills/ o hooks/ sa loob ng .claude-plugin/ ang pinakakaraniwang dahilan kung bakit maayos na nai-install ang plugin ngunit wala itong ginagawa: hinahanap ni Claude Code ang mga directory na iyon sa root, walang nakikita, at naglo-load ng plugin na walang components.

Maliit lamang ang manifest.

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

Paano mag-install ng Claude Code plugin

Dalawang hakbang ang pag-install, at walang ini-install sa unang hakbang. Nagdaragdag ka muna ng marketplace, isang catalog ng mga plugin, at pagkatapos ay nag-i-install ka ng mga indibidwal na plugin mula rito. Ang opisyal na marketplace ng Anthropic, claude-plugins-official, ay awtomatikong nirerehistro sa unang pagsisimula mo ng Claude Code nang interactive. Ikaw mismo ang nagdaragdag ng iba pang marketplace.

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

Tandaan na ang repository ay anthropics/claude-code, samantalang claude-code-plugins ang pangalan ng marketplace. Mula sa catalog file sa loob ng repository ang pangalan, hindi sa path ng repository. Kaya basahin ang pangalan ng marketplace sa tab na Marketplaces ng /plugin bago mag-type ng install command.

Pagkatapos ng pag-install, basahin ang summary line. Ipinapahiwatig ng Plugin is now active. na na-load ang mga component sa session na ito. Ipinapahiwatig naman ng Run /reload-plugins to activate. na hindi na-load ang mga ito at kailangan mong patakbuhin ang command na iyon. Kung magbabala ang /reload-plugins na muling babasahin nito ang conversation, patakbuhin itong muli bilang /reload-plugins --force. Pagkatapos, kumpirmahing talagang naroon ang plugin: ipinapakita ito ng /plugin sa ilalim ng tab na Installed, inililista ng /help ang mga skill nito sa ilalim ng Custom commands, at lumalabas sa tab na Errors ang anumang hindi na-load, kasama ang dahilan.

Humihingi ng scope ang pag-install, at tinutukoy ng scope kung sino ang makakagamit ng plugin. Ang user scope ay para sa iyo sa bawat project. Isinusulat ng project scope ang plugin sa .claude/settings.json ng repository sa ilalim ng enabledPlugins, kaya ino-offer ito sa lahat ng magki-clone ng repository. Ang local scope ay para sa iyo at sa repository na ito lamang.

Para sa script, Dockerfile, o anumang session na walang interactive panel, gamitin ang shell form. Sa user scope ito nag-i-install maliban kung ipasa mo ang --scope.

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

Tumatakbo ang claude plugin install sa labas ng session. Kaya hindi makikita ng session na bukas na ang bagong plugin hanggang patakbuhin mo ang /reload-plugins o magsimula ng bagong session.

Pareho ang pattern sa pamamahala ng mga naka-install na plugin sa dalawang lugar. Ipinapakita ng /plugin list kung ano ang naka-install, at tumatanggap ito ng --enabled o --disabled. Ino-off ng /plugin disable name@marketplace ang plugin nang hindi ito inaalis, ino-on muli ito ng /plugin enable, at inaalis ito ng /plugin uninstall. Binubuksan ng mga slash-command form ang plugin panel para ilapat ang pagbabago. Kaya ang claude plugin ... shell equivalent ang dapat gamitin sa mga script.

Para ibahagi ang isang marketplace sa buong team, ilagay ito sa .claude/settings.json ng project. Ipo-prompt ang mga miyembro na i-install ito kapag pinagkakatiwalaan na nila ang repository folder.

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

Habang binubuo mo ang sarili mong plugin, huwag munang gumamit ng marketplace. Naglo-load ang claude --plugin-dir ./my-plugin ng directory para sa session na iyon, kinukuha ng /reload-plugins ang mga pagbabago mo nang hindi nagre-restart, at sinusuri ng claude plugin validate ./my-plugin ang manifest, ang skill at agent frontmatter, at ang hooks/hooks.json bago ito makita ng iba.

Magkano ang halaga ng Claude Code plugin?

Libre ang mekanismo. Noong August 2026, walang bayad sa pagdaragdag ng marketplace, pag-install ng plugin, o pagpapanatiling enabled nito. Public git repositories ang official at community marketplace, at directory ng mga text file ang isang plugin.

Ang aktuwal na ginagastos ng plugin ay tokens. Ito ang sinusukat ng subscription usage o API bill mo. Kung alin sa dalawang ito ang mababawasan ay depende sa paraan ng pagbabayad mo sa tool. Inilalahad sa halaga ng Claude Code sa bawat plan ang mga subscription tier kasabay ng per-token API pricing. Tatlong paraan ang pinagmumulan ng gastos na ito, at magkakaiba ang epekto ng bawat isa.

Gastos sa persistent context. Napupunta sa context mo ang idinadagdag ng plugin, at binabasa itong muli sa bawat turn ng session. Bago mag-install, ipinapakita ng /plugin detail view ang tinatayang Context cost bilang ng tokens, pati ang Will install section na naglilista ng commands, skills, agents, hooks, at MCP at LSP servers na idaragdag mo. Basahin ang dalawa. Maaaring walang ganitong data ang mga plugin mula sa local o custom marketplace, kaya kailangan mo itong tantiyahin nang manu-mano. Karaniwang pinakamabigat ang plugin na may kasamang MCP server dahil malalaki ang tool definitions. Gayunman, sa mga model na sumusuporta sa MCP tool search, ipinagpapaliban ang mga definition na ito hanggang kailanganin ang isang tool.

Gastos sa invocation. Kapag pinatakbo ang skill ng plugin, idinaragdag ang mga instruction nito sa conversation. Kaya magbabayad ka para sa skill body lamang kapag ginagamit ito. Gayunman, ito ang murang bahagi. Maaaring mas malaki ang gastos sa ipinag-uutos ng skill sa agent: sa Depth Tree method ng unlazy skill, halos lahat ng tokens ay napupunta sa mga karagdagang pass na ipinapagawa nito bago payagang ituring ng agent na tapos na ang task, hindi sa file na ini-install mo. Iba ang agent. Gumagawa ang subagent ng sarili nitong conversation, system prompt, at cache. Nagsisimula ito nang walang cache hits. Kaya mas malaki nang malaki ang gastos ng plugin na nagse-spawn ng agents kaysa sa ipinahihiwatig ng context estimate nito.

Gastos sa cache. Kapag nag-enable o nag-disable ka ng plugin sa kalagitnaan ng session, maaaring kailanganing iproseso muli sa susunod na request ang buong conversation mo. Hindi ito ginagawa ng skills, commands, agents, hooks, LSP servers, monitors, at themes. Idinadagdag ang mga ito pagkatapos ng kasalukuyang history, kaya babayaran ng susunod na request ang bagong content ngunit babasahin pa rin mula sa cache ang lahat ng nauna. Ang exception ay plugin na nagbibigay ng MCP server. Kung ipinagpapaliban ng tool search ang mga tool nito, nananatili ang cache. Kung nilo-load ang mga ito sa prompt prefix, babasahin muli ng susunod na request ang buong conversation bilang uncached input. Ito mismo ang dahilan kung bakit nagbababala ang /reload-plugins at tumatanggi sa ganitong sitwasyon hanggang maipasa mo ang --force.

Maaari mong i-monitor ito sa halip na manghula. Iniuulat ng bawat API response ang cache_read_input_tokens at cache_creation_input_tokens, at inilalagay ng custom statusline na nagpapakita ng live token usage ang dalawang ito sa harap mo. Sa maayos na session, mas marami ang binabasang tokens kaysa sa nalilikhang tokens. Kung nananatiling mataas ang creation sa bawat turn, may bahagi ng prefix mo na nagbabago sa bawat turn. Para sa mas malawak na paliwanag kung ano ang pumupuno sa window, tingnan ang pamamahala sa Claude Code context window at kahulugan ng aktuwal na token counts.

May isang housekeeping task na sulit gawin. Pinagbubukod ng Installed tab ang mga plugin na hindi mo nagamit nang hindi bababa sa dalawang linggo sa ilalim ng Not used recently header, at may Last used line sa detail view. Gumagastos pa rin ang mga plugin na ito ng startup time at context sa bawat session. I-disable o i-uninstall ang mga ito.

Ang plugin ay tumatakbo gamit ang iyong mga permission

Direkta ang dokumentasyon mismo ng Anthropic tungkol dito: ang mga plugin at marketplace ay mga component na lubos na pinagkakatiwalaan at maaaring magpatakbo ng arbitrary code sa iyong machine gamit ang mga user privilege mo. Hindi ito hypothetical. Ang hooks ng plugin ay nagpapatakbo ng shell command kapag may session event, kabilang ang bago at pagkatapos ng tool call. Idinadagdag ang directory nitong bin/ sa PATH ng Bash tool habang naka-enable ang plugin. Ang mga MCP server nito ay mga process na sinisimulan nito. Walang bahagi rito ang naka-sandbox mula sa iyong user account.

Sa laptop, nalilimitahan ang panganib na ito ng mga resource na maaabot ng iyong desktop user. Sa server, karaniwan ay hindi ito nalilimitahan. Ang account na nagpapatakbo sa agent ay madalas may hawak na SSH key, deploy token, cloud CLI session, at access sa Docker socket. Kaya ang ibig sabihin ng “arbitrary code bilang iyong user” ay ang mismong machine. Kung tumatakbo ang Claude Code sa isang VPS, basahin muna ang kung paano ligtas na patakbuhin ang Claude Code sa isang VPS bago ka mag-install ng anuman. Basahin din ang kung paano ilayo ang mga credential sa agent bago ka mag-install ng plugin na kumokonekta sa external service. Parehong problema ang nararanasan ng ibang harness sa parehong rented box. Kaya ang mga DeepSeek Harness plugin na sulit i-install ay kadalasang spend cap, tool permission rule, at injection scanning, sa halip na mga bagong capability.

May ilang guardrail, at makatutulong na malaman kung alin ang mga ito. Ang project-scope plugin ay nagmumula sa repository at hindi sa iyo. Kaya naglo-load lamang ito pagkatapos mong pagkatiwalaan ang workspace. Kailangan pa rin ng per-server approval ang mga MCP server nito. Naghihintay din ang mga LSP server nito sa trust na iyon, at hindi talaga naglo-load ang mga background monitor nito. Hindi pinapayagan ang mga agent na kasama sa plugin na magdeklara ng hooks, MCP server, o permission mode. Kinokopya ang mga marketplace plugin sa cache habang nilalaktawan ang mga symlink na tumuturo sa labas ng marketplace. Kaya hindi maaaring magsama ang plugin ng arbitrary host file.

Hindi nito napapalitan ang pagbasa sa iyong ini-install. Suriin ang listahan ng Will install. Mas piliin ang mga plugin na maaari mong buksan at basahin ang source. Panatilihin ang mga plugin ng team sa marketplace repository na kontrolado mo. Patakbuhin ang claude plugin validate sa anumang ikaw mismo ang sumulat.

FAQ

May dagdag bang bayad ang Claude Code plugins?

Wala. Walang bayad para sa plugin system, pagdaragdag ng marketplace, o pag-install ng plugin. Ang gastos ay paggamit ng token, na sinisingil laban sa iyong plan o API spend gaya ng ibang context. Nagdaragdag ang plugin ng permanenteng context sa bawat turn, nagdaragdag pa kapag tinawag ang isa sa mga skill o agent nito, at maaaring magdulot ng isang mahal ngunit uncached na turn kung nagbibigay ito ng MCP server na ang mga tool ay nilo-load sa prompt prefix. Ipinapakita ng /plugin detail view ang isang Context cost estimate bago ka mag-install.

Ano ang pagkakaiba ng plugin at skill?

Ang skill ay isang hiwalay na unit ng instruction. Ang plugin ay isang package na maaaring maglaman ng mga skill, agent, hook, MCP server, LSP server, at monitor, kasama ang pangalan, version, at marketplace na pagmumulan nito sa pag-install. Sumulat ng standalone skill sa .claude/ kung para sa iyo at sa project na ito. Malinaw na halimbawa nito ang single-purpose skill gaya ng Ponytail, na nagtutulak sa agent na gamitin ang pinakamaliit na gumaganang pagbabago: isang file na may isang rule, hanggang sa kailanganin na rin ito ng team mo. Gawin itong plugin kapag kailangan ito ng ibang tao at kailangan itong i-update sa paglipas ng panahon. Namespaced ang mga plugin skill, kaya tinatawag ang skill sa loob ng plugin bilang /plugin-name:skill-name sa halip na /skill-name.

Na-install ang plugin ko pero hindi lumalabas ang mga skill nito. Ano ang problema?

Suriin muna ang install summary. Kung nakasaad doon ang Run /reload-plugins to activate., hindi pa naka-load ang mga component, at kung nagbabala ang reload na muli nitong babasahin ang conversation, patakbuhin itong muli bilang /reload-plugins --force. Kung naka-load ito pero walang ipinapakita, buksan ang /plugin at basahin ang Errors tab. Ang pinakakaraniwang structural mistake ay ang paglalagay ng skills/, agents/, o hooks/ sa loob ng .claude-plugin/, kung saan hindi hinahanap ng Claude Code ang mga ito. Tandaan na namespaced ang mga plugin skill, kaya hanapin ang /plugin-name:skill-name sa Custom commands tab ng /help. Bilang huling paraan, rm -rf ~/.claude/plugins/cache, mag-restart, at mag-install muli.

Maaari ba akong mag-install ng plugins nang walang interactive panel?

Oo. Gamitin ang shell command na claude plugin install name@marketplace, na nag-i-install sa user scope maliban kung ipasa mo ang --scope project o --scope local. Gumagana ito sa mga script, image, at non-interactive environment kung saan hindi available ang /plugin panel. Dahil tumatakbo ito sa labas ng session, kailangang gamitin ng session na bukas na ang /reload-plugins bago magkabisa ang plugin.

Ligtas bang mag-install ng plugin mula sa marketplace na nakita ko sa GitHub?

Ituring ito na parang pagpapatakbo ng install script ng repository bilang iyong user, dahil halos ganoon din ang nangyayari. Maaaring magpatakbo ang plugin ng shell command sa pamamagitan ng hook, magdagdag ng executable sa PATH ng Bash tool, at magsimula ng MCP server, lahat gamit ang mga privilege ng iyong user. Hindi kinokontrol o bine-verify ng Anthropic ang laman ng third-party plugin. Mag-install mula sa mga source na mababasa mo, suriin ang Will install list bago kumpirmahin, at maging mas mahigpit sa server kaysa sa laptop, dahil karaniwang may hawak doon ang account ng mga key at token na maaaring nakawin.