Claude Code plugin কী এবং এর খরচ কত

Claude Code plugin কী

Claude Code plugin হলো এমন একটি directory, যাতে Claude Code একসঙ্গে একটি unit হিসেবে load ও manage করে। এতে skills, agents, hooks, MCP servers, LSP servers এবং background monitors থাকতে পারে। একটি plugin install করলে এর সব অংশ একই সময়ে একটি name-এর অধীনে যোগ হয়। এটি disable করলে একইভাবে সব অংশ সরিয়ে দেওয়া হয়।

একটি plugin agent-কে আগে থেকে থাকা ক্ষমতার বাইরে কোনো নতুন ক্ষমতা দেয় না। plugin-এর প্রতিটি অংশ আপনি নিজে .claude/ directory-তে লিখতে পারেন। plugin হলো packaging layer। এর মাধ্যমে এই অংশগুলোর version পরিচালনা করা যায়, পনেরো জনকে এগুলো দেওয়া যায় এবং পরে সবাইকে file copy করতে না বলেই update করা যায়। মূল ধারণাটি এটাই। plugin নিয়ে অধিকাংশ বিভ্রান্তি তৈরি হয় এগুলোকে নতুন ধরনের capability মনে করলে।

.claude-plugin/plugin.json-এ থাকা optional manifest plugin-এর name নির্ধারণ করে। সেই name-টি namespace হিসেবে ব্যবহৃত হয়। commit-commands নামের plugin-এর একটি skill /commit-commands:commit হিসেবে invoke করা হয়। তাই দুটি plugin-এ একই name-এর commit skill থাকলেও একটি অন্যটিকে shadow করে না। @-mention list-এ plugin agents-ও একইভাবে scoped থাকে, যেমন plugin-name:agent-name।

Plugin, skill, MCP server অথবা rules file

এই চারটি শব্দকে এমনভাবে ব্যবহার করা হয় যেন এগুলো পরস্পরের বিকল্প। আসলে তা নয়। পার্থক্যটি একবার স্পষ্ট করে নেওয়া দরকার।

• একটি skill হলো নির্দেশনার একটি একক অংশ, যা কাজের প্রয়োজন হলে Claude লোড করে। দেখুন Agent Skill আসলে কী।
• একটি MCP server হলো আলাদা একটি process, যা একটি protocol-এর মাধ্যমে agent-এর জন্য tools উন্মুক্ত করে। এটি প্রায়ই আপনার নিজস্বভাবে চালানো একটি network service।
• CLAUDE.md-এর মতো একটি rules file হলো project context, যা session শুরু হওয়ার সময় পড়া হয় এবং সবকিছুর ক্ষেত্রে প্রযোজ্য।
• একটি plugin হলো এমন একটি container, যাতে skills, agents, hooks এবং MCP server definitions একসঙ্গে রাখা যায়। এর সঙ্গে একটি version number এবং distribution channel-ও থাকে।

তাই একটি plugin যে প্রশ্নের উত্তর দেয়, তা হলো না “agent কী করতে পারে”। বরং প্রশ্নটি হলো “আমি কীভাবে এটি আমার team-এর কাছে release করব এবং আগামী মাসে update করব”। আপনি যদি প্রথম তিনটির মধ্যে বেছে নিতে চান, skills, MCP servers এবং rules files-এর তুলনা-তে এই সিদ্ধান্তটি বিস্তারিতভাবে ব্যাখ্যা করা হয়েছে। MCP অংশটি যদি আপনার মূল আগ্রহ হয়, VPS-এ নিজের MCP servers চালানো-তে hosting-এর দিকটি ব্যাখ্যা করা হয়েছে।

প্লাগইন কোথায় থাকে এবং একটির ভেতরে কী থাকে

Marketplace থেকে ইনস্টল করা প্লাগইনটি যেখান থেকে clone করা হয় সেখান থেকে চালানো হয় না; এটি ~/.claude/plugins/cache-এর স্থানীয় cache-এ কপি করা হয়। প্রতিটি ইনস্টল করা version-এর জন্য আলাদা directory তৈরি হয়। আপনি update বা uninstall করলে পুরোনো version-এর directory-কে orphaned হিসেবে চিহ্নিত করা হয় এবং প্রায় দুই সপ্তাহ পরে মুছে ফেলা হয়। ফলে যে session ইতিমধ্যে পুরোনো version লোড করেছে, সেটি কাজের মাঝখানে ব্যর্থ না হয়ে কাজ চালিয়ে যায়।

