كيف تسجّل جلسة Claude Code، وأي وكيل آخر لن يتعاون: دليل ميداني عملي

نعم: يمكنك تسجيل جلسة Claude Code اليوم، وما ستحصل عليه هو كل شيء (كل جولة نموذج، كل استدعاء أداة، كل ملف لمَسَه الوكيل) في صيغة يمكنك إعادة تشغيلها. هذه هي النسخة المختصرة، وهي صحيحة اليوم. أما النسخة الأطول فهي أن قابلية التسجيل تُحدَّد لكل منظومة وفقًا لسؤالين: هل يمكن توجيه المنظومة إلى بروكسي (proxy)؟ وهل يُفهَم تنسيق بياناتها بمجرد وصول حركة المرور؟ يجتاز Claude Code كلا الشرطين، وكذلك يفعل Codex CLI المسجَّل الدخول بمفتاح API. أما وكيلٌ يكون عنوان مزوّده مثبّتًا في الكود المصدري، ووكيلٌ يعمل داخل حاوية أو على خادم افتراضي خاص (VPS)، ومنظومةٌ مسجَّلة الدخول باشتراك، فكلٌّ منها يسلك مسارًا مختلفًا، وواحدٌ منها — اليوم — لا يصل.

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

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

ما الذي يحدد ما إذا كان يمكن تسجيل الحزام؟

كل سؤال بصيغة "هل يمكنك تسجيل ذلك؟" ينحصر في السؤالين نفسهما.

الأول: هل يمكن توجيه عدة الاختبار إلى وكيل؟ أربعة مسارات تغطي ذلك، بترتيب تنازلي من حيث الملاءمة.

• متغير عنوان URL الأساسي. المسار المُعدّ لهذا: يقرأ الهيكل متغير بيئة لعنوان URL الأساسي، وتقوم أنت بتعيينه.

• إطلاق الحزام بنفسك. ترث العملية الفرعية بيئة العملية الأم، لذا فإن أي بوابة تُطلق وكيل برمجة تُلتقط أيضًا دون تعاونٍ من الوكيل.

• اعتراض TLS. بالنسبة لأدوات الاختبار التي لا تقرأ أي إعدادات إطلاقًا، يشغّل المسجّل الوكيل وتختار أنت تفعيل الاعتراض.

• إرفاق. عندما يعمل الوكيل في مكانٍ لا يستطيع المسجّل تشغيله فيه، فإنّ ما يتبقّى هو الإرفاق.

إذا لم ينطبق أيٌّ من هذه الحالات، فإن حركة المرور لا تصل أبدًا إلى المُسجِّل ولا يوجد ما يمكن مناقشته.

الثاني: بمجرد وصول الحركة، هل يُفهم تنسيقها على مستوى الشبكة؟ التقاط البايتات ليس هو المنتج. ينبغي للمسجّل أن يتعرّف على المحادثة التي يحلّ محلّها، بما في ذلك أشكال استدعاء الأدوات، وأُطر البث، وعمليات إعادة المحاولة؛ وإلا كان التسجيل مجرد التقاط حزم (pcap) وليس إعادة تشغيل. التنسيق الذي يفهمه المسجّل يولّد جلسة يمكنك إعادة تشغيلها؛ أما اللهجة الخاصة فتنتج التقاطًا لا يسعك إلا النظر إليه.

يختلف الجواب باختلاف الأداة، ويختلف في تفاصيل يسهل فيها الخطأ: إنه الدرس نفسه الذي أسفرت عنه مقارنة كيف يختلف إعداد DeepSeek عن Claude Code. أمّا باقي هذا المقال فيُبيّن كيف تبدو المسألتان عندما تُشغِّل الأدوات فعليًا.

Claude Code وCodex CLI وAgents SDK

Claude Code هو المعيار الذي تُقاس به كل الأشياء الأخرى، لأنه يقرأ ANTHROPIC_BASE_URL. عيّن هذا المتغير إلى المسجّل، وشغّل الوكيل، وستصل الجلسة دورًا بعد دور: الاستعلامات، واستدعاءات الأدوات، وتعديلات الملفات، وردود النموذج بينها. لقد تحققنا من ذلك من البداية إلى النهاية عبر إصلاح خطأ حقيقي (مستودع برمجي حقيقي، خلل حقيقي، وجلسة تعمل من أول استعلام حتى الإصلاح الفعلي)، وقد كسر ذلك الوكيل الحقيقي الأول أربعة أشياء لم تُحدِثها أي تجهيزة اختبار. ومنذ ذلك الحين تم إصلاح الأربعة جميعًا، وهي الطريقة الصادقة للقول إن حركة المرور الاصطناعية لا تُهيّئك لما يفعله وكيل حقيقي عندما يُترك وحده مع قاعدة برمجية.

