الإجابة السريعة: يمكنك تشغيل ERNIE 5.5 Flash مجانًا في OpenCode و Claude Code عبر نقطة النهاية baidu/ernie-5.5-flash-preview:free على OpenRouter. في OpenCode، اربط OpenRouter واضبط "model": "openrouter/baidu/ernie-5.5-flash-preview:free". وفي Claude Code، وجّه ANTHROPIC_BASE_URL إلى OpenRouter وثبّت مُعرّف ERNIE كنموذج افتراضي. التكلفة 0 دولار لكل توكن، لكن بدون شراء أرصدة يُسمح لك بـ 50 طلبًا يوميًا فقط.
هذا الحد اليومي هو جوهر القضية عندما يتعلق الأمر بوكلاء البرمجة. الوكيل لا يُرسل طلبًا واحدًا لكل مهمة، بل طلبًا واحدًا لكل خطوة. هذا الدليل يوضّح كيفية إعداد الوكيلين، ويعرض مهمة برمجية تناسب الميزانية المجانية، ويخبرك أين يتعطّل المسار المجاني.
تم التحقق من جميع الحدود المذكورة أدناه من الصفحات الرسمية لـ OpenRouter بتاريخ 12 نوفمبر 2026.
ما هو ERNIE 5.5 Flash Preview؟
ERNIE 5.5 Flash Preview هو نموذج المحادثة والوكلاء من بايدو، صُدر في 10 نوفمبر 2026. وهو نموذج خليط خبيرات متفرّق (sparse mixture-of-experts) بإجمالي 280 مليار معامل، منها 14 مليار معامل نشط لكل توكن، ونافذة سياق تبلغ 1,024,000 توكن. تقدّم بايدو هذا النموذج للبرمجة والأعمال الوكيلة والأبحاث العميقة، ويُدرجه OpenRouter كنموذج يدعم الاستدلال والاستدعاءات الآلية للأدوات.
يوجد أيضًا نموذج ERNIE 5.5 Flash Base مخصص للتدريب المسبق فقط على Hugging Face، لكنه النموذج الذي تضبطه دقيقًا أو تشغّله بنفسك. أما Preview فهو النموذج الذي يتعامل معه وكيل البرمجة الخاص بك. للاطلاع على تفصيل كامل للنموذج، اقرأ ما هو ERNIE 5.5 Flash. وإذا كنت قادمًا من الجيل السابق، فتغطي نظرة عامة على ERNIE 5.1 التغييرات التي طرأت.
الحدود المجانية لـ ERNIE 5.5 Flash على OpenRouter
تُظهر صفحة النموذج على OpenRouter أن النسخة :free تُقدَّم بسعر 0 دولار للمدخلات و 0 دولار للمخرجات، عبر مزوّد واحد هو Baidu Qianfan. وتأتي حدود الاستخدام من وثائق حدود OpenRouter وتنطبق على كل مُعرّف نموذج ينتهي بـ :free.
| البند | القيمة (تم التحقق بتاريخ 2026-11-12) |
|---|---|
| مُعرّف النموذج | baidu/ernie-5.5-flash-preview:free |
| السعر | 0 دولار للمدخلات، 0 دولار للمخرجات |
| نافذة السياق | 1,024,000 توكن |
| الطلبات في الدقيقة | 20 |
| الطلبات في اليوم (أقل من 10 أرصدة مُشتراة على الإطلاق) | 50 |
| الطلبات في اليوم (10 أرصدة مُشتراة أو أكثر) | 1,000 |
| المزوّدون خلفه | 1 (Baidu Qianfan) |
هناك تفصيلان مهمان بالنسبة للوكلاء: تشير صفحة الأسعار على OpenRouter إلى أن المحاولات الفاشلة تُحتسب ضمن الحد اليومي. كما أن الرصيد السالب في حسابك يمنع النماذج المجانية بخطأ 402 حتى تقوم بإعادة الشحن.
فئة الـ 1,000 طلب يوميًا تعتمد على الأرصدة التي اشتريتها، لا على الأرصدة التي تنفقها.
إعداد ERNIE 5.5 Flash في OpenCode
يدعم OpenCode ميزة OpenRouter بشكل مدمج، لذا فإن هذا الإعداد هو الأقصر بين الاثنين. تحتاج إلى حساب على OpenRouter ومفتاح API من لوحة التحكم الخاصة بك على OpenRouter.
- ثبّت OpenCode أو حدّثه، ثم شغّله في مجلد مشروعك:
cd your-project
opencode
- اربط OpenRouter. من داخل OpenCode، نفّذ
/connect، اختر OpenRouter والصق مفتاحك. يمكنك أيضًا تصديره قبل التشغيل:
export OPENROUTER_API_KEY="sk-or-v1-..."
- ثبّت النموذج في ملف
opencode.jsonفي جذر المشروع. تنص وثائق مزوّدي OpenCode على استخدام مُعرّف نموذج OpenRouter الكامل بعد البادئةopenrouter/:
{
"$schema": "https://opencode.ai/config.json",
"model": "openrouter/baidu/ernie-5.5-flash-preview:free"
}
- أكّد الاختيار باستخدام
/models. إذا لم يظهر ERNIE في القائمة، فستظل قيمة الإعدادات هي المُطبّقة، لذا تحقق من تهجئة المُعرّف، بما في ذلك:free.
الآن كل استعلام يذهب إلى ERNIE 5.5 Flash Preview عبر OpenRouter. إذا كنت قد اتبعت دليل GLM-5.3-Flash على OpenCode أو دليل DeepSeek V4.1 Flash لدينا، فالنمط متطابق تمامًا: يتغير المُعرّف فقط.
إعداد ERNIE 5.5 Flash في Claude Code
يمكن لـ Claude Code التواصل مع OpenRouter لأن OpenRouter يوفّر نقطة نهاية متوافقة مع Messages من Anthropic. تُدرج صفحة نموذج ERNIE المسار POST https://openrouter.ai/api/v1/messages كمسار مدعوم لهذا النموذج.
لكن وضّح مستوى الدعم أولًا. تشير وثيقة تكامل Claude Code على OpenRouter إلى أن Claude Code مع OpenRouter "مضمون العمل فقط مع مزوّد Anthropic الأول" وأن Claude Code "قد لا يعمل بشكل صحيح مع مزوّدين آخرين." تشغيل ERNIE هنا يتم عبر إعدادات موثّقة، لكنه ليس اقترانًا مضمونًا.
- اضبط متغيرات الاتصال في ملف تعريف الصدفة (shell profile)، تمامًا كما توثّقها OpenRouter:
export OPENROUTER_API_KEY="sk-or-v1-..."
export ANTHROPIC_BASE_URL="https://openrouter.ai/api"
export ANTHROPIC_AUTH_TOKEN="$OPENROUTER_API_KEY"
export ANTHROPIC_API_KEY="" # must be explicitly empty
- ثبّت ERNIE لكل فئة نموذج يستخدمها Claude Code، حتى لا تعود أي خطوة بصمت إلى نموذج Anthropic المدفوع:
export ANTHROPIC_DEFAULT_OPUS_MODEL="baidu/ernie-5.5-flash-preview:free"
export ANTHROPIC_DEFAULT_SONNET_MODEL="baidu/ernie-5.5-flash-preview:free"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="baidu/ernie-5.5-flash-preview:free"
يمكنك وضع نفس المفاتيح في قسم env داخل .claude/settings.json إذا أردت حصر الإعداد في مشروع واحد.
- أعد تحميل الصدفة، وشغّل
claude، ثم نفّذ/status. يجب أن ترىAuth token: ANTHROPIC_AUTH_TOKENوAnthropic base URL: https://openrouter.ai/api. إذا أظهرANTHROPIC_API_KEYأو تسجيل دخول حساب Claude، فهذا يعني أن المتغيرات لم تصل إلى الجلسة. - افتح
/modelللتأكد من أن الفئات تُحوَّل إلى ERNIE، ثم تحقق من عمود النموذج في لوحة نشاط OpenRouter بعد أول استعلام.
نغطي الإعداد العام لـ Claude Code بتفصيل أكبر في كيفية استخدام Claude Code مع OpenRouter.
مهمة برمجية حقيقية تناسب 50 طلبًا
مع 50 طلبًا يوميًا، لا يمكنك ترك الوكيل يجول بحرية. امنحه مهمة محدودة النطاق تعرف مسبقًا كيف يبدو "الإنجاز". إليك مهمة تناسب مستودعًا صغيرًا:
In src/routes/orders.ts, GET /orders/:id returns 500 when the order
doesn't exist. Make it return 404 with {"error":"order_not_found"}.
Read only the files you need, make the smallest change, then run
the orders tests with npm test and stop. Don't refactor anything else.
لماذا ينجح هذا الشكل على الفئة المجانية:
- يحدد الملف بالاسم. يتخطى الوكيل البحث في المستودع بالكامل، مما يوفّر عدة طلبات.
- يحدد الإصلاح المطلوب. رمز الحالة والاستجابة مذكوران في الاستعلام، فلا حاجة للأخذ والرد.
- يحدد نطاق العمل. عبارة "توقف بعد تشغيل الاختبارات" تُنهي الحلقة بدلاً من ترك الوكيل يواصل التحسين.
مهمة بهذا الشكل تستغرق عادةً حفنة من استدعاءات النموذج: قراءة المسار، قراءة معالج الأخطاء، التعديل، تشغيل الاختبارات، ثم تقديم التقرير. أما استعلام غامض مثل "نظّف وحدة الطلبات" فقد يستهلك حصة اليوم كاملة قبل أن يصل أي شيء إلى الإنجاز.
نافذة السياق البالغة مليون توكن هي السبب الآخر الذي يجعل ERNIE مناسبًا للوكلاء. يمكنك لصق تتبع أخطاء طويل أو ملف OpenAPI كامل في استعلام واحد بدلاً من توزيعه على عدة رسائل. طلب واحد كبير أفضل من خمسة طلبات صغيرة عندما يكون كل طلب مهمًا.
دع ERNIE يشغّل اختبارات API الخاصة بك باستخدام Apidog CLI
بعد أن يُصلح الوكيل نقطة نهاية ما، تحتاج إلى دليل على أن الـ API لا يزال يعمل كما يجب، وليس مجرد نجاح اختبار وحدة. يتيح لك Apidog CLI جعل نفس الوكيل يشغّل سيناريوهات الاختبار التي يحتفظ بها فريقك في Apidog، وقراءة حالات الفشل، وإصلاح الكود، ثم تشغيلها مرة أخرى. أنت تكتب استعلامًا واحدًا؛ و ERNIE يُشغّل الأوامر.
ثبّت الأداة، وسجّل الدخول، وأضف مهارة الوكيل:
npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_TOKEN>
npx -y skills add https://apidog.com # pick OpenCode or Claude Code when prompted
ثم امنح وكيلك استعلامًا واحدًا:
Run the "Orders API" test scenario in Apidog project <projectId> against
the local environment. If any step fails, find the endpoint in this repo
that causes it, fix it, and rerun the scenario until it passes.
Summarize what you changed.
يبحث الوكيل عن السيناريو، ويشغّله بتقرير JSON يمكنه تحليله، ثم يعيد التشغيل بعد الإصلاح:
apidog test-scenario list --project <projectId>
apidog run -t <scenarioId> --project <projectId> -e <envId> -r cli,json --out-dir ./apidog-reports
# agent edits the failing route, then:
apidog run -t <scenarioId> --project <projectId> -e <envId> -r cli,json --upload-report
ترسل علامة --upload-report ملخص التشغيل إلى Apidog ليتمكن فريقك من فتحه في التطبيق. و apidog test-report list --project <projectId> يستدعي التشغيلات السابقة إذا احتاج الوكيل إلى المقارنة.
لكن ضع الميزانية في الحسبان. كل تشغيل اختبار، وكل قراءة لتقرير، وكل تعديل للكود هو خطوة للوكيل، لذا قد تستهلك حلقة الإصلاح وإعادة التشغيل بسهولة 10 طلبات نموذج. على فئة الـ 50 يوميًا، شغّل هذه الحلقة مرة أو مرتين، لا طوال فترة بعد الظهر. تغطي وثيقة Apidog CLI في Claude Code و مرجع أمر apidog run بقية الخيارات. كما تغطي خطة Apidog المجانية الفرق التي تضم حتى 4 مستخدمين.
متى يتعثّر المسار المجاني
نقطة النهاية المجانية هي نموذج معاينة خلف مزوّد واحد. إليك ما يمكن توقعه وما يجب فعله حيال ذلك.
| العَرَض | السبب المحتمل | الحل |
|---|---|---|
429 بعد دفعة من الخطوات |
20 طلبًا في الدقيقة | أبطئ الوكيل أو انتظر دقيقة |
429 لبقية اليوم |
استهلاك 50 طلبًا يوميًا (المحاولات الفاشلة تُحتسب) | انتظر إعادة التعيين بتوقيت UTC أو اشترِ 10 أرصدة للحصول على 1,000 يوميًا |
402 على نموذج مجاني |
رصيد حساب سالب | أضف أرصدة لجعل الرصيد أعلى من الصفر |
| تعطّل الوكيل عند المخرجات المنظمة (JSON) | أخطاء في المخرجات المنظمة | اطلب نصًا عاديًا وحلّله بنفسك |
| سوء عمل ميزات Claude Code | نموذج غير خاص بـ Anthropic خلف Claude Code | استخدم OpenCode مع ERNIE أو أعد النموذج الأصلي |
يستحق صف المخرجات المنظمة رقمًا محددًا. في 12 نوفمبر 2026، أظهرت صفحة النموذج على OpenRouter معدل أخطاء مخرجات منظمة بنسبة 21.70% ومعدل أخطاء استدعاء الأدوات بنسبة 1.01% لنقطة النهاية هذه. الاستدعاء الآلي للأدوات، الذي يعتمد عليه وكلاء البرمجة، يبدو سليمًا. أما مخططات JSON الصارمة فليست كذلك، لذا ابقِ سير عمل الوكيل على الأدوات والنص العادي.
كما تختلف السرعة عن الرقم المُعلن. تدّعي وصف بايدو أكثر من 200 توكن في الثانية، بينما قاس OpenRouter وسيطًا (P50) قدره 79 توكنًا في الثانية على نقطة النهاية المجانية في ذلك اليوم.
وأخيرًا، كلمة "Preview" موجودة في الاسم لسبب وجيه. قد يتغير النموذج وحدوده والنسخة :free دون إشعار مسبق. إذا توقف المُعرّف عن العمل، فتحقق من صفحة OpenRouter قبل البدء في تشخيص إعداداتك. أما للوصول المدفوع أو المباشر، فتغطي وثيقة واجهة ERNIE 5.5 Flash API خدمة Baidu Qianfan.
الأسئلة الشائعة
هل ERNIE 5.5 Flash مجاني فعلًا في OpenCode؟ نعم. نقطة النهاية baidu/ernie-5.5-flash-preview:free تكلف 0 دولار لكل توكن مدخلات ومخرجات على OpenRouter. أنت مقيّد بـ 20 طلبًا في الدقيقة و50 طلبًا في اليوم، إلا إذا كنت قد اشتريت 10 أرصدة على الأقل من OpenRouter.
هل يدعم Claude Code رسميًا ERNIE 5.5 Flash؟ ليس رسميًا. توثّق OpenRouter كيفية توجيه Claude Code إلى نماذج أخرى، لكنها تقول إن الإعداد مضمون فقط مع مزوّد Anthropic الأول. يعمل، لكن توقّع بعض العيوب مع الأدوات. OpenCode هو الخيار الأكثر أمانًا لـ ERNIE.
ما هو مُعرّف نموذج ERNIE 5.5 Flash على OpenRouter؟ هو baidu/ernie-5.5-flash-preview:free للنسخة المجانية. في OpenCode، أضف إليه البادئة openrouter/. وفي Claude Code، استخدمه كما هو في متغيرات ANTHROPIC_DEFAULT_*_MODEL.
كم مهمة برمجية يمكنني إنجازها بـ 50 طلبًا يوميًا؟ يعتمد ذلك على المهمة. قد يستغرق إصلاح محدود النطاق من 5 إلى 10 خطوات للوكيل، فيتناسب مع ذلك عدد محدود من المهام. أما إعادة الهيكلة المفتوحة فقد تستهلك الحصة كاملة دفعة واحدة. حدّد الملفات بالأسماء ووضّح معنى "الإنجاز" في استعلامك.
هل يمكنني استخدام نافذة السياق الكاملة البالغة مليون توكن مجانًا؟ يُدرج OpenRouter نافذة سياق تبلغ 1,024,000 توكن للنسخة المجانية، وهي نفس النافذة الكاملة للنموذج. الاستعلامات الكبيرة تبقى تُحتسب كطلب واحد لكل منها، مما يجعل الاستعلامات طويلة السياق اقتصادية ضمن الحد اليومي.
هل يوجد خيار مجاني بدون OpenRouter؟ يقارن دليلنا لـ ERNIE 5.5 Flash المجاني بين جميع المسارات المجانية. كما نشرت بايدو نموذج ERNIE 5.5 Flash Base على Hugging Face، الذي يمكنك تشغيله بنفسك، كما هو مشروح في تشغيل ERNIE 5.5 Flash محليًا باستخدام vLLM.