كيف تشغّل Claude Code اختبار API؟ أمر Apidog واحد، ولا يُعد ناجحًا إلا إذا كان رمز الخروج 0

ملاحظة المؤلف: اكتب أمر تشغيل سيناريو Apidog داخل CLAUDE.md، ليقوم Claude Code بتشغيل اختبارات API الآلية وفق سيناريو جاهز، ويحكم على النتيجة عبر رمز الخروج، مع تصميم تأكيدات تتعلق بالفوترة والمراجعة باستخدام واجهة Seedance للفيديو كمثال.

إذا كنت تستخدم Claude Code بالفعل لكتابة كود الواجهات، فمن المحتمل جدًا أنك مررت بهذا الموقف: بعد تعديل حقل واحد، تضطر إلى الانتقال إلى Apidog والنقر يدويًا لتشغيل السيناريو مرة واحدة، ثم العودة وإخبار Claude Code بالنتيجة. يعرض هذا المقال طريقة كتابة أمر تشغيل سيناريو Apidog CLI داخل CLAUDE.md، ليقوم Claude Code بتشغيل الاختبارات بنفسه وقراءة رمز الخروج بنفسه، وبذلك يتحول اختبار API الآلي في Claude Code إلى حلقة مغلقة.

هذا ليس مقالًا تعليميًا آخر من مقالات مقدمة Claude Code. خطوات Apidog في المقال مأخوذة من درس رسمي نشرته جهة تطوير Apidog، وقواعد الفوترة والمراجعة في Seedance مأخوذة من النص الأصلي لوثائق APIYI؛ وسنوضح مصدر كليهما صراحةً في متن المقال كي تتمكن من التحقق بنفسك.

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

claude-code-api-automated-testing-apidog-ar-image-0


الاختبار الآلي لواجهات API في Claude Code: النقاط الأساسية في Apidog

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

النقطة الشرح القيمة
كتابة أمر التشغيل في CLAUDE.md يقرأ Claude Code ملف CLAUDE.md الموجود في جذر المستودع، وشكل الأمر هو apidog run -t معرّف السيناريو -e معرّف البيئة -r cli تشغيل الأمر نفسه في كل جلسة بدلًا من الاعتماد على الذاكرة
الحكم على النتيجة برمز الخروج رمز الخروج 0 يعني أن جميع التحققات نجحت، ورمز غير 0 يعني وجود فشل يمنع أن يقول النموذج «نجح» بينما لم ينجح فعلًا
نسخ المعرّفات من صفحة CI/CD يُحصل على معرّف السيناريو ومعرّف البيئة من صفحة CI/CD الخاصة بهذا السيناريو في Apidog يمنع النموذج من اختلاق المعرّفات فتصبح السيناريوهات غير موجودة
عدم إدخال الرمز إلى الملف سجّل الدخول على جهازك باستخدام apidog login، ولا تكتب --access-token داخل CLAUDE.md يمنع تسرّب الرمز عند رفع المستودع
فصل نوعي نقاط النهاية نقطة النهاية التي تدير Claude Code بنموذج نصي ليست نفس نقطة النهاية الخاصة بواجهة الفيديو قيد الاختبار إعداد أوضح وإمكانية تتبّع الفواتير

كيفية قراءة Claude Code لملف CLAUDE.md

وفقًا لدليل Apidog من المزوّد، الأداة نفسها هي حزمة npm باسم apidog-cli، وعند تشغيل Claude Code يقرأ ملف CLAUDE.md في جذر المستودع كوصف للمشروع. أي أن أوامر التشغيل وقواعد التقييم والمحظورات التي تكتبها في هذا الملف ستصبح سياقًا لكل جلسة في Claude Code. وإذا لم تكن متأكدًا من ملفات التعليمات التي تم تحميلها في الجلسة الحالية، يمكنك تنفيذ /memory داخل Claude Code لمراجعتها.

هذه النقطة تحدد استقرار الحل. فبدلًا من تكرار «من فضلك شغّل سيناريو Apidog» في كل محادثة، من الأفضل تثبيت الأمر مرة واحدة. بعد أن ينتهي Claude Code من تعديل الشيفرة، سيستدعي apidog run وفقًا لتعليمات CLAUDE.md، ويقرر بناءً على مخرجات الطرفية ما إذا كان سيواصل الإصلاح أم ينهي المهمة.