ينطبق الأمر نفسه على Codex CLI، المُسجَّل دخوله بمفتاح API، عبر OPENAI_BASE_URL. وجّهه إلى المسجِّل وستحصل على الجلسة؛ لا يتغيّر أي شيء آخر في طريقة استخدامك للنظام.

الوكلاء البرمجيون يرثون أسهل مسار على الإطلاق. العملية الفرعية ترث بيئة العملية الأم، لذا فإن البوابة التي تشغّل وكيل برمجة يتم التقاطها أيضًا دون تعاون الوكيل. عيّن متغير عنوان URL الأساسي مرة واحدة في العملية التي تقوم بالإطلاق، وسيصل كل وكيل تطلقه إلى المسجّل من تلقاء نفسه. إذا كنت تشغّل الوكلاء من CI، أو من منسّق، أو عبر Agents SDK، فهذا هو المسار الذي تسلكه بالفعل.

المسجِّل في كل هذه الحالات هو OrcaReplay، ويُثبَّت عبر npm i -g orcareplay، ويتطلب Node 20 أو أحدث، وليس له أي تبعيات أصلية: لا شيء يُجمَّع ولا شيء يُبنى، ويلتقط نفس حركة مرور الوكلاء التي يقوم OrcaRouter بتمريرها عبر فهرس نماذج OrcaRouter.

وكيل لا يقرأ متغير العنوان الأساسي لـ URL

بعض الأدوات تُرمّز رابط المزوّد داخل الكود المصدري بشكل ثابت. لا متغير بيئة، لا ملف إعدادات، لا خيار. تعيين ANTHROPIC_BASE_URLلا يفعل شيئًا، لأن لا شيء يقرؤه. إذا كان بإمكان المسجّل تشغيل الوكيل، فلا يزال هناك طريق، وهو أكثر ما يقلق الناس: اعتراض TLS.

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

ما يرفضه المسار عمدًا لا يقل أهميةً عمّا يفعله. فهو لا يقرأ سوى المضيفات المدرجة في قائمة السماح، ولا شيء غيرها. أما المضيفات خارج قائمة السماح، فتُمرَّر عبر النفق دون قراءتها، وتُسجَّل كعنوانٍ وعددٍ من البايتات: دليلٌ على أن الوكيل اتصل بشيءٍ ما، دون تسجيل بايتٍ واحدٍ ممّا قيل. وهذا الحدُّ قرارٌ تصميميٌّ، وليس قيدًا لم نتناوله بعدُ؛ ويسري الانضباط نفسه على جدار حماية الوكيل في OrcaRouter، حيث تكون قائمة السماح هي المنتَج لا مجرّد أثرٍ جانبيٍّ للتسجيل.

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

وكيل ليس على هذا الجهاز

الحاوية لها بيئة مستقلة خاصة بها. متغير base-URL الذي تحدّده في الصدفة لا يصل إلى داخلها، كما أن أداة التسجيل على المضيف لا تستطيع إطلاق عملية موجودة أصلًا في مكان آخر: على خادم افتراضي خاص (VPS)، أو في بيئة تكامل مستمر (CI)، أو في صندوق رمل (sandbox) أنشأته أداة الاختبار (harness) دون أن تطلب منك. يفشل الالتقاط القائم على التشغيل هنا ليس لأن الوكيل (agent) صعب، بل لأن أداة التسجيل لا تحصل أبدًا على فرصة لمس تلك العملية.

في هذه الحالة تحديدًا، توجد أداة orca attach، وهي تسجّل وكيلًا لا يستطيع المسجِّل تشغيله، مثل وكيل داخل حاوية أو على خادم افتراضي خاص (VPS). وينقلب الاتجاه هنا: فبدلًا من أن يبدأ المسجِّل الوكيل ويمنحه بيئة التشغيل، يرتبط هذا المسجِّل بوكيل يعمل بالفعل ويقوم بتسجيله.

ما لا يفعله الإرفاق هو الإجابة عن السؤال الثاني نيابةً عنك. فهو يحلّ مشكلة إيصال الحركة إلى المسجّل؛ لكن ما إذا كانت هذه الحركة ستتحوّل إلى جلسة يمكنك إعادة تشغيلها لا يزال يعتمد على فهم تنسيق البيانات المرسَلة. أرفِق وكيلًا يتحدّث بصيغة يعرفها المسجّل وستحصل على جلسة قابلة لإعادة التشغيل. أرفِق وكيلًا لا يتحدّث بها، وستكون قد وجدت الجدار، وهو أمرٌ اكتشافه عن قصد أرخص من اكتشافه في منتصف الحادث.

ما الذي تغيّره عملية تسجيل الدخول بالاشتراك؟

