Claude Code: ما هو وكيف تثبّته؟ دليل البداية خطوة بخطوة

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

🎯 ماذا ستتعلم؟

بنهاية هذا الدرس ستكون قادرًا على:

• شرح ما هو Claude Code، وكيف يختلف عن المحادثة العادية مع الذكاء الاصطناعي.
• تثبيت Claude Code على Windows أو macOS أو Linux.
• التأكد من نجاح التثبيت بأمر واحد.
• بدء جلسة داخل مجلد مشروعك وكتابة أول طلب.
• كتابة طلبات واضحة يفهمها Claude Code جيدًا.

🧰 ماذا تحتاج قبل أن تبدأ؟

• جهاز كمبيوتر (Windows أو macOS أو Linux) واتصال بالإنترنت.
• معرفة بسيطة بالبرمجة تفيدك كثيرًا. إن كنت جديدًا، فابدأ بدرس ما هي البرمجة؟.
• حساب Claude لشخص بالغ. حسابات Claude متاحة لمن عمره 18 سنة فأكثر. لذلك اطلب من أحد والديك أو معلّمك أن يملك الحساب، وأن يجلس معك وأنت تتعلّم.

👨‍👩‍👦 ملاحظة للأهل والمعلمين: يحتاج Claude Code اشتراكًا مدفوعًا في Claude أو حسابًا في منصة Anthropic Console. ويُفضَّل أن يجرّب الطالب على مشروع تدريبي، لا على ملفات مهمة.

الفكرة ببساطة

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

أما Claude Code فيشبه صديقًا يأتي إلى بيتك ويمسك الأدوات معك. فهو يعمل داخل مشروعك مباشرة: يقرأ الملفات، ويعدّلها، ويشغّل الأوامر، ثم يتأكد أن كل شيء يعمل.

لهذا نسمّيه AI agent. الـ agent لا يكتفي بالإجابة، بل ينفّذ خطوات العمل بنفسه. ومع ذلك، أنت القائد دائمًا. Claude Code يستأذنك قبل الخطوات المهمة، وأنت توافق أو ترفض.

الخطوة 1: أين يعمل Claude Code؟

يعمل Claude Code في عدة surfaces، وكلها تستخدم المحرّك نفسه:

في هذا الدرس سنستخدم Terminal، لأنه الأساس. وما تتعلّمه هنا ستجده في كل الـ surfaces الأخرى.

الخطوة 2: افتح الـ Terminal

الـ Terminal نافذة نكتب فيها أوامر نصية للكمبيوتر بدل النقر بالفأرة. لا تقلق من شكلها البسيط، فهي أداة كل مبرمج.

• macOS: اضغط Cmd + Space، واكتب Terminal، ثم اضغط Enter.
• Windows: اضغط زر Start، واكتب PowerShell، ثم افتحه.
• Linux: اضغط غالبًا Ctrl + Alt + T.

الخطوة 3: ثبّت Claude Code

الطريقة الموصى بها هي native installer. ميزته أنه يحدّث Claude Code تلقائيًا في الخلفية.

على macOS أو Linux، انسخ هذا الأمر في الـ Terminal واضغط Enter:

curl -fsSL https://claude.ai/install.sh | bash

على Windows داخل PowerShell، استخدم هذا الأمر:

irm https://claude.ai/install.ps1 | iex

الأمر الأول يحمّل ملف التثبيت ثم يشغّله. انتظر قليلًا حتى ينتهي.

💡 على Windows: يُنصح بتثبيت Git for Windows أيضًا، ليستطيع Claude Code استخدام أوامر Bash. وإن لم يكن مثبّتًا، فسيستخدم PowerShell بدلًا منه.

هناك طرق أخرى للتثبيت إن كنت تفضّلها:

brew install --cask claude-code

winget install Anthropic.ClaudeCode

الأمر الأول لمستخدمي Homebrew على macOS، والثاني لمستخدمي WinGet على Windows. انتبه: هاتان الطريقتان لا تحدّثان Claude Code تلقائيًا، فعليك تحديثه بنفسك من وقت لآخر.

الخطوة 4: تأكد أن التثبيت نجح

أغلق الـ Terminal وافتح نافذة جديدة، ثم اكتب:

claude --version

2.1.287 (Claude Code)

إن ظهر رقم إصدار مثل هذا، فقد نجح التثبيت 🎉. لا تقلق إن كان الرقم عندك مختلفًا، فالإصدارات تتجدّد باستمرار.

الخطوة 5: ابدأ أول جلسة

Claude Code يعمل داخل مجلد المشروع. لذلك ادخل أولًا إلى مجلد مشروعك بالأمر cd، ثم شغّل claude:

cd my-quiz-game
claude