شرح مفصّل لرموز الخروج وتنسيق التقرير في Apidog CLI

يشدد دليل المزوّد على ضرورة الاحتفاظ بتنسيق التقرير -r cli، لأن Claude Code يعتمد على مخرجات الطرفية لتحديد الخطوة التالية. وإذا كنت تريد أيضًا تقريرًا يمكن فتحه في المتصفح، يمكنك إضافة html إلى معامل -r، وستُولَّد الملفات في المجلد ./apidog-reports. لاحظ أن ذلك «إضافة» وليس «استبدالًا»؛ فإزالة تقرير cli ستجعل Claude Code يفقد الأساس الذي يقرأ منه النتائج.

رمز الخروج هو المرجع الفاصل في المنظومة كلها. يستحق ترتيب التحقق الوارد في الدليل أن يُنقل كما هو: أولًا تأكد من أن الأمر apidog run ظهر فعلًا في الطرفية؛ ثم انظر إلى رمز الخروج، وعندما يتعارض رمز الخروج مع الخلاصة الشفهية للنموذج، فاعتمد رمز الخروج؛ وإذا ظهرت رسالة تفيد بأن السيناريو غير موجود، فارجع إلى CLAUDE.md وتحقق من صحة ID.

claude-code-api-automated-testing-apidog-ar-image-1


الاختبار الآلي لواجهة Claude Code API: بداية سريعة

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

الخطوة الأولى: ضبط عنوان اتصال النموذج في Claude Code

تشغيل Claude Code نفسه يستهلك رموزًا (tokens)، واستدعاء واجهة الفيديو قيد الاختبار لاحقًا سيستهلك المزيد. لذا افصل بين نوعي عنوان الاتصال أولًا. عند الاتصال عبر APIYI، يستخدم Claude Code بروتوكول Anthropic الأصلي، والعنوان هو https://api.apiyi.com، ولا تضف /v1 بعده، وإلا فسيُركّب العنوان ليصبح /v1/v1/messages ويفشل الطلب. أما عملاء البروتوكول المتوافق مع OpenAI، فعنوانهم هو https://api.apiyi.com/v1 فقط.

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

🚀 بداية سريعة: الطريقة الموصى بها رسميًا هي إنشاء رموز منفصلة لـ Claude Code وللواجهة قيد الاختبار في لوحة تحكم APIYI apiyi.com. يحصل المستخدمون الجدد على رصيد اختبار مجاني يكفي لتشغيل السيناريو الأول بنجاح قبل تحديد النموذج الذي ستستخدمه على المدى الطويل.

الخطوة الثانية: كتابة تعليمات الاختبار في CLAUDE.md

وفقًا لدليل المورّد، يُقترح أن يتضمن المحتوى المتعلق بالاختبار في CLAUDE.md البنود التالية، مع كتابة كل بند في جملة واحدة واضحة:

  1. أمر التشغيل: استخدم لاختبار الانحدار apidog run -t <场景ID> -e <环境ID> -r cli، حيث تُملأ المعرّفان بالقيم الفعلية المنسوخة من صفحة CI/CD في Apidog.
  2. قاعدة الحكم: اعتمد على رمز خروج الأمر لتحديد النتيجة؛ يعني 0 أن جميع الاختبارات نجحت، ويعني غير 0 وجود فشل. لا تتخذ ملخصًا باللغة الطبيعية كنتيجة نهائية.
  3. المحظورات: لا تختلق أو تعدّل معرّف السيناريو أو معرّف البيئة بنفسك؛ ولا تضف --access-token إلى الأمر.
  4. متطلبات التقرير: أبقِ -r cli، وإذا كنت بحاجة إلى تقرير في المتصفح فيمكنك إضافة html، وتكون المخرجات في ./apidog-reports.
  5. ملاحظة المنطقة: إذا كان المشروع منشورًا في المنطقة الأوروبية من Apidog، فيجب إضافة --api-base-url api.eu.apidog.com إلى الأمر. هذا عنوان المنطقة الخاص بـ Apidog نفسه، وليس له علاقة بعنوان الوصول إلى النموذج.

الخطوة الثالثة: تسجيل الدخول وإعداد الصلاحيات

