Claude Code plugins ni nini na gharama zake?

Plugin ya Claude Code ni nini

Plugin ya Claude Code ni saraka moja ya vipengele ambavyo Claude Code hupakia na kusimamia kama kitengo kimoja. Vipengele hivyo ni skills, agents, hooks, MCP servers, LSP servers, na background monitors. Kusakinisha plugin huongeza sehemu zake zote kwa wakati mmoja, chini ya jina moja, na kuizima huondoa sehemu hizo kwa njia hiyo hiyo.

Plugin haimpi agent uwezo wowote ambao hakuwa nao awali. Kila sehemu iliyo ndani ya plugin ni kitu unachoweza kukiandika mwenyewe kwenye saraka ya .claude/. Plugin ni safu ya ufungashaji: njia ya kuweka toleo (version) kwa sehemu hizo, kuzigawa kwa watu kumi na watano, na kuzisasisha baadaye bila kumwomba kila mtu kunakili faili. Hiyo ndiyo dhana nzima, na mkanganyiko mwingi kuhusu plugins hutokana na kutarajia kuwa ni aina mpya ya uwezo.

Manifest ya hiari iliyo kwenye .claude-plugin/plugin.json huipa plugin jina, na jina hilo huwa namespace. Skill iliyo ndani ya plugin inayoitwa commit-commands huitwa kama /commit-commands:commit, hivyo plugins mbili zinaweza kila moja kusafirisha skill inayoitwa commit bila moja kuifunika nyingine. Plugin agents huwekewa wigo (scope) kwa njia hiyo hiyo kwenye orodha ya @-mention, kama plugin-name:agent-name.

Plugin, skill, MCP server, au faili ya rules

Maneno haya manne hutumika kana kwamba yanashindana. Hayashindani, na ni muhimu kuweka wazi mipaka yake mara moja.

• Skill ni kitengo kimoja cha maelekezo ambacho Claude hupakia wakati kazi inahitaji hivyo. Tazama nini maana halisi ya Agent Skill.
• MCP server ni mchakato (process) tofauti unaofichua zana (tools) kwa wakala kupitia itifaki, mara nyingi ni huduma ya mtandao unayojiendeshea mwenyewe.
• Faili ya rules kama vile CLAUDE.md ni muktadha wa mradi unaosomwa wakati wa kuanza kwa kikao na hutumika kwa kila kitu.
• Plugin ni kontena inayoweza kuhifadhi skills, agents, hooks, na ufafanuzi wa MCP server pamoja, ikiwa na namba ya toleo na njia ya usambazaji.

Kwa hivyo, swali ambalo plugin hujibu si "wakala anaweza kufanya nini". Swali ni "ninasambazaje hii kwa timu yangu na kuisasisha mwezi ujao". Ikiwa unachagua kati ya vitu vitatu vya kwanza, ulinganisho wa skills, MCP servers na faili za rules unaelezea uamuzi huo kwa kina. Ikiwa sehemu ya MCP ndiyo unayojali, kuendesha MCP servers zako mwenyewe kwenye VPS inashughulikia upande wa hosting.

Mahali plugins zinapohifadhiwa na muundo wake

Plugin inayosanikishwa kutoka kwenye marketplace hunakiliwa kwenye cache ya ndani katika ~/.claude/plugins/cache badala ya kuendeshwa kutoka mahali ilipokopiwa awali. Kila toleo lililosanikishwa hupata saraka yake binafsi. Unaposasisha au kuondoa plugin, saraka ya toleo la zamani huwekwa alama ya kuwa imeachwa na kufutwa baada ya takriban wiki mbili; hii inaruhusu kipindi cha kazi (session) kilichopakia toleo la zamani kuendelea kufanya kazi badala ya kukwama katikati ya kazi.

