کشف و نصب pluginهای آماده از طریق مارکت‌پلیس‌ها

Pluginها Claude Code را با skillها، agentها، hookها و MCP serverها گسترش می‌دهند. مارکت‌پلیس‌های plugin کاتالوگ‌هایی هستند که به تو کمک می‌کنند این افزونه‌ها را بدونِ ساختنشان کشف و نصب کنی.

می‌خواهی مارکت‌پلیسِ خودت را بسازی و توزیع کنی؟ ساختن و توزیعِ مارکت‌پلیسِ plugin را ببین.

مارکت‌پلیس‌ها چطور کار می‌کنند

مارکت‌پلیس کاتالوگی از pluginهاست که فردِ دیگری ساخته و به اشتراک گذاشته است. استفاده از یک مارکت‌پلیس فرآیندی دو مرحله‌ای است:

افزودنِ مارکت‌پلیس

این کاتالوگ را نزدِ Claude Code ثبت می‌کند تا بتوانی آنچه در دسترس است را مرور کنی. هنوز هیچ pluginی نصب نشده است.

نصبِ pluginهای جداگانه

کاتالوگ را مرور کن و pluginهایی را که می‌خواهی نصب کن.

مثلِ اضافه‌کردنِ یک فروشگاهِ اپ به آن نگاه کن: افزودنِ فروشگاه به تو دسترسی می‌دهد تا مجموعه‌اش را مرور کنی، اما همچنان خودت انتخاب می‌کنی کدام اپ‌ها را جداگانه دانلود کنی.

مارکت‌پلیسِ رسمیِ Anthropic

مارکت‌پلیسِ رسمیِ Anthropic (claude-plugins-official) وقتی Claude Code را شروع می‌کنی به‌صورت خودکار در دسترس است. /plugin را اجرا کن و به تبِ Discover برو تا آنچه در دسترس است را مرور کنی، یا کاتالوگ را در claude.com/plugins ببین.

برای نصبِ یک plugin از مارکت‌پلیسِ رسمی، از /plugin install <name>@claude-plugins-official استفاده کن. مثلاً برای نصبِ یکپارچه‌سازیِ GitHub:

/plugin install github@claude-plugins-official

اگر Claude Code گزارش داد که plugin در هیچ مارکت‌پلیسی پیدا نمی‌شود، مارکت‌پلیست یا غایب است یا قدیمی. /plugin marketplace update claude-plugins-official را اجرا کن تا تازه‌اش کنی، یا اگر قبلاً اضافه‌اش نکرده‌ای /plugin marketplace add anthropics/claude-plugins-official را اجرا کن. سپس نصب را دوباره امتحان کن.

مارکت‌پلیسِ رسمی چند دسته از pluginها را در بر می‌گیرد:

هوشِ کد (Code intelligence)

pluginهای code intelligence ابزارِ داخلیِ LSP در Claude Code را فعال می‌کنند و به Claude توانایی می‌دهند به تعریف‌ها بپرد، ارجاع‌ها را پیدا کند و بلافاصله پس از ویرایش خطاهای نوع را ببیند. این pluginها اتصال‌های Language Server Protocol را پیکربندی می‌کنند، همان فناوری‌ای که code intelligence در VS Code را به کار می‌اندازد.

این pluginها نیاز دارند که باینریِ language server روی سیستمت نصب باشد. اگر از قبل یک language server نصب داری، Claude ممکن است هنگامِ بازکردنِ یک پروژه نصبِ pluginِ متناظر را پیشنهاد دهد.

زبان	Plugin	باینریِ موردنیاز
C/C++	`clangd-lsp`	`clangd`
C#	`csharp-lsp`	`csharp-ls`
Go	`gopls-lsp`	`gopls`
Java	`jdtls-lsp`	`jdtls`
Kotlin	`kotlin-lsp`	`kotlin-language-server`
Lua	`lua-lsp`	`lua-language-server`
PHP	`php-lsp`	`intelephense`
Python	`pyright-lsp`	`pyright-langserver`
Rust	`rust-analyzer-lsp`	`rust-analyzer`
Swift	`swift-lsp`	`sourcekit-lsp`
TypeScript	`typescript-lsp`	`typescript-language-server`

