---
title: Magpie | RunAPI
description: أضف RunAPI إلى Magpie واختر نماذجه لاستخدامها مع Claude Code أو Codex.
url: https://runapi.ai/ar/docs/resources/tool-integrations/magpie.md
canonical: https://runapi.ai/ar/docs/resources/tool-integrations/magpie
locale: ar
---

> نسخة HTML: https://runapi.ai/ar/docs/resources/tool-integrations/magpie
> فهرس الموقع للوكلاء: https://runapi.ai/llms.txt

# Magpie

## التثبيت والتحضير

ثبّت أحدث إصدار مستقر من [Magpie][1]. اتبع [المرجع الرسمي][2] للحصول على
تعليمات التثبيت الخاصة بمنصتك. ثبّت Claude Code أو Codex بشكل منفصل.



[1]: https://usemagpie.ai
[2]: https://github.com/yetone/magpie/blob/main/docs/reference.md

أنشئ مفتاح API قياسيًا مخصصًا باتباع [دليل
المصادقة](https://runapi.ai/ar/docs/guides/authentication.md). انسخ معرّف نموذج والبروتوكول
الذي يدعمه من [كتالوج النماذج](https://runapi.ai/ar/models). احتفظ بنسخة احتياطية من إعدادات
وكيلك قبل تغيير المزوّد.

## إضافة مزوّد متوافق مع OpenAI

استخدم هذا المسار للنماذج التي تدعم Chat Completions. استبدل القيمتين
النائبتين قبل تشغيل الأمر. ينتهي العنوان الأساسي `url=` بـ `/v1`؛ ويضيف
Magpie المسار `/chat/completions`.

```shell
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`.

```shell
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 الخاص بك. توفر واجهة سطر
الأوامر الاختيار نفسه. شغّل أمرًا واحدًا باستخدام المزوّد ومعرّف النموذج
اللذين اخترتهما.

```shell
magpie serve
```

اختر النموذج في نافذة طرفية أخرى.

```shell
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.

## التحقق من الإعداد

تحقق من المزوّد والنموذج المحدد باستخدام هذه الأوامر، ثم ابدأ جلسة وكيل
جديدة وأرسل مطالبة قصيرة.

```shell
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 إذا ظهر هذا التحذير. لم تتحقق بيئة الاختبار من
حدود السياق أو استدعاءات الأدوات أو جودة النموذج.

## استعادة الإعداد السابق

استعد إعداد الوكيل قبل إزالة مزوّده. تعيد هذه الأوامر كل وكيل إلى
إعداداته السابقة.

```shell
magpie claude default
magpie codex default
magpie provider rm runapi-chat
magpie provider rm runapi-anthropic
```

أزل المزوّدين الذين أضفتهم فقط. ألغِ مفاتيح RunAPI المخصصة إذا لم تعد
بحاجة إليها. استعد النسخة الاحتياطية إذا أجريت تغييرات يدوية إضافية على
الإعدادات.

## الخطوات التالية

راجع [البدء السريع لواجهة LLM API](https://runapi.ai/ar/docs/guides/llm-api/quickstart.md)
للاطلاع على أمثلة البروتوكولات العامة في RunAPI، و[كتالوج
النماذج](https://runapi.ai/ar/models) لمعرفة النماذج المدعومة. يذكر مرجع Magpie الرسمي أيضًا
تكاملًا مع Grok Build؛ ولم يُختبر Grok Build لهذا الدليل.

---

## المزيد من RunAPI

- [الرئيسية](https://runapi.ai/ar/.md)
- [كتالوج النماذج](https://runapi.ai/ar/models.md)
- [الأسعار](https://runapi.ai/ar/pricing.md)
- [مزودو الخدمة](https://runapi.ai/ar/models)
- [التوثيق](https://runapi.ai/ar/docs/guides)
- [حزم SDK](https://runapi.ai/ar/sdk.md)
- [CLI](https://runapi.ai/ar/cli.md)
- [خادم MCP](https://runapi.ai/ar/mcp.md)
- [x402](https://runapi.ai/ar/x402.md)
- [Claude Code مقابل Cursor](https://runapi.ai/ar/claude-code-vs-cursor.md)
- [إعداد Cursor API](https://runapi.ai/ar/cursor-api-setup.md)
- [RunAPI مقابل OpenRouter](https://runapi.ai/ar/openrouter-alternative.md)
- [المؤسسات](https://runapi.ai/ar/contact.md)
- [اتصل بنا](https://runapi.ai/ar/contact.md)
- [الشروط](https://runapi.ai/ar/terms.md)
- [الخصوصية](https://runapi.ai/ar/privacy.md)
- [فهرس الموقع للوكلاء](https://runapi.ai/llms.txt)

التواصل: contact@runapi.ai

## البيانات المنظمة

```json
[
  {
    "@context": "https://schema.org",
    "inLanguage": "ar",
    "@type": "WebSite",
    "name": "RunAPI",
    "url": "https://runapi.ai/ar",
    "potentialAction": {
      "@type": "SearchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "https://runapi.ai/ar/models?q={search_term_string}"
      },
      "query-input": "required name=search_term_string"
    }
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "ar",
    "@type": "Organization",
    "name": "RunAPI",
    "url": "https://runapi.ai/ar",
    "logo": {
      "@type": "ImageObject",
      "url": "https://runapi.ai/aricon.svg"
    },
    "sameAs": [
      "https://github.com/runapi-ai"
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "ar",
    "@type": "TechArticle",
    "headline": "Magpie",
    "description": "أضف RunAPI إلى Magpie واختر نماذجه لاستخدامها مع Claude Code أو Codex.",
    "url": "https://runapi.ai/ar/docs/resources/tool-integrations/magpie",
    "mainEntityOfPage": "https://runapi.ai/ar/docs/resources/tool-integrations/magpie"
  }
]
```