ما هو Claude Code؟
Claude Code هو أداة سطر أوامر (CLI) طورتها شركة Anthropic لتكون أقوى مساعد برمجة بالذكاء الاصطناعي في العالم. على عكس واجهة الدردشة في claude.ai التي تتحدث معها عبر المتصفح، Claude Code يعمل مباشرة في الـ Terminal على جهازك — يقرأ ملفاتك، يفهم بنية مشروعك، يعدّل الكود، ينفذ أوامر، ويبني مشاريع كاملة من الصفر.
الفرق الجوهري بين Claude Code وclaude.ai هو أن Claude Code يعيش داخل كودك. لا تحتاج لنسخ ولصق أكواد — هو يرى كل شيء مباشرة. يمكنه قراءة مئات الملفات في ثوانٍ، فهم العلاقات بين المكونات، واقتراح تعديلات دقيقة تراعي سياق المشروع بالكامل. تخيل مبرمجاً خبيراً يجلس بجانبك 24 ساعة، يفهم كل سطر في مشروعك، ويستطيع تنفيذ مهام معقدة بأمر واحد منك.
Claude Code متاح مع اشتراك Claude Max (يبدأ من 100 دولار/شهر) أو عبر مفتاح API من Anthropic بتكلفة حسب الاستخدام. يعمل على macOS وLinux وWindows (عبر WSL أو مباشرة). ويستخدم نافذة سياق تصل إلى مليون توكن — مما يعني أنه يستطيع فهم مشاريع ضخمة بالكامل في محادثة واحدة.
لماذا Claude Code مختلف عن أي أداة برمجة أخرى؟
Claude Code ليس مجرد مساعد يكتب كود — إنه وكيل ذكي (Agent) يستطيع التفكير، التخطيط، التنفيذ، والمراجعة. يمكنه إنشاء ملفات جديدة، تعديل ملفات موجودة، تشغيل اختبارات، عمل Git commits، وحتى نشر التطبيقات — كل ذلك من خلال محادثة طبيعية بالعربي أو الإنجليزي.
التثبيت والإعداد — 3 دقائق فقط
تثبيت Claude Code عملية بسيطة لا تتجاوز 3 دقائق. اتبع هذه الخطوات المرقمة وستكون جاهزاً للعمل:
Claude Code يعمل كحزمة npm، لذا تحتاج Node.js الإصدار 18 أو أحدث. افتح Terminal واكتب node --version للتأكد. إذا لم يكن مثبتاً، حمله من nodejs.org — التثبيت يستغرق دقيقة واحدة.
افتح Terminal ونفذ الأمر التالي:
هذا الأمر سيثبت Claude Code على جهازك ويجعله متاحاً من أي مكان. على macOS/Linux قد تحتاج sudo قبل الأمر.
انتقل إلى مجلد مشروعك عبر Terminal ثم اكتب:
claude
سيبدأ Claude Code وسيطلب منك تسجيل الدخول بحساب Anthropic في أول مرة. بعدها سيقرأ ملفات مشروعك تلقائياً ويكون جاهزاً لتلقي أوامرك.
عند التشغيل لأول مرة، سيفتح المتصفح تلقائياً لتسجيل الدخول بحساب Anthropic الخاص بك. بعد المصادقة، يتم حفظ الجلسة ولن تحتاج تسجيل الدخول مجدداً.
جرب أول أمر لفهم قوة Claude Code:
سيقرأ Claude Code جميع ملفات المشروع ويعطيك ملخصاً شاملاً: التقنيات المستخدمة، البنية، الملفات الرئيسية، ونقاط القوة والضعف.
الأوامر الأساسية (Slash Commands)
Claude Code يأتي مع مجموعة أوامر مدمجة تبدأ بعلامة / (Slash Commands) تساعدك في إدارة جلسة العمل بكفاءة. هذه الأوامر ليست للبرمجة مباشرة — بل لإدارة Claude Code نفسه. إليك الجدول الشامل لأهم الأوامر:
| الأمر | الوظيفة | متى تستخدمه |
|---|---|---|
/help |
عرض المساعدة وقائمة الأوامر المتاحة | عندما تنسى أمراً أو تريد استكشاف الخيارات |
/clear |
مسح المحادثة الحالية والبدء من جديد | عند الانتقال لمهمة مختلفة تماماً |
/compact |
تلخيص المحادثة لتوفير نافذة السياق | عندما تطول المحادثة وتقترب من الحد الأقصى |
/memory |
إدارة ذاكرة Claude Code عبر الجلسات | لحفظ معلومات مهمة تريد أن يتذكرها دائماً |
/config |
عرض وتعديل إعدادات Claude Code | لتخصيص سلوك الأداة حسب احتياجاتك |
/model |
اختيار نموذج الذكاء الاصطناعي | للتبديل بين Opus (أقوى) وSonnet (أسرع) |
/review |
مراجعة شاملة للتغييرات الحالية | قبل عمل commit للتأكد من جودة الكود |
/init |
إنشاء ملف CLAUDE.md للمشروع | عند بدء مشروع جديد أو إعداد مشروع موجود |
/context |
إضافة ملفات محددة لسياق المحادثة | عندما تريد التركيز على ملفات بعينها |
/branch |
إنشاء فرع Git جديد | قبل البدء في ميزة جديدة أو إصلاح |
هذه الأوامر هي أدوات إدارة الجلسة. لكن القوة الحقيقية لـ Claude Code تكمن في كتابة طلباتك بلغة طبيعية مباشرة — اطلب منه أي شيء وسيفهمك: "أضف نظام تسجيل دخول"، "أصلح هذا الخطأ"، "اكتب اختبارات لهذا الملف". كل هذا بالعربي أو الإنجليزي.
CLAUDE.md — ذاكرة المشروع الدائمة
ملف CLAUDE.md هو أهم ملف في أي مشروع يستخدم Claude Code. فكّر فيه كـ "دليل المشروع" الذي يقرأه Claude Code في بداية كل جلسة — يحتوي على قواعد المشروع، الأنماط المتبعة، التقنيات المستخدمة، وأي تعليمات خاصة تريد أن يلتزم بها. بدون هذا الملف، Claude Code سيعمل بشكل عام — لكن مع CLAUDE.md سيعمل كأنه عضو في فريقك يعرف كل تفاصيل المشروع.
لإنشاء الملف، شغّل Claude Code في مشروعك واكتب /init. سيسألك عن المشروع ويولّد ملف CLAUDE.md أولي. لكن القوة الحقيقية تأتي عندما تخصصه يدوياً. إليك مثالين عمليين:
مثال CLAUDE.md لمشروع Laravel
## القواعد العامة
- استخدم PHP 8.2+ مع strict types
- اتبع نمط Repository Pattern
- كل Controller يجب أن يكون Single Action
- اكتب Form Request لكل endpoint
- استخدم API Resources للـ responses
## قاعدة البيانات
- MySQL 8.0 مع utf8mb4
- استخدم Soft Deletes لكل الجداول
- أضف indexes للحقول المستخدمة في WHERE/ORDER BY
## الاختبارات
- اكتب Feature Test لكل endpoint
- استخدم Factories و Seeders
- شغّل: php artisan test قبل كل commit
مثال CLAUDE.md لمشروع React
## التقنيات
- React 19 + TypeScript
- Tailwind CSS 4 للتصميم
- Zustand لإدارة الحالة
- React Query للـ API calls
## قواعد الكود
- استخدم Functional Components فقط
- كل Component في ملف منفصل
- استخدم custom hooks لفصل المنطق
- أسماء الملفات: PascalCase للمكونات، camelCase للـ hooks
## أوامر مهمة
- npm run dev — تشغيل محلي
- npm run build — بناء للإنتاج
- npm run test — تشغيل الاختبارات
يمكنك أيضاً إنشاء ملفات CLAUDE.md متعددة: ملف في جذر المشروع للقواعد العامة، وملفات فرعية في المجلدات الداخلية لقواعد خاصة بكل وحدة. Claude Code يقرأها جميعاً ويجمع السياق تلقائياً.
Skills — مهارات قابلة للتخصيص
Skills هي ميزة قوية في Claude Code تتيح لك تعليمه مهارات جديدة قابلة لإعادة الاستخدام. فكّر في Skill كـ "وصفة" محفوظة — تكتبها مرة واحدة ثم تستدعيها في أي مشروع وأي وقت. على سبيل المثال، يمكنك إنشاء Skill لمراجعة الكود، أو لكتابة محتوى تسويقي، أو لتوليد تقارير بصيغة معينة.
كل Skill عبارة عن ملف Markdown بصيغة محددة (SKILL.md) يحتوي على: اسم المهارة، الوصف، التعليمات، وأمثلة على الاستخدام. يتم حفظ ملفات Skills في مجلد ~/.claude/skills/ وتصبح متاحة في جميع مشاريعك.
أمثلة على Skills مفيدة
- Skill للتسويق: يكتب محتوى سوشيال ميديا بنبرة العلامة التجارية مع هاشتاقات وCTA مناسب
- Skill لمراجعة الكود: يفحص الأمان، الأداء، الأنماط، ويقترح تحسينات بتنسيق موحد
- Skill لكتابة التوثيق: يولّد API documentation تلقائياً من الكود مع أمثلة
- Skill للاختبارات: يكتب unit tests وintegration tests بالأنماط المعتمدة في مشروعك
لاستدعاء Skill أثناء العمل، استخدم الأمر /skill اسم_المهارة أو اذكرها بالاسم في طلبك وسيطبقها Claude Code تلقائياً. هذه الميزة تحول Claude Code من أداة عامة إلى مساعد مخصص بالكامل لطريقة عملك.
Hooks — أتمتة سير العمل
Hooks في Claude Code هي أوامر تُنفَّذ تلقائياً عند أحداث معينة — مثل قبل أو بعد استخدام أداة معينة. فكّر فيها كـ "مشغلات تلقائية" تضمن تنفيذ خطوات مهمة بدون أن تتذكرها في كل مرة. النوعان الأساسيان هما:
- PreToolUse: يُنفَّذ قبل أن يستخدم Claude Code أداة معينة (مثل: قبل تعديل ملف، تأكد أن الاختبارات تمر)
- PostToolUse: يُنفَّذ بعد استخدام أداة (مثل: بعد كل تعديل، شغّل linter وfixer تلقائياً)
مثال عملي: تشغيل الاختبارات تلقائياً
هذا المثال يشغّل الاختبارات تلقائياً بعد كل تعديل في ملف PHP:
{
"hooks": {
"PostToolUse": [
{
"tool": "edit_file",
"pattern": "*.php",
"command": "php artisan test --filter=$(basename $FILE .php)"
}
]
}
}
Hooks تضمن جودة مستمرة بدون تدخل يدوي. يمكنك إعداد hooks لتشغيل formatters، linters، type checkers، أو أي أمر آخر. هذا يحول Claude Code من مساعد إلى خط إنتاج برمجي متكامل.
MCP Servers — ربط كلود بأدواتك
MCP (Model Context Protocol) هو بروتوكول مفتوح من Anthropic يتيح لـ Claude Code الاتصال بأدوات وخدمات خارجية. بدلاً من أن يكون Claude Code محصوراً في الملفات المحلية، MCP يفتح له الباب للتفاعل مع قواعد البيانات، منصات التطوير، أدوات التواصل، وأي خدمة تدعم البروتوكول.
أمثلة على ربط MCP
- قاعدة البيانات (PostgreSQL/MySQL): Claude Code يستطيع قراءة البيانات، كتابة استعلامات، وتحليل الأداء مباشرة من المحادثة
- GitHub: إنشاء Issues، مراجعة Pull Requests، إدارة المشروع بدون مغادرة Terminal
- Slack: إرسال إشعارات تلقائية للفريق عند اكتمال مهام أو اكتشاف مشاكل
- Google Sheets: قراءة وتحديث جداول البيانات — مثالي لتقارير الأداء والمبيعات
- Jira/Linear: إنشاء وتحديث المهام تلقائياً أثناء العمل على الكود
إعداد MCP Server يتم عبر ملف .claude/settings.json في مشروعك. تحدد فيه عنوان الخادم ومفاتيح الاتصال، وبعدها يصبح Claude Code قادراً على استخدام الأدوات الخارجية كأنها جزء من وظائفه الأساسية. هذا يحول Claude Code من أداة برمجة إلى مركز قيادة رقمي شامل.
Subagents — فريق من الوكلاء الذكيين
Subagents هي ميزة متقدمة في Claude Code تتيح له تفويض مهام فرعية لوكلاء ذكيين متخصصين. عندما تعطي Claude Code مهمة كبيرة ومعقدة، يمكنه تقسيمها وإنشاء subagents — كل واحد يتعامل مع جزء محدد من المهمة ثم يجمع النتائج.
أنواع Subagents
- Explore Agent: يبحث في الكود ويستكشف البنية — مثالي لفهم مشاريع كبيرة وغير مألوفة
- Plan Agent: يحلل المهمة ويضع خطة تنفيذ مفصلة قبل البدء بالعمل
- Code Review Agent: يراجع التغييرات ويبحث عن مشاكل أمنية وأخطاء منطقية وفرص تحسين
يمكنك أيضاً بناء Agent مخصص يجمع بين عدة أدوات وSkills لتنفيذ سير عمل محدد. على سبيل المثال: Agent يقرأ Issue من GitHub، يكتب الكود، يشغّل الاختبارات، ويفتح Pull Request — كل ذلك بأمر واحد. كما تدعم ميزة Agent Teams تشغيل عدة Agents بالتوازي على مهام مختلفة، مما يضاعف الإنتاجية بشكل كبير.
أمثلة مشاريع حقيقية بنيناها بـ Claude Code
في فريق A Plan، نستخدم Claude Code يومياً في مشاريع حقيقية مع عملائنا. إليك 3 أمثلة توضح القوة الحقيقية لهذه الأداة:
1. موقع شركة كامل بـ Next.js — من الصفر للنشر في 4 ساعات
عميل سعودي طلب موقعاً مؤسسياً احترافياً يشمل: صفحة رئيسية، خدمات، فريق العمل، بورتفوليو، مدونة، ونموذج تواصل. استخدمنا Claude Code لبناء المشروع بالكامل. بدأنا بأمر واحد: "ابني موقع شركة بـ Next.js 15 مع Tailwind CSS". خلال 4 ساعات كان الموقع مكتملاً ومنشوراً على Vercel — يشمل 12 صفحة، تصميم responsive، SEO محسّن، ودعم كامل للعربية.
2. بوت واتساب لمطعم — استقبال طلبات تلقائياً
مطعم في القاهرة أراد بوت واتساب يستقبل الطلبات تلقائياً. طلبنا من Claude Code: "ابني بوت واتساب بـ Node.js يستقبل طلبات مطعم — القائمة، الأسعار، التوصيل". Claude Code بنى النظام بالكامل: واجهة WhatsApp API، قاعدة بيانات MongoDB للطلبات، لوحة تحكم للمطعم، وإشعارات فورية. المشروع استغرق يومين بدلاً من أسبوعين.
3. لوحة تحكم CRM — إدارة عملاء ومبيعات
شركة خدمية في الرياض احتاجت نظام CRM مخصص. بدأنا مع Claude Code ببناء: نظام إدارة عملاء مع Pipeline مبيعات. النتيجة: لوحة تحكم React مع API بـ Laravel، نظام أدوار وصلاحيات، تقارير مبيعات تفاعلية، وتكامل مع واتساب والبريد الإلكتروني. وفّرنا 60% من وقت التطوير المعتاد.
Claude Code vs GitHub Copilot vs Cursor
السوق مليء بأدوات برمجة بالذكاء الاصطناعي، لكن كل أداة تتميز في مجال مختلف. إليك مقارنة شاملة تساعدك على اختيار الأنسب:
| الميزة | Claude Code | GitHub Copilot | Cursor |
|---|---|---|---|
| طريقة العمل | CLI في Terminal — وكيل كامل | إضافة داخل VS Code | محرر كود كامل (fork من VS Code) |
| الذكاء | Opus 4 — الأقوى في السوق | GPT-4o / Claude Sonnet | متعدد النماذج |
| نافذة السياق | مليون توكن | محدودة | كبيرة مع Codebase indexing |
| تنفيذ أوامر | نعم — ينفذ أوامر Terminal | لا | محدود |
| إنشاء ملفات جديدة | نعم — مشاريع كاملة من الصفر | لا — يكمل الكود الموجود فقط | نعم — بشكل محدود |
| Git Integration | كامل — commits, branches, PRs | أساسي | أساسي |
| MCP/أدوات خارجية | نعم — بروتوكول مفتوح | لا | محدود |
| دعم العربية | ممتاز | متوسط | متوسط |
| السعر | من 100$/شهر (Max) أو API | 10$/شهر | 20$/شهر |
| الأفضل لـ | مشاريع كاملة وأتمتة متقدمة | إكمال كود سريع أثناء الكتابة | تعديل كود موجود بمساعدة AI |
الخلاصة: إذا كنت تريد مساعد إكمال كود سريع أثناء الكتابة — Copilot ممتاز. إذا كنت تريد محرر ذكي — Cursor خيار جيد. لكن إذا كنت تريد وكيل برمجة كامل يبني ويعدّل وينفّذ ويراجع — Claude Code هو الأقوى بلا منافس. وهو ما نستخدمه في A Plan لتنفيذ مشاريع عملائنا بسرعة وجودة استثنائية.
أسئلة شائعة عن Claude Code
إليك إجابات مفصلة على أكثر الأسئلة شيوعاً حول Claude Code:
هل Claude Code مجاني؟
▼Claude Code متاح مع اشتراك Claude Max الذي يبدأ من 100 دولار شهرياً، أو مع خطط Claude Team وEnterprise. يمكنك أيضاً استخدامه مع مفتاح API من Anthropic حيث تدفع فقط حسب استهلاكك الفعلي. لا توجد نسخة مجانية بالكامل، لكن عند إنشاء حساب Anthropic جديد تحصل على رصيد API مجاني يمكنك استخدامه لتجربة Claude Code.
هل يعمل على Windows؟
▼نعم، Claude Code يعمل على الأنظمة الثلاثة: Windows وmacOS وLinux. على Windows يمكنك تشغيله عبر WSL (Windows Subsystem for Linux) للحصول على أفضل تجربة، أو مباشرة عبر PowerShell وCommand Prompt. التثبيت يتم بنفس أمر npm على جميع الأنظمة بدون أي تعقيدات إضافية.
هل يحتاج إنترنت؟
▼نعم، Claude Code يحتاج اتصال إنترنت نشط لأنه يرسل أوامرك إلى خوادم Anthropic للمعالجة ويستقبل الردود. لكن النقطة المهمة: ملفات مشروعك تُقرأ وتُعدَّل محلياً على جهازك فقط — لا يتم رفع كودك بالكامل إلى خوادم خارجية. Claude Code يرسل فقط الأجزاء الضرورية لفهم سياق طلبك.
هل يمكنه العمل على مشاريع كبيرة؟
▼بالتأكيد — هذه إحدى أقوى نقاط Claude Code. بفضل نافذة السياق التي تصل إلى مليون توكن، يستطيع فهم مشاريع تتكون من آلاف الملفات. Anthropic نفسها تستخدم Claude Code في تطوير منتجاتها الداخلية. يمكنه إجراء تعديلات عبر ملفات متعددة في وقت واحد مع الحفاظ على تناسق الكود والبنية.
كيف A Plan تساعدني في استخدام Claude Code؟
▼فريق A Plan يقدم خدمات متكاملة حول Claude Code: إعداد الأداة لمشاريعك، كتابة ملفات CLAUDE.md مخصصة تناسب بنية مشروعك وقواعد فريقك، بناء Skills وHooks مخصصة لسير عملك، وربط MCP Servers بأدواتك وخدماتك. نقدم أيضاً تدريب فردي لفريقك التقني ودعم تقني مستمر. تواصل معنا عبر واتساب +2+201225456668 لاستشارة مجانية.