برای زبان‌های دیگر هم می‌توانی pluginِ LSP خودت را بسازی.

Claude از pluginهای code intelligence چه به دست می‌آورد

وقتی یک pluginِ code intelligence نصب باشد و باینریِ language serverاش در دسترس باشد، Claude دو توانایی به دست می‌آورد:

عیب‌یابیِ خودکار (Automatic diagnostics): پس از هر ویرایشِ فایلی که Claude انجام می‌دهد، language server تغییرات را تحلیل می‌کند و خطاها و هشدارها را به‌صورت خودکار برمی‌گرداند. Claude خطاهای نوع، importهای غایب و مشکل‌های نحوی را بدونِ نیاز به اجرای کامپایلر یا linter می‌بیند. اگر Claude خطایی وارد کند، متوجه می‌شود و در همان نوبت رفعش می‌کند. این جز نصبِ plugin به هیچ پیکربندیِ دیگری نیاز ندارد. می‌توانی diagnosticها را به‌صورت inline ببینی با فشردنِ Ctrl+O وقتی نشانگرِ «diagnostics found» ظاهر می‌شود.
پیمایشِ کد (Code navigation): Claude می‌تواند از language server استفاده کند تا به تعریف‌ها بپرد، ارجاع‌ها را پیدا کند، با hover اطلاعاتِ نوع بگیرد، نمادها را فهرست کند، پیاده‌سازی‌ها را پیدا کند و سلسله‌مراتبِ فراخوانی را ردیابی کند. این عملیات‌ها پیمایشی دقیق‌تر از جست‌وجوی مبتنی بر grep به Claude می‌دهند، هرچند در دسترس‌بودنشان ممکن است بسته به زبان و محیط فرق کند.

اگر به مشکل برخوردی، عیب‌یابیِ code intelligence را ببین.

یکپارچه‌سازی‌های بیرونی

این pluginها MCP serverهای از پیش پیکربندی‌شده را بسته‌بندی می‌کنند تا بتوانی Claude را بدونِ راه‌اندازیِ دستی به سرویس‌های بیرونی متصل کنی:

کنترلِ سورس: github، gitlab
مدیریتِ پروژه: atlassian (Jira/Confluence)، asana، linear، notion
طراحی: figma
زیرساخت: vercel، firebase، supabase
ارتباطات: slack
پایش: sentry

بازبینیِ امنیتیِ خودکار

pluginِ security-guidance هر تغییری را که Claude انجام می‌دهد برای آسیب‌پذیری‌های رایج بازبینی می‌کند و به Claude دستور می‌دهد آنچه پیدا کرده را در همان نشست رفع کند. برای آنچه بررسی می‌کند و نحوه‌ی افزودنِ قواعدِ مخصوصِ پروژه، مشکل‌های امنیتی را همان‌طور که Claude کد می‌نویسد بگیر را ببین.

ورک‌فلوهای توسعه

pluginهایی که برای کارهای رایجِ توسعه skill و agent اضافه می‌کنند:

commit-commands: ورک‌فلوهای commit در Git شامل commit، push و ساختِ PR
pr-review-toolkit: agentهای تخصصی برای بازبینیِ pull requestها
agent-sdk-dev: ابزارهایی برای ساختن با Claude Agent SDK
plugin-dev: جعبه‌ابزار برای ساختنِ pluginهای خودت

سبک‌های خروجی

نحوه‌ی پاسخ‌دهیِ Claude را سفارشی کن:

explanatory-output-style: بینش‌های آموزشی درباره‌ی انتخاب‌های پیاده‌سازی
learning-output-style: حالتِ یادگیریِ تعاملی برای ساختِ مهارت

مارکت‌پلیسِ جامعه

مارکت‌پلیسِ جامعه در anthropics/claude-plugins-community میزبانِ pluginهای شخصِ ثالثی است که اعتبارسنجیِ خودکار و غربالگریِ ایمنیِ Anthropic را پشتِ سر گذاشته‌اند. هر plugin در کاتالوگ به یک commit SHA مشخص پین شده است. برخلافِ مارکت‌پلیسِ رسمی، آن را به‌صورت دستی اضافه می‌کنی:

