Claude Code طوال الليل: هندسة الحلقات وRalph Loop في 2026

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

الوثائق المرجعية لـ Ailoot: ailoot.ai/docs/.

ما هندسة الحلقات، ولماذا ينبغي أن تهتم بها؟#

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

أما التصريح الثاني فيوضح حجم العمل:

تقف وراء هذه التصريحات وظيفة هندسية جديدة: أنت مهندس الحلقات، لا مشغّل لوحة المفاتيح.

يصف النهج فكرة إنجاز المهام، وتتلخص الفكرة الرئيسية في الآتي:

أنجزه مرة اليوم، وستزداد العملاء المحتملون كل يوم، وتُنشر المقالات تلقائياً، ويتولى الروبوت المراسلات، ويصل تقرير المقاييس إلى مكتبك بحلول الساعة 9 صباحاً. تبنيه مرة، ثم يعمل كل يوم من دونك.

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

كيف يختلف Ralph Loop عن طلب Claude Code عادي؟#

في جوهرها، التقنية حلقة bash بسيطة حول وكيل:

هذا هو الكود الأصلي الذي أطلق الموجة كلها:

while :; do cat PROMPT.md | claude-code ; done

موجّه واحد في ملف، وحلقة لا نهائية حوله. وهذه أكثر تعليقات المؤلف صراحةً:

جمّعت Anthropic المنطق نفسه في الإضافة ralph-loop وفي الأوامر /loop و/goal و/batch في Claude Code؛ وهي متاحة مباشرةً في الطرفية من دون سكربتات. وأثار مجرد إصدار Anthropic إضافة لإعادة توجيه المطالبات بلا نهاية نقاشاً في GitHub Issue #23084 حول مدى إنصاف ذلك للنموذج. لا يزال النقاش مفتوحاً، لكن الإضافة تعمل.

ثلاثة أوامر مدمجة في Claude Code: /loop و/goal و/batch#

/goal هو الأمر الأقرب إلى Ralph Loop. في الخلفية، يتحقق نموذج تقييم (Haiku افتراضياً) في كل دور مما إذا كان الهدف قد تحقق. إن لم يتحقق، تتضمن الدورة التالية تلميحاً يوضح بالضبط ما الذي ينبغي إصلاحه. وإن تحقق، يتوقف. تناولت /goal بالتفصيل في دليل تشغيل Claude Code ذاتياً طوال الليل باستخدام /goal، ويتضمن سيناريوهات جاهزة للاستخدام لمدة 14 ساعة من العمل.

/batch أمر نادر لكنه قوي. عندما تحتاج إلى إجراء التغيير نفسه في أكثر من 100 ملف (ترحيل API، أو استبدال مكوّن، أو إعادة تسمية)، يرسل /batch كل ملف إلى وكيل فرعي منفصل ضمن git worktree خاص به. لا تتعارض التغييرات؛ إذ يعمل كل وكيل في نسخة معزولة. لمزيد من التفاصيل عن الوكلاء الفرعيين، راجع دليل الوكلاء الفرعيين المتداخلين.

في وصف المؤلف لهذا النهج، يُسمى ببساطة:

الحدود الصارمة لـ /loop و/goal:

• تستمر المهمة ما دام Claude Code مفتوحاً. أغلق الطرفية فتنتهي الحلقة. لدورة ليلية جادة، استخدم خادماً بعيداً أو غلاف shell خاصاً بك.
• الحد الأقصى لمدة المهمة المتكررة هو 7 أيام (بعد ذلك تُحذف تلقائياً للحماية من الحلقات المنسية).
• حتى 50 مهمة متزامنة في الجلسة الواحدة.

كيف تطلق أول حلقة مستقلة في 5 دقائق#

5 خطوات:

1. افتح المشروع في Claude Code

   انتقل إلى جذر المشروع في الطرفية وشغّل claude. انتظر حتى يقرأ Claude ملف CLAUDE.md ويفهرس المستودع.

