تعرض هذه المحاضرة كيفية تثبيت وكيل برمجة والبدء باستخدامه في الطرفية. نستخدم Claude Code في أمثلتنا. سنشرح خطوة بخطوة كيف تثبّتونه على حاسوبكم. يمكنكم استخدام وكيل برمجة آخر في هذا المساق إن فضّلتم ذلك. طريقة العمل الأساسية متشابهة في هذه الأدوات. لكن أوامرها وإعداداتها قد تختلف. وسنرى أيضًا كيف تسجّلون الدخول وتبدؤون جلستكم الأولى، وكيف تتحقّقون من حدود الاستخدام في حسابكم.
واجهة سطر الأوامر (CLI) تتيح لكم العمل بالكتابة في الطرفية. وهناك تتحدّثون مع وكيل البرمجة. تعطون الوكيل مهمة بلغة عادية. في هذا المثال، نطلب منه إصلاح اختبار فاشل.
على الوكيل أن يكتشف سبب فشل الاختبار. يمكنه قراءة الكود والنظر في الاختبارات وقراءة تعليمات المشروع. قراءة هذه الملفات تساعده على معرفة أمور لم تذكروها في طلبكم.
يستطيع الوكيل تعديل الملفات بنفسه. مثلًا، قد يجد مشكلة في دالة ما فيعدّلها. هذه تغييرات في ملفات مشروعكم.
ويستطيع الوكيل أيضًا تشغيل أوامر. في هذه الأمثلة، تشغّل الأوامر الاختبارات أو تبني البرنامج. يقرأ الوكيل النتيجة ويستخدمها ليقرّر خطوته التالية.
مع مساعد محادثة، قد تحصلون على كود عليكم نسخه إلى مشروعكم. أما هنا، فيستطيع الوكيل قراءة الملفات وتعديلها وتشغيل الأوامر مباشرة. وقد يفعل ذلك عدة مرات خلال مهمة واحدة. قد ينجح تشغيل أمر ما حتى لو كان الكود لا يزال خاطئًا. لذلك ما زال عليكم التحقّق من التغييرات والنتائج.
نستخدم في أمثلتنا Claude Code، وهو وكيل برمجة من إنتاج Anthropic. أما Claude فهو اسم النماذج، ومنها Opus وSonnet وHaiku. وClaude Code هو البرنامج الذي يتيح لهذه النماذج استخدام الأدوات في مشروعكم.
يمكنكم أيضًا استخدام Claude Code داخل محرّرات مثل Visual Studio Code وJetBrains. يظهر الوكيل في لوحة بجانب الكود. أمثلتنا تستخدم الطرفية. وطريقة العمل الأساسية تنطبق أيضًا داخل المحرّر، وإن اختلف شكل بعض عناصر التحكم.
ومن وكلاء البرمجة الآخرين: Codex CLI من OpenAI، وGemini CLI من Google، وخيارات مفتوحة المصدر مثل OpenCode. هذه مجرد أمثلة، وليست قائمة كاملة. تتيح لكم هذه الأدوات إعطاء مهام لوكيل يعمل على مشروعكم. كثير منها يوفّر ملفات لحفظ التعليمات، وأوامر slash، وإعدادات تحدّد ما يُسمح للوكيل بفعله. الأفكار الأساسية متشابهة، لكن الأوامر والإعدادات قد تختلف.
أمثلة المساق كلها تستخدم Claude Code. العمل بأداة واحدة يتيح لنا وقتًا أطول لتعلّم استخدامها جيدًا، بدلًا من تكرار الإعداد لعدة أدوات. لكن يمكنكم أنتم استخدام أيٍّ من هذه الأدوات في المختبرات والمشروع. اتّبعوا تعليمات الأداة التي تختارونها حين تختلف أوامرها أو إعداداتها.
هذا الأمر الأول يثبّت Claude Code على macOS أو Linux أو على Windows عبر WSL. وهو ينزّل سكربت التثبيت من Anthropic ويشغّله. انسخوه من التعليمات الرسمية وتحقّقوا من مصدره قبل تشغيله. عند التثبيت بهذه الطريقة، تُحدَّث الأداة تلقائيًا ما لم تغيّروا هذا الإعداد.
يمكن أيضًا تشغيل Claude Code مباشرة على Windows. وهذا الأمر في PowerShell يثبّته هناك. إنه خيار بديل، وليس خطوة إضافية بعد التثبيت في WSL.
يمكنكم أيضًا تثبيت Claude Code عبر Homebrew أو npm. اختاروا طريقة واحدة. لا حاجة إلى تثبيته عدة مرات. ومع Homebrew، تُجرون التحديثات بأنفسكم عادةً. اطّلعوا على تعليمات الإعداد والتحديث الرسمية للطريقة التي تستخدمونها.
على Windows، استخدموا WSL 2 في المساق. فهو يتيح لكم استخدام Linux داخل Windows. افتحوا فيه طرفية Linux، وشغّلوا أمر التثبيت الخاص بـ Linux. تستخدم المختبرات shell بنمط Unix، أي برنامج سطر الأوامر الذي تجدونه على macOS وLinux. أبقوا الوكيل وأدوات مشروعكم في النظام نفسه الذي ستستخدمونه في المساق.
بعد التثبيت، اكتبوا claude --version في الـ shell. إذا ظهر رقم الإصدار، فالطرفية تجد البرنامج وتستطيع تشغيله. الأمر claude doctor يفحص إعدادكم بتفصيل أكبر. ويمكنه الإبلاغ عن مشكلات في التثبيت أو الإعدادات واقتراح حلول. أصلحوا هذه المشكلات قبل بدء المختبر.
لاستخدام النموذج، عليكم تسجيل الدخول. وتُسمّى هذه العملية المصادقة. أحد الخيارات هو تسجيل الدخول عبر المتصفح باشتراك في Claude يشمل Claude Code، مثل باقة Max. تتضمّن الباقة قدرًا محدودًا من الاستخدام، دون رسوم منفصلة لكل token ضمن هذا الحدّ. قد تدفعون مقابل استخدام أكثر إذا فعّلتم الاستخدام الإضافي. تحقّقوا من إعدادات الفوترة لتعرفوا إن كان مفعّلًا.
خيار آخر هو استخدام مفتاح API من Anthropic. يتيح المفتاح للبرنامج الاتصال بحساب الـ API الخاص بكم. مع الـ API، تدفعون مقابل ما تستخدمونه. النص الذي ترسلونه والنص الذي يكتبه النموذج كلاهما يُحسب بقطع صغيرة تُسمّى tokens. يمكن لسكربت استخدام المفتاح دون أن يضطر أحد إلى تسجيل الدخول عبر المتصفح في كل مرة. وهذا مفيد للمهام التي تعمل تلقائيًا. فاتورة الـ API منفصلة عن اشتراككم. إذا استخدمتم الوكيل كثيرًا، فالاشتراك سيكلّف أقل بكثير من دفع ثمن العمل نفسه عبر الـ API. التفاصيل تعتمد طبعًا على الباقة، وعلى النماذج التي تختارون استخدامها، وعلى مقدار استخدامكم لها.
نتوقّع أنكم ستحتاجون في المساق إلى باقة Claude Max 5x، أو باقة مشابهة تعمل مع وكيل آخر. تحقّقوا من شروط الباقة الحالية قبل الشراء. داخل Claude Code، يتيح لكم الأمر /login تسجيل الدخول أو تبديل الحساب.
ابدؤوا من مجلد مشروعكم. هنا، يفتح الأمر cd المجلد «my-project». استخدموا اسم مشروعكم أنتم وموقعه. المجلد يخبر الوكيل أين تريدون أن يعمل. استخدام Git في هذا المجلد سيساعدكم على حفظ نسخ والتراجع عن التغييرات. وسنتحدّث عن ذلك لاحقًا في المساق.
اكتبوا claude لبدء جلسة. سيفتح هذا Claude Code في الطرفية، حيث تكتبون طلباتكم وتقرؤون ردود الوكيل.
في أول مرة تشغّلون فيها Claude Code، اتّبعوا خطوات تسجيل الدخول. إذا كنتم تسجّلون الدخول عبر المتصفح، فأكملوا هذه الخطوات فيه. وإذا كنتم قد سجّلتم الدخول، فقد لا يُطلب منكم ذلك مجددًا.
ابدؤوا بسؤال يمكنكم التحقّق من إجابته، مثل: ماذا يفعل هذا المشروع؟ ويمكنكم أيضًا أن تطلبوا من الوكيل ألّا يغيّر أي ملف. لاحظوا الملفات التي يقرؤها، ثم قارنوا شرحه بها.
أنتم الآن تعملون داخل جلسة. الأمر /status يعرض إعداداتكم الحالية، بما فيها النموذج وطريقة تسجيل دخولكم. استخدموه للتحقّق من الإعداد والحساب الحاليَّين.
عند فتح مشروع، قد يسألكم Claude Code إن كنتم تثقون بهذا المشروع. سطر مساحة العمل في أعلى الشاشة يبيّن المجلد الذي يسأل عنه. تحقّقوا من أنه المجلد الذي قصدتم فتحه. وإن لم يكن كذلك، فاختاروا الخروج وشغّلوا الوكيل من جديد من المجلد الصحيح.
يذكر هذا السؤال أن الوكيل سيتمكّن هنا من قراءة الملفات وتعديلها وتشغيلها. لكن هذه الإجراءات ما زالت تعتمد على صلاحياته. والثقة بالمجلد لا تجعل كل إجراء لاحق آمنًا. فكّروا في مصدر المشروع. فقد تحتوي ملفاته على تعليمات للوكيل، أو إعدادات، أو كود يمكنه تشغيله. إذا كنتم لا تعرفون المشروع، فتصفّحوه قبل أن تثقوا به.
تُظهر هذه اللقطة الشاشة الرئيسية داخل جلسة Claude Code. يعرض مربع الترحيب النموذج والباقة ومجلد المشروع. قد تبدو شاشتكم مختلفة قليلًا بحسب حسابكم وإصدار Claude Code لديكم.
اكتبوا طلبكم في سطر الإدخال قرب أسفل الشاشة. أخبروا الوكيل بما تريدون منه أن يفعله، وبما يجب ألّا يغيّره. راقبوا عمله وتحقّقوا من الإجابة. الطلب وحده لا يمنع التعديلات، لذا استخدموا إعدادات الصلاحيات أيضًا إذا احتجتم إلى منعها.
الاشتراك لا يمنح استخدامًا غير محدود. تُظهر هذه اللقطة شاشة الاستخدام، مع أشرطة للحدود التي تنطبق على الحساب. شريط الجلسة الحالية يبيّن الاستخدام ضمن فترة الخمس ساعات. تحقّقوا من موعد التجدّد المكتوب تحته. وهناك أيضًا حدّ أسبوعي منفصل لجميع النماذج معًا. وهو يتجدّد في موعد أسبوعي ثابت يظهر في حسابكم. قد يتبقّى لكم استخدام في فترة الخمس ساعات بينما تكونون قد بلغتم الحدّ الأسبوعي. وقد ترون أيضًا حدودًا لنماذج بعينها، كما في الشريط السفلي هنا. باقة Max 5x تمنح حصة جلسة تعادل نحو خمسة أضعاف حصة باقة Pro. ومن يُكثر الاستخدام قد يحتاج إلى حساب أغلى من ذلك.
قد تتشارك محادثات Claude وClaude Code حدّ الاستخدام نفسه. فاستخدام Claude على الويب أو في تطبيق سطح المكتب قد يُبقي لكم استخدامًا أقل للبرمجة. الاستخدام لا يقتصر على عدد الطلبات التي ترسلونها. فالرسائل والملفات السابقة قد تُرسَل من جديد مع كل طلب جديد. لذلك قد تعني المحادثة الأطول نصًا أكثر يعالجه النموذج. كما أن النماذج الأكبر قد تستهلك الحصة أسرع من النماذج الأصغر. ومقدار الاستهلاك يعتمد على النموذج والعمل الذي يؤدّيه.
الأمر /usage يبيّن مقدار ما استخدمتم وموعد تجدّد الحدود. تحقّقوا منه خلال المهام الأطول، خاصة حين تقتربون من أحد الحدود. في الإصدار الحالي من الأداة، الأمر /cost هو اسم آخر للأمر /usage. تقدير التكلفة في الأعلى محسوب بأسعار الـ API. وهو ليس فاتورة إضافية على عمل يغطّيه اشتراككم. إذا كنتم تدفعون عبر الـ API، فتحقّقوا من الفاتورة الفعلية بدلًا من الاعتماد على هذا التقدير.
العمل مع الوكيل لا يقتصر على إعداده. لا يتّسع الأسبوع الأول لهذه المواضيع الثلاثة كاملةً، لذا سنترك التفاصيل لوقت لاحق. أما الآن، فهناك بعض العادات التي ينبغي أن تحرصوا عليها من البداية.
استخدموا Git منذ بداية المشروع. عندما تكون لديكم نسخة تعمل، احفظوها كـ commit قبل إجراء تغيير كبير. تحقّقوا مما تغيّر قبل أن تحفظوا الـ commit التالي. يمنحكم الـ commit نسخة محفوظة تقارنون بها أو تعودون إليها. سنتناول Git وGitHub بالتفصيل لاحقًا.
أوضاع الصلاحيات تحدّد كم مرة يسأل الوكيل قبل أن يتصرّف. الفيديو التالي يعرّفكم بالأوضاع التي ستحتاجونها في المختبر. وسنتناول لاحقًا قواعد الصلاحيات المحفوظة وطرق تقييد وصول الوكيل بتفصيل أكبر. خلال فترة التعلّم، أبقوا طلبات الإذن مفعّلة. اقرؤوا ما يريد الوكيل فعله قبل أن توافقوا عليه. تحقّقوا من الملفات التي قد يغيّرها، وهل يمكن أن يغيّر شيئًا خارج حاسوبكم، كمستودع مشترك. لا تمنحوا الإذن إلا بعد التحقّق من الإجراء.
الجلسة الجديدة لا تتضمّن تلقائيًا كامل المحادثة السابقة. نافذة السياق هي أقصى قدر من المعلومات يستطيع النموذج استخدامه في وقت واحد. ملفات الذاكرة يمكنها حفظ تعليمات أو حقائق لجلسة أخرى. سنتناولهما الأسبوع القادم. لا تحتاجون إلى كل التفاصيل قبل المختبر الأول. أخبروا الوكيل بما تريدون فعله، وبما يحتاج إلى معرفته عن المشروع. التعليمات المحفوظة أو الذاكرة يمكنها نقل بعض المعلومات إلى جلسة جديدة. ويمكنكم أيضًا استئناف جلسة سابقة. تحقّقوا مما يعرفه الوكيل بدلًا من افتراض أنه يتذكّر كل قرار.
أنتم تعرفون الآن كيف تثبّتون Claude Code، وتسجّلون الدخول، وتبدؤون جلسة. جرّبوا طلبًا بسيطًا وتحقّقوا من الإجابة لتتأكّدوا أن إعدادكم يعمل.
الفيديو التالي يتناول العمل داخل الجلسة. قبل المختبر، ثبّتوا الأداة وسجّلوا الدخول. ورقة تعليمات المختبر تذكر الأدوات والحسابات الأخرى اللازمة.