প্রতিটি update-এর পরে path পরিবর্তিত হয়। তাই কোনো প্লাগইনকে নিজের location কখনো hardcode করা যাবে না। একটি প্লাগইনের ভেতরের hooks ও MCP configs-এ ${CLAUDE_PLUGIN_ROOT} ব্যবহার করতে হবে। এটি বর্তমান install directory-তে resolve হয়। যে state update-এর পরেও রাখতে হবে, তা ${CLAUDE_PLUGIN_DATA}-এ রাখুন। এটি ~/.claude/plugins/data/-এর অধীনে একটি স্থিতিশীল directory-তে resolve হয়।

শুধু প্লাগইনের নিজস্ব directory-ই cache-এ কপি করা হয়। এর একটি গুরুত্বপূর্ণ ফল আছে, যা অনেকে পরে বুঝতে পারেন। ../shared-utils-এর মতো plugin root-এর বাইরের কোনো path local path দিয়ে development করার সময় কাজ করতে পারে, কিন্তু installation-এর পরে ব্যর্থ হয়। কারণ ওই file-গুলো কখনো কপি করা হয়নি।

Layout দেখতে এরকম।

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

শুধু plugin.json, .claude-plugin/-এর ভেতরে থাকবে। অন্য সবকিছু plugin root-এ থাকবে। skills/ বা hooks/-কে .claude-plugin/-এর ভেতরে রাখা হলো এমন প্লাগইন ইনস্টল হওয়ার পর একেবারেই কোনো কাজ না করার সবচেয়ে সাধারণ কারণ। Claude Code root-এ ওই directory-গুলো খোঁজে, কিছুই পায় না, এবং কোনো component ছাড়া প্লাগইন লোড করে।

Manifest-টি নিজেই ছোট।

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

Claude Code plugin কীভাবে ইনস্টল করবেন

ইনস্টল করার প্রক্রিয়ায় দুটি ধাপ আছে। প্রথম ধাপে কোনো plugin ইনস্টল হয় না। আপনি একটি marketplace যোগ করেন, যা plugin-এর catalog। এরপর সেখান থেকে পৃথক plugin ইনস্টল করেন। Anthropic-এর official marketplace, claude-plugins-official, আপনি প্রথমবার Claude Code interactiveভাবে চালু করলে স্বয়ংক্রিয়ভাবে নিবন্ধিত হয়। অন্য marketplace আপনাকেই যোগ করতে হবে।

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

মনে রাখুন, repository হলো anthropics/claude-code, কিন্তু marketplace-এর নাম claude-code-plugins। এই নামটি repository path থেকে নয়, repository-এর ভেতরের catalog file থেকে নেওয়া হয়। তাই install command টাইপ করার আগে /plugin-এর Marketplaces tab থেকে marketplace-এর নাম দেখে নিন।

ইনস্টল শেষ হলে summary line পড়ুন। Plugin is now active. বোঝায়, এই session-এ component-গুলো loaded হয়েছে। Run /reload-plugins to activate. বোঝায়, এগুলো loaded হয়নি এবং আপনাকে ওই command চালাতে হবে। /reload-plugins যদি সতর্ক করে যে conversation আবার পড়া হবে, তাহলে সেটিকে /reload-plugins --force হিসেবে চালান। এরপর plugin সত্যিই আছে কি না নিশ্চিত করুন: /plugin এটি Installed tab-এর অধীনে দেখায়, /help এর skill-গুলো Custom commands-এর অধীনে তালিকাভুক্ত করে, এবং load হতে ব্যর্থ হওয়া যেকোনো কিছু কারণসহ Errors tab-এর অধীনে দেখা যায়।

ইনস্টল করার সময় একটি scope নির্বাচন করতে হয়। এই scope নির্ধারণ করে কারা plugin ব্যবহার করবে। User scope হলো আপনি, সব project-এ। Project scope plugin-টি repository-এর .claude/settings.json-এর ভেতরে enabledPlugins-এ লেখে, তাই repository clone করা সবাইকে এটি ইনস্টল করার প্রস্তাব দেওয়া হয়। Local scope হলো আপনি, শুধু এই repository-তে।

Script, Dockerfile অথবা interactive panel নেই এমন যেকোনো session-এর জন্য shell form ব্যবহার করুন। আপনি --scope পাস না করলে এটি user scope-এ ইনস্টল হয়।

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

claude plugin install কোনো session-এর বাইরে চলে। তাই ইতিমধ্যে খোলা session নতুন plugin দেখতে পাবে না, যতক্ষণ না আপনি /reload-plugins চালান বা নতুন session শুরু করেন।