2. حدّد هدفاً وشرط توقف

   الهدف هو ما يجب إنجازه. وشرط التوقف هو الطريقة التي سيعرف بها Claude أنه انتهى. والأفضل أن يكون أمراً يعيد 0 أو 1. مثال: «الهدف: اجتياز الاختبارات الـ23 كلها في tests/api/*.test.ts. توقف عندما يعيد pnpm test رمز الخروج 0».

3. شغّل /goal

   الأمر:

   /goal يجب أن تنجح جميع الاختبارات في tests/api/*.test.ts. شغّل pnpm test، واقرأ الأخطاء، وأصلحها، ثم شغّله مجدداً. توقف عندما يكون رمز الخروج = 0. الحد الأقصى 20 دورة.
   

نمط المُتحقِّق: كيف يفحص Claude عمله بنفسه ضمن حلقة#

هناك ثلاثة أنواع من أدوات التحقق:

1. تقني (رمز الخروج)—وهو الأكثر موثوقية. تعيد أوامر pnpm test وnpm run lint وtsc --noEmit وplaywright test القيمة 0 أو 1 من دون الحاجة إلى تفسير. يعمل /goal بهذه الطريقة أيضاً؛ إذ يستخدم في الخلفية نموذج تقييم Haiku، الذي يتحقق في كل دور مما إذا كان الشرط قد تحقق (حتى 4000 حرف).

2. نموذج تقييم—يفحص نموذج ثانٍ نتيجة النموذج الأول ويقيّمها وفق معايير. يصلح للمهام التي لا تملك فحصاً رسمياً («هل أسلوب الكتابة جيد؟» أو «هل يتوافق التصميم مع العلامة التجارية؟»). يُسمى هذا في Anthropic باسم Claude Code Review؛ وهو نمط يبحث فيه وكيل مراجعة منفصل عن أخطاء المنطق والحالات الطرفية ومشكلات الأمان في عمل الوكيل الرئيسي. ووفقاً للبيانات الداخلية لدى Anthropic، يكتشف 84% من المشكلات في طلبات السحب الكبيرة (مقارنةً بـ16% في النهج الأساسي).

3. فحص مخصص—سكربت shell تكتبه بنفسك. «إذا لم تتضمن السجلات كلمة ERROR، فالمهمة منتهية». «إذا كان الملف output.json موجوداً وقابلاً للتحليل، فالمهمة منتهية». «إذا أعادت صفحة /pricing الرمز 200، فالمهمة منتهية».

في نهج المؤلف، تتضمن المهارات مراجعةً خصومية منفصلة يجريها Claude بعد كل مرحلة. إليك قالب موجّه أضعه في CLAUDE.md أو في أمر:

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

أكثر أخطاء المبتدئين شيوعاً هو بدء حلقة من دون مُتحقِّق. يدور الوكيل في مكانه: يكتب الكود، ولا يفحصه، ويظن أنه انتهى، ثم ينتقل إلى الدورة التالية ويعيد كتابة ما أنجزه بالفعل. بعد ثلاث ساعات تصبح النتيجة فوضوية وتبلغ الفاتورة $200.

أفضل قاعدة تعلمتها هي: اكتب المُتحقِّق أولاً، ثم ابدأ الحلقة. إذا لم تستطع صياغة شرط التوقف في سطر واحد، فالمهمة غير جاهزة للاستقلالية.

كيف لا تنفق آلاف الدولارات طوال الليل: حدود الميزانية وشروط التوقف#

ثلاثة مكابح أساسية لأي حلقة تعمل طوال الليل:

1. حد التكرارات. --max-iterations 20. لا يمكن للحلقة أن تعمل أكثر من N مرة، حتى لو لم يُفعّل المُتحقِّق. إذا لم تبلغ شرط التوقف بعد 20 دورة، فالمهمة عالقة وتحتاج إلى تدخل بشري.

2. حد للرموز أو الإنفاق. /usage limit 50—بحد أقصى $50 يومياً. عندما تقترب الحلقة من الحد، تتوقف تلقائياً وترسل تنبيهاً.

3. فحص تقدم بعقد صريح. تكشف مقارنة HEAD أدناه commits جديدة، وليس كل تغييرات الشيفرة. استخدمها في شجرة عمل معزولة فقط، حيث تسجل كل دورة تغير الشيفرة commit محليًا كنقطة حفظ قبل المقارنة. لا تغير التعديلات المفيدة غير المثبتة HEAD؛ ودون هذا العقد قد يشير ثبات المعرّف إلى جمود كاذب. احتفظ أيضًا بنتيجة المتحقق؛ فالـ commit الجديد يثبت تغييرًا مسجلًا، وليس تحسن المهمة أو نجاحها.

هيكل توضيحي لغلاف يتضمن هذه الفحوص الثلاثة. أسطر تقارير التكلفة واستدعاء الوكيل أمثلة خاصة بالمشغل، وليست وصفة تثبيت CLI موثقة؛ أكد هذه الواجهات للإصدار المثبت قبل تكييفه. لفحص التقدم بالـ commits، اشترط نقطة حفظ محلية لكل دورة تغير الشيفرة. إذا ترك المشغل تعديلات غير مثبتة، فتوقف للمراجعة بدل وصفها بأنها «بلا تقدم».

#!/bin/bash
PROMPT="$1"
MAX_ITER=20
MAX_COST_USD=50
COMPLETION="DONE"
PREV_HASH=""
STAGNATION=0

for i in $(seq 1 $MAX_ITER); do
  # حد الإنفاق
  CURRENT_COST=$(claude usage --json | jq '.cost_usd')
  if (( $(echo "$CURRENT_COST > $MAX_COST_USD" | bc -l) )); then
    echo "STOP: budget cap $MAX_COST_USD reached"
    break
  fi

  # التشغيل
  OUTPUT=$(claude code -p "$PROMPT" --auto-accept)

  # التحقق من الاكتمال
  if echo "$OUTPUT" | grep -q "$COMPLETION"; then
    echo "STOP: completion signal"
    break
  fi

  # تقدم commits فقط: تسجل كل دورة تغير الشيفرة commit كنقطة حفظ.
  # لا يستطيع HEAD كشف التعديلات المفيدة التي تبقى غير مثبتة.
  CURRENT_HASH=$(git rev-parse HEAD 2>/dev/null)
  if [ "$CURRENT_HASH" = "$PREV_HASH" ]; then
    STAGNATION=$((STAGNATION + 1))
    if [ "$STAGNATION" -ge 3 ]; then
      echo "STOP: stagnation 3 iterations"
      break
    fi
  else
    STAGNATION=0
  fi
  PREV_HASH="$CURRENT_HASH"
done

تحقق من فحص التقدم قبل توسيع الهيكل: يعامل التعديل دون commit كعمل غير مسجل؛ وتغير نقطة حفظ بالـ commit قيمة HEAD؛ ولا يثبت النجاح سوى المتحقق المستقل. تشير ثلاث مقارنات بلا commits جديدة إلى غياب تغييرات مسجلة وفق العقد المحدد، لا إلى إثبات ثبات كل ملفات العمل. ويمكنك بعد ذلك إضافة تنبيه Slack عند التوقف، أو تقرير Telegram تلقائي في الصباح، أو إشعار push عندما تبلغ الميزانية 80%. المبدأ واحد: تحتاج الحلقة إلى مكابح، لا إلى دواسة تسريع فحسب.

5 سيناريوهات جاهزة للاستخدام لحلقات تعمل طوال الليل#

السيناريو 1: اجعل الاختبارات الفاشلة تنجح

/goal هناك 47 اختباراً فاشلاً في الدليل tests/. الهدف: اجعلها كلها تنجح.
شغّل pnpm test، واقرأ stderr، وافتح الملف الذي يحتوي على الخطأ، وأصلحه، ثم شغّل pnpm test مجدداً.
توقف عندما تكون النتيجة exit 0. الحد الأقصى 30 دورة.

السيناريو 2: إعادة هيكلة كبيرة تشمل 200 ملف

/batch استبدل عميل API القديم apiV1 بالجديد apiV2 في جميع الملفات تحت src/**/*.ts.
خصص worktree لكل ملف. بعد الاستبدال، شغّل tsc --noEmit وأصلح أي أخطاء.
ادمج worktree في النهاية.

