ما تحتاجه
قبل أن تبدأ البناء مع الذكاء الاصطناعي في الدرس ٣، تحتاج إلى تثبيت ثلاثة أشياء على جهازك. الثلاثة مجانية التحميل. العنصر المدفوع الوحيد هو اشتراكك في Claude، والذي قد يكون لديك بالفعل.
لا تحتاج إلى بيئة تطوير معقدة. VS Code هو مجرد الحاوية، وClaude Code هو المحرك. فكّر في VS Code كمفكرة ذكية جداً يمكنها التحدث مع الذكاء الاصطناعي. أما Git فهو نظام التحكم بالإصدارات الذي يعمل في الخلفية ويستخدمه Claude Code لتتبع التغييرات. هذا كل شيء.
اختر نظام التشغيل أدناه. الخطوات تختلف قليلاً بين Windows وMac.
VS Code هو محرر أكواد مجاني من Microsoft. لا تدع كلمة "أكواد" تخيفك. ستكتب بلغة طبيعية، وليس برمجة.
- اذهب إلى code.visualstudio.com وانقر على Download for Windows
- شغّل ملف التثبيت الذي تم تحميله
- وافق على اتفاقية الترخيص، وانقر "التالي" في كل شاشة
- في شاشة "Select Additional Tasks"، ضع علامة على جميع الخيارات (خاصة "Add to PATH" و"Add Open with Code")
- انقر Install، ثم Finish
افتح VS Code للتأكد من أنه يعمل. سترى تبويب ترحيب. هذا كل ما تحتاجه في هذه الخطوة.
Git هو أداة للتحكم بالإصدارات. لن تستخدمه مباشرة، لكن Claude Code يحتاجه في الخلفية لتشغيل الأوامر وتتبع تغييرات الملفات. على Windows، يتضمن Git أيضاً "Git Bash" الذي يستخدمه Claude Code كواجهة أوامر.
- اذهب إلى git-scm.com/downloads/win وحمّل ملف التثبيت
- شغّل ملف التثبيت. سيسألك أسئلة كثيرة. اقبل جميع الإعدادات الافتراضية باستثناء واحد (انظر أدناه)
- عندما تصل إلى "Choosing the default editor used by Git"، غيّره من Vim إلى Visual Studio Code
- انقر Next في كل شاشة متبقية، ثم Install
إليك ملخص شاشات التثبيت. الرسالة الأساسية: اقبل الإعدادات الافتراضية.
| الشاشة | ماذا تختار |
|---|---|
| Select Components | اترك الإعدادات الافتراضية. تأكد أن "Git Bash Here" مفعّل |
| Default editor | غيّره إلى Visual Studio Code غيّر هذا |
| Initial branch name | أي خيار مناسب. "Override with main" هو المعيار الحديث |
| PATH environment | اترك الافتراضي: "Git from the command line and also from 3rd-party software" |
| SSH executable | اترك الافتراضي: "Use bundled OpenSSH" |
| HTTPS backend | اترك الافتراضي: "Use the OpenSSL library" |
| Line ending conversions | اترك الافتراضي: "Checkout Windows-style, commit Unix-style" |
| Terminal emulator | اترك الافتراضي: "Use MinTTY" |
| Git pull behaviour | اترك الافتراضي: "Fast-forward or merge" |
| Credential helper | اترك الافتراضي: "Git Credential Manager" |
| Extra options | اترك الإعدادات الافتراضية. لا تفعّل الميزات التجريبية |
للتحقق، افتح Command Prompt أو PowerShell واكتب git --version. يجب أن ترى رقم إصدار.
Claude Code هي إضافة لـ VS Code تمنحك واجهة محادثة مع الذكاء الاصطناعي داخل المحرر مباشرة. نشرتها Anthropic (الشركة المطوّرة لـ Claude).
- افتح VS Code
- اضغط
Ctrl+Shift+Xلفتح لوحة الإضافات - في شريط البحث، اكتب "Claude Code"
- ابحث عن الإضافة المنشورة من Anthropic (لديها ملايين التثبيتات)
- انقر Install
هذا كل شيء. لا شاشات إعداد، ولا خيارات للاختيار. نقرة واحدة.
إذا كان لديك حساب Claude Pro أو Max بالفعل:
- افتح أي ملف في VS Code (أيقونة Claude تظهر فقط عند فتح ملف)
- انقر على أيقونة الشرارة في أعلى يمين المحرر، أو ابحث عن "Claude Code" في شريط الحالة أسفل الشاشة
- سيفتح المتصفح لتسجيل الدخول عبر صفحة Anthropic
- سجّل دخولك، وستتم إعادة توجيهك إلى VS Code تلقائياً
إذا لم يكن لديك حساب بعد:
- اذهب إلى claude.ai في المتصفح
- انقر "Continue with Google" أو أدخل بريدك الإلكتروني وانقر "Continue with email"
- إذا استخدمت البريد الإلكتروني، تحقق من صندوق الوارد لرابط تسجيل الدخول (لا حاجة لكلمة مرور)
- بعد تسجيل الدخول، انقر على اسمك في الزاوية السفلى اليسرى، اذهب إلى Settings، ثم Billing
- قم بالترقية إلى Claude Pro (حوالي $٢٠/شهرياً). هذه هي أدنى خطة مطلوبة لـ Claude Code
- عد إلى VS Code وسجّل الدخول باتباع الخطوات أعلاه
Claude Code يتطلب خطة مدفوعة. الخطة المجانية من claude.ai لا تشمل الوصول إلى Claude Code. خطة Claude Pro هي أدنى خطة مدفوعة وهي كل ما تحتاجه لهذه الدورة.
- افتح مجلداً في VS Code (ملف > فتح مجلد، أو
Ctrl+K, O). اختر أي مجلد على جهازك، أو أنشئ مجلداً فارغاً جديداً - انقر على أيقونة الشرارة في أعلى يمين المحرر
- يجب أن تفتح لوحة Claude Code. قد ترى قائمة "Learn Claude Code" عند الإطلاق الأول
- اكتب "Hello, are you working?" واضغط Enter
- إذا رد Claude، فأنت جاهز. العمل الحقيقي يبدأ في الدرس ٣
اختياري: افتح الطرفية في VS Code (Ctrl+`) واكتب claude --version للتأكد من توفر واجهة الأوامر. يمكنك أيضاً تشغيل claude doctor للتحقق أن كل شيء مُعدّ بشكل صحيح.
لماذا مجلد وليس ملف؟ يعمل Claude Code بأفضل شكل عندما يرى مشروعك بالكامل. عند فتح مجلد، يمكن لـ Claude قراءة وتعديل وإنشاء ملفات في أي مكان داخله. إذا فتحت ملفاً واحداً فقط، يفقد Claude كل هذا السياق.
VS Code هو محرر أكواد مجاني من Microsoft. لا تدع كلمة "أكواد" تخيفك. ستكتب بلغة طبيعية، وليس برمجة.
- اذهب إلى code.visualstudio.com وانقر على Download for Mac
- انقر مرتين على ملف .zip الذي تم تحميله لاستخراجه
- اسحب أيقونة VS Code إلى مجلد Applications
- افتح VS Code من Applications
لا معالج تثبيت، ولا خيارات لضبطها. فقط اسحب وأفلت.
Git هو أداة للتحكم بالإصدارات. لن تستخدمه مباشرة، لكن Claude Code يستخدمه في الخلفية لتتبع التغييرات وإدارة الملفات. على Mac، غالباً ما يكون Git مثبتاً مسبقاً أو يسهل إضافته.
تحقق إذا كان مثبتاً لديك: افتح Terminal (ابحث عن "Terminal" في Spotlight) واكتب git --version. إذا رأيت رقم إصدار، انتقل إلى الخطوة ٣.
إذا لم يكن Git مثبتاً:
- عند تشغيل
git --versionلأول مرة، سيظهر macOS نافذة منبثقة تطلب تثبيت Xcode Command Line Tools - انقر Install في النافذة المنبثقة
- انتظر حتى ينتهي التحميل (بضع دقائق)
- شغّل
git --versionمرة أخرى للتأكد من التثبيت
هذا كل شيء. لا شاشات تثبيت، ولا خيارات للاختيار. macOS يتولى كل شيء نيابة عنك.
Claude Code هي إضافة لـ VS Code تمنحك واجهة محادثة مع الذكاء الاصطناعي داخل المحرر مباشرة. نشرتها Anthropic (الشركة المطوّرة لـ Claude).
- افتح VS Code
- اضغط
Cmd+Shift+Xلفتح لوحة الإضافات - في شريط البحث، اكتب "Claude Code"
- ابحث عن الإضافة المنشورة من Anthropic (لديها ملايين التثبيتات)
- انقر Install
هذا كل شيء. لا شاشات إعداد، ولا خيارات للاختيار. نقرة واحدة.
إذا كان لديك حساب Claude Pro أو Max بالفعل:
- افتح أي ملف في VS Code (أيقونة Claude تظهر فقط عند فتح ملف)
- انقر على أيقونة الشرارة في أعلى يمين المحرر، أو ابحث عن "Claude Code" في شريط الحالة أسفل الشاشة
- سيفتح المتصفح لتسجيل الدخول عبر صفحة Anthropic
- سجّل دخولك، وستتم إعادة توجيهك إلى VS Code تلقائياً
إذا لم يكن لديك حساب بعد:
- اذهب إلى claude.ai في المتصفح
- انقر "Continue with Google" أو أدخل بريدك الإلكتروني وانقر "Continue with email"
- إذا استخدمت البريد الإلكتروني، تحقق من صندوق الوارد لرابط تسجيل الدخول (لا حاجة لكلمة مرور)
- بعد تسجيل الدخول، انقر على اسمك في الزاوية السفلى اليسرى، اذهب إلى Settings، ثم Billing
- قم بالترقية إلى Claude Pro (حوالي $٢٠/شهرياً). هذه هي أدنى خطة مطلوبة لـ Claude Code
- عد إلى VS Code وسجّل الدخول باتباع الخطوات أعلاه
Claude Code يتطلب خطة مدفوعة. الخطة المجانية من claude.ai لا تشمل الوصول إلى Claude Code. خطة Claude Pro هي أدنى خطة مدفوعة وهي كل ما تحتاجه لهذه الدورة.
- افتح مجلداً في VS Code (ملف > فتح مجلد، أو
Cmd+K, O). اختر أي مجلد على جهازك، أو أنشئ مجلداً فارغاً جديداً - انقر على أيقونة الشرارة في أعلى يمين المحرر
- يجب أن تفتح لوحة Claude Code. قد ترى قائمة "Learn Claude Code" عند الإطلاق الأول
- اكتب "Hello, are you working?" واضغط Enter
- إذا رد Claude، فأنت جاهز. العمل الحقيقي يبدأ في الدرس ٣
اختياري: افتح الطرفية في VS Code (Cmd+`) واكتب claude --version للتأكد من توفر واجهة الأوامر. يمكنك أيضاً تشغيل claude doctor للتحقق أن كل شيء مُعدّ بشكل صحيح.
لماذا مجلد وليس ملف؟ يعمل Claude Code بأفضل شكل عندما يرى مشروعك بالكامل. عند فتح مجلد، يمكن لـ Claude قراءة وتعديل وإنشاء ملفات في أي مكان داخله. إذا فتحت ملفاً واحداً فقط، يفقد Claude كل هذا السياق.
حل المشكلات
معظم مشكلات الإعداد سهلة الحل. إليك أكثرها شيوعاً.
إذا واجهت أي مشكلة أثناء الإعداد، افتح claude.ai في المتصفح والصق رسالة الخطأ أو صِف ما يحدث. يمكنك حتى لصق لقطة شاشة. سيرشدك Claude إلى الحل خطوة بخطوة.
هذه حقاً أسرع طريقة لحل مشكلات الإعداد. يمكن للذكاء الاصطناعي قراءة رسائل الخطأ وتشخيص المشكلات وإعطاءك أوامر دقيقة لتنفيذها. استخدمه.
المشكلات الشائعة
- تأكد أن لديك ملفاً مفتوحاً (الأيقونة تظهر فقط عندما يكون ملف نشطاً في المحرر)
- تحقق أن إصدار VS Code لديك هو ١.٩٨.٠ أو أحدث (مساعدة > حول)
- جرّب تشغيل "Developer: Reload Window" من لوحة الأوامر (
Ctrl+Shift+P/Cmd+Shift+P) - بديل: ابحث عن "Claude Code" في شريط الحالة أسفل VS Code. هذا يعمل حتى بدون فتح ملف
هذا يعني أن Git for Windows غير مثبت أو أن Claude Code لا يستطيع العثور عليه. ثبّت Git من git-scm.com/downloads/win، ثم أعد تشغيل VS Code.
- ابحث عن رسالة في لوحة Claude Code. اضغط
cلنسخ رابط تسجيل الدخول يدوياً، ثم الصقه في المتصفح - تأكد أن اشتراكك في Claude Pro/Max فعّال على claude.ai/settings
- الخطة المجانية من Claude لا تدعم Claude Code. تحتاج اشتراكاً مدفوعاً
قد يكون اشتراكك المدفوع انتهى أو لم يُفعّل بعد. تحقق من حالة الفوترة على claude.ai/settings تحت قسم Billing.
إذا حدث أي خطأ، افتح claude.ai واسأل Claude مباشرة. الصق الخطأ، صِف المشكلة، ودع الذكاء الاصطناعي يحلها لك. إنه جيد بشكل ملحوظ في هذا الأمر، وهو بالضبط نوع مهارات حل المشكلات التي ستستخدمها طوال هذه الدورة.
أنت جاهز
VS Code مثبت، Git مثبت، إضافة Claude Code متصلة. هذا كل ما تحتاجه. الدرس التالي هو حيث يبدأ العمل الحقيقي: ستبني مستند عرض تقديمي كامل من الصفر، باستخدام اللغة الطبيعية فقط.