أثناء عمل وكيل البرمجة، يمكنكم متابعة ما يفعله وتصحيحه. ويمكنكم أيضًا اختيار الإجراءات التي تحتاج إلى موافقتكم. تشرح المحاضرة كيف تستخدمون وسائل التحكم هذه في Claude Code. وسنشرح أيضًا ما يمكنكم التراجع عنه عندما يحدث خطأ ما.
في مثالنا، تحاول مبرمجة إصلاح مشكلة في تسجيل الدخول إلى برنامج تتولّى صيانته. يجب أن يستطيع المستخدمون الدخول حتى لو كتبوا أحرفًا كبيرة في عنوان بريدهم الإلكتروني، لكن الدخول يفشل حاليًا. تطلب من الوكيل إصلاح المشكلة وتتابع عمله خطوة بخطوة.
يقرأ الوكيل كود تسجيل الدخول قبل تعديله، كي يبني على ما هو موجود أصلًا. يُظهر سطر Read الملف الذي فتحه.
يشغّل الوكيل برنامج تسجيل الدخول بالعنوان Alice@Example.com، مستخدمًا أحرفًا كبيرة في العنوان. يردّ البرنامج بأن المستخدم غير معروف، فترى المشكلة بنفسها. يُظهر سطر Bash الأمر ومُخرَجاته. يمكنها تشغيل المثال نفسه بعد التعديل لتتحقّق من نجاحه.
يعدّل الوكيل ملف تسجيل الدخول لمعالجة المشكلة. يخبرها سطر Edit بالملف الذي تغيّر، لكنها لا تزال بحاجة إلى قراءة التغييرات لتفهم أثرها.
يشغّل الوكيل المثال نفسه مرة أخرى. هذه المرة يرحّب البرنامج بـ Alice، فهذا العنوان يعمل الآن. تتيح لها استدعاءات الأدوات هذه متابعة ما فعله الوكيل. مثال واحد ناجح لا يثبت أن نظام تسجيل الدخول كله يعمل، لذا لا تزال بحاجة إلى قراءة التغييرات وفحص حالات أخرى مهمة.
بعض الإجراءات تحتاج إلى موافقتكم، بحسب إعدادات الصلاحيات. يسأل طلب الإذن هذا هل يُسمح للوكيل بإنشاء ملف اسمه hello.py. يعرض الطلب اسم الملف وسطر الكود الذي يريد الوكيل كتابته. تحقّقوا مما سيفعله الإجراء قبل الموافقة عليه.
هنا يمكنكم الموافقة على هذا الإجراء فقط، أو السماح بالتعديلات لبقية الجلسة، أو الرفض. إذا رفضتم، فيمكنكم إخبار الوكيل بما عليه فعله بدلًا من ذلك. الإجراء المسموح به مسبقًا يمكن تشغيله دون سؤالكم من جديد، لذا لا يظهر طلب إذن لكل تعديل أو أمر. تأكّدوا: هل تشمل موافقتكم إجراءً واحدًا، أم تسمح بإجراءات أخرى لاحقًا؟
يحدّد وضع الصلاحيات كيف تُفحص الإجراءات قبل تشغيلها. اضغطوا Shift+Tab للتنقل بين الأوضاع المتاحة في إعدادكم. يسألكم الوضع اليدوي عن الإجراءات غير المسموح بها مسبقًا. بعض الإجراءات، مثل قراءة الملفات، والإجراءات التي تسمح بها قواعدكم، تُنفَّذ حتى في هذا الوضع دون طلب إذن.
في وضع قبول التعديلات، يمكن للوكيل تعديل الملفات وتنفيذ العمليات الشائعة عليها دون سؤالكم كل مرة. وقد يشمل ذلك نقل الملفات أو حذفها، بينما قد تظل أوامر أخرى بحاجة إلى موافقة.
في وضع التخطيط، يستطيع الوكيل قراءة المشروع واقتراح خطة قبل تغيير الكود. ما يُسمح به في هذا الوضع يعتمد على إعدادكم، فلا تفترضوا أن تشغيل الأوامر كلها ممنوع فيه.
يستخدم الوضع التلقائي نموذجًا آخر يُسمّى مصنِّفًا، ليتحقّق هل تبدو الإجراءات آمنة وتناسب المهمة. يمكنه السماح بتشغيل الإجراءات دون سؤالكم، لكنه يبقى معرّضًا للخطأ. يبدأ Claude Code في الوضع التلقائي ما لم تغيّر إعداداتكم ذلك. انظروا إلى الوضع على الشاشة، واختاروا الوضع اليدوي إن أردتم الموافقة بأنفسكم على مزيد من الإجراءات.
هناك أيضًا وضع يتخطى طلبات الإذن المعتادة، ويمكنكم تفعيله بخيار عند التشغيل. لكن هذا الوضع لا يعزل الوكيل عن بقية حاسوبكم. فلا يزال بإمكانه استخدام الملفات وبيانات الاعتماد والخدمات التي يصل إليها. لا تستخدموا هذا الخيار إلا في بيئة معزولة يمكنكم التخلص منها، مع تقييد وصول الوكيل فيها بعناية.
اختاروا الوضع بحسب المهمة، وبحسب ما قد يتضرّر إن وقع خطأ. ابدؤوا بمزيد من طلبات الإذن، ولا تقلّلوها إلا حين تفهمون ما يستطيع الوكيل تغييره وكيف ستتحقّقون من عمله.
إذا بدأ الوكيل يفعل الشيء الخطأ، فلا حاجة إلى انتظاره حتى ينتهي. اضغطوا Esc لإيقاف الردّ الحالي. أخبروا الوكيل بلغة بسيطة بما يجب تغييره. إيقافه لا يتراجع عن الإجراءات التي أنهاها بالفعل، لذا تحقّقوا مما فعله قبل المتابعة.
يمكنكم أيضًا تغيير تعليماتكم أثناء المهمة. تابعوا في المحادثة نفسها دون شرح المهمة كلها من جديد. مثلًا، قولوا: «أبقِ الـ API القديم، ليظل الكود الآخر يستدعيه بالطريقة نفسها». بهذا تخبرون الوكيل بما يجب أن يتركه كما هو أثناء تنفيذ التغيير المطلوب.
يمكنكم الرجوع إلى نقطة سابقة في المحادثة، والمتابعة بتعليمات أوضح. اختاروا رسالة سابقة، ثم اقرؤوا خيارات الاستعادة المتاحة. لفتح قائمة الرجوع في المحادثة، اضغطوا Esc مرتين على سطر إدخال فارغ. إذا كنتم قد بدأتم كتابة رسالة، فالضغط على Esc مرتين يمسح تلك المسودة أولًا.
يمكن للرجوع التراجع عن تعديلات حفظتها أدوات التعديل في Claude Code، لكنه لا يتراجع عن كل تغيير. يمكنه استعادة المحادثة، أو تعديلات الملفات المحفوظة، أو كليهما، بحسب ما حُفظ. ولا يتراجع الرجوع عن أوامر الـ shell، ولا عن الإجراءات في أنظمة أخرى. إذا حذف أمرٌ ملفًا أو نشر تغييرًا، فالرجوع إلى نقطة سابقة لا يتراجع عمّا فعله الأمر.
Git أداة للتحكم في الإصدارات تحفظ نسخًا من المشروع لمقارنتها أو الرجوع إليها لاحقًا. هذه النسخ المحفوظة منفصلة عن المحادثة. استخدموا Git من البداية، وتأكّدوا من أن ملفاتكم المهمة محفوظة. نأمل أنكم تعلّمتموه في مساقات سابقة. وإن لم تتعلّموه، فسنراجعه لاحقًا في المساق. حتى Git لا يستطيع التراجع عن كل شيء. فمثلًا، إذا نشرتم تغييرًا على الإنترنت، فقد يلزم التراجع عن الإجراء هناك.
باختصار: يمكنكم إيقاف الوكيل، أو تصحيحه، أو الرجوع إلى نقطة سابقة في المحادثة. بهذه الوسائل تعدّلون المهمة كلما اتّضحت لكم الصورة. صحّحوا الخطأ مبكرًا، قبل أن يبني الوكيل فوقه مزيدًا من الكود. استخدموا طريقة التراجع التي تناسب التغيير، ثم تحقّقوا مما استُعيد.
أثناء عمل الوكيل، اقرؤوا استدعاءات الأدوات لتتابعوا ما يفعله. تحقّقوا من الكود ومن سلوك البرنامج، حتى لو قال الوكيل إن المهمة انتهت.
اختاروا الإجراءات التي تحتاج إلى موافقتكم بضبط وضع الصلاحيات وقواعدها. الإجراءات التي سمحتم بها مسبقًا قد تُنفَّذ دون طلب إذن آخر.
يوقف Esc الردّ الحالي، وضغطه مرتين على سطر إدخال فارغ يفتح قائمة الرجوع. الإيقاف ليس كالتراجع، لذا تحقّقوا مما تغيّر واختاروا الطريقة الصحيحة لاستعادته.
استخدموا هذه الوسائل في المختبر عند بناء العرض التوضيحي. احضروا بعد تثبيت Claude Code وتسجيل الدخول فيه، مستعدين لمتابعة عمله وتصحيحه.