Kwa sababu njia (path) hubadilika kila baada ya sasisho, plugin haipaswi kamwe kuweka njia yake yenyewe kwa njia ya hardcode. Hooks na usanidi wa MCP ndani ya plugin hutumia ${CLAUDE_PLUGIN_ROOT}, ambayo hujitatua yenyewe kuelekea kwenye saraka ya sasa ya usanikishaji. Data ya hali (state) inayopaswa kubaki baada ya sasisho huwekwa kwenye ${CLAUDE_PLUGIN_DATA}, ambayo hujitatua kuelekea kwenye saraka thabiti chini ya ~/.claude/plugins/data/.

Saraka ya plugin pekee ndiyo hunakiliwa kwenye cache, jambo ambalo lina matokeo ambayo watu hukutana nayo baadaye. Njia inayoelekeza nje ya mzizi wa plugin, kama vile ../shared-utils, hufanya kazi wakati unapoendeleza programu kwa kutumia njia ya ndani (local path) lakini huvunjika baada ya usanikishaji, kwa sababu faili hizo hazikunakiliwa kamwe.

Muundo wake unaonekana hivi.

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

plugin.json pekee ndiyo huwekwa ndani ya .claude-plugin/. Kila kitu kingine hukaa kwenye mzizi wa plugin. Kuweka skills/ au hooks/ ndani ya .claude-plugin/ ndiyo sababu ya kawaida zaidi inayofanya plugin isanikishwe kwa usahihi kisha isifanye kazi yoyote: Claude Code hutafuta saraka hizo kwenye mzizi, haioni yoyote, na hupakia plugin bila vipengele vyovyote.

Manifest yenyewe ni ndogo.

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

Jinsi ya kusakinisha plugin ya Claude Code

Usakinishaji una hatua mbili, na ya kwanza haisakinishi kitu chochote. Unaongeza marketplace, ambayo ni orodha ya plugins, kisha unasakinisha plugins binafsi kutoka humo. Marketplace rasmi ya Anthropic, claude-plugins-official, husajiliwa kwako mara ya kwanza unapoanzisha Claude Code kwa njia ya mwingiliano (interactive). Nyingine unaziongeza wewe mwenyewe.

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

Kumbuka kuwa repository ni anthropics/claude-code wakati marketplace inaitwa claude-code-plugins. Jina hilo linatokana na faili ya orodha iliyo ndani ya repository, si kutoka kwenye njia ya repository, kwa hivyo soma jina la marketplace kwenye tab ya Marketplaces ya /plugin kabla ya kuandika amri ya kusakinisha.

Baada ya usakinishaji, soma mstari wa muhtasari. Plugin is now active. inamaanisha vipengele vimepakiwa katika kipindi hiki (session). Run /reload-plugins to activate. inamaanisha havijapakiwa, na unahitaji kuendesha amri hiyo. Ikiwa /reload-plugins itatoa onyo kwamba itasoma upya mazungumzo, iendeshe tena kama /reload-plugins --force. Kisha thibitisha kuwa plugin ipo kweli: /plugin inaionyesha chini ya tab ya Installed, /help inaorodhesha ujuzi wake chini ya Custom commands, na chochote kilichoshindwa kupakia kinaonekana chini ya tab ya Errors pamoja na sababu yake.

Usakinishaji huuliza kuhusu scope, na scope huamua nani anapata plugin hiyo. User scope ni wewe, katika kila mradi. Project scope huandika plugin kwenye .claude/settings.json ya repository chini ya enabledPlugins, kwa hivyo kila mtu anayekopi (clone) repository hiyo hupewa fursa ya kuitumia. Local scope ni wewe, katika repository hii pekee.

Kwa script, Dockerfile, au kipindi chochote ambapo paneli ya mwingiliano haipatikani, tumia fomu ya shell badala yake. Hii husakinisha kwenye user scope isipokuwa ukitumia --scope.

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

claude plugin install huendeshwa nje ya kipindi, kwa hivyo kipindi ambacho tayari kimefunguliwa hakitaona plugin mpya hadi uendeshe /reload-plugins au uanzishe kipindi kipya.

