Claude Code plugins: Ano ang mga ito at gastos

Kung 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, sabay-sabay na nadaragdag ang lahat ng bahagi nito sa ilalim ng iisang pangalan. Kapag dine-disable ito, sabay-sabay din silang inaalis.

Walang bagong kakayahan ang plugin na wala pa sa agent. Ang bawat bahagi sa loob ng plugin ay maaari mong isulat nang mano-mano sa isang .claude/ directory. Packaging layer ang plugin. Paraan ito upang ma-version ang mga bahaging iyon, maipamahagi sa labinlimang tao, at ma-update sa ibang pagkakataon nang hindi kailangang hilingin sa lahat na mag-copy ng mga file. Iyan ang buong konsepto. Karamihan ng kalituhan tungkol sa mga plugin ay nagmumula sa pag-aakalang bago itong uri ng capability.

Ang optional manifest sa .claude-plugin/plugin.json ang nagbibigay ng pangalan sa plugin. Nagiging namespace ang pangalang iyon. Ang skill sa plugin na may pangalang commit-commands ay ini-invoke bilang /commit-commands:commit. Kaya maaaring mag-release ang dalawang plugin ng skill na parehong tinatawag na commit nang hindi nagkakaroon ng shadowing ang isa sa isa. Pareho ring naka-scope ang 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 para bang magkakapareho ang tungkulin. Hindi ganoon, kaya mahalagang linawin ang pagkakaiba ng mga ito.

• 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 hiwalay na process na naglalantad ng mga tool sa agent sa pamamagitan ng protocol. Madalas itong network service na ikaw mismo ang nagpapatakbo.
• Ang rules file gaya ng CLAUDE.md ay project context na binabasa sa simula ng session at naaangkop sa lahat.
• Ang plugin ay isang container na maaaring maglaman ng skills, agents, hooks, at MCP server definitions nang magkakasama, pati version number at distribution channel.

Kaya ang sinasagot ng plugin ay hindi “ano ang kayang gawin ng agent”. Ang tanong ay “paano ko ito ipapamahagi sa team ko at ia-update sa susunod na buwan”. Kung namimili ka sa unang tatlong opsyon, detalyadong ipinapaliwanag ng paghahambing ng skills, MCP servers, at rules files ang desisyong iyon. Kung MCP ang pangunahing kailangan mo, ipinapaliwanag ng pagpapatakbo ng sarili mong MCP servers sa VPS ang bahagi tungkol sa hosting.

Saan nakalagay ang mga plugin at ano ang laman ng mga ito

Ang plugin na ini-install mula sa marketplace ay kinokopya sa local cache sa ~/.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 na-load na ang lumang version sa halip na biglang mag-fail habang may 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 nang huli. Ang path na tumuturo sa labas ng plugin root, gaya ng ../shared-utils, ay gumagana habang nade-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 roon, 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 ang unang hakbang. Nagdadagdag ka muna ng marketplace, na isang catalog ng mga plugin, saka nag-i-install 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 nagdadagdag 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 ang marketplace ay pinangalanang claude-code-plugins. Ang pangalan ay nagmumula sa catalog file sa loob ng repository, hindi sa repository path. Kaya basahin ang pangalan ng marketplace sa Marketplaces tab ng /plugin bago mag-type ng install command.

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

Humihingi ang pag-install ng scope, 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 io-offer ito sa lahat ng magki-clone ng repository. Ang Local scope ay para sa iyo lamang at sa repository na ito.

Para sa script, Dockerfile, o anumang session na walang interactive panel, gamitin ang shell form. Nag-i-install ito sa user scope 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 kasalukuyang bukas na session ang bagong plugin hangga't hindi mo pinapatakbo ang /reload-plugins o nagsisimula ng bagong session.

Pareho ang pattern sa pamamahala ng mga naka-install na plugin sa dalawang lugar. Ini-print ng /plugin list ang mga naka-install, at tumatanggap ito ng --enabled o --disabled. Ino-off ng /plugin disable name@marketplace ang plugin nang hindi ito inaalis, ibinabalik ito sa active state ng /plugin enable, at inaalis ito ng /plugin uninstall. Binubuksan ng mga slash-command form ang plugin panel upang ilapat ang pagbabago. Kaya ang claude plugin ... shell equivalent ang dapat gamitin sa mga script.