إدارة الرموز المميزة (Token) هي الجزء الأكثر عرضة للمشاكل. تنصح tutorials الشركة المصنّعة بتنفيذ apidog login مرة واحدة على الجهاز المحلي لإتمام تسجيل الدخول، مع التأكيد على عدم كتابة الرمز في CLAUDE.md، وعدم ظهور --access-token في هذا الملف. عادةً ما يتم إرسال CLAUDE.md مع المستودع، فبمجرد كتابة الرمز فيه يصبح مكشوفًا للجميع.

يقوم Claude Code افتراضيًا بالسؤال قبل تنفيذ أوامر Bash. إذا كنت ترغب في أن يشغّل الاختبارات تلقائيًا، يمكنك إضافة Bash(apidog run *) إلى قائمة allow للصلاحيات في .claude/settings.json، بحيث يتم السماح لهذا النوع من الأوامر فقط. كما يذكّر tutorial بأن --dangerously-skip-permissions مناسب فقط لبيئات CI التي تُستخدم مرة واحدة، وليس مناسبًا للجهاز المحلي الذي يبقى قيد التشغيل يوميًا.

بند الإعداد الممارسة الموصى بها الممارسة غير الموصى بها المصدر
تسجيل الدخول إلى Apidog apidog login على الجهاز المحلي كتابة --access-token في CLAUDE.md tutorial الشركة المصنّعة
تمرير الأوامر allow لـ Bash(apidog run *) ترك --dangerously-skip-permissions مفتوحًا دائمًا على الجهاز المحلي tutorial الشركة المصنّعة
معرّف السيناريو النسخ من صفحة CI/CD ترك النموذج يخمّن أو يولّد tutorial الشركة المصنّعة
عنوان Claude Code ANTHROPIC_BASE_URL بدون /v1 وجود /v1 يؤدي إلى تكرار المسار توثيق APIYI
تجميع الرمز Claude يستخدم ClaudeCode، والفيديو يستخدم SeeDance2 رمز واحد يخلط جميع المجموعات توثيق APIYI

الخطوة الرابعة: تنفيذ أول تشغيل والتحقق منه

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

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


اختبارات Claude Code الآلية لواجهات API في الممارسة: تصميم عبارات التأكيد لواجهة Seedance للفيديو

اختبار الواجهات النصية بديهي نسبيًا، أما الواجهات غير المتزامنة للفيديو فهي التي تختبر تصميم عبارات التأكيد اختبارًا حقيقيًا. يعرض هذا القسم، مستخدمًا سلسلة Seedance المتاحة على APIYI كمثال، ما ينبغي تأكيده وما لا ينبغي تأكيده في سيناريو Apidog.

طرازات Seedance ومجموعاتها وأسعارها

وفقًا لوثائق APIYI، فإن معرّفات الطرازات المتاحة من Seedance هي doubao-seedance-2-5-260628 وdoubao-seedance-2-0-260128 وdoubao-seedance-2-0-fast-260128 وdoubao-seedance-2-0-mini-260615. ويجب أن ينتمي الرمز (token) المستخدم في استدعاء هذه الطرازات إلى مجموعة SeeDance2، وإلا فسيُعيد الخطأ «لا توجد قناة متاحة لهذا النموذج». وواجهة الفيديو قيد الاختبار ونموذج النص الذي يشغّل Claude Code هما نقطتا نهاية مختلفتان، وليس مجرد تغيير حقل model كافيًا لجعل الأمر صالحًا في الحالتين؛ ففي سيناريو Apidog يجب إعداد طلبات الإرسال والاستعلام بشكل منفصل وفقًا لوثائق Seedance.

يعرض الجدول التالي الأسعار حسب الاستخدام من جدول الأسعار العام (المحدّث في 2026-11-16)، والوحدة هي دولار / مليون توكن. والمرجع في الطراز والسعر هو قائمة الطرازات على المنصة.

الطراز الإدخال الإخراج قراءة الذاكرة المؤقتة المنصات المتاحة
doubao-seedance-2-5-260628 70 70 لا يوجد APIYI apiyi.com
doubao-seedance-2-0-260128 46 46 لا يوجد APIYI
doubao-seedance-2-0-fast-260128 37 37 لا يوجد APIYI
doubao-seedance-2-0-mini-260615 23 23 لا يوجد APIYI