/plugin marketplace add anthropics/claude-plugins-community

سپس pluginها را از آن با نامِ مارکت‌پلیسِ claude-community نصب کن:

/plugin install <plugin-name>@claude-community

برای ثبتِ pluginِ خودت در مارکت‌پلیسِ جامعه، pluginت را به مارکت‌پلیسِ جامعه ثبت کن در راهنمای ساختِ plugin را ببین.

امتحانش کن: افزودنِ مارکت‌پلیسِ نمایشی

Anthropic یک مارکت‌پلیسِ نمایشیِ pluginها (claude-code-plugins) هم نگه می‌دارد، با pluginهای نمونه که نشان می‌دهند با سیستمِ plugin چه چیزهایی ممکن است. برخلافِ مارکت‌پلیسِ رسمی، باید این یکی را به‌صورت دستی اضافه کنی.

افزودنِ مارکت‌پلیس

از داخلِ Claude Code، دستورِ plugin marketplace add را برای مارکت‌پلیسِ anthropics/claude-code اجرا کن:

/plugin marketplace add anthropics/claude-code

این کاتالوگِ مارکت‌پلیس را دانلود می‌کند و pluginهایش را برایت در دسترس می‌گذارد.

مرورِ pluginهای موجود

/plugin را اجرا کن تا مدیرِ plugin باز شود. این یک رابطِ تب‌دار با چهار تب باز می‌کند که می‌توانی با Tab (یا Shift+Tab برای رفتن به عقب) بینشان بچرخی:

Discover: pluginهای موجود را از همه‌ی مارکت‌پلیس‌هایت مرور کن
Installed: pluginهای نصب‌شده‌ات را ببین و مدیریت کن
Marketplaces: مارکت‌پلیس‌های اضافه‌شده‌ات را اضافه، حذف یا به‌روز کن
Errors: هر خطای بارگذاریِ plugin را ببین

به تبِ Discover برو تا pluginهای مارکت‌پلیسی را که همین الان اضافه کردی ببینی. {/* min-version: 2.1.154 */}وقتی مدیرت آن مارکت‌پلیس را از طریقِ تنظیمِ مدیریت‌شده‌ی pluginSuggestionMarketplaces در فهرستِ مجاز قرار داده باشد، pluginهای علامت‌خورده به‌عنوان مرتبط با دایرکتوریِ کاریِ فعلی‌ات با برچسبِ suggested for this directory بالای فهرست پین می‌شوند.

نصبِ یک plugin

یک plugin را انتخاب کن تا جزئیاتش را ببینی. پنلِ جزئیات نشان می‌دهد plugin شاملِ چیست و چه هزینه‌ای دارد:

{/* min-version: 2.1.143 */}یک برآوردِ Context cost تا ببینی plugin هر نوبت چند توکن به پنجره‌ی کانتکستِ تو اضافه می‌کند (Claude Code نسخه‌ی 2.1.143 و بالاتر)
{/* min-version: 2.1.144 */}تاریخِ Last updated پلاگین (نسخه‌ی 2.1.144 و بالاتر)
{/* min-version: 2.1.145 */}یک بخشِ Will install که دستورها، agentها، skillها، hookها و MCP و LSP serverهای plugin را فهرست می‌کند، تا پیش از نصب دقیقاً ببینی چه چیزی اضافه می‌کند (نسخه‌ی 2.1.145 و بالاتر)

یک دامنه‌ی نصب انتخاب کن:

User scope: برای خودت در همه‌ی پروژه‌ها نصب کن
Project scope: برای همه‌ی همکارانِ این مخزن نصب کن
Local scope: فقط برای خودت در همین مخزن نصب کن

مثلاً commit-commands (یک plugin که skillهای ورک‌فلوِ git اضافه می‌کند) را انتخاب کن و آن را در دامنه‌ی userات نصب کن.

همچنین می‌توانی مستقیم از خطِ فرمان نصب کنی:

/plugin install commit-commands@claude-code-plugins

برای آشناییِ بیشتر با دامنه‌ها، دامنه‌های پیکربندی را ببین.

استفاده از pluginِ جدیدت