غيّر my-quiz-game إلى اسم مجلدك. في أول مرة سيطلب منك تسجيل الدخول، فيفتح المتصفح لتدخل بحساب Claude. هنا يأتي دور والدك أو معلّمك صاحب الحساب.

بعد الدخول ستظهر لك خانة كتابة. اكتب طلبك بلغة عادية واضغط Enter. جرّب أن تبدأ بسؤال لا يغيّر شيئًا:

اشرح لي ماذا يفعل هذا المشروع، وما هي أهم ملفاته

الخطوة 6: ماذا تطلب من Claude Code؟

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

أضف إلى لعبة الأسئلة عدّادًا للنقاط، واطبع النتيجة في النهاية

عند تشغيل البرنامج يظهر هذا الخطأ: NameError: name 'score' is not defined. ابحث عن السبب وأصلحه

اكتب اختبارات لدالة حساب المعدّل، ثم شغّلها وأصلح أي فشل

لاحظ أن كل طلب محدّد: ماذا تريد، وأين، وكيف تعرف أنه نجح. كلما كان طلبك أوضح، كانت النتيجة أفضل.

وعندما يريد Claude Code تعديل ملف أو تشغيل أمر، سيعرض عليك ما سيفعله ويطلب إذنك. اقرأ ما يعرضه قبل الموافقة، فهكذا تتعلّم منه أيضًا.

🚀 للمتقدمين: تستطيع تشغيل Claude Code بطلب واحد دون فتح جلسة كاملة، باستخدام الخيار -p. مثلًا: claude -p "اشرح ملف main.py في ثلاث نقاط". هذا مفيد لكتابة سكربتات تستخدم Claude Code تلقائيًا.

⚠️ أخطاء شائعة

1. الـ Terminal تقول إن claude غير موجود.

❌ zsh: command not found: claude

✅ الحل: أغلق الـ Terminal وافتح نافذة جديدة، ثم جرّب مرة أخرى. فالنافذة القديمة لا تعرف بالبرنامج الجديد. وإن استمر الخطأ، فراجع صفحة حلّ مشاكل التثبيت في توثيق Claude Code.

2. كتابة أمر Windows في المكان الخطأ.

❌ 'irm' is not recognized as an internal or external command

✅ الحل: أنت في نافذة CMD، والأمر مكتوب لـ PowerShell. افتح PowerShell وأعد الأمر. ستعرف أنك في PowerShell إن بدأ السطر بـ PS.

3. تشغيل claude خارج مجلد المشروع.

إن شغّلته في مجلد آخر، فسيقرأ ملفات ذلك المجلد ولن يجد مشروعك. ✅ الحل: استخدم cd للدخول إلى مجلد المشروع أولًا، ثم شغّل claude.

🧪 جرّب بنفسك

التحدي 1 (سهل): افتح الـ Terminal، وتأكد من إصدار Claude Code عندك. ما الأمر الذي ستكتبه؟

claude --version

التحدي 2 (متوسط): أنشئ مجلدًا جديدًا اسمه football-scores، وادخل إليه، ثم ابدأ جلسة Claude Code فيه.

mkdir football-scores
cd football-scores
claude

التحدي 3 (للمتقدمين): هذا الطلب غامض: «اعمل لي برنامج كورة». أعد كتابته بحيث يكون محدّدًا وواضحًا.

أنشئ ملف بايثون اسمه scores.py. فيه قاموس لنتائج 4 فرق كرة قدم، ودالة تطبع الفريق صاحب أعلى نقاط. شغّل الملف وأرني الناتج.

✅ اختبر نفسك

1. ما الفرق الأساسي بين Claude Code والمحادثة العادية مع الذكاء الاصطناعي؟ (أ) Claude Code أسرع فقط (ب) Claude Code يعمل داخل مشروعك ويعدّل الملفات ويشغّل الأوامر (ج) لا فرق بينهما
2. صح أم خطأ: بعد التثبيت بأداة Homebrew يتحدّث Claude Code تلقائيًا.
3. ما الأمر الذي يبدأ جلسة Claude Code؟

📝 الخلاصة

• Claude Code هو AI agent يقرأ مشروعك، ويعدّل الملفات، ويشغّل الأوامر بإذنك.
• يعمل في Terminal، وفي VS Code وJetBrains، وفي Desktop app، وفي Web.
• التثبيت الموصى به بأمر واحد، ويتحدّث تلقائيًا.
• تتأكد من التثبيت بالأمر claude --version، وتبدأ الجلسة بالأمر claude داخل مجلد المشروع.
• الطلب الواضح المحدّد يعطيك نتيجة أفضل، والحساب يملكه شخص بالغ.

⏭️ الخطوة التالية

الآن صار عندك مساعد برمجة على جهازك! في الدرس التالي ستتعلّم كيف تعلّمه Skills جديدة خاصة بك: Claude Code Skills. وتستطيع متابعة مسار Claude درسًا بعد درس.