شرح Claude Code بالعربي: دليل عملي للمبتدئين من التثبيت إلى الإحتراف

إذا كنت تستخدم Claude أو أي مساعد ذكاء اصطناعي لكتابة الكود، فمن المعتاد أن تطلب دالة أو حل خطأ ثم تنسخ النتيجة إلى محرر الأكواد. Claude Code يغيّر هذه الطريقة؛ فهو لا ينتظر منك نسخ الملفات إليه واحدًا واحدًا، بل يعمل مباشرة داخل بيئة التطوير، ويستطيع قراءة المشروع وتعديل الملفات وتشغيل الأوامر والاختبارات ضمن الصلاحيات التي تمنحها له.

تصف Anthropic الأداة بأنها أداة برمجة وكيلية (Agentic Coding Tool) تستطيع فهم قاعدة الكود والعمل عبر ملفات وأدوات متعددة لإنجاز مهام التطوير. وهي متاحة في الـTerminal وكذلك عبر بيئات وأسطح أخرى مثل VS Code وJetBrains والويب.

هذا الدليل يشرح Claude Code من منظور عملي: كيف تبدأ، وما الذي يستحق تعلمه أولًا، وكيف تحافظ على السيطرة على ما يفعله قبل الانتقال إلى MCP والوكلاء المتعددين.

ما هو Claude Code؟

Claude Code هو Coding Agent من Anthropic مخصص للعمل على البرمجيات، الفرق الأساسي بينه وبين المحادثة التقليدية مع نموذج ذكاء اصطناعي هو مكان تنفيذ العمل،في واجهة الدردشة قد ترسل جزءًا من الكود وتسأل عن الحل. أما في Claude Code، فيمكن للأداة قراءة ملفات المشروع، البحث بينها، تعديلها، تنفيذ أوامر في الـTerminal وتشغيل الاختبارات، ثم استخدام النتائج للانتقال إلى الخطوة التالية.

مستودع Anthropic الرسمي يصفه بأنه أداة تعمل داخل بيئة المطور وتستطيع التعامل مع الكود وGit والمهام الروتينية من خلال اللغة الطبيعية.لهذا يظهر مصطلح Agentic Coding كثيرًا عند الحديث عنه. الفكرة ليست أن النموذج يعطي إجابة واحدة، بل أنه يدخل في حلقة عمل:يفهم المهمة → يجمع السياق → يستخدم أداة → يقرأ النتيجة → يقرر الخطوة التالية → يتحقق من العمل.وتسمى هذه العملية عادة Agentic Loop.

هل Claude Code متاح في الجزائر؟

نعم. الجزائر موجودة حاليًا ضمن قائمة الدول التي تتيح فيها Anthropic الوصول إلى Claude، كما تظهر أيضًا في قائمة المناطق المدعومة لخدمات Anthropic التجارية.Claude Code متاح كذلك ضمن اشتراكات Claude المؤهلة مثل Pro وMax. وتوضح Anthropic أن مستخدم Pro أو Max يستطيع تسجيل الدخول إلى Claude Code باستخدام حساب Claude نفسه.

هذا مهم للمستخدم الجزائري لأن بعض الأدلة القديمة قد توحي بأن استخدام Claude Code مرتبط حصرًا بمفتاح API وحساب Console، بينما توجد اليوم إمكانية استخدامه من خلال اشتراك Claude المناسب أيضًا.

ماذا تحتاج قبل تثبيت Claude Code؟

لا تحتاج إلى أن تكون خبيرًا في الـTerminal، لكن من المفيد أن تعرف أساسيات مثل:”cd” للتنقل بين المجلدات، و”git status” لمراجعة حالة المشروع، وطريقة تشغيل اختبارات مشروعك.

المتطلبات الحالية تتضمن نظامًا مدعومًا مثل macOS 13 أو أحدث، Windows 10 1809 أو أحدث، Ubuntu 20.04+ أو Debian 10+، مع 4 GB من الذاكرة على الأقل ومعالج x64 أو ARM64 واتصال بالإنترنت.

ولا أنصح بأن يكون أول تدريب لك داخل مشروع إنتاجي مهم. أنشئ مشروعًا تجريبيًا أو استخدم فرع Git منفصلًا، حتى تستطيع فهم طريقة عمل الأداة ومراجعة تغييراتها دون ضغط.

كيفية تثبيت Claude Code على Windows وmacOS وLinux