আপনার ইনস্টল করা plugin পরিচালনার পদ্ধতি দুই জায়গাতেই একই। /plugin list ইনস্টল করা plugin-গুলোর তালিকা দেখায় এবং --enabled বা --disabled গ্রহণ করে। /plugin disable name@marketplace plugin না মুছে সেটি বন্ধ করে, /plugin enable আবার চালু করে, এবং /plugin uninstall এটি সরিয়ে দেয়। Slash-command form-গুলো পরিবর্তন প্রয়োগ করতে plugin panel খোলে। তাই script-এ claude plugin ... shell equivalent ব্যবহার করতে হবে।

পুরো team-এর জন্য কোনো marketplace দিতে চাইলে সেটিকে project-এর .claude/settings.json-এ রাখুন। Members repository folder-টিকে trust করার পর marketplace-টি একবার ইনস্টল করার prompt পাবে।

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

নিজের plugin তৈরি করার সময় marketplace সম্পূর্ণ এড়িয়ে চলুন। claude --plugin-dir ./my-plugin ওই session-এর জন্য একটি directory load করে, /reload-plugins restart ছাড়াই আপনার edit গ্রহণ করে, এবং claude plugin validate ./my-plugin manifest, skill ও agent frontmatter এবং hooks/hooks.json যাচাই করে, অন্য কেউ এটি ব্যবহারের আগে।

Claude Code plugin-এর খরচ কত?

প্রক্রিয়াটি বিনামূল্যের। August 2026 পর্যন্ত marketplace যোগ করা, plugin install করা বা কোনো plugin enabled রাখা—কোনোটির জন্যই আলাদা charge নেই। Official ও community marketplace-গুলো public git repository, আর একটি plugin হলো text file-এর একটি directory।

Plugin-এর প্রকৃত খরচ token-এ মাপা হয়। আপনার subscription usage বা API bill-ও মূলত token ব্যবহারের হিসাব করে। এই খরচ 3ভাবে আসে, এবং প্রতিটির আচরণ আলাদা।

স্থায়ী context খরচ। কোনো plugin যে content যোগ করে, তা আপনার context-এ থাকে এবং session-এর প্রতিটি turn-এ আবার পড়া হয়। Install করার আগে /plugin detail view-তে token হিসেবে একটি Context cost estimate এবং একটি Will install section দেখায়। সেখানে আপনি যে commands, skills, agents, hooks এবং MCP ও LSP servers যোগ করতে চলেছেন, সেগুলোর তালিকা থাকে। দুটিই পড়ুন। Local বা custom marketplace-এর plugin-এ এই data নাও থাকতে পারে। সে ক্ষেত্রে আপনাকে নিজেই আনুমানিক হিসাব করতে হবে। কোনো plugin-এর সঙ্গে MCP server থাকলে সেটি সাধারণত সবচেয়ে ভারী হয়, কারণ tool definition বড় হয়। তবে MCP tool search সমর্থনকারী model-এ কোনো tool প্রয়োজন না হওয়া পর্যন্ত সেই definition load করা হয় না।

Invocation খরচ। কোনো plugin-এর skill চালালে তার instruction conversation-এ যুক্ত হয়। তাই skill body ব্যবহারের সময়ই শুধু এর জন্য খরচ হয়। Agent আলাদা। একটি subagent নিজের system prompt এবং নিজের cache-সহ পৃথক conversation চালায়। এটি কোনো cache hit ছাড়াই শুরু হয়। তাই যে plugin-এর workflow agent চালু করে, তার খরচ context estimate-এর তুলনায় অনেক বেশি হতে পারে।

Cache খরচ। Session চলাকালে plugin enable বা disable করলে পরবর্তী request-এ পুরো conversation আবার process করতে হতে পারে। Skills, commands, agents, hooks, LSP servers, monitors এবং themes কখনো এমন করে না। এগুলো যে content যোগ করে, তা existing history-এর পরে যুক্ত হয়। ফলে পরবর্তী request-এ নতুন content-এর জন্য খরচ হয়, কিন্তু তার আগের সবকিছু cache থেকে পড়া হয়। ব্যতিক্রম হলো MCP server সরবরাহকারী plugin। Tool search-এর মাধ্যমে এর tools deferred থাকলে cache বজায় থাকে। কিন্তু tools prompt prefix-এ load হলে পরবর্তী request পুরো conversation-কে uncached input হিসেবে আবার পড়ে। এই কারণেই /reload-plugins সতর্ক করে এবং সেই অবস্থায় কাজটি প্রত্যাখ্যান করে, যতক্ষণ না আপনি --force pass করেন।