Para maibigay ang isang marketplace sa buong team, ilagay ito sa .claude/settings.json ng project. Ipo-prompt ang mga member na i-install ito kapag nagtiwala na sila sa repository folder.

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

Habang ginagawa 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, awtomatikong nakikita ng /reload-plugins ang mga edit mo nang walang restart, at sinusuri ng claude plugin validate ./my-plugin ang manifest, ang frontmatter ng skill at agent, at ang hooks/hooks.json bago ito makita ng iba.

Magkano ang gastos para sa Claude Code plugin?

Libre ang mekanismo. Simula Agosto 2026, walang bayad para magdagdag ng marketplace, mag-install ng plugin, o panatilihing naka-enable ang isang plugin. Ang official at community marketplace ay mga public git repository, at ang plugin ay isang directory ng mga text file.

Ang aktuwal na gastos ng plugin ay nasa tokens, at tokens ang sinusukat ng subscription usage o API bill mo. May tatlong paraan kung paano ito nagkakaroon ng gastos, at magkakaiba ang epekto ng bawat isa.

Standing context cost. Ang idinadagdag ng plugin ay napupunta sa context at muling binabasa sa bawat turn ng session. Bago mag-install, ipinapakita ng /plugin detail view ang Context cost estimate sa tokens, pati ang Will install section na naglilista ng mga command, skill, agent, hook, at MCP at LSP server na idaragdag mo. Basahin ang dalawang ito. Maaaring walang ganitong data ang mga plugin mula sa local o custom marketplace. Sa ganitong kaso, ikaw ang kailangang gumawa ng estimate. Karaniwang pinakamabigat ang plugin na may kasamang MCP server dahil malalaki ang tool definition. Gayunman, sa mga model na sumusuporta sa MCP tool search, ipinagpapaliban ang mga definition na ito hanggang kailanganin ang isang tool.

Invocation cost. Kapag pinatakbo ang skill ng plugin, idinadagdag ang mga instruction nito sa conversation. Kaya magbabayad ka para sa skill body kapag ginagamit lamang ito. Iba ang agent. Ang subagent ay nagpapatakbo ng sarili nitong conversation, may sarili nitong system prompt at cache, at nagsisimula nang walang cache hit. Dahil dito, mas malaki ang gastos ng plugin na nag-spawn ng mga agent kaysa sa ipinahihiwatig ng context estimate nito.

Cache cost. Kapag nag-enable o nag-disable ng plugin sa kalagitnaan ng session, maaaring kailanganing iproseso muli ng susunod na request ang buong conversation. Hindi ito ginagawa ng mga skill, command, agent, hook, LSP server, monitor, at theme. Ang idinadagdag ng mga ito ay inilalagay pagkatapos ng kasalukuyang history. Kaya magbabayad ang susunod na request para sa bagong content, habang binabasa pa rin nito 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, muling babasahin ng susunod na request ang buong conversation bilang uncached input. Ito mismo ang dahilan kung bakit nagbababala ang /reload-plugins at tumatangging magpatuloy sa ganitong sitwasyon hanggang maipasa mo ang --force.

Maaari mo itong i-monitor sa halip na manghula. Iniuulat ng bawat API response ang cache_read_input_tokens at cache_creation_input_tokens, at ipinapakita ng isang custom statusline na nagpapakita ng live token usage ang dalawang ito. Sa isang maayos na session, mas marami ang binabasang token kaysa sa nalilikha. Kung nananatiling mataas ang creation sa bawat turn, may bahagi ng prefix mo na nagbabago sa bawat turn. Para sa mas malawak na pagtingin sa pumupuno sa window, tingnan ang kung paano pamahalaan ang Claude Code context window at kung ano talaga ang ibig sabihin ng mga token count na iyon.