پس از نصب، /reload-plugins را اجرا کن تا plugin فعال شود. skillهای plugin با نامِ plugin فضای‌نام‌بندی می‌شوند، پس commit-commands skillهایی مثلِ /commit-commands:commit فراهم می‌کند.

با ایجادِ یک تغییر در یک فایل و اجرای این امتحانش کن:

/commit-commands:commit

این تغییراتت را stage می‌کند، یک پیامِ commit تولید می‌کند و commit را می‌سازد.

هر plugin متفاوت کار می‌کند. جزئیاتِ plugin را در تبِ Discover ببین تا دستورها و skillهایی که فراهم می‌کند را بشناسی، یا برای راهنماییِ استفاده به صفحه‌ی اصلی‌اش سر بزن.

بقیه‌ی این راهنما همه‌ی راه‌هایی را پوشش می‌دهد که می‌توانی مارکت‌پلیس اضافه کنی، plugin نصب کنی و پیکربندی‌ات را مدیریت کنی.

افزودنِ مارکت‌پلیس‌ها

از دستورِ /plugin marketplace add برای افزودنِ مارکت‌پلیس از منابعِ مختلف استفاده کن.

مخزن‌های GitHub: قالبِ owner/repo (مثلاً anthropics/claude-code)
URLهای Git: هر URL مخزنِ git (GitLab، Bitbucket، self-hosted)
مسیرهای محلی: دایرکتوری‌ها یا مسیرهای مستقیم به فایل‌های marketplace.json
URLهای ریموت: URLهای مستقیم به فایل‌های marketplace.json میزبانی‌شده

افزودن از GitHub

یک مخزنِ GitHub که شاملِ یک فایلِ .claude-plugin/marketplace.json است را با قالبِ owner/repo اضافه کن — که در آن owner نامِ کاربری یا سازمانِ GitHub و repo نامِ مخزن است.

مثلاً anthropics/claude-code به مخزنِ claude-code متعلق به anthropics اشاره دارد:

/plugin marketplace add anthropics/claude-code

افزودن از سایر میزبان‌های Git

هر مخزنِ git را با دادنِ URL کامل اضافه کن. این با هر میزبانِ Git کار می‌کند، از جمله GitLab، Bitbucket و سرورهای self-hosted. پسوندِ .git را بگنجان تا Claude Code مخزن را کلون کند، نه اینکه URL را به‌عنوان لینکِ مستقیم به یک marketplace.json میزبانی‌شده تلقی کند.

با HTTPS:

/plugin marketplace add https://gitlab.com/company/plugins.git

با SSH:

/plugin marketplace add git@gitlab.com:company/plugins.git

برای افزودنِ یک شاخه یا تگِ مشخص، یک # و سپس ref را در ادامه بیاور:

/plugin marketplace add https://gitlab.com/company/plugins.git#v1.0.0

افزودن از مسیرهای محلی

یک دایرکتوریِ محلی که شاملِ یک فایلِ .claude-plugin/marketplace.json است را اضافه کن:

/plugin marketplace add ./my-marketplace

همچنین می‌توانی یک مسیرِ مستقیم به فایلِ marketplace.json اضافه کنی:

/plugin marketplace add ./path/to/marketplace.json

افزودن از URLهای ریموت

یک فایلِ marketplace.json ریموت را از طریقِ URL اضافه کن:

/plugin marketplace add https://example.com/marketplace.json

نصبِ pluginها

وقتی مارکت‌پلیس‌ها را اضافه کردی، می‌توانی pluginها را مستقیم نصب کنی (به‌صورت پیش‌فرض در دامنه‌ی user نصب می‌شود):

/plugin install plugin-name@marketplace-name

برای انتخابِ یک دامنه‌ی نصبِ متفاوت، از رابطِ تعاملی استفاده کن: /plugin را اجرا کن، به تبِ Discover برو و روی یک plugin کلیدِ Enter بزن. گزینه‌هایی می‌بینی برای:

User scope (پیش‌فرض): برای خودت در همه‌ی پروژه‌ها نصب کن
Project scope: برای همه‌ی همکارانِ این مخزن نصب کن (به .claude/settings.json اضافه می‌شود)
Local scope: فقط برای خودت در همین مخزن نصب کن (با همکاران به اشتراک گذاشته نمی‌شود)