অনুমান না করে আপনি এটি পর্যবেক্ষণ করতে পারেন। প্রতিটি API response-এ cache_read_input_tokens এবং cache_creation_input_tokens report করা হয়। একটি live token usage দেখানো custom statusline দুটিই আপনার সামনে রাখে। একটি স্বাভাবিক session-এ তৈরি হওয়া token-এর তুলনায় অনেক বেশি token পড়া হয়। যদি turn-এর পর turn creation বেশি থাকে, তাহলে আপনার prefix-এর কোনো content প্রতিটি turn-এ পরিবর্তিত হচ্ছে। Context window-এ কী কী content জায়গা নিচ্ছে, তার বিস্তৃত ধারণার জন্য Claude Code context window কীভাবে পরিচালনা করবেন এবং ওই token count-এর প্রকৃত অর্থ কী দেখুন।

একটি housekeeping কাজ নিয়মিত করলে লাভ হয়। Installed tab-এ অন্তত দুই সপ্তাহ ব্যবহার না করা plugin-গুলো Not used recently header-এর অধীনে group করা হয়। Detail view-তে Last used line-ও দেখানো হয়। এসব plugin প্রতিটি session-এ startup time এবং context ব্যবহার করে। এগুলো disable বা uninstall করুন।

একটি plugin আপনার permissions-এ চলে

Anthropic-এর নিজস্ব documentation এ বিষয়ে স্পষ্ট: plugin এবং marketplace অত্যন্ত trusted component, যেগুলো আপনার user privilege ব্যবহার করে মেশিনে arbitrary code চালাতে পারে। এটি কেবল hypothetical বিষয় নয়। কোনো plugin-এর hook session event-এ shell command চালায়, যার মধ্যে tool call-এর আগে ও পরে চালানো event-ও রয়েছে। plugin enabled থাকলে তার bin/ directory Bash tool-এর PATH-এ যোগ হয়। এর MCP server-গুলো plugin নিজেই চালু করা process। এর কোনোটিই আপনার user account থেকে sandbox করা নয়।

একটি laptop-এ এই ঝুঁকি desktop user যে resource-গুলোতে পৌঁছাতে পারে, সাধারণত সেখানেই সীমাবদ্ধ থাকে। Server-এ সাধারণত তা নয়। Agent চালানো account-এ প্রায়ই SSH key, deploy token, cloud CLI session এবং Docker socket-এর access থাকে। তাই “আপনার user হিসেবে arbitrary code” চালানোর অর্থ বাস্তবে পুরো machine-এ code চালানোর ক্ষমতা। Claude Code কোনো VPS-এ চললে কিছু install করার আগে VPS-এ Claude Code নিরাপদে চালানোর পদ্ধতি পড়ুন। External service-এর সঙ্গে যোগাযোগ করে এমন plugin install করার আগে agent-এর নাগালের বাইরে credential রাখার পদ্ধতি পড়ুন।

কিছু guardrail আছে, এবং কোনগুলো কী কাজ করে তা জানা সহায়ক। Project-scope plugin আপনার কাছ থেকে নয়, repository থেকে আসে। তাই workspace-এ trust স্থাপন করার পরেই এটি load হয়। এর MCP server-গুলোর জন্য এখনও প্রতিটি server-এর আলাদা approval প্রয়োজন। এর LSP server-গুলোও সেই trust না পাওয়া পর্যন্ত অপেক্ষা করে। তবে এর background monitor একেবারেই load হয় না। Plugin-এর সঙ্গে সরবরাহ করা agent-গুলো hook, MCP server বা permission mode declare করতে পারে না। Marketplace plugin cache-এ copy করার সময় marketplace-এর বাইরে নির্দেশ করা symlink বাদ দেওয়া হয়। তাই কোনো plugin arbitrary host file অন্তর্ভুক্ত করতে পারে না।

তবুও আপনি যা install করছেন তা পড়ার বিকল্প নেই। Will install list পরীক্ষা করুন। যে plugin-এর source আপনি খুলে পড়তে পারেন, সেগুলো অগ্রাধিকার দিন। আপনার দলের plugin এমন একটি marketplace repository-তে রাখুন যা আপনি নিয়ন্ত্রণ করেন। নিজে লেখা যেকোনো কিছুর ওপর claude plugin validate চালান।

FAQ