كما تقدّم الوثائق أمثلة على حساب تكلفة فيديو بدقة 720p ومدته 5 ثوانٍ: فالطراز 2.5 يكلّف نحو 1.3721 دولار، والطراز 2.0 القياسي نحو 0.9074 دولار. وتجدر الإشارة إلى أن هذا مجرد مثال يحوّل سعر المليون توكن إلى تكلفة فيديو واحد، وليس مجموعة أسعار ثانية مختلفة عن الجدول العام.

خمسة تأكيدات موصى بها

هذه التأكيدات الخمسة مبنية على نص الوثائق الأصلي، ويمكن استخدامها مباشرة في سيناريوهات Apidog:

  • لكل مهمة ID: بعد نجاح إرسال الطلب، يجب أن تحتوي الاستجابة على ID المهمة، إذ يعتمد عليه الاستطلاع الدوري لاحقًا؛ وغياب هذا ID يعني الفشل.
  • تمرير المدة بشكل صريح: ينص النص الأصلي على أن القيمة الافتراضية لـ duration في 2.5 هي -1. يجب تمرير المدة صراحةً في طلب الاختبار، وإلا تعذرت مقارنة تكلفة الجولات المختلفة.
  • أخطاء المعاملات لا تُحتسب: ينص النص الأصلي على أن خطأ المعاملات من نوع HTTP 400 لا يُحتسب ضمن الفاتورة. يمكنك إنشاء طلب ينقصه حقل مطلوب، والتأكد من أن رمز الحالة هو 400، ثم التحقق في السجلات من عدم وجود خصم.
  • الحجب بسبب المراجعة لا يُحتسب: ينص النص الأصلي على أن الأخطاء التي تبدأ بالبادئة PUBLIC_ هي حجب من مراجعة المحتوى لدى الجهة العلوية، ولا تُحتسب أيضًا. يقتصر التأكيد على التعرف على هذا النوع من رموز الأخطاء والتمييز بينه وبين أخطاء المعاملات باعتبارهما نوعين مختلفين من الفشل.
  • مجموع السجلين هو السعر الإجمالي: ينص النص الأصلي على أن الفيديو الواحد له سجلّا خصم في السجلات: خصم مسبق عند الإرسال، وتسوية بعد الاكتمال بالاسترداد أو الخصم الإضافي، والتكلفة الإجمالية هي مجموع السجلين.

بخصوص مبلغ الخصم المسبق، يذكر النص الأصلي أن سلسلة 2.0 تكلّف نحو 0.09 دولار/ثانية، و2.5 نحو 0.135 دولار/ثانية، وتُسوّى التكلفة بعد الاكتمال وفق token الفعلي. لذلك لا يجوز أن يقتصر تأكيد التكلفة على السجل الأول، فهو مجرد قيمة الخصم المسبق.

claude-code-api-automated-testing-apidog-ar-image-2

ما الذي لا ينبغي كتابته كحالة اختبار

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

📊 ملاحظة حول البيانات: قواعد الفوترة والمراجعة الخاصة بـ Seedance المذكورة أعلاه مقتطفة من النص الأصلي لوثائق APIYI، ويمكن التحقق من أحدث وصف في صفحة Seedance بمركز الوثائق على apiyi.com قبل تثبيتها في التوكيدات.


اختيار النموذج المشغّل لـ Claude Code والتكلفة

تشغيل الاختبارات عبر Claude Code يستهلك بدوره رموزًا (tokens)، واختيار النموذج يؤثر مباشرة على التكلفة اليومية. يوضح الجدول التالي أسعار ثلاثة نماذج من Claude في جدول الأسعار الإجمالي، والوحدة كذلك دولار أمريكي / مليون token، وجميعها تدعم نقطتي النهاية chat و messages.

النموذج الإدخال الإخراج قراءة التخزين المؤقت المجموعة
claude-opus-5-5 4 20 0.2 ClaudeCode، Claude_Reverse، Claude_Enterprise، Default، SVIP
claude-sonnet-5-5 2 10 0.1 كما هو أعلاه
claude-haiku-5-5 من 0 إلى 100 ألف token بسعر 0.1، وفوق ذلك 0.5 0.5 0.01 ClaudeCode، Claude_Enterprise، Default، SVIP

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