ممکن است pluginهایی با دامنه‌ی managed هم ببینی — این‌ها را مدیران از طریقِ تنظیماتِ مدیریت‌شده نصب می‌کنند و قابلِ تغییر نیستند.

مدیریتِ pluginهای نصب‌شده

/plugin را اجرا کن و به تبِ Installed برو تا pluginهایت را ببینی، فعال، غیرفعال یا حذف کنی. فهرست بر اساسِ دامنه گروه‌بندی و طوری مرتب شده که مشکل‌ها را اول ببینی: pluginهای دارای خطای بارگذاری یا وابستگی‌های حل‌نشده بالا ظاهر می‌شوند، سپس موردِعلاقه‌هایت، و pluginهای غیرفعال زیرِ یک سرتیترِ جمع‌شده در پایین تا می‌شوند.

از این فهرست می‌توانی:

f را بزنی تا pluginِ انتخاب‌شده را موردِعلاقه کنی یا از موردِعلاقه‌ها برداری
تایپ کنی تا بر اساسِ نام یا توضیحِ plugin فیلتر کنی
Enter را بزنی تا نمای جزئیاتِ یک plugin باز شود و آن را فعال، غیرفعال یا حذف کنی

نمای جزئیات، اجزایی را که plugin اضافه می‌کند نشان می‌دهد: دستورها، skillها، agentها، hookها، MCP serverها و LSP serverها. همین فهرست از خطِ فرمان هم با claude plugin details در دسترس است.

وقتی pluginی نصب می‌کنی که وابستگی اعلام می‌کند، خروجیِ نصب نشان می‌دهد کدام وابستگی‌ها کنارش به‌صورت خودکار نصب شدند.

همچنین می‌توانی pluginها را با دستورهای مستقیم مدیریت کنی.

فهرستِ pluginهای نصب‌شده را بدونِ بازکردنِ منو ببین:

/plugin list

--enabled یا --disabled را بده تا فقط pluginهای آن وضعیت را نشان دهد.

یک plugin را بدونِ حذف، غیرفعال کن:

/plugin disable plugin-name@marketplace-name

یک pluginِ غیرفعال را دوباره فعال کن:

/plugin enable plugin-name@marketplace-name

یک plugin را به‌کلی حذف کن:

/plugin uninstall plugin-name@marketplace-name

گزینه‌ی --scope به تو اجازه می‌دهد با دستورهای CLI یک دامنه‌ی مشخص را هدف بگیری:

claude plugin install formatter@your-org --scope project
claude plugin uninstall formatter@your-org --scope project

اعمالِ تغییراتِ plugin بدونِ restart

وقتی در طولِ یک نشست plugin نصب، فعال یا غیرفعال می‌کنی، /reload-plugins را اجرا کن تا همه‌ی تغییرات بدونِ restart اعمال شوند:

/reload-plugins

Claude Code همه‌ی pluginهای فعال را دوباره بارگذاری می‌کند و شمارشِ pluginها، skillها، agentها، hookها، MCP serverهای plugin و LSP serverهای plugin را نشان می‌دهد.

بارگذاریِ دوباره در درخواستِ بعدی یک هزینه‌ی توکنی دارد: اجزای تازه‌بارگذاری‌شده خود را در محتوایی که به مکالمه افزوده می‌شود معرفی می‌کنند، در حالی که تاریخچه‌ی موجود همچنان از کشِ پرامپت خوانده می‌شود. یک pluginی که MCP server فراهم می‌کند، وقتی ابزارهایش با tool search به تعویق نیفتاده باشند هزینه‌ی بیشتری دارد: این تغییر کش را بی‌اعتبار می‌کند و درخواستِ بعدی کلِ مکالمه را دوباره می‌خواند. {/* min-version: 2.1.163 */}در آن صورت /reload-plugins یک هشدار نشان می‌دهد و بارگذاریِ دوباره را اعمال نمی‌کند؛ --force را بده تا به‌هرحال اعمال شود. برای جزئیات، فعال یا غیرفعال‌کردنِ یک plugin را ببین.

مدیریتِ مارکت‌پلیس‌ها