Kusimamia ulichonacho hufuata muundo uleule katika maeneo yote mawili. /plugin list huchapisha kilichosakinishwa, na inakubali --enabled au --disabled. /plugin disable name@marketplace huzima plugin bila kuiondoa, /plugin enable huiwasha tena, na /plugin uninstall huiondoa kabisa. Fomu za slash-command hufungua paneli ya plugin ili kutekeleza mabadiliko, ndiyo maana njia mbadala za shell za claude plugin ... ndizo zinazopaswa kutumika kwenye scripts.

Ili kutoa marketplace kwa timu nzima, iweke kwenye .claude/settings.json ya mradi. Wanachama huombwa kuisakinisha mara tu wanapoiamini folda ya repository.

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

Wakati unajenga plugin yako mwenyewe, ruka marketplace kabisa. claude --plugin-dir ./my-plugin hupakia saraka (directory) kwa kipindi hicho, /reload-plugins huchukua mabadiliko yako bila kuhitaji kuanzisha upya, na claude plugin validate ./my-plugin hukagua manifest, ujuzi na frontmatter ya agent, na hooks/hooks.json kabla ya mtu mwingine yeyote kuiona.

Je, plugin ya Claude Code inagharimu kiasi gani?

Utaratibu huu ni wa bure. Kufikia Agosti 2026, hakuna gharama ya kuongeza marketplace, kusakinisha plugin, au kuiacha ikiwa imewezeshwa. Marketplace rasmi na zile za jamii ni git repositories za umma, na plugin ni saraka ya faili za maandishi.

Gharama ya plugin ni token, na token ndizo zinazopimwa na matumizi ya usajili wako au bili yako ya API. Gharama hiyo inajitokeza kwa njia tatu tofauti, na zinafanya kazi kwa namna tofauti.

Gharama ya muktadha wa kudumu (Standing context cost). Kile ambacho plugin inachangia hukaa kwenye muktadha wako na kusomwa upya katika kila hatua ya kipindi (session). Kabla ya kusakinisha, mwonekano wa kina wa /plugin unaonyesha makadirio ya Context cost katika token pamoja na sehemu ya Will install inayoorodhesha amri, ujuzi, mawakala (agents), ndoano (hooks), na seva za MCP na LSP unazokaribia kuongeza. Soma yote mawili. Plugin kutoka kwenye marketplace za ndani au maalum zinaweza zisitoe data hiyo, ambapo utalazimika kukadiria mwenyewe. Plugin inayojumuisha seva ya MCP kwa kawaida ndiyo nzito zaidi, kwa sababu ufafanuzi wa zana ni mkubwa, ingawa kwenye miundo (models) inayounga mkono utafutaji wa zana za MCP, ufafanuzi huo huahirishwa hadi zana inapohitajika.

Gharama ya uanzishaji (Invocation cost). Kuendesha ujuzi wa plugin huongeza maelekezo yake kwenye mazungumzo, kwa hivyo unalipia mwili wa ujuzi huo pale tu unapoutumia. Wakala (agent) ni tofauti. Wakala mdogo (subagent) huendesha mazungumzo yake mwenyewe na prompt yake ya mfumo na cache yake yenyewe, akianza bila cache hits, kwa hivyo plugin ambayo mtiririko wake wa kazi huzaa mawakala inagharimu zaidi kuliko makadirio ya muktadha wake yanavyopendekeza.

Gharama ya cache. Kuwezesha au kulemaza plugin katikati ya kipindi kunaweza kulazimisha ombi linalofuata kuchakata upya mazungumzo yako yote. Ujuzi, amri, mawakala, ndoano, seva za LSP, vichunguzi na mandhari (themes) havifanyi hivi kamwe: kile wanachoongeza huwekwa baada ya historia iliyopo, kwa hivyo ombi linalofuata hulipia maudhui mapya na bado husoma kila kitu kilichotangulia kutoka kwenye cache. Isipokuwa ni plugin inayotoa seva ya MCP. Ikiwa zana zake zimeahirishwa na utafutaji wa zana, cache husalia. Ikiwa zinapakia kwenye kiambishi awali cha prompt (prompt prefix), ombi linalofuata husoma upya mazungumzo yote kama ingizo lisilokuwa kwenye cache. Hiyo ndiyo sababu hasa /reload-plugins inatoa onyo na kukataa katika hali hiyo hadi utakapopitisha --force.