💰 تحسين التكلفة: نظرًا لأن الفوترة تشمل كلاً من النموذج المشغّل والواجهة قيد الاختبار، يُنصح بمراجعة سجلات الاستخدام في لوحة تحكم APIYI حسب بُعد الرمز (token)، وحساب استهلاك Claude Code واستهلاك Seedance كلاً على حدة، لتحديد الجانب الذي تذهب إليه معظم تكلفة الاختبار.


الأسئلة الشائعة (FAQ)

س1: ما هو حل Apidog للاختبار الآلي لواجهة Claude Code API؟

الفكرة ببساطة أن تكتب أوامر تشغيل السيناريوهات الخاصة بـ Apidog CLI داخل ملف `CLAUDE.md` في جذر المستودع، بحيث ينفّذ Claude Code أمر `apidog run` بنفسه بعد الانتهاء من تعديل الشيفرة، ويحدّد نجاح الاختبار بناءً على رمز الخروج، فتتخلّص من عناء النقر اليدوي على زر التشغيل.

س2: لماذا نعتمد رمز الخروج بدلًا من استنتاج Claude Code؟

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

س3: هل يجب إضافة /v1 إلى عنوان Claude Code؟

لا. يعمل Claude Code وفق بروتوكول Anthropic الأصلي، وعنوانه هو `https://api.apiyi.com`، وإضافة `/v1` ستنتج `/v1/v1/messages`. أما عملاء المتوافقون مع OpenAI وحدهم هم من يستخدمون العنوان الذي يحوي `/v1`.

س4: أين ينبغي وضع رمز Apidog؟

على جهازك المحلي يكفي تسجيل الدخول عبر `apidog login`. ويشترط دليل المزوّد صراحةً عدم كتابة `–access-token` في `CLAUDE.md`، وعدم كتابة الرمز في هذا الملف أصلًا، حتى لا يتسرّب مع مستودع الشيفرة.

س5: كيف أبدأ استدعاء Seedance لاختبار واجهة الفيديو؟

بعد التسجيل في APIYI عبر apiyi.com، أنشئ رمزًا ينتمي إلى المجموعة `SeeDance2`، واضبط طلبات الإرسال والاستعلام وفق وثائق Seedance، وأضف إلى سيناريو Apidog تحققات مثل معرّف المهمة والمدة الصريحة وتصنيف رموز الأخطاء وسجلَّي خصم الرصيد. ويمكن للمستخدمين الجدد الاستفادة من حصة الاختبار المجانية لتشغيل السيناريو الأول من البداية إلى النهاية.

س6: ماذا أفعل إذا أبلغ Claude Code أن السيناريو غير موجود؟

تأكد أولًا من الأمر المنفَّذ فعليًا في الطرفية، ثم ارجع إلى `CLAUDE.md` وتحقق من معرّف السيناريو ومعرّف البيئة، واحرص على نسخهما مجددًا من صفحة CI/CD الخاصة بذلك السيناريو في Apidog، ولا تدع النموذج يخمّنهما. أما مشاريع المنطقة الأوروبية فتأكد كذلك مما إذا كان الخيار `–api-base-url api.eu.apidog.com` مضافًا.

س7: ما القيود التي يفرضها هذا الحل؟

أولًا، الفوترة المزدوجة: فكلٌّ من Claude Code والواجهة المُختبرة يستهلك tokens. ثانيًا، ضرورة ضبط الأذونات بقدر محدود، فلا يُسمح محليًا إلا بـ `Bash(apidog run *)`. ثالثًا، حجب المراجعة والصور المرجعية للوجوه الحقيقية تقع ضمن حدود الامتثال، فلا يمكن إلا رصدها ومعالجتها مسبقًا، دون تصميم حالات اختبار من نوع التحايل عليها.