می‌توانی مارکت‌پلیس‌ها را از طریقِ رابطِ تعاملیِ /plugin یا با دستورهای CLI مدیریت کنی.

استفاده از رابطِ تعاملی

/plugin را اجرا کن و به تبِ Marketplaces برو تا:

همه‌ی مارکت‌پلیس‌های اضافه‌شده‌ات را با منبع و وضعیتشان ببینی
مارکت‌پلیس‌های جدید اضافه کنی
فهرست‌های مارکت‌پلیس را به‌روز کنی تا آخرین pluginها را بگیری
مارکت‌پلیس‌هایی را که دیگر لازم نداری حذف کنی

استفاده از دستورهای CLI

همچنین می‌توانی مارکت‌پلیس‌ها را با دستورهای مستقیم مدیریت کنی.

فهرستِ همه‌ی مارکت‌پلیس‌های پیکربندی‌شده را ببین:

/plugin marketplace list

فهرست‌های plugin را از یک مارکت‌پلیس تازه کن:

/plugin marketplace update marketplace-name

یک مارکت‌پلیس را حذف کن:

/plugin marketplace remove marketplace-name

پیکربندیِ به‌روزرسانی‌های خودکار

Claude Code می‌تواند مارکت‌پلیس‌ها و pluginهای نصب‌شده‌شان را هنگامِ شروع به‌صورت خودکار به‌روز کند. وقتی به‌روزرسانیِ خودکار برای یک مارکت‌پلیس فعال باشد، Claude Code داده‌ی مارکت‌پلیس را تازه می‌کند و pluginهای نصب‌شده را به آخرین نسخه‌هایشان به‌روز می‌کند. اگر pluginی به‌روز شد، یک اعلان می‌بینی که از تو می‌خواهد /reload-plugins را اجرا کنی.

به‌روزرسانیِ خودکار را برای مارکت‌پلیس‌های جداگانه از طریقِ رابط روشن یا خاموش کن:

/plugin را اجرا کن تا مدیرِ plugin باز شود
Marketplaces را انتخاب کن
یک مارکت‌پلیس را از فهرست انتخاب کن
Enable auto-update یا Disable auto-update را انتخاب کن

مارکت‌پلیس‌های رسمیِ Anthropic به‌صورت پیش‌فرض به‌روزرسانیِ خودکار فعال دارند. مارکت‌پلیس‌های شخصِ ثالث و توسعه‌ی محلی به‌صورت پیش‌فرض به‌روزرسانیِ خودکار غیرفعال دارند.

مدیران همچنین می‌توانند روی هر ورودیِ extraKnownMarketplaces در تنظیماتِ مدیریت‌شده مقدارِ "autoUpdate": true را بگذارند تا به‌روزرسانیِ خودکار را برای یک مارکت‌پلیسِ سازمانی فعال کنند، بدونِ اینکه هر کاربر مجبور باشد خودش آن را روشن کند.

برای غیرفعال‌کردنِ کاملِ همه‌ی به‌روزرسانی‌های خودکار هم برای Claude Code و هم همه‌ی pluginها، متغیرِ محیطیِ DISABLE_AUTOUPDATER را تنظیم کن. برای جزئیات، به‌روزرسانی‌های خودکار را ببین.

برای اینکه به‌روزرسانیِ خودکارِ pluginها فعال بماند در حالی که به‌روزرسانیِ خودکارِ Claude Code را غیرفعال می‌کنی، FORCE_AUTOUPDATE_PLUGINS=1 را کنارِ DISABLE_AUTOUPDATER تنظیم کن:

export DISABLE_AUTOUPDATER=1
export FORCE_AUTOUPDATE_PLUGINS=1

این وقتی مفید است که می‌خواهی به‌روزرسانی‌های Claude Code را دستی مدیریت کنی اما همچنان به‌روزرسانی‌های خودکارِ plugin را دریافت کنی.

پیکربندیِ مارکت‌پلیس‌های تیمی

مدیرانِ تیم می‌توانند با افزودنِ پیکربندیِ مارکت‌پلیس به .claude/settings.json، نصبِ خودکارِ مارکت‌پلیس را برای پروژه‌ها راه بیندازند. وقتی اعضای تیم به پوشه‌ی مخزن اعتماد کنند، Claude Code به آن‌ها پیشنهاد می‌دهد این مارکت‌پلیس‌ها و pluginها را نصب کنند.