May isang housekeeping task na sulit gawin. Pinagpapangkat 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. Nagdudulot pa rin ang mga plugin na ito ng startup time at context cost sa bawat session. I-disable o i-uninstall ang mga ito.

Tumatakbo ang plugin gamit ang iyong permissions

Direkta ang pahayag ng sariling documentation ng Anthropic tungkol dito: ang mga plugin at marketplace ay highly trusted components na maaaring magpatakbo ng arbitrary code sa iyong machine gamit ang user privileges mo. Hindi ito hypothetical. Ang hooks ng plugin ay nagpapatakbo ng shell commands sa mga session event, kabilang ang bago at pagkatapos ng tool calls. Idinadagdag ang bin/ directory nito sa PATH ng Bash tool habang enabled 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 risk batay sa mga resource na maa-access ng iyong desktop user. Sa server, karaniwan ay hindi. Ang account na nagpapatakbo ng agent ay madalas may hawak na SSH keys, deploy tokens, cloud CLI session, at access sa Docker socket. Kaya ang ibig sabihin ng “arbitrary code as your user” ay ang mismong machine. Kung tumatakbo ang Claude Code sa isang VPS, basahin ang kung paano ligtas na patakbuhin ang Claude Code sa isang VPS bago mag-install ng anuman. Basahin din ang kung paano ilayo ang credentials sa agent bago mag-install ng plugin na kumokonekta sa external service.

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

Hindi nito pinapalitan ang pagbasa sa iyong ini-install. Suriin ang Will install list, piliin ang mga plugin na mabubuksan at mababasa ang source, ilagay ang plugins ng iyong team sa marketplace repository na kontrolado ninyo, at patakbuhin ang claude plugin validate sa anumang ikaw mismo ang sumulat.

FAQ

Mas may dagdag bang bayad ang mga Claude Code plugin?

Wala. Walang bayad para sa plugin system, pagdaragdag ng marketplace, o pag-install ng plugin. Ang sinisingil ay token usage, na ibinabawas sa iyong plan o API spend gaya ng iba pang 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 mamahaling uncached turn kung nagbibigay ito ng MCP server na naglo-load ng mga tool nito sa prompt prefix. Ipinapakita ng /plugin detail view ang Context cost estimate bago mo ito i-install.

Ano ang pagkakaiba ng plugin at skill?

Ang skill ay isang yunit ng instruction. Ang plugin ay isang package na maaaring maglaman ng skills, agents, hooks, MCP servers, LSP servers, at monitors, kasama ang pangalan, bersyon, at marketplace na pagmumulan nito para 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 gawin ang pinakamaliit na gumaganang pagbabago: isang file na may isang rule, hanggang sa kailanganin din ito ng team ninyo. Gawin itong plugin kapag kailangan ito ng ibang tao at kailangang i-update sa paglipas ng panahon. Naka-namespace ang plugin skills, 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 sinabi nitong Run /reload-plugins to activate., hindi pa naka-load ang mga component, at kung nagbabala ang reload na babasahin nitong muli ang conversation, patakbuhin itong muli bilang /reload-plugins --force. Kung nag-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 naka-namespace ang plugin skills, kaya hinahanap mo ang /plugin-name:skill-name sa Custom commands tab ng /help. Bilang huling hakbang, rm -rf ~/.claude/plugins/cache, mag-restart, at muling mag-install.

Maaari ba akong mag-install ng mga plugin nang hindi ginagamit ang 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 scripts, images, at non-interactive environments 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 maging aktibo ang plugin.

Ligtas ba ang pag-install ng plugin mula sa marketplace na nakita ko sa GitHub?

Ituring ito na parang nagpapatakbo ka ng install script ng repository bilang sarili mong user, dahil halos ganoon ang ginagawa nito. Maaaring magpatakbo ang plugin ng shell commands sa pamamagitan ng hooks, magdagdag ng executables sa PATH ng Bash tool, at magsimula ng MCP servers, lahat gamit ang privileges ng iyong user. Hindi kinokontrol o bine-verify ng Anthropic ang laman ng mga 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 ang account doon na mga key at token na maaaring nakawin.