Unaweza kufuatilia hili badala ya kukisia. Kila jibu la API huripoti cache_read_input_tokens na cache_creation_input_tokens, na custom statusline showing live token usage huweka yote mawili mbele yako. Kipindi chenye afya husoma zaidi kuliko kinachotengeneza. Ikiwa utengenezaji utabaki juu katika kila hatua, kuna kitu kwenye kiambishi awali chako kinabadilika kila hatua. Kwa picha pana ya kile kinachojaza dirisha, angalia how to manage the Claude Code context window na what those token counts actually mean.

Kazi moja ya usimamizi hujilipia yenyewe. Tab ya Installed huweka pamoja plugin ambazo hujazitumia kwa angalau wiki mbili chini ya kichwa cha habari cha Not used recently, na mstari wa Last used katika mwonekano wa kina. Plugin hizo bado zinakugharimu muda wa kuanza na muktadha katika kila kipindi. Zilemaze au uziondoe.

Plugin huendeshwa kwa kutumia ruhusa zako

Nyaraka za Anthropic zenyewe ziko wazi kuhusu hili: plugin na soko la programu (marketplaces) ni vipengele vinavyoaminika sana ambavyo vinaweza kutekeleza code yoyote kwenye mashine yako kwa kutumia ruhusa za mtumiaji wako. Hili si jambo la kubuni. Hook za plugin huendesha amri za shell wakati wa matukio ya session, ikiwemo kabla na baada ya wito wa zana (tool calls). Saraka yake ya bin/ huongezwa kwenye PATH ya zana ya Bash wakati plugin inapokuwa imewashwa. Seva zake za MCP ni michakato (processes) inayoanzishwa na plugin yenyewe. Hakuna kitu hapa kilichotengwa (sandboxed) mbali na akaunti yako ya mtumiaji.

Kwenye laptop, hatari hiyo imepakana na kile ambacho mtumiaji wa desktop anaweza kufikia. Kwenye seva, mara nyingi hali si hivyo. Akaunti inayoendesha wakala (agent) mara nyingi huwa na SSH keys, deploy tokens, session ya cloud CLI, na uwezo wa kufikia Docker socket, kwa hivyo "code yoyote kama mtumiaji wako" inamaanisha mashine nzima. Ikiwa Claude Code inaendeshwa kwenye VPS, soma jinsi ya kuendesha Claude Code kwa usalama kwenye VPS kabla ya kusakinisha chochote, na jinsi ya kuweka vitambulisho mbali na wakala kabla ya kusakinisha plugin inayowasiliana na huduma ya nje.

Kuna vizuizi (guardrails) vilivyopo, na inasaidia kujua ni vipi. Plugin ya kiwango cha mradi (project-scope) hutoka kwenye hazina (repository) badala ya kutoka kwako, kwa hivyo hupakia tu baada ya kuamini workspace, seva zake za MCP bado zinahitaji idhini kwa kila seva, seva zake za LSP husubiri idhini hiyo, na vichunguzi vyake vya nyuma (background monitors) havipakii kabisa. Mawakala wanaokuja na plugin hawaruhusiwi kutangaza hook, seva za MCP, au hali ya ruhusa. Plugin za soko (marketplace plugins) hunakiliwa kwenye cache huku symlink zinazoelekeza nje ya soko zikirukwa, kwa hivyo plugin haiwezi kuvuta faili za kiholela za mwenyeji (host).

Hakuna hata kimoja kati ya hayo kinachochukua nafasi ya kusoma kile unachokisakinisha. Angalia orodha ya Will install, pendelea plugin ambazo unaweza kufungua na kusoma chanzo chake, weka plugin za timu yako kwenye hazina ya soko unayoimiliki, na uendeshe claude plugin validate kwenye chochote unachoandika mwenyewe.

FAQ

Je, plugins za Claude Code zina gharama ya ziada?