قد يكون الملف التنفيذي نفسه قابلاً للتسجيل أو لا، اعتمادًا على طريقة تسجيل دخوله. أداة Codex CLI التي سُجِّل دخولها بمفتاح API يُلتقط اتصالها عبر OPENAI_BASE_URL: اجعل هذا المتغير يشير إلى جهاز التسجيل وستكون قد انتهيت. أما عند تسجيل دخول الأداة نفسها باستخدام اشتراك ChatGPT، فإنها تتوقف نهائيًا عن التواصل مع نقطة الوصول تلك؛ إذ تخاطب خادمها الخلفي الخاص بوصفك أنت، ولا يوجد أي أصل يمكن إعادة كتابته. يظل متغير عنوان URL الأساسي موجودًا، لكن لا يصبح أي شيء توجّهه إليه هو الخدمة التي تستخدمها المنظومة فعلًا.

هذا هو السؤال الثاني الذي يفشل، وليس الأول. يمكن جعل البايتات تتحرك؛ بل إن المسجِّل يستطيع رؤيتها. لكن المحادثة موجَّهة إلى نظامٍ خلفي لا يمكن للمسجِّل أن يحل محلَّه، في تدفقٍ ليس هو واجهة البرمجة التي يتحدث بها المسجِّل. لا توجد إعادة تشغيل يمكن إنتاجها، لأنه لا يوجد أصلٌ يمكن للمسجِّل أن يصبحه.

الإجابة الصادقة اليوم عن أداة اختبارٍ يُسجَّل الدخول إليها باشتراك هي أنها ليست قابلةً للتسجيل، والدرس المفيد هو أن طريقة تسجيل الدخول جزءٌ من قرار قابلية التسجيل. وإذا كنت تحتاج إلى تسجيلاتٍ للتقييمات أو لسجل التدقيق، فشغّل الجلسات التي تريد تسجيلها بمفتاح API، واحتفظ بالاشتراك للعمل التفاعلي — كيفية تحويل جلسةٍ مُسجَّلة إلى تقييم انحداريشرح هذه الحلقة من بدايتها إلى نهايتها. وقبل أن تعتمد أيَّ أداةٍ كمعيار، اطرح عليها السؤالين أولًا؛ فنحن نفعل ذلك تمامًا مع كل أداةٍ، وآخرها كان معأداة Prime Agent.

الخلاصة

يمكنك تسجيل جلسة Claude Code اليوم بأمر واحد ومتغير بيئة واحد:

• npm i -g orcareplay

• وجّه ANTHROPIC_BASE_URLإلى المُسجِّل

• تشغيل الوكيل

إنّ تشغيل Codex CLI بمفتاح API يبعُد المسافة نفسها. والرابط الثابت المكتوب في الكود يُكلّفك الموافقة على اعتراض TLS الذي لا يقرأ إلا قائمة السماح الخاصة به (وهو الانضباط نفسه الذي يفرضه جدار حماية الوكيل في OrcaRouter) وينسى شهاداته عند انتهاء التشغيل. أمّا الحاوية أو الخادم الافتراضي الخاص (VPS) فيُكلّفك orca attach. تسجيل الدخول بالاشتراك يُكلّفك التسجيل نفسه: فذلك الهيكل لن يُسجَّل، ولا تغييرات في الإعدادات اليوم.

القرار بأكمله في لمحة:

• Claude Code — مفتاح API لتسجيل الدخول مقابل التوجيه إلى المسجِّل ANTHROPIC_BASE_URL مقابل قابل للتسجيل اليوم: نعم

• Codex CLI — مفتاح API لتسجيل الدخول مقابل التوجيه إلى المُسجِّل OPENAI_BASE_URL مقابل قابل للتسجيل اليوم: نعم

• أداة اختبار مع عنوان URL للمزوّد مضمّن فيها — تسجيل الدخول بأي طريقة مقابل التوجيه إلى المسجِّل، واعتراض TLS اختياري يطلقه المسجِّل مقابل قابلية التسجيل اليوم: نعم

• وكيل في حاوية أو على VPS — أي تسجيل دخول مقابل توجيه إلى المُسجِّل orca attach مقابل قابل للتسجيل اليوم نعم، إذا كان تنسيق الإرسال معروفًا

• Codex CLI — تسجيل الدخول باشتراك ChatGPT مقابل المسار إلى المسجِّل لا شيء مقابل قابل للتسجيل اليوم لا

الصف الأخير هو التركيبة الوحيدة التي لا يوجد لها أي مسار إلى المسجل على الإطلاق.

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

ملاحظة حول المصادر: كل سلوك ورقم في هذه المقالة (مسارات الالتقاط الخاصة بـ `ANTHROPIC_BASE_URL` و`OPENAI_BASE_URL`، والأعطال الأربعة التي أعقبت التجهيزات وإصلاحاتها، ودورة حياة شهادة TLS، وسلوك القائمة المسموحة والنفق، و`orca attach`، ومتطلبات التثبيت) مستمد من عمليات التحقق الخاصة بنا على الأدوات المذكورة، وكان آخرها بتاريخ 2026-09-04. نحن لا نستشهد بمعايير مرجعية من جهات خارجية لأننا لم نجرِ أيًا منها.