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 ile ile.

Plugin haimpi agent uwezo wowote ambao hakuwa nao awali. Kila sehemu iliyo ndani ya plugin ni kitu unachoweza kuandika mwenyewe kwenye saraka ya .claude/. Plugin ni safu ya upakiaji: 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 ziwe 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, kwa hivyo plugins mbili zinaweza kila moja kusafirisha skill inayoitwa commit bila moja kufunika nyingine. Plugin agents huwekewa wigo (scoped) kwa njia ile ile 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 mipaka yake wazi mara moja.

• Skill ni kitengo kimoja cha maelekezo ambacho Claude hupakia wakati kazi inahitaji kufanya hivyo. Tazama nini maana halisi ya Agent Skill.
• MCP server ni mchakato tofauti unaotoa zana kwa agent kupitia itifaki, mara nyingi ni huduma ya mtandao unayoiendesha wewe 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, ikijumuisha namba ya toleo na njia ya usambazaji.

Kwa hiyo, swali ambalo plugin hujibu si "agent anaweza kufanya nini". Bali 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 iliyosakinishwa kutoka kwenye marketplace hunakiliwa kwenye cache ya ndani katika ~/.claude/plugins/cache badala ya kuendeshwa kutoka mahali ilipokopiwa awali. Kila toleo lililosakinishwa hupata saraka yake binafsi. Unaposasisha au kuondoa plugin, saraka ya toleo la zamani huwekwa alama ya kuwa imeachwa (orphaned) na kufutwa baada ya takriban wiki mbili; hii inaruhusu kipindi cha kazi (session) kilichopakia toleo la zamani kuendelea kufanya kazi badala ya kukatika 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 saraka ya sasa ya usakinishaji. Data ya hali (state) inayopaswa kubaki baada ya sasisho huwekwa katika ${CLAUDE_PLUGIN_DATA}, ambayo hujitatua kuelekea saraka thabiti iliyo chini ya ~/.claude/plugins/data/.