extraKnownMarketplaces را به .claude/settings.json پروژه‌ات اضافه کن:

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

برای گزینه‌های کاملِ پیکربندی شامل extraKnownMarketplaces و enabledPlugins، تنظیماتِ plugin را ببین.

امنیت

pluginها و مارکت‌پلیس‌ها اجزای به‌شدت مورد اعتمادی هستند که می‌توانند کدِ دلخواه را روی ماشینت با امتیازهای کاربریِ تو اجرا کنند. فقط pluginها را از منابعِ مورد اعتماد نصب و مارکت‌پلیس اضافه کن. سازمان‌ها می‌توانند با محدودیت‌های مارکت‌پلیسِ مدیریت‌شده محدود کنند که کاربران اجازه‌ی افزودنِ کدام مارکت‌پلیس‌ها را دارند.

عیب‌یابی

دستورِ /plugin شناسایی نمی‌شود

اگر «unknown command» می‌بینی یا دستورِ /plugin ظاهر نمی‌شود:

نسخه‌ات را بررسی کن: claude --version را اجرا کن تا ببینی چه چیزی نصب است.
Claude Code را به‌روز کن:
- Homebrew: brew upgrade claude-code (یا brew upgrade claude-code@latest اگر آن cask را نصب کرده بودی)
- npm: npm install -g @anthropic-ai/claude-code@latest
- نصب‌کننده‌ی Native: دستورِ نصب را از Setup دوباره اجرا کن
Claude Code را restart کن: پس از به‌روزرسانی، ترمینالت را restart کن و دوباره claude را اجرا کن.

مشکل‌های رایج

بارگذاری‌نشدنِ مارکت‌پلیس: تأیید کن که URL قابل‌دسترسی است و .claude-plugin/marketplace.json در آن مسیر وجود دارد
شکستِ نصبِ plugin: بررسی کن که URLهای منبعِ plugin قابل‌دسترسی‌اند و مخزن‌ها عمومی‌اند (یا تو دسترسی داری)
یافت‌نشدنِ فایل‌ها پس از نصب: pluginها به یک کش کپی می‌شوند، پس مسیرهایی که به فایل‌های بیرون از دایرکتوریِ plugin ارجاع می‌دهند کار نمی‌کنند
ظاهرنشدنِ skillهای plugin: کش را با rm -rf ~/.claude/plugins/cache پاک کن، Claude Code را restart کن و plugin را دوباره نصب کن.

برای عیب‌یابیِ مفصل همراه با راه‌حل، عیب‌یابی در راهنمای مارکت‌پلیس را ببین. برای ابزارهای دیباگ، ابزارهای دیباگ و توسعه را ببین.

مشکل‌های code intelligence

شروع‌نشدنِ language server: تأیید کن که باینری نصب است و در $PATH تو در دسترس است. تبِ Errors از /plugin را برای جزئیات بررسی کن.
مصرفِ بالای حافظه: language serverهایی مثلِ rust-analyzer و pyright می‌توانند روی پروژه‌های بزرگ حافظه‌ی قابل‌توجهی مصرف کنند. اگر به مشکلِ حافظه برخوردی، plugin را با /plugin disable <plugin-name> غیرفعال کن و به‌جایش به ابزارهای جست‌وجوی داخلیِ Claude اتکا کن.
diagnosticهای مثبتِ کاذب در monorepoها: language serverها ممکن است برای پکیج‌های داخلی خطاهای import حل‌نشده گزارش دهند اگر workspace درست پیکربندی نشده باشد. این‌ها بر توانایی Claude در ویرایشِ کد اثری ندارند.

گام‌های بعدی

pluginهای خودت را بساز: برای ساختِ skill، agent و hook، Plugins را ببین
یک مارکت‌پلیس بساز: برای توزیعِ pluginها به تیم یا جامعه‌ات، ساختِ مارکت‌پلیسِ plugin را ببین
مرجعِ فنی: برای مشخصاتِ کامل، مرجعِ Plugins را ببین