في الدروس السابقة فهمنا ما هو الـ Agent، وكيف يعمل الـ Agentic Loop. وعرفنا أن الـ Agent يعيش داخل مجلد. في الدرس الجاي سنثبّت Claude Code فعلياً، والتثبيت يحدث في مكان واحد: الـ Terminal، أي الشاشة السوداء التي تكتب فيها الأوامر.
وهنا بالضبط يتوقف كثير من الناس.
هذه الشاشة لا يوجد فيها زر واحد، لذلك تبدو وكأنها مكان للمبرمجين فقط. ويظن كثيرون أن أي حرف خاطئ فيها قد يكسر الجهاز. الحقيقة مختلفة تماماً: أنت تحتاج أقل من عشرة أوامر لتستخدم Claude Code طوال هذا الكورس. وكلها أوامر تقرأ أو تنقلك من مكان لآخر، ولا تحذف شيئاً.
فكّر في الـ Terminal كأنه نافذة الملفات، زي File Explorer على Windows أو Finder على Mac، لكن بالكتابة بدل الماوس. أنت تعرف بالفعل كيف تفتح مجلداً وترى ما بداخله وترجع للخلف. هذا كل ما سنفعله هنا، لكن بالكلمات بدل النقر.
بنهاية هذا الدرس، ستكون قادراً على:
على Windows، لديك أكثر من تطبيق يقوم بنفس الوظيفة تقريباً:
ابحث في قائمة Start عن cmd، وافتح تطبيق Command Prompt. هذا يكفي.
على Mac، افتح البحث بالضغط على Command + Space، ثم ابحث عن Terminal وافتحه. لا توجد خيارات متعددة تشغل بالك.
عندما تفتح الـ Terminal، سترى سطراً يشبه هذا على Windows:
C:\Users\Hatem>أو هذا على Mac:
hatem@MacBook ~ %هذا السطر مش زينة. هو يخبرك وين أنت واقف هسا، أي ما هو المجلد المفتوح أمامك في هذه اللحظة. وهذه أهم معلومة في الـ Terminal كله. لأنه كل أمر تكتبه ينفّذ في المكان الذي أنت واقف فيه، مش في مكان آخر.
على Mac، الرمز ~ يعني مجلد المستخدم الخاص بك، ويسمى مجلد Home. وعلى Windows، المسار C:\Users\Hatem هو نفس الشيء.
القاعدة التي تحتاج أن تحفظها: الـ Agent يقرأ المجلد الذي فتحته فيه. إذا فتحت Claude Code وأنت واقف في المكان الخطأ، سيقرأ ملفات لا علاقة لها بشغلك. أو لن يجد شيئاً أصلاً.
هذه كل الأوامر التي تحتاجها. اقرأها مرة، وارجع لهذه الصفحة كلما نسيت واحداً. لا أحد يحفظها من أول مرة.
على Mac:
pwdعلى Windows:
cdيطبع لك المسار الكامل للمكان الذي أنت واقف فيه. استخدمه كلما شككت.
على Mac:
lsعلى Windows:
dirيعرض لك الملفات والمجلدات الموجودة في المكان الحالي. هذا هو مقابل "فتح المجلد والنظر بداخله".
cd Documentsالأمر cd اختصار لعبارة change directory، أي «غيّر المجلد». اكتب cd ثم اسم المجلد الذي تريد الدخول إليه. لاحظ أن المجلد لازم يكون موجوداً في المكان الحالي. لا يمكنك القفز إلى مجلد لا تراه.
cd ..النقطتان تعنيان "المجلد الأب". هذا هو زر الرجوع.
على Mac:
cd ~على Windows:
cd %USERPROFILE%يعيدك إلى مجلد المستخدم مهما كنت متوغلاً في المجلدات.
mkdir agentic-aiالأمر mkdir اختصار لعبارة make directory، أي «أنشئ مجلداً». هذا الأمر تحديداً ستستخدمه كثيراً في هذا الكورس، لأنه كل مشروع جديد يبدأ بمجلد جديد.
claudeبعد التثبيت، هذه الكلمة الواحدة تفتح Claude Code في المكان الذي أنت واقف فيه.
على Mac:
clearعلى Windows:
clsهذا الأمر لا يحذف شيئاً. هو فقط يمسح ما هو معروض أمامك عندما تمتلئ الشاشة.
اضغط Control + C معاً.
إذا شعرت أن شيئاً عالقاً، أو أن أمراً يعمل ولا ينتهي، فهذا هو زر الإيقاف. تذكّره جيداً، لأنه يريحك نفسياً أكثر من أي أمر آخر في هذه القائمة.
هذه مش أوامر، لكنها تختصر وقتاً حقيقياً:
زر Tab يكمل الأسماء نيابة عنك. اكتب أول حرفين من اسم المجلد ثم اضغط Tab، وسيكمله الـ Terminal. هذا لا يوفر الوقت فقط، بل يمنع الأخطاء الإملائية. وهذه الأخطاء هي السبب الأول لرسالة "المجلد غير موجود".
السهم لأعلى يعيد آخر أمر كتبته. اضغطه مرتين ليعيد الأمر الذي قبله، وهكذا. لا تعيد كتابة أمر طويل من الصفر أبداً.
يمكنك سحب المجلد وإفلاته داخل الـ Terminal. اكتب cd ومسافة، ثم اسحب المجلد من نافذة الملفات وأفلته في الـ Terminal. سيكتب لك المسار كاملاً وبشكل صحيح.
هذه المشكلة ستقابلك، ومن الأفضل أن تعرفها قبل أن تحصل.
إذا كان اسم المجلد يحتوي على مسافة، مثل My Documents، فإن هذا الأمر سيفشل:
cd My Documentsلأنه الـ Terminal سيفهم أنك تتكلم عن مجلد اسمه My، ثم كلمة غريبة اسمها Documents. الحل هو وضع الاسم بين علامتي تنصيص:
cd "My Documents"أما المجلدات ذات الأسماء العربية، فهي تعمل تقنياً، لكنها ستسبب لك ارتباكاً بصرياً حقيقياً. اتجاه الكتابة سينقلب، والمسار سيبدو مبعثراً على الشاشة. وستجد صعوبة في معرفة وين ينتهي اسم المجلد.
النصيحة العملية: سمّ مجلدات العمل بالإنجليزي، حتى لو كان محتواها كله بالعربي. اسم مثل zaytoun-docs أسهل عليك وعلى الـ Agent من اسم مثل «مستندات زيتون».
هذا هو السيناريو الذي ستكرره في كل مشروع جديد بهذا الكورس. لنفترض أنك تريد مجلداً لملفات شركتك:
cd ~
mkdir zaytoun
cd zaytoun
claudeأربعة أسطر: ارجع للبداية، أنشئ مجلداً، ادخل إليه، شغّل الـ Agent. هسا الـ Agent يعمل حصرياً داخل هذا المجلد. وكل ملف تضعه فيه يصبح جزءاً من الـ Context الخاص به.
وهذه هي الفكرة التي بنينا عليها درس «الـ Agent والمجلدات» كاملاً: المجلد مش مجرد مكان تحفظ فيه الملفات. المجلد هو ذاكرة الـ Agent وحدود عمله.
الـ Terminal هو نافذة الملفات لكن بالكتابة. كل ما تعرف عمله بالماوس، زي فتح مجلد والنظر بداخله والرجوع للخلف، له كلمة واحدة تقابله.
السطر الذي أمامك يخبرك وين أنت واقف. اقرأه قبل أن تكتب أي أمر. لأنه كل أمر ينفّذ في المكان الحالي، والـ Agent يقرأ المجلد الحالي.
تسعة أوامر تكفيك: pwd وls وcd وcd .. وcd ~ وmkdir وclaude وclear وControl + C. لا شيء منها يحذف ملفاتك.
زر Tab يكمل، والسهم لأعلى يعيد، والسحب والإفلات يكتب المسار. ثلاث حركات تختصر عليك معظم الكتابة وتمنع معظم الأخطاء.
المسافات تحتاج علامات تنصيص، والأسماء العربية تربك الشاشة. سمّ مجلدات عملك بالإنجليزي وسترتاح.
كل مشروع يبدأ بمجلد خاص فيه. أنشئ المجلد أولاً، ثم ادخل إليه، ثم شغّل الـ Agent. مش العكس.
في الدرس الجاي: رح نثبّت Claude Code فعلياً خطوة بخطوة على Windows وعلى Mac، ونسجّل الدخول، ونشغّل أول أمر مع الـ Agent.
يلا، نلتقي بالدرس الجاي!