Claude Code چیست و چه تفاوتی با Claude.ai دارد؟
Claude Code یک ابزار CLI از شرکت Anthropic است که برای کار مستقیم با پروژه‌ها از طریق Terminal طراحی شده است. برخلاف Claude.ai که یک رابط وب برای گفتگو با مدل است، Claude Code در محیط خط فرمان اجرا می‌شود و به فایل‌ها، Git، و ابزارهای سیستم دسترسی دارد.
برای مثال، وقتی Claude Code را در یک پروژه PHP یا JavaScript اجرا می‌کنید، می‌تواند:
🔹 ساختار پروژه را بررسی کند
🔹 فایل‌های کد را بخواند و اصلاح کند
🔹 تست‌ها را اجرا کند و خطاها را پیدا کند
🔹 با Git کار کند و Pull Request بررسی کند
🔹 تحلیل امنیتی انجام دهد
بنابراین Claude Code را نباید با Claude.ai اشتباه گرفت. Claude.ai برای گفتگوی عمومی با مدل است، در حالی که Claude Code برای Workflowهای توسعه در Terminal ساخته شده است.
Claude Plugins Official چیست؟
Claude Plugins Official یک Marketplace یا دایرکتوری مدیریت‌شده برای Pluginهای Claude Code است که در مخزن GitHub شرکت Anthropic قرار دارد.
طبق مستندات رسمی، این مخزن دو بخش اصلی دارد:
│
├── plugins/ # Pluginهای داخلی Anthropic
│
└── external_plugins/ # Pluginهای شخص ثالث و شرکا
نکته مهم این است که تمام Pluginهای این مخزن توسط Anthropic ساخته نشده‌اند. بخش plugins شامل Pluginهای داخلی است که تیم Anthropic توسعه داده است، اما بخش external_plugins شامل Pluginهایی است که توسط شرکت‌ها و توسعه‌دهندگان دیگر ارائه شده‌اند.
برای مثال، Plugin مربوط به GitHub توسط خود GitHub ارائه شده و Plugin Context7 توسط Upstash نگهداری می‌شود.
تفاوت Claude Code، Plugin، MCP، Skill و Command
یکی از رایج‌ترین مشکلات کاربران جدید، اشتباه گرفتن این مفاهیم است. جدول زیر تفاوت آن‌ها را نشان می‌دهد:
| مفهوم | نقش و تعریف | مثال کاربردی |
|---|---|---|
| Claude Code | ابزار CLI برای کار با Claude در Terminal | کار روی پروژه و اجرای Workflow |
| Plugin | بسته قابل نصب برای گسترش Claude Code | claude-security |
| MCP | پروتکل اتصال به ابزارها و سرویس‌های خارجی | اتصال به GitHub |
| Skill | دستورالعمل و دانش تخصصی برای یک نوع کار | آموزش Workflow تست |
| Command | دستور قابل اجرا در Claude Code | /reload-plugins |
| Agent | عامل تخصصی برای انجام وظیفه مشخص | Agent بررسی امنیت |
| Hook | اجرای خودکار عملیات در رویدادهای مشخص | بررسی فایل قبل از Write |
نکته کلیدی: این مفاهیم جایگزین یکدیگر نیستند. یک Plugin می‌تواند همزمان شامل Skill، Agent، Command، Hook و تنظیمات MCP باشد.
MCP چیست و چه نقشی در Pluginها دارد؟
MCP یا Model Context Protocol یک پروتکل باز است که امکان اتصال مدل‌های زبانی به ابزارها و منابع خارجی را فراهم می‌کند. MCP را نباید صرفاً «یک ابزار» در نظر گرفت؛ MCP بیشتر نقش یک استاندارد ارتباطی را دارد که Serverها و Toolهای قابل استفاده توسط مدل را تعریف می‌کند.
برای مثال، Claude Code از طریق MCP می‌تواند به GitHub، Context7 یا Playwright متصل شود. در ساختار یک Plugin، تنظیمات MCP معمولاً در فایل .mcp.json قرار می‌گیرد.
طبق مشخصات رسمی MCP، این پروتکل سه مفهوم اصلی دارد:
🔹 Hosts: برنامه‌هایی مثل Claude Code که اتصال را آغاز می‌کنند
🔹 Clients: کانکتورهای داخل Host
🔹 Servers: سرویس‌هایی که Context و ابزار ارائه می‌دهند
Skill چیست و چه تفاوتی با Command دارد؟
Skill مجموعه‌ای از دستورالعمل‌ها و دانش تخصصی برای انجام یک نوع کار است. برای مثال، یک Skill می‌تواند به Claude Code کمک کند تا تست Unit بنویسد، یک Plugin بسازد، یا فرآیند Code Review را اجرا کند.
Command دستورهایی هستند که کاربر مستقیماً از داخل Claude Code اجرا می‌کند، مثل /reload-plugins. اما طبق مستندات رسمی Plugin نمونه Anthropic، ساختار commands/*.md یک قالب Legacy محسوب می‌شود و برای Pluginهای جدید، استفاده از پوشه skills/ ترجیح داده می‌شود.
این نکته برای افرادی که قصد ساخت Plugin جدید دارند اهمیت زیادی دارد.
📌 نکته سئویی مهم
Skillها از مفهوم Progressive Disclosure پشتیبانی می‌کنند. یعنی تمام اطلاعات تخصصی همیشه وارد Context نمی‌شوند. ابتدا فقط Metadata Skill بارگذاری می‌شود، سپس SKILL.md و در صورت نیاز Referenceها. این روش Context را خلوت‌تر نگه می‌دارد.
ساختار استاندارد یک Plugin
طبق Marketplace رسمی، یک Plugin استاندارد ساختاری شبیه این دارد:
├── .claude-plugin/
│ └── plugin.json # Manifest اصلی Plugin
├── .mcp.json # تنظیمات MCP (اختیاری)
├── commands/ # Slash commands (اختیاری)
├── agents/ # تعریف Agentها (اختیاری)
├── skills/ # تعریف Skillها (اختیاری)
└── README.md # مستندات
plugin.json فایل اصلی Manifest است که نام، توضیحات و نویسنده Plugin را مشخص می‌کند. .mcp.json تنظیمات اتصال به MCP Serverها را تعریف می‌کند.
نصب Claude Plugins Official از صفر
نصب Plugin در Claude Code یک فرآیند دو مرحله‌ای است: ابتدا Marketplace را اضافه می‌کنید، سپس Plugin موردنظر را نصب می‌کنید.
مرحله ۱: افزودن Marketplace رسمی
Claude Code به‌صورت خودکار Marketplace رسمی را هنگام شروع یک Session تعاملی اضافه می‌کند. اما اگر با خطای «Marketplace not found» مواجه شدید، می‌توانید دستی اضافه کنید:
مرحله ۲: نصب Plugin
پس از افزودن Marketplace، Plugin موردنظر را نصب کنید:
اگر نام دقیق Plugin را نمی‌دانید، می‌توانید Marketplace را از داخل Claude Code مرور کنید. دستور /plugin را اجرا کنید و وارد تب Discover شوید. در این بخش می‌توانید Pluginهای موجود را مشاهده، جستجو و نصب کنید.
مشاهده Pluginهای نصب‌شده
برای مشاهده اطلاعات یک Plugin خاص:
در صورت تغییر تنظیمات یا نصب Plugin جدید، ممکن است نیاز باشد Pluginها Reload شوند:
🚀 سرور مجازی ایرانیکاسرور؛ بستر حرفه‌ای برای توسعه با Claude Code
اگر روی پروژه‌های حساس یا Repositoryهای شخص ثالث کار می‌کنید، اجرای Claude Code داخل یک محیط ایزوله روی سرور مجازی، امن‌ترین گزینه است. ایرانیکاسرور با منابع اختصاصی CPU و RAM، دیسک NVMe و پهنای باند نامحدود، محیطی پایدار برای Workflowهای سنگین توسعه فراهم می‌کند. پشتیبانی ۲۴/۷ ما هم در کنار شماست.
📞 تماس با پشتیبانی: 021-91302460 | ایرانیکاسرور
Pluginهای برتر Marketplace رسمی
Marketplace رسمی شامل ده‌ها Plugin در دسته‌بندی‌های مختلف است. جدول زیر برخی از پرکاربردترین‌ها را معرفی می‌کند:
| Plugin | کاربرد | دسته |
|---|---|---|
| Context7 | دریافت مستندات به‌روز کتابخانه‌ها | مستندات |
| GitHub | مدیریت Repository، Issue و PR | کنترل نسخه |
| Playwright | تست End-to-End و Automation مرورگر | تست |
| claude-security | بررسی امنیتی Repository | امنیت |
| plugin-dev | ابزار ساخت Plugin | توسعه |
Context7: حل مشکل مستندات قدیمی در AI
یکی از مشکلات رایج در برنامه‌نویسی با AI، استفاده از مستندات قدیمی یا APIهای اشتباه است. Context7 دقیقاً برای حل این مشکل طراحی شده است.
Context7 می‌تواند مستندات و نمونه کدهای به‌روز کتابخانه‌ها را از منابع اصلی دریافت کرده و در اختیار Claude Code قرار دهد. دو ابزار اصلی آن عبارت‌اند از:
🔹 resolve-library-id: کتابخانه موردنظر را پیدا می‌کند
🔹 query-docs: مستندات مرتبط را دریافت می‌کند
مثلاً اگر از Next.js استفاده می‌کنید، می‌توانید بنویسید:
Context7 مستندات مرتبط با نسخه ۱۵ را پیدا می‌کند. برای پروژه‌های حساس به نسخه، می‌توانید نسخه دقیق را مشخص کنید:
تنظیم API Key برای Context7
Context7 بدون API Key نیز به‌صورت Anonymous کار می‌کند، اما برای استفاده از Plan شخصی می‌توانید API Key خود را تنظیم کنید:
برای دائمی شدن در Bash:
# سپس خط زیر را اضافه کنید:
export CONTEXT7_API_KEY=”your-api-key”
source ~/.bashrc
در Zsh فایل ~/.zshrc را ویرایش کنید. نکته مهم: Context7 الزاماً به فایل .env پروژه نیاز ندارد. API Key باید در Shell Environment اجرای Claude Code قرار بگیرد.
ساخت Plugin اختصاصی برای Claude Code
یکی از جذاب‌ترین امکانات Claude Plugins، ساخت Plugin اختصاصی است. Anthropic یک Toolkit رسمی با نام plugin-dev ارائه کرده که شامل Skillهای تخصصی برای ساخت Plugin است.
برای شروع، می‌توانید از Workflow زیر استفاده کنید:
یا هدف خود را مشخص کنید:
A plugin for managing database migrations
این Workflow شامل مراحل Discovery، Component Planning، Detailed Design، Structure Creation، Implementation، Validation، Testing و Documentation است.
ساخت یک Skill نمونه
Skillها در پوشه skills/ قرار می‌گیرند. ساختار:
└── database-review/
└── SKILL.md
محتوای SKILL.md می‌تواند این باشد:
name: database-review
description: Review database migrations for safety
—Review the migration files and check for:- destructive changes
– missing indexes
– unsafe table locks
– data loss risks
ساخت MCP Server برای Plugin
اگر Plugin شما باید با سرویس خارجی ارتباط داشته باشد، می‌توانید MCP را اضافه کنید. فایل .mcp.json می‌تواند یک Server HTTP را تعریف کند:
“my-service”: {
“type”: “http”,
“url”: “https://example.com/mcp”
}
}
رفع خطاهای رایج Claude Plugins
مشکل ۱: Marketplace پیدا نمی‌شود
راه‌حل: Marketplace رسمی را دستی اضافه کنید:
مشکل ۲: Plugin نصب شده ولی Command ظاهر نمی‌شود
راه‌حل: Pluginها را Reload کنید:
سپس با /plugin list بررسی کنید که Plugin واقعاً نصب شده باشد.
مشکل ۳: MCP Server متصل نمی‌شود
این موارد را بررسی کنید:
🔹 API Key تنظیم شده باشد
🔹 Environment Variable در دسترس باشد
🔹 اتصال شبکه برقرار باشد
🔹 تنظیمات .mcp.json صحیح باشد
🔹 نسخه Claude Code با Plugin سازگار باشد
مشکل ۴: API Key شناخته نمی‌شود
برای بررسی متغیر محیطی در Linux یا macOS:
اگر خروجی خالی بود، متغیر را تنظیم کنید و Claude Code را دوباره اجرا کنید.
⚠️ هشدار امنیتی
API Key را هرگز داخل کد پروژه قرار ندهید. از Commit کردن API Key، Token، Password یا Private Key خودداری کنید. استفاده از Environment Variable مناسب‌ترین روش برای جدا کردن Secret از Source Code است.
امنیت در نصب Plugin: چه چیزهایی را باید بررسی کنیم؟
نصب Plugin را نباید مانند نصب یک Theme ساده در نظر گرفت. Plugin می‌تواند شامل MCP Server، Script، Hook و دسترسی به فایل‌ها باشد. Marketplace رسمی صراحتاً هشدار می‌دهد که Anthropic کنترل کاملی بر MCP Serverها یا فایل‌های موجود در تمام Pluginها ندارد.
قبل از نصب هر Plugin این موارد را بررسی کنید:
🔹 نویسنده Plugin: Plugin متعلق به چه سازمان یا توسعه‌دهنده‌ای است؟
🔹 Repository: Source Code و فایل‌های Plugin را بررسی کنید
🔹 فایل .mcp.json: Plugin به چه سرویس‌های خارجی متصل می‌شود؟
🔹 Hookها: چه عملیات خودکاری اجرا می‌شود؟
🔹 دسترسی فایل‌ها: Plugin با چه فایل‌هایی کار می‌کند؟
🔹 README: مستندات کامل را مطالعه کنید
نکته مهم: Plugin امنیتی claude-security از Repository بازشده مانند یک Session عادی استفاده می‌کند و لایه Isolation جداگانه ایجاد نمی‌کند. برای Repositoryهای ناشناس، مستندات رسمی پیشنهاد می‌کنند کل Session را داخل sandbox-runtime اجرا کنید.
مشکلات Windows با MCP Server
برخی MCP Serverها روی Windows رفتار متفاوتی نسبت به Linux یا macOS دارند. یکی از Issueهای ثبت‌شده در مخزن رسمی به مشکل اجرای npx به‌عنوان Shim با پسوند .cmd و Timeout شدن MCP روی Windows اشاره دارد.
اگر روی Windows مشکل MCP داشتید، این موارد را بررسی کنید:
🔹 Node.js و npm و npx نصب و در PATH باشند
🔹 PowerShell دسترسی اجرای Script را داشته باشد
🔹 Firewall ارتباط را مسدود نکرده باشد
Pluginها و مدیریت VPS
اگر روی سرور مجازی کار می‌کنید، Claude Code و Pluginها می‌توانند برای Workflowهای توسعه و مدیریت پروژه بسیار مفید باشند. برای مثال:
🔹 بررسی فایل‌های پروژه و تحلیل خطا
🔹 بررسی Configuration و تست
🔹 بررسی Git و تحلیل کد
اما بهتر است دسترسی‌های سیستمعامل و SSH را حداقل نگه دارید و برای عملیات حساس از محیط‌های آزمایشی یا Sandbox استفاده کنید. ایرانیکاسرور با ارائه سرور مجازی ایران با منابع اختصاصی، محیطی امن برای این Workflowها فراهم می‌کند.
🔧 مشکل در نصب یا کانفیگ Plugin دارید؟
تیم فنی ایرانیکاسرور آماده کمک به شماست. اگر در نصب MCP، تنظیم API Key، یا راه‌اندازی Claude Code روی سرور مجازی به مشکل خوردید، درخواست خود را از طریق صفحه کانفیگ ارسال کنید. کارشناسان ما در سریع‌ترین زمان پاسخ می‌دهند.
📞 تماس با پشتیبانی: 021-91302460 | ایرانیکاسرور
جمع‌بندی: چرا Claude Plugins یک انتخاب حرفه‌ای است؟
Claude Plugins Official یک Marketplace مدیریت‌شده برای گسترش قابلیت‌های Claude Code است. این اکوسیستم شامل مفاهیم مختلفی است که هرکدام نقش مشخصی دارند:
│
└── Plugin
├── Skill
├── Command
├── Agent
├── Hook
└── MCP
Plugin می‌تواند یک بسته کامل باشد، MCP وظیفه اتصال به ابزارها و سرویس‌های خارجی را بر عهده دارد، Skill دستورالعمل تخصصی ارائه می‌کند، Command برای اجرای Workflow توسط کاربر استفاده می‌شود و Agent یک عامل تخصصی برای انجام وظیفه مشخص است.
از نمونه‌های موجود در Marketplace می‌توان به Context7، GitHub، Playwright، Claude Security و Plugin Development Toolkit اشاره کرد. برای شروع، Marketplace رسمی را اضافه کنید و Plugin موردنظر را نصب کنید. اما قبل از نصب هر Plugin، منبع، دسترسی‌ها، MCP Serverها و Hookهای آن را بررسی کنید.
با رویکرد درست، Claude Plugins می‌تواند Workflow توسعه شما را از یک ابزار خط فرمان ساده به یک پلتفرم توسعه یکپارچه تبدیل کند. اگر روی سرور مجازی ایران کار می‌کنید، ایرانیکاسرور با منابع اختصاصی و پشتیبانی ۲۴/۷ آماده همراهی شماست.
دیدگاه‌ها
0 دیدگاه برای این مطلب ثبت شده است.