السيناريو 3: مراقبة الإنتاج طوال الليل

/loop 30m كل 30 دقيقة، تحقق من https://your-app.example.com/api/health.
إذا لم يُرجع 200، فاقرأ السجلات واعثر على السبب وأصلحه ثم أعد النشر.
سجّل كل دورة في /tmp/night-monitor.log.

السيناريو 4: استيراد مجموعة بيانات كبيرة مع إزالة التكرارات

/goal استورد ملف CSV /tmp/import.csv (12,000 صف) إلى جدول clients.
لكل صف، تحقق من وجود تكرار باستخدام البريد الإلكتروني؛ أدرج الصف إذا لم يوجد تكرار، وحدّثه إذا وجد.
سجّل حالات التعارض في /tmp/conflicts.log. توقف بعد معالجة الصف الأخير.

السيناريو 5: خط إعداد المقالات (إعداد نموذجي)

لخدمة عبر الإنترنت أو وكالة تحتاج بانتظام إلى مقالات SEO، يبدو السيناريو كالتالي:

/loop 8h كل 8 ساعات: افتح ملف قائمة الانتظار وابحث عن الموضوعات ذات الحالة 'queued'.
إذا توفر موضوع، فشغّل مهارة كتابة دليل.
انشر إلى dev. غيّر الحالة إلى 'review'. أبلغ الشخص المسؤول عبر Telegram.

