پلاگین Claude Code چیست و چه هزینهای دارد؟
با ساختار پلاگینهای Claude Code و نحوه مدیریت مهارتها، سرورهای MCP و LSP آشنا شوید. هزینه استفاده از این ابزارها رایگان است و تنها هزینه مصرف توکن برای پردازش محتواست.
پلاگین Claude Code چیست
یک پلاگین Claude Code شامل یک دایرکتوری از مؤلفهها است که Claude Code آنها را به عنوان یک واحد یکپارچه بارگذاری و مدیریت میکند. مؤلفههای اصلی شامل مهارتها (skills)، عاملها (agents)، هوکها (hooks)، سرورهای MCP، سرورهای LSP و مانیتورهای پسزمینه هستند. یک پلاگین همچنین میتواند شامل دستورات، استایلهای خروجی، تمها، گردشهای کاری و یک دایرکتوری bin/ از فایلهای اجرایی باشد. نصب یک پلاگین، تمامی بخشهای آن را به صورت یکجا و تحت یک نام اضافه میکند و غیرفعال کردن آن نیز به همان شیوه، تمامی بخشها را حذف مینماید.
یک پلاگین در اکثر موارد، قابلیتی فراتر از آنچه عامل (agent) از قبل داشته است به آن نمیدهد. مهارتها، عاملها، هوکها و سرورهای MCP همگی مواردی هستند که میتوانید بهصورت دستی در یک دایرکتوری .claude/ بنویسید. استثنائات شامل سرورهای زبان برای هوش کدنویسی و mods هستند که Claude Code آنها را فقط از طریق پلاگین بارگذاری میکند. برای سایر موارد، پلاگین نقش لایه بستهبندی را ایفا میکند: روشی برای نسخهبندی آن بخشها، تحویل آنها به پانزده نفر و بهروزرسانی بعدی بدون نیاز به اینکه از کسی بخواهید فایلها را کپی کند. ایده اصلی همین است و بیشتر سردرگمیها درباره پلاگینها ناشی از این انتظار است که آنها نوع جدیدی از قابلیتها باشند.
فایل manifest اختیاری در .claude-plugin/plugin.json، نام پلاگین را تعیین میکند و آن نام به یک فضای نام (namespace) تبدیل میشود. یک مهارت در پلاگینی به نام commit-commands با دستور /commit-commands:commit فراخوانی میشود؛ بنابراین دو پلاگین میتوانند هر کدام مهارتی به نام commit داشته باشند بدون اینکه یکی دیگری را بپوشاند. عاملهای پلاگین نیز در لیست @-mention به همان صورت و با فرمت plugin-name:agent-name محدود میشوند.
افزونه، skill، سرور MCP یا فایل rules
این چهار اصطلاح گاهی چنان به کار میروند که گویی با یکدیگر رقابت دارند. چنین نیست و بهتر است یک بار مرز میان آنها را مشخص کنیم.
- یک skill واحدی از دستورالعملهاست که Claude هنگام نیاز وظیفه آن را بارگذاری میکند. به تعریف واقعی Agent Skill مراجعه کنید.
- یک سرور MCP فرایندی جداگانه است که ابزارها را از طریق یک پروتکل در اختیار agent قرار میدهد؛ این فرایند اغلب یک سرویس شبکهای است که خودتان اجرا میکنید.
- یک فایل rules مانند
CLAUDE.mdبخشی از context پروژه است که در شروع session خوانده میشود و بر همهچیز اعمال میشود. - یک plugin دایرکتوریای شامل skillها، agentها، hookها، سرورهای MCP یا اجزای دیگر است که Claude Code آن را بهعنوان یک واحد نصب و بارگذاری میکند. manifest اختیاری آن نام plugin را مشخص میکند و میتواند version، description و metadataهای دیگری اضافه کند. توزیع بخشی از plugin نیست: marketplace یک catalog جداگانه است که pluginها و محل دریافت هرکدام را فهرست میکند.
بنابراین پرسشی که یک plugin به آن پاسخ میدهد این نیست که «agent چه کاری میتواند انجام دهد». پرسش این است که «چگونه این را برای تیم خود منتشر کنم و ماه آینده بهروزرسانی کنم». اگر بین سه مورد اول تصمیم میگیرید، مقایسه skillها، سرورهای MCP و فایلهای rules این تصمیم را با جزئیات پوشش میدهد. اگر بخش MCP برای شما اهمیت دارد، اجرای سرورهای MCP خودتان روی یک VPS جنبه میزبانی را توضیح میدهد.
محل قرارگیری افزونهها و محتویات آنها
بیشتر افزونههای marketplace در یک کش محلی در مسیر ~/.claude/plugins/cache کپی میشوند و برای هر نسخهٔ نصبشده، یک دایرکتوری جداگانه ایجاد میشود. افزونههایی که از مسیر محلی به marketplace اضافه شدهاند (relative-path)، در همان محل اصلی بارگذاری میشوند و افزونههای command-source در حالت link، از طریق لینک به دایرکتوری منبع خود فراخوانی میشوند. هنگامی که یک افزونهٔ کپیشده را بهروزرسانی یا حذف میکنید، دایرکتوری نسخهٔ قدیمی بهعنوان orphaned (یتیم) علامتگذاری شده و حدود دو هفته بعد حذف میشود؛ این کار باعث میشود نشستهایی که نسخهٔ قدیمی را بارگذاری کردهاند، بهجای مواجهه با خطا در حین کار، به فعالیت خود ادامه دهند. عملیات پاکسازی تنها زمانی اجرا میشود که حداقل یک افزونه نصب باشد؛ پس از حذف آخرین افزونه، دایرکتوریهای orphaned تا زمانی که افزونهٔ دیگری نصب نکنید، باقی میمانند.
از آنجا که مسیر یک افزونهٔ کپیشده با هر بهروزرسانی تغییر میکند، افزونه نباید هرگز موقعیت خود را بهصورت hardcode در کد قرار دهد. هوکها و پیکربندیهای MCP در داخل افزونه از ${CLAUDE_PLUGIN_ROOT} استفاده میکنند که به دایرکتوری نصب فعلی اشاره دارد. دادههایی که باید پس از بهروزرسانی باقی بمانند، باید در ${CLAUDE_PLUGIN_DATA} ذخیره شوند که به یک دایرکتوری ثابت در زیرمجموعهٔ ~/.claude/plugins/data/ اشاره میکند.
برای یک افزونهٔ کپیشده، تنها دایرکتوری خودِ افزونه در کش کپی میشود (بهجز اهداف symlink در همان marketplace که در محل کپی میشوند). اسکریپتی که مسیری خارج از ریشهٔ افزونه (مانند ../shared-utils) را میخواند، هنگام توسعه با مسیر محلی کار میکند اما پس از کپی شدن افزونه در کش از کار میافتد، زیرا آن فایلها هرگز کپی نشدهاند. مسیری از کامپوننت که به این شکل در plugin.json تعریف شده باشد، سریعتر دچار خطا میشود: Claude Code هر مسیر کامپوننتی که از ریشهٔ افزونه خارج شود را حتی در زمان توسعه با خطای path escapes plugin directory رد میکند.
ساختار فایلها به این صورت است:
my-plugin/
├── .claude-plugin/
│ └── plugin.json
├── skills/
│ └── code-review/
│ └── SKILL.md
├── agents/
├── hooks/
│ └── hooks.json
├── .mcp.json
└── bin/فقط plugin.json باید در داخل .claude-plugin/ قرار بگیرد. سایر موارد در ریشهٔ افزونه قرار دارند. قرار دادن skills/ یا hooks/ در داخل .claude-plugin/ رایجترین دلیل برای این است که افزونه بهدرستی نصب میشود اما هیچ کاری انجام نمیدهد: Claude Code این دایرکتوریها را در ریشه جستجو میکند، چیزی نمییابد و افزونه را بدون هیچ کامپوننتی بارگذاری میکند.
فایل manifest بهخودیخود کوچک است.
{
"name": "my-first-plugin",
"description": "A greeting plugin to learn the basics",
"version": "1.0.0"
}نحوه نصب افزونه Claude Code
نصب در دو مرحله انجام میشود و مرحله اول در واقع چیزی را نصب نمیکند. شما ابتدا یک marketplace (فروشگاه) را اضافه میکنید که کاتالوگی از افزونههاست و سپس افزونههای مورد نظر خود را از آن نصب میکنید. marketplace رسمی Anthropic یعنی claude-plugins-official، اولین باری که Claude Code را بهصورت تعاملی اجرا میکنید برای شما ثبت میشود، مگر اینکه سیاستهای مدیریتی یا CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL مانع آن شوند. سایر فروشگاهها را باید خودتان اضافه کنید.
/plugin marketplace add anthropics/claude-plugins-official
/plugin install commit-commands@claude-plugins-officialنام marketplace از فایل کاتالوگ داخل مخزن (repository) گرفته میشود، نه از مسیر مخزن؛ بنابراین پیش از تایپ دستور نصب، نام marketplace را از تب Marketplaces در /plugin بخوانید. marketplace قدیمی claude-code-plugins در anthropics/claude-code منسوخ شده است؛ برای نصبهای جدید از claude-plugins-official استفاده کنید. افزونههای موجود از آن marketplace قدیمی، از مخزن رسمی بهروزرسانی میشوند، بنابراین برای تغییر marketplace نیازی به نصب مجدد commit-commands ندارید.
پس از نصب، خط خلاصه را بخوانید. Plugin is now active. به این معنی است که مؤلفهها در این نشست (session) بارگذاری شدهاند. Run /reload-plugins to apply. به این معنی است که آنها در حین نصب فعال نشدهاند؛ پنل بسته میشود و Claude Code آن بارگذاری مجدد را برای شما انجام میدهد. اگر بارگذاری مجدد هشدار دهد که مکالمه را دوباره میخواند، افزونه را در حالت معلق باقی میگذارد و شما باید آن را با دستور /reload-plugins --force دوباره اجرا کنید. سپس تأیید کنید که افزونه واقعاً وجود دارد: /plugin آن را در تب Installed نشان میدهد، تایپ / مهارتهای آن را به عنوان /plugin-name:skill-name فهرست میکند و هر چیزی که در بارگذاری شکست خورده باشد، در تب Errors به همراه دلیل آن نمایش داده میشود.
نصب، یک scope (دامنه) درخواست میکند و این دامنه تعیین میکند چه کسی به افزونه دسترسی داشته باشد. دامنه User (کاربر) یعنی شما، در هر پروژهای. دامنه Project (پروژه) افزونه را در فایل .claude/settings.json مخزن تحت enabledPlugins مینویسد که باعث میشود برای هر کسی که مخزن را clone میکند، فعال شود. این کار افزونه را برای آنها دانلود نمیکند: هر همکار همچنان باید آن را یکبار روی دستگاه خود نصب کند، برای مثال با claude plugin install name@marketplace --scope project، مگر اینکه ورودی marketplace آن یک مسیر نسبی باشد یا یک دایرکتوری seed از قبل آن را داشته باشد. دامنه Local (محلی) یعنی شما، فقط در همین مخزن.
برای یک اسکریپت، یک Dockerfile یا هر نشستی که پنل تعاملی در دسترس نیست، از فرم shell استفاده کنید. این دستور در دامنه User نصب میشود مگر اینکه --scope را ارسال کنید. روی دستگاهی که هنوز کسی نشست تعاملی را باز نکرده است، marketplace رسمی ثبت نشده است، بنابراین ابتدا آن را اضافه کنید.
claude plugin marketplace add anthropics/claude-plugins-official
claude plugin install commit-commands@claude-plugins-official --scope project
claude plugin listclaude plugin install خارج از یک نشست اجرا میشود، بنابراین نشستی که از قبل باز است، افزونه جدید را نمیبیند مگر اینکه /reload-plugins را اجرا کنید یا یک نشست جدید شروع کنید.
مدیریت آنچه دارید در هر دو حالت از یک الگو پیروی میکند. /plugin list موارد نصبشده را چاپ میکند و --enabled یا --disabled را میپذیرد. /plugin disable name@marketplace یک افزونه را بدون حذف کردن غیرفعال میکند، /plugin enable آن را دوباره فعال میکند و /plugin uninstall آن را حذف میکند. فرمهای slash-command پنل افزونه را برای اعمال تغییرات باز میکنند، به همین دلیل است که معادلهای shell یعنی claude plugin ... برای استفاده در اسکریپتها مناسبتر هستند.
برای ارائه یک marketplace به کل تیم، آن را در فایل .claude/settings.json پروژه قرار دهید یا یکبار claude plugin marketplace add your-org/claude-plugins --scope project را اجرا کرده و فایلی که مینویسد را commit کنید. Claude Code به محض اینکه اعضا به پوشه مخزن اعتماد کنند، marketplace را برای هر کدام ثبت میکند.
{
"extraKnownMarketplaces": {
"my-team-tools": {
"source": {
"source": "github",
"repo": "your-org/claude-plugins"
}
}
}
}هنگامی که در حال ساخت افزونه خود هستید، marketplace را کاملاً نادیده بگیرید. claude --plugin-dir ./my-plugin یک دایرکتوری را برای آن نشست بارگذاری میکند، /reload-plugins ویرایشهای شما را بدون نیاز به راهاندازی مجدد اعمال میکند و claude plugin validate ./my-plugin پیش از اینکه کس دیگری آن را ببیند، manifest، مهارت، frontmatter عامل و hooks/hooks.json را بررسی میکند. برای اشتراکگذاری افزونه نیز نیازی به marketplace نیست: میتوانید پوشه یا یک .zip از آن را برای کسی بفرستید تا با --plugin-dir بارگذاری کند، هرچند تا زمانی که نسخه جدیدی برای آنها نفرستید، بهروزرسانی دریافت نخواهند کرد.
هزینه افزونههای Claude Code چقدر است؟
مکانیسم استفاده از افزونهها رایگان است. تا نوامبر 2026، هیچ هزینهای برای افزودن یک مارکتپلیس، نصب افزونه یا فعال نگهداشتن آن دریافت نمیشود. مارکتپلیسهای رسمی و اجتماعی، مخازن عمومی git هستند و هر افزونه در واقع یک دایرکتوری از فایلهای متنی است.
هزینه واقعی یک افزونه با توکن (token) محاسبه میشود و توکنها همان چیزی هستند که میزان مصرف اشتراک یا صورتحساب API شما را تعیین میکنند. اینکه یک افزونه از کدامیک از این دو منبع مصرف میکند، به نحوه پرداخت شما برای ابزار بستگی دارد. در هزینه Claude Code در طرحهای مختلف، سطوح اشتراک در کنار قیمتگذاری API بر اساس هر توکن توضیح داده شده است. این هزینه به سه روش مختلف اعمال میشود که رفتار متفاوتی دارند.
هزینه کانتکست ثابت (Standing context cost). هر افزونه فعال، نام و توضیحات مهارتها، ایجنتها و دستوراتی که Claude میتواند بهطور مستقل فراخوانی کند را به کانتکست شما اضافه میکند. این بخش در هر نوبت از نشست (session) بازخوانی میشود، فارغ از اینکه چیزی اجرا شود یا خیر. همه اجزا هزینه توکن ندارند: یک hook توسط harness اجرا میشود و چیزی به کانتکست مدل اضافه نمیکند. پیش از نصب، نمای جزئیات /plugin بخشی با عنوان Will install را نشان میدهد که دستورات، مهارتها، ایجنتها، hookها و سرورهای MCP و LSP که قصد افزودن آنها را دارید، فهرست میکند. برای افزونههای موجود در مارکتپلیس رسمی Anthropic، بخشی با عنوان Context cost نیز نمایش داده میشود که شامل برآوردهای Every turn و When invoked است؛ به شرطی که افزونه را از طریق نام آن در مارکتپلیس یا از تب Marketplaces باز کنید (نه از لیست Discover). هر دو را مطالعه کنید. افزونهای که از مارکتپلیس خودتان یا شخص ثالث باشد، بخش Context cost ندارد، اما نیازی نیست دستی محاسبه کنید: دستور claude plugin details name در شل شما، یک رقم توکن Always-on و تفکیک هزینهها به تفکیک هر جزء را برای هر افزونه بارگذاریشده چاپ میکند (از جمله افزونهای که با --plugin-dir ارسال میکنید). بنابراین میتوانید یک مخزن را clone کرده و پیش از نصب هر چیزی، claude --plugin-dir ./that-plugin plugin details that-plugin را اجرا کنید. این رقم شامل سرورهای MCP نمیشود. افزونهای که یک سرور MCP را بستهبندی میکند معمولاً سنگینترین نوع است، زیرا تعاریف ابزارها حجیم هستند؛ هرچند در مدلهایی که از جستجوی ابزار MCP پشتیبانی میکنند، این تعاریف تا زمانی که به ابزار نیاز نباشد، به تعویق میافتند. در نشستی که افزونه در آن فعال است، /context را اجرا کرده و خط MCP tools را بخوانید تا ببینید چه چیزی اضافه میکنند.
هزینه فراخوانی (Invocation cost). اجرای مهارت یک افزونه، دستورالعملهای آن را به گفتگو اضافه میکند، بنابراین شما فقط زمانی هزینه بدنه مهارت را میپردازید که از آن استفاده شود. البته بدنه مهارت بخش ارزان ماجراست و آنچه مهارت به ایجنت میگوید انجام دهد، لزوماً ارزان نیست: روش Depth Tree در مهارت unlazy تقریباً تمام توکنهای خود را صرف بررسیهای اضافی میکند که پیش از اجازه دادن به ایجنت برای اعلام پایان کار، اعمال میکند، نه صرف فایلی که نصب کردهاید. ایجنت متفاوت است. یک زیر-ایجنت (subagent) گفتگوی خاص خود را با system prompt و کش مخصوص خود اجرا میکند و بدون هیچ cache hit شروع میشود؛ بنابراین افزونهای که گردش کار آن ایجنتهایی را ایجاد میکند، هزینه بسیار بیشتری نسبت به برآورد کانتکست آن دارد.
هزینه کش (Cache cost). فعال یا غیرفعال کردن یک افزونه در میانه نشست میتواند باعث شود درخواست بعدی، کل گفتگوی شما را دوباره پردازش کند. مهارتها، دستورات، ایجنتها، hookها، مانیتورها و تمها هرگز این کار را نمیکنند: آنچه آنها اضافه میکنند به انتهای تاریخچه موجود ضمیمه میشود، بنابراین درخواست بعدی هزینه محتوای جدید را میپردازد و همچنان همه چیز پیش از آن را از کش میخواند. استثنا، افزونهای است که سرور MCP ارائه میدهد یا افزونه هوش کدنویسی که language server آن، ابزار LSP را به Claude میدهد. برای MCP، موضوع به جستجوی ابزار بستگی دارد: اگر ابزارها به تعویق بیفتند، کش باقی میماند، اما اگر در پیشوند prompt بارگذاری شوند، درخواست بعدی کل گفتگو را به عنوان ورودی غیرکششده (uncached) بازخوانی میکند. دقیقاً به همین دلیل است که /reload-plugins هشدار میدهد و در صورت تغییر در ابزارهای MCP یا ابزار LSP که باعث شکستن کش شود، تا زمانی که --force را وارد نکنید، از انجام آن خودداری میکند.
شما میتوانید این روند را به جای حدس زدن، مشاهده کنید. هر پاسخ API، مقادیر cache_read_input_tokens و cache_creation_input_tokens را گزارش میدهد و یک خط وضعیت سفارشی که مصرف زنده توکن را نشان میدهد، هر دو را پیش روی شما میگذارد. یک نشست سالم، بسیار بیشتر از آنچه تولید میکند، میخواند. اگر میزان تولید در نوبتهای متوالی بالا بماند، یعنی چیزی در پیشوند شما در هر نوبت در حال تغییر است. برای درک وسیعتر از آنچه پنجره را پر میکند، نحوه مدیریت پنجره کانتکست Claude Code و معنای واقعی آن شمارشهای توکن را ببینید.
یک مورد خانهداری (housekeeping) وجود دارد که هزینه خود را جبران میکند. تب Installed، افزونههای نصبشده از مارکتپلیس که حداقل 14 روز و 10 نشست از آنها استفاده نکردهاید را زیر هدر Not used recently گروهبندی میکند و یک خط Last used در نمای جزئیات نشان میدهد. این هدر شامل افزونههای مدیریتشده، افزونههای seed-directory و افزونههای دارای تم، سبک خروجی، مانیتور یا گردش کار نمیشود؛ یک سرور LSP زمانی استفادهشده تلقی میشود که تشخیصها (diagnostics) را ارائه دهد یا به درخواست ناوبری کد پاسخ دهد. وقتی strictKnownMarketplaces پیکربندی شده باشد، نه هدر و نه خط Last used: ظاهر نمیشوند. آن افزونهها همچنان در هر نشست هزینه زمان راهاندازی و کانتکست را برای شما دارند. آنها را غیرفعال یا حذف کنید. عادت ارزانتر این است که پیش از نصب، گزینشی عمل کنید: کدامیک از مهارتهای Matt Pocock ارزش نصب دارند، مجموعهای از 27 مهارت را بررسی کرده و موارد مورد نیاز یک توسعهدهنده انفرادی را از مواردی که فقط در تیمها سودمند هستند، جدا میکند.
یک افزونه با دسترسیهای شما اجرا میشود
مستندات رسمی Anthropic صراحتاً بیان میکند: افزونهای که نصب میکنید میتواند با دسترسیهای کاربری شما، کد دلخواه را روی سیستمتان اجرا کند. این یک فرضیه نیست. هوکهای (hooks) یک افزونه، دستورات shell را در رویدادهای نشست (session)، از جمله قبل و بعد از فراخوانی ابزارها، اجرا میکنند. دایرکتوری bin/ آن در زمان فعال بودن افزونه به PATH ابزار Bash اضافه میشود. سرورهای MCP که از طریق stdio کار میکنند، فرآیندهایی هستند که توسط خود افزونه شروع میشوند و یک mod، کدهای JavaScript را درون خود Claude Code اجرا میکند. هوکها، مانیتورها، فرآیندهای سرور و فرآیندهای mod خارج از sandbox محیط Claude Code اجرا میشوند؛ با این حال، قوانین دسترسی همچنان بر فراخوانی ابزارهایی که Claude انجام میدهد، اعمال میگردد.
روی یک لپتاپ، این ریسک محدود به دسترسیهای کاربر دسکتاپ شماست. اما روی یک سرور، معمولاً اینطور نیست. حسابی که agent را اجرا میکند، اغلب دارای کلیدهای SSH، توکنهای استقرار (deploy tokens)، نشستهای cloud CLI و دسترسی به Docker socket است؛ بنابراین «اجرای کد دلخواه با دسترسی کاربر شما» به معنای در اختیار گرفتن کل ماشین است. اگر Claude Code روی یک VPS اجرا میشود، پیش از نصب هر چیزی، نحوه اجرای ایمن Claude Code روی VPS را مطالعه کنید و پیش از نصب افزونهای که با یک سرویس خارجی در ارتباط است، نحوه دور نگه داشتن اعتبارنامهها از دسترس agent را بخوانید. سایر محیطهای اجرایی نیز در همان سرور اجارهای با همین محدودیت مواجه هستند؛ به همین دلیل است که افزونههای DeepSeek Harness که ارزش نصب دارند، بیشتر شامل محدودیتهای هزینه (spend caps)، قوانین دسترسی ابزارها و اسکن تزریق کد (injection scanning) هستند تا قابلیتهای جدید.
برخی محافظها (guardrails) وجود دارند و شناخت آنها مفید است. یک افزونه با دامنه پروژه (project-scope) از مخزن (repository) بارگذاری میشود، نه از سمت شما؛ بنابراین تنها پس از آنکه به workspace اعتماد کردید بارگذاری میشود، سرورهای MCP آن همچنان نیاز به تأییدیه برای هر سرور دارند و مانیتورهای پسزمینه آن اصلاً بارگذاری نمیشوند. agentهایی که توسط افزونهها ارائه میشوند، اجازه ندارند هوک، سرور MCP یا حالت دسترسی (permission mode) تعریف کنند. هنگامی که افزونههای marketplace در cache کپی میشوند، symlinkهایی که به خارج از marketplace اشاره دارند نادیده گرفته میشوند؛ بنابراین یک افزونه کپیشده نمیتواند از طریق آن لینکها، فایلهای دلخواه میزبان را فراخوانی کند.
هیچکدام از این موارد جایگزین بررسی آنچه نصب میکنید، نیست. لیست Will install را چک کنید، افزونههایی را ترجیح دهید که سورسکد آنها قابل مشاهده و خواندن است، افزونههای تیم خود را در یک marketplace که تحت کنترل شماست نگه دارید و روی هر چیزی که خودتان مینویسید، claude plugin validate را اجرا کنید. آنچه بررسی کردهاید ممکن است بعداً تغییر کند: قابلیت بهروزرسانی خودکار برای marketplaceهای رسمی Anthropic به جز knowledge-work-plugins و first-party-plugins بهصورت پیشفرض فعال است و برای موارد شخص ثالث که از طریق منبع اضافه شدهاند، غیرفعال است؛ در مواردی که این قابلیت فعال باشد، Claude Code فایلهای افزونه را در پسزمینه بهروزرسانی میکند.
FAQ
آیا افزونههای Claude Code هزینه اضافی دارند؟
خیر. هیچ هزینهای برای سیستم افزونه، افزودن بازارچه (marketplace) یا نصب افزونه وجود ندارد. هزینه مربوط به مصرف توکن است که مانند هر محتوای دیگری، از طرح اشتراک یا اعتبار API شما کسر میشود. یک افزونه در هر نوبت، محتوای زمینه (context) ثابتی اضافه میکند، هنگام فراخوانی مهارتها یا عاملهایش (agents) محتوای بیشتری میافزاید و اگر یک سرور MCP ارائه دهد که ابزارهای آن در پیشوند پرامپت بارگذاری میشوند، میتواند باعث یک نوبت پرهزینه و بدون کش (uncached) شود. برای افزونههای موجود در بازارچه رسمی Anthropic، نمای جزئیات /plugin قبل از نصب، یک تخمین Context cost نمایش میدهد؛ برای سایر افزونهها، claude plugin details name پس از نصب یا بارگذاری با --plugin-dir، هزینه توکن همیشگی آن را چاپ میکند.
تفاوت بین افزونه (plugin) و مهارت (skill) چیست؟
مهارت یک واحد دستورالعمل واحد است. افزونه بستهای است که میتواند شامل مهارتها، عاملها، هوکها، سرورهای MCP، سرورهای LSP و مانیتورها باشد و دارای نام، معمولاً نسخه و معمولاً یک بازارچه برای نصب است؛ اگرچه میتواند به صورت یک پوشه یا یک .zip که افراد با --plugin-dir بارگذاری میکنند نیز به اشتراک گذاشته شود. زمانی که یک مهارت برای خودتان و پروژه فعلی است، آن را به صورت مستقل در .claude/ بنویسید. یک مهارت تکمنظوره مانند Ponytail، که عامل را به سمت کوچکترین تغییرِ کارآمد سوق میدهد، واضحترین نمونه از این مورد است: یک فایل با یک قانون در آن، تا روزی که تیم شما هم آن را بخواهد. زمانی که دیگران به آن نیاز دارند و نیاز است در طول زمان بهروزرسانی شود، آن را به یک افزونه تبدیل کنید. مهارتهای افزونه دارای فضای نام (namespaced) هستند، بنابراین یک مهارت درون یک افزونه به جای /skill-name، به صورت /plugin-name:skill-name فراخوانی میشود.
افزونه من نصب شد اما مهارتهایش ظاهر نمیشوند. مشکل چیست؟
ابتدا خلاصه نصب را بررسی کنید. اگر پیام Run /reload-plugins to apply. نمایش داده شد، Claude Code هنگام بسته شدن پنل، آن بارگذاری مجدد را اجرا میکند؛ اگر بارگذاری مجدد هشدار داد که مکالمه را دوباره میخواند، آن را به صورت /reload-plugins --force دوباره اجرا کنید. اگر بارگذاری شد اما چیزی نشان نمیدهد، /plugin را باز کرده و زبانه Errors را بخوانید. رایجترین اشتباه ساختاری، قرار دادن skills/، agents/ یا hooks/ در داخل .claude-plugin/ است، جایی که Claude Code آنها را جستجو نمیکند. به یاد داشته باشید که مهارتهای افزونه دارای فضای نام هستند، بنابراین هنگام تایپ /، باید به دنبال /plugin-name:skill-name باشید. اگر افزونه متعلق به شخص دیگری است و بدون خطا بارگذاری میشود، پنل جزئیات آن را در زبانه Installed باز کنید: افزونهای که هیچ مهارتی را در آنجا فهرست نمیکند، مهارتی برای ارائه ندارد. اگر زبانه Errors میگوید افزونه کش نشده است، دایرکتوری نصب آن گم شده است؛ بنابراین آن را از طریق شل با claude plugin install name@marketplace دوباره نصب کرده و /reload-plugins را اجرا کنید.
آیا میتوانم افزونهها را بدون پنل تعاملی نصب کنم؟
بله. از دستور شل claude plugin install name@marketplace استفاده کنید که افزونه را در محدوده کاربر نصب میکند، مگر اینکه --scope project یا --scope local را ارسال کنید. این دستور در اسکریپتها، ایمیجها و محیطهای غیرتعاملی که پنل /plugin در دسترس نیست، کار میکند. از آنجا که این دستور خارج از یک نشست (session) اجرا میشود، نشستی که از قبل باز است برای اعمال تغییرات افزونه به /reload-plugins نیاز دارد. در نشستی که ترمینال تعاملی ندارد، تغییرات سرورهای MCP افزونه در نشست بعدی اعمال میشود.
آیا نصب افزونه از بازارچهای که در GitHub پیدا کردهام امن است؟
با آن همانطور رفتار کنید که با اجرای اسکریپت نصب آن مخزن توسط خودتان رفتار میکنید، زیرا این کار تقریباً مشابه همان است. یک افزونه میتواند از طریق هوکها دستورات شل را اجرا کند، فایلهای اجرایی را به PATH ابزار Bash اضافه کند و سرورهای MCP را با امتیازات کاربر شما راهاندازی کند. Anthropic محتوای افزونههای شخص ثالث را کنترل یا تأیید نمیکند. از منابعی نصب کنید که میتوانید آنها را بخوانید، قبل از تأیید لیست Will install را بررسی کنید و در سرور سختگیرتر از لپتاپ باشید، زیرا حساب کاربری در سرور معمولاً حاوی کلیدها و توکنهایی است که ارزش سرقت دارند.