Magpie
أضف RunAPI إلى Magpie واختر نماذجه لاستخدامها مع Claude Code أو Codex.
التثبيت والتحضير
ثبّت أحدث إصدار مستقر من Magpie. اتبع المرجع الرسمي للحصول على تعليمات التثبيت الخاصة بمنصتك. ثبّت Claude Code أو Codex بشكل منفصل.
أنشئ مفتاح API قياسيًا مخصصًا باتباع دليل المصادقة. انسخ معرّف نموذج والبروتوكول الذي يدعمه من كتالوج النماذج. احتفظ بنسخة احتياطية من إعدادات وكيلك قبل تغيير المزوّد.
إضافة مزوّد متوافق مع OpenAI
استخدم هذا المسار للنماذج التي تدعم Chat Completions. استبدل القيمتين
النائبتين قبل تشغيل الأمر. ينتهي العنوان الأساسي url= بـ /v1؛ ويضيف
Magpie المسار /chat/completions.
magpie provider add runapi-chat url=https://runapi.ai/v1 key=YOUR_RUNAPI_API_KEY models=YOUR_RUNAPI_MODEL_ID
إضافة مزوّد متوافق مع Anthropic
استخدم هذا المسار للنماذج التي تدعم Anthropic Messages. لا يحتوي العنوان
الأساسي anthropic= على /v1؛ ويضيف Magpie المسار /v1/messages.
magpie provider add runapi-anthropic anthropic=https://runapi.ai key=YOUR_RUNAPI_API_KEY models=YOUR_RUNAPI_MODEL_ID
اختر مسارًا واحدًا أولًا. يرفض Magpie إضافة مزوّد ثانٍ بالمفتاح نفسه. للاحتفاظ بالمزوّدين، أنشئ مفتاح RunAPI مخصصًا مختلفًا لكل منهما. احتفظ بمفاتيح RunAPI في Magpie، خارج مستودعاتك.
تعيين نموذج لوكيل
شغّل Magpie وأبقِ بوابته قيد التشغيل. في شاشة Agents، اختر Claude Code أو Codex ثم اختر النموذج ضمن مزوّد RunAPI الخاص بك. توفر واجهة سطر الأوامر الاختيار نفسه. شغّل أمرًا واحدًا باستخدام المزوّد ومعرّف النموذج اللذين اخترتهما.
magpie serve
اختر النموذج في نافذة طرفية أخرى.
magpie models
magpie claude runapi-chat/YOUR_RUNAPI_MODEL_ID
magpie codex runapi-chat/YOUR_RUNAPI_MODEL_ID
لمسار Anthropic، استبدل runapi-chat بـ runapi-anthropic. يستخدم
Magpie الصيغة provider/model محليًا ويمرر معرّف النموذج الأصلي إلى
RunAPI. يتصل الوكيل بـ Magpie على 127.0.0.1:3425؛ ولا يحتاج إلى مفتاح
RunAPI. يستخدم Codex واجهة Responses المحلية، وهذا لا يعني أن RunAPI
يستقبل طلب Responses. يحدد مسارا المزوّد هذان استخدام Chat Completions
أو Messages في جانب RunAPI.
التحقق من الإعداد
تحقق من المزوّد والنموذج المحدد باستخدام هذه الأوامر، ثم ابدأ جلسة وكيل جديدة وأرسل مطالبة قصيرة.
magpie version
magpie providers
magpie claude
magpie codex
تأكد من وجود النموذج والطلب المتوقعين في سجلات استخدام RunAPI. لا تكفي استجابة الوكيل الناجحة وحدها لتحديد المزوّد الذي عالج الطلب. قد ترسل ميزات Test models وDetect APIs واختبار المزوّد في Magpie طلبات استدلال.
جرى التحقق من الإعداد والمسارات المحلية باستخدام Magpie 0.1.1307 وClaude Code 2.1.295 على Linux. أعاد كلا مساري المزوّد استجابة ثابتة من بيئة اختبار محلية. لم يُختبر استدلال RunAPI الحقيقي ولا استدلال Codex لهذا الدليل. تحقق من بروتوكول النموذج المحدد ودعمه للأدوات قبل استخدامه في مهام الوكيل.
استكشاف الأخطاء وإصلاحها
إذا أفاد Magpie بأن مزوّدًا أُضيف بالفعل بهذا المفتاح، فأعد استخدام ذلك المزوّد أو استخدم مفتاحًا مخصصًا مختلفًا للمسار الثاني. أُعيد إنتاج هذا الخطأ محليًا.
أعادت تجربة ببيئة اختبار محلية إنتاج الخطأ no model list مع
connection refused عند إيقاف الخادم المضبوط. تحقق من العنوان وتوفّر
الخادم، ثم استخدم models= مع معرّف النموذج الدقيق. أبقِ Magpie قيد
التشغيل أثناء استخدام الوكلاء لبوابته المحلية.
أبلغ Claude Code عن unrecognized_model لمعرّفات بيئة الاختبار، لكنه
أعاد استجابة الاختبار رغم ذلك. تحقق من معرّف النموذج الأصلي وإعدادات
النماذج في Claude Code إذا ظهر هذا التحذير. لم تتحقق بيئة الاختبار من
حدود السياق أو استدعاءات الأدوات أو جودة النموذج.
استعادة الإعداد السابق
استعد إعداد الوكيل قبل إزالة مزوّده. تعيد هذه الأوامر كل وكيل إلى إعداداته السابقة.
magpie claude default
magpie codex default
magpie provider rm runapi-chat
magpie provider rm runapi-anthropic
أزل المزوّدين الذين أضفتهم فقط. ألغِ مفاتيح RunAPI المخصصة إذا لم تعد بحاجة إليها. استعد النسخة الاحتياطية إذا أجريت تغييرات يدوية إضافية على الإعدادات.
الخطوات التالية
راجع البدء السريع لواجهة LLM API للاطلاع على أمثلة البروتوكولات العامة في RunAPI، وكتالوج النماذج لمعرفة النماذج المدعومة. يذكر مرجع Magpie الرسمي أيضًا تكاملًا مع Grok Build؛ ولم يُختبر Grok Build لهذا الدليل.