Hapana. Hakuna ada kwa ajili ya mfumo wa plugin, kuongeza marketplace, au kusakinisha plugin. Gharama ni matumizi ya token, ambayo hutoza kwenye mpango wako au matumizi ya API kama muktadha mwingine wowote. Plugin huongeza muktadha wa kudumu katika kila hatua, huongeza zaidi wakati ujuzi au wakala wake unapoitwa, na inaweza kulazimisha hatua moja ya gharama kubwa isiyo na cache ikiwa inatoa MCP server ambayo zana zake hupakiwa kwenye kiambishi awali cha prompt. Mwonekano wa kina wa /plugin huonyesha makadirio ya Context cost kabla ya kusakinisha.

Kuna tofauti gani kati ya plugin na skill?

Skill ni kitengo kimoja cha maelekezo. Plugin ni kifurushi kinachoweza kuwa na skills, agents, hooks, MCP servers, LSP servers, na monitors, kikiwa na jina, toleo, na marketplace ya kukisakinishia. Andika skill inayojitegemea katika .claude/ ikiwa ni kwa ajili yako na mradi huu. Skill ya kusudi moja kama Ponytail, ambayo husukuma wakala kuelekea mabadiliko madogo zaidi yanayofanya kazi ndiyo mfano wazi zaidi wa hilo: faili moja yenye kanuni moja ndani yake, hadi siku ambayo timu yako pia inaitaka. Igeuze kuwa plugin wakati watu wengine wanapohitaji na inahitaji kusasishwa kadiri muda unavyopita. Plugin skills huwa na namespace, kwa hivyo skill iliyo ndani ya plugin huitwa kama /plugin-name:skill-name badala ya /skill-name.

Plugin yangu imesakinishwa lakini skills zake hazionekani. Kuna tatizo gani?

Kwanza, kagua muhtasari wa usakinishaji. Ikiwa ilisema Run /reload-plugins to activate., vipengele havijapakiwa bado, na ikiwa upakiaji upya unaonya kuwa utasoma tena mazungumzo, iendeshe tena kama /reload-plugins --force. Ikiwa imepakiwa lakini haionyeshi chochote, fungua /plugin na usome kichupo cha Errors. Kosa la kawaida la kimuundo ni kuweka skills/, agents/, au hooks/ ndani ya .claude-plugin/, ambapo Claude Code haitafuti vipengele hivyo. Kumbuka kuwa plugin skills zina namespace, kwa hivyo unatafuta /plugin-name:skill-name katika kichupo cha Custom commands cha /help. Kama suluhu ya mwisho, rm -rf ~/.claude/plugins/cache, anzisha upya, na usakinishe tena.

Je, ninaweza kusakinisha plugins bila kutumia paneli shirikishi?

Ndiyo. Tumia amri ya shell ya claude plugin install name@marketplace, ambayo husakinisha kwenye wigo wa mtumiaji isipokuwa utapitisha --scope project au --scope local. Inafanya kazi kwenye hati, picha, na mazingira yasiyo shirikishi ambapo paneli ya /plugin haipatikani. Kwa sababu inaendeshwa nje ya kipindi, kipindi ambacho tayari kimefunguliwa kinahitaji /reload-plugins kabla ya plugin kuanza kufanya kazi.

Je, ni salama kusakinisha plugin kutoka marketplace niliyopata kwenye GitHub?

Ichukulie kama unavyochukulia kuendesha hati ya usakinishaji ya hifadhi hiyo kama wewe mwenyewe, kwa sababu hiyo ndiyo hali halisi. Plugin inaweza kuendesha amri za shell kupitia hooks, kuongeza faili zinazoweza kutekelezwa kwenye PATH ya zana ya Bash, na kuanzisha MCP servers, yote hayo yakitumia marupurupu ya mtumiaji wako. Anthropic haidhibiti au kuhakiki yaliyomo kwenye plugins za watu wengine. Sakinisha kutoka vyanzo unavyoweza kusoma, kagua orodha ya Will install kabla ya kuthibitisha, na uwe mkali zaidi kwenye seva kuliko kwenye kompyuta ya mkononi, kwa sababu akaunti iliyo huko kwa kawaida huwa na funguo na token zenye thamani ya kuibiwa.