هنا توجد نقطة مهمة لأن كثيرًا من الشروحات القديمة ما زالت تعتمد على npm. حاليًا، يوصي مستودع Claude Code الرسمي بالمثبّت الأصلي، بينما أصبحت طريقة:”npm install -g @anthropic-ai/claude-code”مصنفة على أنها Deprecated.

macOS وLinux استخدم: “curl -fsSL https://claude.ai/install.sh | bash”

وعلى macOS أو Linux يمكن أيضًا استخدام Homebrew:”brew install –cask claude-code”Windows

من PowerShell:”irm https://claude.ai/install.ps1 | iex” أو باستخدام WinGet:”winget install Anthropic.ClaudeCode”

بعد التثبيت افتح مجلد مشروعك في الـTerminal وشغّل:”claude”ثم أكمل تسجيل الدخول بالطريقة المتاحة لحسابك.

هذه التفاصيل قد تتغير مع تطور المنتج، لذلك يجب إعطاء الوثائق الرسمية الأولوية على أي فيديو أو مقال قديمعند حدوث اختلاف.

كيف تبدأ أول مشروع باستخدام Claude Code؟

الخطأ الشائع هو تثبيت Claude Code ثم كتابة طلب ضخم مثل:«ابنِ لي التطبيق بالكامل.»

يمكن للأداة التعامل مع مهام كبيرة، لكن البداية الأفضل هي إعطاؤها فرصة لفهم المشروع قبل أن تسمح لها بتغيير عشرات الملفات.مثلًا، داخل مشروع موجود يمكنك أن تبدأ بطلب:«اقرأ بنية المشروع والملفات الرئيسية. لا تعدل أي ملف. اشرح لي كيف يعمل التطبيق وحدد مكان منطق تسجيل الدخول.»

بعد ذلك يمكنك الانتقال إلى:«اقترح خطة لإضافة استرجاع كلمة المرور. لا تنفذ شيئًا بعد.»ثم تراجع الخطة قبل التنفيذ.هذه الطريقة تفصل الفهم والتخطيط عن التعديل وتقلل احتمال أن يبدأ الوكيل من افتراض خاطئ.استخدم Plan Mode قبل المهام الكبيرةClaude Code يوفر أوضاع صلاحيات مختلفة، ومن بينها Plan Mode المخصص للاستكشاف والتخطيط دون تعديل ملفات المصدر.

في هذا الوضع يستطيع Claude قراءة المشروع واستخدام عمليات استكشافية، لكنه لا يشرع في تغيير الكود.استخدمه خصوصًا عندما تكون المهمة:

• – إعادة هيكلة جزء كبير من المشروع.
• – تغيير قاعدة البيانات.
• – تعديل نظام المصادقة.
• – إضافة مكتبة جديدة تؤثر في المعمارية.
• – إصلاح مشكلة لا تعرف سببها بعد.

المطور الجيد لا يريد من AI أن يكتب كودًا بسرعة فقط؛ يريد أن يتأكد أولًا أنه يحل المشكلة الصحيحة.

كيف يعمل Agentic Loop؟

لفهم Claude Code بصورة صحيحة، تخيل أنك تعمل مع مطور يستطيع استخدام الأدوات، وليس مع محرك لإكمال النصوص.إذا قلت:«أصلح الاختبار الفاشل في وحدة المستخدمين.»قد يبدأ بالبحث عن الاختبار، ثم يقرأ الكود المرتبط به، ويحدد السبب المحتمل، ويعدّل ملفًا، ويشغّل الاختبار، ثم يقرأ الخطأ الجديد إن ظهر ويكرر العملية.

القيمة هنا لا تأتي من كتابة الكود فقط، بل من قدرة الأداة على استخدام نتيجة كل خطوة كسياق للخطوة التالية.ولهذا فإن جودة النتيجة تعتمد بشدة على ثلاثة أشياء: السياق الذي توفره، الصلاحيات التي تمنحها، وطريقة التحقق من النتيجة.

استخدم CLAUDE.md لإعطاء المشروع ذاكرة ثابتة

إعادة شرح قواعد المشروع في بداية كل جلسة مضيعة للوقت.لهذا يوفر Claude Code ملفات “CLAUDE.md”. وهي ملفات Markdown تضع فيها تعليمات دائمة مثل بنية المشروع، أوامر البناء والاختبار، معايير كتابة الكود، والقواعد التي يجب مراعاتها عند التعديل.

ويقرأ Claude هذه التعليمات مع بداية الجلسات.يمكن أن يحتوي ملف بسيط مثلًا على معلومات من نوع:

• – استخدم TypeScript strict mode.
• – شغّل اختبارات الوحدة قبل اعتبار المهمة مكتملة.
• – لا تعدّل ملفات migrations القديمة.
• – توجد واجهات API داخل “src/api”.
• – استخدم pnpm بدل npm في هذا المشروع.لكن لا تحوّل “CLAUDE.md” إلى موسوعة.

توضح وثائق Claude Code أن التعليمات الأقصر والأكثر تحديدًا تحصل عادة على التزام أفضل، ويمكن تقسيم القواعد الكبيرة إلى ملفات داخل “.claude/rules/” وربطها بمسارات معينة.

ماذا عن Auto Memory؟

إلى جانب “CLAUDE.md” الذي تكتبه أنت، لدى Claude Code نظام Auto Memory يستطيع حفظ بعض المعارف التي يكتشفها أثناء العمل مثل أوامر البناء أو أنماط تصحيح الأخطاء أو تفضيلات المشروع.

توضح الوثائق الحالية أن الذاكرة التلقائية مفعّلة افتراضيًا، ويمكن مراجعتها وإدارتها من خلال “/memory”. وهي تختلف عن “CLAUDE.md”: الأول يمثل ما يتعلمه Claude، بينما الثاني يمثل التعليمات التي تريد أنت فرضها كسياق دائم.

لا تعتمد على الذاكرة بدل توثيق القرارات المهمة. قواعد المشروع الأساسية يجب أن تبقى في ملفات واضحة يمكن للفريق مراجعتها.الصلاحيات أهم من جودة الـPromptClaude Code يستطيع تشغيل أوامر وتعديل ملفات، وهذا يعني أن الصلاحيات ليست إعدادًا ثانويًا.النظام الحالي يسمح بقواعد Allow وAsk وDeny، وتكون قواعد المنع أعلى أولوية.

كما توجد أوضاع مختلفة تبدأ من الوضع الافتراضي الذي يطلب الموافقة على العمليات الحساسة، وصولًا إلى أوضاع أكثر استقلالية.للمبتدئ، أفضل قاعدة هي:لا توافق على أمر في الـTerminal لا تفهم بصورة معقولة ماذا سيفعل.إذا اقترح Claude حذف ملفات، تغيير إعدادات Git، تنفيذ migration، أو تشغيل أمر غير مألوف، اقرأ الأمر أولًا.وابتعد عن “bypassPermissions” أو “–dangerously-skip-permissions” على جهازك الرئيسي.

وثائق Anthropic نفسها توصي باستخدام هذا النوع من التشغيل فقط داخل بيئات معزولة مثل Containers أو Virtual Machines، لأنه يتجاوز طبقة الحماية المعتادة.

ما فائدة CLAUDE.md؟

يحتوي على التعليمات والسياق الدائم الذي تريد من Claude معرفته في كل جلسة، مثل بنية المشروع ومعايير الكود وأوامر الاختبار.

ما هو MCP؟

Model Context Protocol هو معيار لربط تطبيقات الذكاء الاصطناعي بالأدوات ومصادر البيانات الخارجية، ويمكن استخدامه في Claude Code للوصول إلى خدمات تحتاج إليها عملية التطوير.

هل Agent Teams أفضل من Subagents؟

ليس دائمًا. Subagents أنسب غالبًا للمهام المتخصصة داخل جلسة واحدة، بينما Agent Teams مفيدة للأعمال الكبيرة القابلة للتقسيم بين جلسات مستقلة تحتاج إلى التنسيق. Agent Teams ما زالت ميزة تجريبية في الوثائق الحالية.

هل يمكنني السماح لـClaude Code بتنفيذ كل شيء دون موافقتي؟

توجد أوضاع تقلل طلبات الموافقة، لكن تجاوز الصلاحيات بالكامل يرفع المخاطر. توصي الوثائق باستخدام وضع bypass فقط داخل بيئات معزولة مثل Container أو VM، وليس بصورة عشوائية على جهاز التطوير الرئيسي.

المصدر: صفحة freeCodeCamp الحالية للدورة منشورة في 26 مارس 2026، وتذكر أن Andrew Brown من ExamPro طوّر الدورة، وأنها تغطي Agentic Coding وCLI والجلسات والسياق والصلاحيات وHooks وMCP وSub-agents وMulti-Agent Teams، وتصفها بأنها دورة مدتها 12 ساعة