scenario 5

ما الذي تقدمه في كل دورة: CLAUDE.md وSecond Brain بوصفهما حالة#

تحوّل طبقات «ذاكرة» المشروع الثلاث الموجّه الذي يُستخدم مرة واحدة إلى حلقة مضبوطة:

1. CLAUDE.md—دستور المشروع. يوضح ماهية المنتج، ومكدس التقنيات، والقواعد، وما يجب عدم فعله مطلقاً. يقرأ Claude هذا الملف عند بدء كل جلسة وكل دورة من الحلقة. ومن دونه، يتعين على Claude «إعادة فتح» المشروع في كل مرة، ما يستهلك السياق ويزيد خطر الهلوسة. اعثر على قالب جاهز و6 قواعد في دليل CLAUDE.md.

2. Second Brain—مجلد للمعرفة التجارية: المنتج والجمهور والأهداف والاقتصاد والتسويق. إنه ليس كوداً، بل معنى. عندما تكتب الحلقة مقالاً أو تبحث عن إجابة للدعم، تقرأ Second Brain وتجيب ضمن سياق المشروع، لا من فراغ.

3. Context engineering—ما تقدمه بالضبط إلى Claude في كل دورة. لا تقدم مجلد Second Brain بكامله ولا المستودع كله، بل ما يرتبط بالمهمة فقط. يفيد Plan Mode هنا: يحدد Claude الملفات التي تحتاج إليها المهمة ويقرأها وحدها. مزيد من التفاصيل في دليل Plan Mode.

المبدأ التشغيلي الأساسي الذي اضطررت إلى ترسيخه بعد أخطاء كثيرة:

من دون الطبقات الثلاث، تتحول الحلقة إلى دورة لا نهائية وفاتورة متزايدة.

ما المهام في كل جلسة؟ مهام مختلفة: تصلح حلقةٌ الأخطاء، وتكتب أخرى ميزات جديدة، وتراجع ثالثة طلبات السحب للفريق، وتحسّن رابعة الأداء، وتعد خامسة الوثائق. لا يوجد وكيل عام واحد يفعل كل شيء. بل عشرات الوكلاء المتخصصين، لكل منهم مهارته وهدفه ومُتحقِّقه.

إعادة التأطير الأساسية:

بالنسبة إلى رائد أعمال ليس لديه مبرمجون، يعني ذلك شيئاً ملموساً. لديك حساب Claude مقابل $200/month وحاسوب محمول عادي. يمكنك تشغيل 5 حلقات بالتوازي: للدعم، والمقالات، والمقاييس، واختبار منتج جديد، ومراقبة المنافسين. تعمل كل حلقة في علامة تبويب Claude Code منفصلة. وفي الصباح، تقرأ الملخص. هذا هو بالفعل نمط العمل المعتاد في صيف 2026.

أربعة إخفاقات شائعة في الحلقات المستقلة#

الإخفاق 1: «حلقة الهلوسة»

يقرر الوكيل أنه انتهى رغم أن المُتحقِّق لم يُفعّل. أو لا يوجد مُتحقِّق أصلاً. بعد ثلاث ساعات يقول Claude: «انتهى كل شيء!» لكن الاختبارات فاشلة والصفحة لا تفتح ولا شيء يعمل. وقد أنفقت بالفعل $80 على دورات بلا جدوى.

الحل: مُتحقِّق صارم (أي exit code للأمر)، لا فحص لفظي.

الإخفاق 2: «استنزاف الميزانية طوال الليل»

من دون حد للميزانية، تصبح الحلقة قنبلة يدوية بلا صاعق أمان.

الحل: استخدم /usage limit أو سكربتاً خارجياً يستعين بـclaude usage --json لإيقاف الحلقة عند بلوغ حد معين.

الإخفاق 3: «فقدت الحلقة السياق بين الدورات»

في الدورة 1، اتخذ Claude قراراً معمارياً. وبحلول الدورة 7 نسيه واتخذ القرار المعاكس. وبعد 15 دورة، يصبح الكود كومة فوضى.

الحل: أضف طبقة حالة باستخدام CLAUDE.md ومجلد Second Brain. تسجل الحلقة كل قرار معماري في ملف تقرأه في الدورة التالية.

الإخفاق 4: «شرط التوقف غير دقيق، فالحلقة تعمل إلى الأبد»

/goal "اجعل الصفحة جميلة"—ماذا تعني «جميلة»؟ من دون مقياس واضح، لن تتوقف الحلقة أبداً، وستواصل العمل حتى تبلغ حد التكرارات أو الميزانية.

الحل: يجب أن يكون شرط التوقف قابلاً للقياس دائماً. لا تقل «جميلة»، بل «Lighthouse Performance ≥ 90, Accessibility ≥ 95». ولا تقل «تعمل»، بل «تجتاز الاختبارات في tests/pricing.test.ts».

متى لا تحتاج إلى هندسة الحلقات؟#

لا تناسب الحلقة المستقلة ما يلي:

• مهمة إبداعية تُنفذ مرة واحدة. موقع واحد لمنتج جديد، أو شعار واحد، أو مذكرة استراتيجية واحدة. استخدام الحلقة هنا مبالغ فيه؛ من الأسهل كتابة موجّه واحد وتنقيح النتيجة يدوياً.
• مهمة بلا مُتحقِّق. إذا لم تستطع التعبير عن شرط التوقف برمز خروج أو إشارة واضحة لا لبس فيها، فلا تبدأ الحلقة؛ وإلا ستصبح حريقاً لا ينتهي.
• مهمة تتطلب تقييماً ذاتياً. عبارات مثل «اجعل الصياغة أفضل» أو «حسّن تجربة المستخدم لتصبح أكثر إمتاعاً» تحتاج إليك أنت، لا إلى حلقة.
• مجال جديد غير مألوف. إذا كنت لا تعرف بنفسك كيف ينبغي أن تبدو النتيجة المكتملة، فلا تشغّل Claude ضمن حلقة. افهم الأمر أولاً، ثم أتمته.

وهذه أهم قاعدة تعلمتها من أخطائي:

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

هندسة الحلقات طبقة تُضاف إلى كل ما تعرفه بالفعل عن Claude Code. تابع استكشاف Ailoot على ailoot.ai.