Saraka ya plugin pekee ndiyo hunakiliwa kwenye cache, jambo ambalo lina matokeo ambayo watumiaji hukutana nayo baadaye. Njia inayoelekeza nje ya mzizi (root) wa plugin, kama vile ../shared-utils, hufanya kazi wakati wa maendeleo (development) ukiwa na njia ya ndani, lakini huvunjika baada ya usakinishaji 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 isakinike vizuri lakini isifanye kazi yoyote: Claude Code hutafuta saraka hizo kwenye mzizi, haioni chochote, na hupakia plugin isiyo na vipengele.

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 hatua ya kwanza haisakinishi chochote. Unaongeza marketplace, ambayo ni orodha ya plugins, kisha unasakinisha plugins binafsi kutoka humo. Marketplace rasmi ya Anthropic, claude-plugins-official, husajiliwa kiotomatiki mara ya kwanza unapoanzisha Claude Code kwa njia ya maingiliano (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 kichupo cha Marketplaces cha /plugin kabla ya kuandika amri ya usakinishaji.

Baada ya usakinishaji, soma mstari wa muhtasari. Plugin is now active. inamaanisha vipengele vimepakiwa katika kipindi hiki. 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: /plugin inaionyesha chini ya kichupo cha Installed, /help inaorodhesha ujuzi wake chini ya Custom commands, na chochote kilichoshindwa kupakia kinaonekana chini ya kichupo cha Errors kikiwa na sababu.

Usakinishaji huuliza kuhusu scope, na scope huamua nani anayepata plugin hiyo. User scope ni wewe, katika kila mradi. Project scope huandika plugin hiyo kwenye .claude/settings.json ya repository chini ya enabledPlugins, 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 ambacho paneli ya maingiliano haipatikani, tumia fomu ya shell badala yake. Inasakinisha kwenye user scope isipokuwa utapitisha --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 utaratibu 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, pamoja 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 malipo 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 tokens, na tokens ndizo zinazopimwa na matumizi ya usajili wako au bili yako ya API. Ni ipi kati ya hizo mbili inayotumiwa na plugin inategemea jinsi unavyolipia zana hiyo kwanza, na gharama za Claude Code kwa kila mpango inaainisha viwango vya usajili kando ya bei ya API kwa kila token. Gharama hiyo inajitokeza kwa njia tatu tofauti, na zina tabia tofauti.

Gharama ya muktadha wa kudumu (Standing context cost). Kile ambacho plugin inachangia hukaa kwenye muktadha wako na husomwa upya katika kila hatua ya kikao. Kabla ya kusakinisha, mwonekano wa kina wa /plugin unaonyesha makadirio ya Context cost katika tokens pamoja na sehemu ya Will install inayoorodhesha amri, ujuzi, mawakala, hooks, na seva za MCP na LSP unazokaribia kuongeza. Soma zote mbili. Plugin kutoka kwa marketplace za ndani au maalum zinaweza zisitoe data hiyo, ambapo utakuwa unakadiria kwa mkono. Plugin inayojumuisha seva ya MCP kwa kawaida ndiyo nzito zaidi, kwa sababu ufafanuzi wa zana ni mkubwa, ingawa kwenye mifano inayounga mkono utafutaji wa zana za MCP, ufafanuzi huo huahirishwa hadi zana inapohitajika.

Gharama ya uanzishaji (Invocation cost). Kuendesha ujuzi wa plugin huongeza maagizo yake kwenye mazungumzo, kwa hivyo unalipia mwili wa ujuzi huo pale tu unapotumika. Hata hivyo, mwili huo ni sehemu ya bei nafuu, na kile ambacho ujuzi humwambia wakala afanye hakilazimiki kuwa hivyo: mbinu ya Depth Tree ya unlazy skill hutumia karibu tokens zake zote kwenye hatua za ziada inazolazimisha kabla wakala hajaruhusiwa kusema kazi imekamilika, si kwenye faili uliyosakinisha. Wakala ni tofauti. Wakala mdogo (subagent) huendesha mazungumzo yake mwenyewe na prompt yake ya mfumo na cache yake mwenyewe, akianza bila cache hits, kwa hivyo plugin ambayo mtiririko wake wa kazi huzaa mawakala inagharimu zaidi kuliko makadirio yake ya muktadha yanavyopendekeza.

Gharama ya cache (Cache cost). Kuwezesha au kulemaza plugin katikati ya kikao kunaweza kulazimisha ombi linalofuata kuchakata upya mazungumzo yako yote. Ujuzi, amri, mawakala, hooks, seva za LSP, monitors na 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 zitapakia kwenye kiambishi awali cha prompt, ombi linalofuata husoma upya mazungumzo yote kama maudhui ambayo hayajawa 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 statusline maalum inayoonyesha matumizi ya token moja kwa moja huweka zote mbili mbele yako. Kikao chenye afya husoma zaidi kuliko kinachounda. Ikiwa uundaji utabaki juu baada ya hatua nyingine, kuna kitu kwenye kiambishi awali chako kinabadilika kila hatua. Kwa picha pana ya kile kinachojaza dirisha, angalia jinsi ya kudhibiti dirisha la muktadha la Claude Code na nini maana halisi ya idadi hizo za token.

Kipengele kimoja cha utunzaji hujilipia chenyewe. 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 kikao. 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 kufikirika tu. Hooks za plugin huendesha amri za shell wakati wa matukio ya session, ikiwemo kabla na baada ya tool calls. Saraka yake ya bin/ huongezwa kwenye PATH ya Bash tool wakati plugin imewezeshwa. Seva zake za MCP ni michakato (processes) inayozinduliwa na plugin hiyo. Hakuna kitu hapa kilichotengwa (sandboxed) kutoka kwa akaunti yako ya mtumiaji.

Kwenye laptop, hatari hiyo imepakana na kile ambacho mtumiaji wa desktop anaweza kufikia. Kwenye seva, mara nyingi si hivyo. Akaunti inayoendesha 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 uwezo wa agent kabla ya kusakinisha plugin inayowasiliana na huduma ya nje. Harness nyingine hukutana na kikwazo hicho hicho kwenye mashine hiyo hiyo iliyokodishwa, ndiyo maana plugin za DeepSeek Harness zinazofaa kusakinishwa ni zile za kuweka mipaka ya matumizi (spend caps), sheria za ruhusa za tool, na uchunguzi wa injection badala ya uwezo mpya.

Kuna vizuizi (guardrails) vilivyopo, na inasaidia kujua ni vipi. Plugin ya kiwango cha mradi (project-scope) hutoka kwenye repository badala ya kutoka kwako, kwa hivyo hupakiwa tu baada ya kuamini workspace hiyo, seva zake za MCP bado zinahitaji idhini kwa kila seva, seva zake za LSP husubiri idhini hiyo, na monitors zake za nyuma (background monitors) hazipakiwi kabisa. Agent zinazokuja na plugin haziruhusiwi kutangaza hooks, seva za MCP, au mode ya ruhusa. Plugin za soko (marketplace plugins) hunakiliwa kwenye cache huku symlinks zinazoelekeza nje ya soko zikirukwa, hivyo plugin haiwezi kuvuta faili holela za host.

Hakuna kati ya hayo yanayochukua nafasi ya kusoma unachokisakinisha. Angalia orodha ya Will install, pendelea plugin ambazo unaweza kufungua na kusoma source code yake, weka plugin za timu yako kwenye repository ya soko unayoimiliki, na uendeshe claude plugin validate kwenye chochote unachokiandika 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 unapotumika, na inaweza kulazimisha hatua moja ya gharama kubwa isiyohifadhiwa kwenye cache ikiwa inatoa MCP server ambayo zana zake hupakia kwenye kiambishi awali cha prompt. Mwonekano wa kina wa /plugin unaonyesha 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/ wakati ni kwa ajili yako na mradi huu. Skill yenye lengo moja kama Ponytail, ambayo inasukuma 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 wanaihitaji na inahitaji kusasishwa kadiri muda unavyoenda. Plugin skills zina nafasi ya majina (namespaced), 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?

Kagua muhtasari wa usakinishaji kwanza. Ikiwa ilisema Run /reload-plugins to activate., vipengele havijapakiwa bado, na ikiwa upakiaji upya unaonya kuwa utasoma mazungumzo tena, 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 vitu hivyo. Kumbuka kuwa plugin skills zina nafasi ya majina, 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 ya mwingiliano?

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 katika hati, picha, na mazingira yasiyo ya mwingiliano ambapo paneli ya /plugin haipatikani. Kwa sababu inaendeshwa nje ya kikao, kikao ambacho tayari kimefunguliwa kinahitaji /reload-plugins kabla ya plugin kuanza kufanya kazi.

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

Ichukulie kama unavyochukulia kuendesha hati ya usakinishaji ya hazina 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 yakiwa na marupurupu ya mtumiaji wako. Anthropic haidhibiti au kuhakiki maudhui ya plugins za watu wengine. Sakinisha kutoka kwa 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 iliyopo huko kwa kawaida huwa na funguo na token zenye thamani ya kuibiwa.