النقاط الأساسية في اختبار أتمتة Claude Code API

  • تثبيت الأوامر: اكتب الأمر apidog run -t -e -r cli داخل CLAUDE.md، ونفّذه بالشكل نفسه في كل جلسة.
  • رمز الخروج هو الحكم: القيمة 0 تعني النجاح، وأي قيمة غير 0 تعني الفشل. وإذا تعارض الاستنتاج الشفهي مع رمز الخروج، فالأولوية لرمز الخروج.
  • فصل الرموز: سجّل الدخول على الجهاز عبر apidog login، ولا تضع الرمز ولا --access-token داخل CLAUDE.md.
  • أقل صلاحيات ممكنة: اسمح فقط بتنفيذ Bash(apidog run *)، ولا تستخدم معامل تخطي الصلاحيات إلا في CI.
  • تمييز العناوين: يستخدم Claude Code عنوان API الأصلي دون /v1، بينما يتضمن المسار المتوافق مع OpenAI البادئة /v1.
  • تحققات الفيديو: تحقّق من معرّف المهمة، والمدة المحددة صراحةً، واستجابة 400 وتصنيف PUBLIC_، وإجمالي السعر وفق سجلّي الفوترة.
  • طريقة البدء: أنشئ في APIYI رمزين منفصلين للمجموعتين ClaudeCode وSeeDance2، ثم شغّل أول سيناريو باستخدام الحصة المجانية.

الخلاصة

يتلخص الجمع بين اختبار أتمتة Claude Code API وApidog في ثلاث نقاط:

  1. اجعل الأوامر والقواعد داخل الملفات: يحمل CLAUDE.md أمر التشغيل وقواعد الحسم والمحظورات، بينما تُدار الرموز عبر apidog login.
  2. اجعل رمز الخروج هو الفيصل: احتفظ بمخرجات -r cli، وراجع الأمر ورمز الخروج والمعرّف بالترتيب نفسه الوارد في دليل المزوّد.
  3. اجعل التحققات مطابقة للفوترة الفعلية: يجب أن تتحقق واجهة الفيديو غير المتزامنة من حالة المهمة، وأن تميز بين خطأ المعاملات وحجب المراجعة، وأن تجمع سجلّي الخصم، وأن تمرر المدة صراحةً.

نوصي بالبدء بأبسط سيناريو لواجهة نصية لإكمال الدورة كاملة، ثم إضافة تحققات الواجهات غير المتزامنة مثل Seedance تدريجيًا. ويُفضّل إدارة رموز Claude Code والنماذج قيد الاختبار واستهلاكها من الحساب نفسه عبر APIYI apiyi.com، لتصبح تكلفة الجانبين واضحة، مما يسهّل تحسين نفقات الاختبار باستمرار.

📚 المراجع

  1. درس مُصنّع Apidog: استخدام Apidog CLI في Claude Code: المؤلف المذكور هو INEZA Felin-Michel، وتاريخ الإصدار وفق ما يظهر على الموقع
  2. الرابط: apidog.com/blog/apidog-cli-in-claude-code
  3. الوصف: مصدر طريقة كتابة CLAUDE.md، وقواعد رموز الخروج، وإعداد الصلاحيات، وتسلسل التحقق

  4. مقدمة Apidog CLI الرسمية: توجّه CLI نحو الوكلاء وCI، والمعاملات الإقليمية

  5. الرابط: docs.apidog.com/en/introduction-to-apidog-cli-605134m0
  6. الوصف: يتضمن شرح --api-base-url الخاص بالمنطقة الأوروبية

  7. مستندات APIYI Seedance 2: معرّفات النماذج، والمجموعات، والفوترة، وقواعد المراجعة

  8. الرابط: docs.apiyi.com/api-capabilities/seedance2/overview
  9. الوصف: أساس تصميم ادعاءات الفيديو الواردة في هذا المقال

  10. جدول أسعار نماذج APIYI الشامل: الأسعار حسب الاستخدام والمجموعات لكل طراز

  11. الرابط: docs.apiyi.com/models
  12. الوصف: الطرازات والأسعار تُؤخذ من أحدث محتوى في هذه الصفحة

  13. شرح بروتوكول APIYI: الفرق بين عناوين Anthropic الأصلية والعناوين المتوافقة مع OpenAI

  14. الرابط: docs.apiyi.com/llms.txt
  15. الوصف: يوضح لماذا لا يمكن أن يحتوي عنوان Claude Code على /v1

المؤلف: فريق APIYI التقني
التواصل التقني: مرحبًا بك للتواصل معنا عبر الصفحة الرئيسية لموقع APIYI، والمزيد من المواد متاح في مركز مستندات docs.apiyi.com

أضف تعليق