Claude Code plugin-এর জন্য কি অতিরিক্ত অর্থ লাগে?

না। Plugin system, marketplace যোগ করা বা plugin install করার জন্য কোনো fee নেই। খরচ হয় token usage-এর জন্য, যা অন্য যেকোনো context-এর মতো আপনার plan বা API spend-এর বিপরীতে billed হয়। প্রতিটি turn-এ একটি plugin স্থায়ী context যোগ করে। এর কোনো skill বা agent invoke করলে আরও context যোগ হয়। Plugin এমন একটি MCP server প্রদান করলে, যার tools prompt prefix-এ load হয়, একটি ব্যয়বহুল uncached turn বাধ্যতামূলকভাবে চালু হতে পারে। Install করার আগে /plugin detail view-তে Context cost estimate দেখা যায়।

Plugin এবং skill-এর মধ্যে পার্থক্য কী?

Skill হলো instruction-এর একটি একক unit। Plugin হলো এমন একটি package, যাতে skill, agent, hook, MCP server, LSP server এবং monitor থাকতে পারে। এর সঙ্গে একটি name, version এবং install করার marketplace থাকে। কোনো skill শুধু আপনার এবং এই project-এর জন্য হলে সেটি .claude/-এ standalone skill হিসেবে লিখুন। Ponytail, যা agent-কে কার্যকর সবচেয়ে ছোট পরিবর্তনের দিকে পরিচালিত করে-এর মতো single-purpose skill এর স্পষ্ট উদাহরণ। এতে একটি rule-সহ একটি file থাকে, যতক্ষণ না আপনার team-ও এটি ব্যবহার করতে চায়। অন্যদের এটি প্রয়োজন হলে এবং সময়ের সঙ্গে update করতে হলে সেটিকে plugin-এ রূপান্তর করুন। Plugin-এর skill-গুলো namespaced হয়। তাই plugin-এর ভেতরের একটি skill /plugin-name:skill-name হিসেবে invoke হয়, /skill-name হিসেবে নয়।

আমার plugin install হয়েছে, কিন্তু এর skill দেখা যাচ্ছে না। সমস্যা কী?

প্রথমে install summary পরীক্ষা করুন। সেখানে Run /reload-plugins to activate. লেখা থাকলে component-গুলো এখনো load হয়নি। Reload করার সময় conversation আবার read করার warning দিলে সেটি /reload-plugins --force হিসেবে rerun করুন। Load হওয়ার পরও কিছু দেখা না গেলে /plugin খুলে Errors tab পড়ুন। সবচেয়ে সাধারণ structural mistake হলো skills/, agents/ বা hooks/-কে .claude-plugin/-এর ভেতরে রাখা। Claude Code সেখানে এগুলো খোঁজে না। মনে রাখবেন, plugin skill namespaced হয়। তাই /help-এর Custom commands tab-এ /plugin-name:skill-name খুঁজতে হবে। শেষ উপায় হিসেবে rm -rf ~/.claude/plugins/cache চালান, restart করুন এবং reinstall করুন।

Interactive panel ছাড়া কি plugin install করা যায়?

হ্যাঁ। claude plugin install name@marketplace shell command ব্যবহার করুন। --scope project বা --scope local pass না করলে এটি user scope-এ install করে। /plugin panel অনুপস্থিত এমন script, image এবং non-interactive environment-এও এটি কাজ করে। এটি session-এর বাইরে চলে। তাই আগে থেকেই খোলা session-এ plugin কার্যকর করতে /reload-plugins প্রয়োজন।

GitHub-এ পাওয়া কোনো marketplace থেকে plugin install করা কি নিরাপদ?

নিজের account দিয়ে ওই repository-র install script চালানোর মতোই এটিকে বিবেচনা করুন, কারণ বাস্তবে বিষয়টি তার কাছাকাছি। Plugin hook-এর মাধ্যমে shell command চালাতে পারে, Bash tool-এর PATH-এ executable যোগ করতে পারে এবং MCP server চালু করতে পারে—সবই আপনার user privilege দিয়ে। Anthropic third-party plugin-এর content নিয়ন্ত্রণ বা যাচাই করে না। আপনি যে source পড়তে পারেন সেখান থেকে install করুন। Confirm করার আগে Will install list পর্যালোচনা করুন। Laptop-এর তুলনায় server-এ আরও কঠোর সতর্কতা অবলম্বন করুন, কারণ server-এর account-এ সাধারণত চুরি করার মতো গুরুত্বপূর্ণ key এবং token থাকে।