إعداد magpie مع Claude Code: ثبّت البوابة المحلية واختر النماذج (نوفمبر 2026)
اعتبارًا من 2026-11-10، تضع الوثائق الرسمية لـ magpie (usemagpie.ai) Claude Code على magpie في ثلاث خطوات: نفّذ أمر التثبيت وابدأ magpie؛ أضف مزوّدًا ضمن Providers باستخدام مفتاح API الخاص بك؛ ثم نفّذ magpie claude مع اسم المزوّد/النموذج، ويُطبّق النموذج بدءًا من الجلسة التالية (ولـ Codex، نفّذ magpie codex وأعد تشغيل تطبيق Codex). magpie (yetone/magpie) بوابة على جهازك عند 127.0.0.1:3425 تترجم بين OpenAI Chat وOpenAI Responses وAnthropic Messages وGemini؛ وهي مرخّصة بموجب MIT وغير تابعة لـ Apache Magpie. عناوين QCode الثلاثة والأوامر أدناه.
آخر تحديث 2026-11-13
وجّه هذه الأداة إلى نقطة نهاية QCode — مفتاح واحد لـ Claude وGPT والنماذج الصينية.
- الفوترة حسب token — الأسعار المباشرة على /models
- الدفع بالبطاقة (Visa / Mastercard) أو Apple Pay أو Google Pay أو العملات الرقمية
- خدمة ذاتية: شحن الرصيد والتفعيل فورًا
أربع نقاط من المصادر الرسمية
مفتوح المصدر بموجب رخصة MIT، من yetone
يحمل مستودع yetone/magpie رخصة MIT (Copyright (c) 2026 yetone). ويُختتم ملف README بالعبارة: magpie ليست تابعة لـ Apache Magpie أو Apache Software Foundation.
عنوان البوابة المحلية
تتحدث البوابة لغات OpenAI Chat وOpenAI Responses وAnthropic Messages وGemini وتترجم بينها، مع تضمين البث واستدعاءات الأدوات والاستدلال.
المنصات والأشكال
يقول ملف README إنه يعمل على macOS وWindows وLinux (تطبيق شريط القوائم، ونافذة، وTUI، وweb UI، وCLI)، وفي Docker، وعلى Termux.
مكان وجود مفاتيحك
توجد المفاتيح في ~/.config/magpie/providers.json، وهي قابلة للقراءة لك وحدك. لا يقرأ magpie أبدًا مفاتيح من بيئة shell لديك: ما تضيفه هو ما يستخدمه.
ما هو magpie؟
اعتبارًا من 2026-11-10، تصفه وثائق magpie بأنه مكان واحد لاختيار النموذج الذي يستخدمه كل وكيل من وكلائك. تضيف المزوّدين الذين لديك، وتختار نموذجًا لكل وكيل، ويكتبه magpie في إعدادات ذلك الوكيل نفسه. وخلفه بوابة صغيرة على جهازك عند 127.0.0.1:3425 تدعم واجهات API الخاصة بـ OpenAI وAnthropic وGemini وتترجم بينها، بحيث يمكن لوكيل يتحدث Anthropic Messages فقط، مثل Claude Code، أن يستخدم أيضًا GPT أو النماذج الصينية. المؤلف هو yetone، والموقع هو usemagpie.ai، والمستودع هو yetone/magpie.
أوامر التثبيت وإلغاء التثبيت
اعتبارًا من 2026-11-10، أمر التثبيت الرسمي هو curl -fsSL https://usemagpie.ai/install.sh | sh. وهو يضع أمر magpie في ~/.local/bin والتطبيق في /Applications على جهاز Mac أو في قائمة تطبيقاتك على Linux؛ ويعمل أيضًا go install github.com/yetone/magpie@latest. على Windows، نزّل magpie-windows-amd64.exe (وmagpie-windows-arm64.exe لـ ARM) من أحدث إصدار؛ ويقبل magpie.exe الأوامر نفسها، وmagpie-cli-windows-amd64.exe هو البناء المخصّص للطرفية فقط. توجد أيضًا صورة Docker، ghcr.io/yetone/magpie؛ راجع وثائق Docker الرسمية. لإلغاء التثبيت، نفّذ curl -fsSL https://usemagpie.ai/install.sh | sh -s -- --uninstall: يفصل magpie أولًا كل وكيل ويعيد ما كان لدى كل وكيل؛ وتبقى إعداداتك ومزوّدوك في ~/.config/magpie، ويحذفها --purge أيضًا.
الجدول الزمني
أُنشئ مستودع yetone/magpie على GitHub.
تُنهي وثائق QCode اختبار magpie مع Claude Code وCodex، وتنشر مقال إعداد magpie على docs.qcode.cc.
أعادت QCode الاختبار باستخدام بناء magpie المخصّص للطرفية في ذلك اليوم: أضاف أمر magpie provider add واحد QCode، وحصل provider test على إجابات من العناوين الثلاثة كلها. وفي اليوم نفسه: فُحص README، والوثائق الرسمية (Get started، وAdd to magpie، وDocker، وصفحتا نماذج Claude Code وCodex)، والمرجع، وإصدارات GitHub؛ وتقول الوثائق إن magpie يُشحن عدة مرات يوميًا.
ما تنص عليه الوثائق، وما تتركه مفتوحًا
ما تنص عليه الوثائق الرسمية
① بالنسبة إلى نموذج عبر magpie، تعمل البوابة مع التطبيق. ② تحتفظ الجلسة الجارية بالنموذج الذي بدأت به؛ إذ يقرأ الوكلاء إعداداتهم عند البدء، لذا يسري النموذج الجديد بدءًا من الجلسة التالية، ويحتاج Codex أيضًا إلى إعادة تشغيل تطبيقه. ③ لا يغيّر اختيار النموذج سوى المفاتيح التي يحتاجها magpie في إعدادات الوكيل؛ وتبقى التعليقات والترتيب والمسافات البادئة، وتكون عمليات الكتابة ذرّية. ④ Claude Code: يكتب magpie المتغيرين ANTHROPIC_BASE_URL و ANTHROPIC_AUTH_TOKEN في ~/.claude/settings.json، وtoken هو مفتاح البوابة، وليس مفتاح المزوّد الخاص بك؛ Codex: جدول [model_providers.magpie] والنموذج في ~/.codex/config.toml. ⑤ لا تحتاج إلى تصدير OPENAI_BASE_URL أو ANTHROPIC_BASE_URL بنفسك. ⑥ لا يحفظ رابط الاستيراد شيئًا حتى تضغط Add، وعندما يكون المعرّف مستخدمًا بالفعل يظهر على الزر Replace. ⑦ تظهر نماذج magpie أيضًا في قوائم /model في Claude Code و Codex (موسومة عبر magpie في Claude Code)، لذا يمكنك التبديل من داخل الوكيل أيضًا.
ما تتركه الوثائق مفتوحًا
اعتبارًا من 2026-11-10: ① تصوغ الصفحة الرئيسية الرسمية الحد الأدنى لإصدار macOS بطريقتين (macOS 12+ و macOS 11 أو أحدث)، لذا اتبع المتطلب الظاهر عند التنزيل. ② قائمة الوكلاء المدعومين في README أطول من تلك الموجودة في Get started وتستمر في النمو؛ ويظهر ما إذا كان وكيلك معروفًا من مخرجات magpie ls. ③ تقول صفحة الاستيراد الرسمية إنه من دون معامل models يسرد magpie النماذج التي تعيدها /v1/models لدى المزوّد؛ في اختبار QCode بتاريخ 2026-11-10، لم يعرض مزوّد أُضيف من دون models= سوى أول 24 (قرأت المخرجات 24 exposed of 28)، لذا اختر النماذج التي تحتاجها باستخدام magpie provider models بعد إضافته.
ثلاث طرق لإضافة مزوّد
رابط الاستيراد أو التطبيق
رابط الاستيراد هو magpie://import? متبوعًا بمعاملات؛ على الويب استخدم https://usemagpie.ai/import# مع المعاملات نفسها، مع ترميز URL لكل قيمة. تشمل الحقول name (أو preset) و chat و responses و anthropic و gemini و key و models. إذا لم يكن في الرابط key، فالصق مفتاحًا في مربع الحوار. في التطبيق يكون المدخل Providers → Add provider.
أمر واحد في الطرفية
لا يتطلب preset سوى magpie provider add مع معرّف preset و key (المثال الرسمي: deepseek و sk-…)؛ ويأخذ العنوان المخصص url= (متوافق مع OpenAI) و anthropic= (متوافق مع Anthropic) و responses= و models= و key=. في الطرفية، يعرض magpie import مع رابط ملخصًا ويسأل أولًا، ويتخطى -y السؤال؛ وجدت وثائق QCode أن الرابط الذي لا يحتوي على key يُعاين فقط هناك ولا يُحفظ، لذا في الطرفية ينجز magpie provider add ذلك في خطوة واحدة.
إعداد magpie: التثبيت، وإضافة مزوّد، واختيار نموذج لـ Claude Code و Codex
① التثبيت: على macOS و Linux شغّل curl -fsSL https://usemagpie.ai/install.sh | sh؛ وعلى Windows نزّل magpie-windows-amd64.exe؛ ثم شغّل magpie لتكون البوابة قيد التشغيل. ② إضافة مزوّد: في تبويب Providers اضغط + Add provider، أو الصق مفتاحًا لإعداد preset، أو اختر Custom · any compatible URL لأي عنوان آخر؛ صيغة الطرفية موجودة في البطاقة أعلاه، وأمر QCode الكامل أدناه. ③ اختر نموذجًا: في تبويب Agents انقر على نموذج الوكيل، أو شغّل magpie claude deepseek/deepseek-v4-pro أو magpie codex deepseek/deepseek-v4-pro؛ تُسمى النماذج عبر magpie باسم provider/model. ④ ابدأ جلسة جديدة ليقرأ الوكيل الإعدادات الجديدة؛ ويحتاج Codex أيضًا إلى إعادة تشغيل تطبيقه. ⑤ تحقق: يسرد magpie ls الإعدادات الحالية لكل وكيل، ويرسل magpie provider test مع معرّف مزوّد طلبًا صغيرًا واحدًا لكل API ويعرض زمن الاستجابة. ⑥ للعودة إلى إعداد الوكيل الخاص به: magpie claude default أو magpie codex default.
إضافة QCode إلى magpie
اعتبارًا من 2026-11-10، يعرض مقال QCode عن magpie ثلاثة عناوين: anthropic هو https://api.qcode.cc/api، وchat هو https://api.qcode.cc/openai/v1، وresponses هو https://api.qcode.cc/openai (تنتهي أمثلة magpie لـ responses بـ /v1؛ وتذكر صفحة نقاط النهاية في QCode أن /openai/responses و /openai/v1/responses متكافئان). يمر Claude عبر عنوان anthropic، وGPT عبر chat وresponses، والنماذج الصينية عبر anthropic أو chat؛ وبالنسبة إلى نقاط الوصول في آسيا وأمريكا الشمالية، استبدل النطاق بـ asia.qcode.cc أو us.qcode.cc مع الإبقاء على المسارات. أسهل طريق هو زر Import to CC Switch / magpie في لوحة التحكم: انقر فوق Import to magpie هناك، ويُهيَّأ Claude وGPT دفعة واحدة، ثم اختر النماذج عبر magpie claude qcode/claude-sonnet-5-5 أو magpie codex qcode/gpt-6.1-sol. ضبط النموذج الرئيسي فقط يضع خانة opus في Claude Code على النموذج نفسه؛ لإعطائها Opus، شغّل أيضًا magpie claude opus qcode/claude-opus-5-5. مفاتيح QCode مستقلة عن البروتوكول، لذا يخدم مفتاح واحد واجهتي Anthropic وOpenAI-compatible لـ Claude Code وCodex وأدوات أخرى، ويُحتسب بحسب token، مع أسعار لكل نموذج على /models. لست مستعدًا لخطة شهرية؟ تبدأ باقات الدفع حسب الاستخدام من $4 مقابل حصة لمرة واحدة تستخدمها خلال 7 أيام؛ وإذا كانت لديك خطة شخصية بالفعل، فأضف باقة التعزيز عندما تحتاج إلى حصة أكبر.
الأسئلة الشائعة
لماذا لا يسري magpie بعد التبديل؟
الأرجح أن الجلسة لم يُعَد تشغيلها: تحتفظ الجلسة قيد التشغيل بالنموذج الذي بدأت به، ويُطبَّق النموذج الجديد ابتداءً من الجلسة التالية، ويحتاج Codex أيضًا إلى إعادة تشغيل تطبيقه. ثم تأكد من أن البوابة تعمل: بالنسبة إلى نموذج عبر magpie، تعمل البوابة مع التطبيق، ويخرج magpie healthcheck بالرمز 0 إذا كانت البوابة تستجيب. يعرض magpie ls إعدادات كل وكيل الحالية، ويتحقق magpie provider test مما إذا كان المزوّد يستجيب؛ وتُغطى الأخطاء الأخرى على /magpie-errors-and-fixes.
هل يجب أن يبقى magpie مفتوحًا؟
بالنسبة إلى نموذج عبر magpie، نعم: تعمل البوابة مع التطبيق. إغلاق النافذة يتركه يعمل في شريط القوائم أو صينية النظام؛ يشغّل magpie tray الأيقونة وحدها، ويشغّل magpie serve البوابة فقط، ويُبقي magpie daemon install البوابة قيد التشغيل كخدمة (systemd على Linux، وlaunchd على Mac). الوكيل الذي يستخدم نموذجه الخاص لا يمر عبر magpie.
أين يخزّن magpie المفتاح الخاص بي، وهل هو آمن؟
توجد المفاتيح في ~/.config/magpie/providers.json، قابلة للقراءة منك وحدك، ولا يقرأ magpie أبدًا المفاتيح من بيئة shell لديك. تقول الوثائق إن الوكلاء لا يرون مفاتيحك أبدًا: إن ANTHROPIC_AUTH_TOKEN في إعدادات Claude Code هو مفتاح البوابة. يحتفظ رابط استيراد على الويب بمعاملاته بعد #، وهي معاملات لا ترسلها المتصفحات إلى الخادم. وهناك أيضًا إخفاء الخصوصية: عند تفعيله، تُستبدل المفاتيح وكلمات المرور وعناوين البريد الإلكتروني في prompt بعناصر نائبة على حاسوبك قبل أن يغادر الطلب جهازك، ثم تُعاد في الرد؛ وهو معطّل افتراضيًا ويُفعّل من Settings → Privacy.
كيف أزيل تثبيت magpie أو أستعيد إعداداتي الأصلية؟
للاستعادة: شغّل magpie claude default أو magpie codex default؛ يزيل magpie ما كتبه ويستعيد القيم التي استبدلها، مثل ANTHROPIC_BASE_URL الذي كان لديك سابقًا. لإزالة تثبيت نصي، شغّل curl -fsSL https://usemagpie.ai/install.sh | sh -s -- --uninstall؛ تبقى إعداداتك والمزوّدون في ~/.config/magpie، و --purge يحذفها أيضًا.
هل يمكن استخدام magpie وCC Switch معًا؟
نعم، يمكن تثبيتهما جنبًا إلى جنب: في 2026-11-09 ردّ yetone مؤلف magpie على X بأن استخدامهما معًا لا بأس به، ويقول README إن Import في magpie يجلب المزوّدين من CC Switch. تكتب كلتا الأداتين ملفات إعدادات Claude Code وCodex؛ وكيف يقتسمان العمل وأي الإعدادات يجب الانتباه إليها عند تشغيلهما معًا موجودان في صفحة المقارنة /magpie-vs-cc-switch.
كيف أضيف QCode في magpie؟
اختر أيًا من ثلاث طرق. الأسرع هو زر Import to magpie في لوحة التحكم؛ في الطرفية، شغّل magpie provider add QCode anthropic=https://api.qcode.cc/api url=https://api.qcode.cc/openai/v1 responses=https://api.qcode.cc/openai key=cr_xxx، وهو ما أضاف QCode دفعة واحدة في اختبار QCode بتاريخ 2026-11-10؛ في التطبيق، اختر Custom ضمن Providers → Add provider وأدخل Base URL المتوافق مع OpenAI (عنوان chat)، والآخر المتوافق مع Anthropic (عنوان anthropic)، ومفتاح cr_ الخاص بك. من دون models=، يعرض magpie أول 24 نموذجًا فقط، لذا اختر النماذج التي تستخدمها عبر magpie provider models qcode gpt-6.1-sol claude-sonnet-5-5 claude-opus-5-5 claude-haiku-5-5 (من دون +، تُستبدل القائمة بالكامل)؛ وعند وضع نموذج GPT أولًا، يُظهر magpie provider test ✓ في الصفوف الثلاثة كلها: chat وresponses وanthropic. لاستبدال مفتاح مزوّد QCode محفوظ، شغّل magpie provider key مع qcode والمفتاح الجديد.
المصادر
ملف README وLICENSE والمرجع الخاص بمستودع yetone/magpie على GitHub، وGitHub API، ومعلومات إصدار magpie-releases، والصفحة الرئيسية لـusemagpie.ai، والوثائق الرسمية Get started وAdd to magpie وDocker، وصفحات نماذج Claude Code وCodex، كلها قُرئت في 2026-11-10؛ وردّ مؤلف magpie، yetone، على X بتاريخ 2026-11-09. QCode: مقال magpie وصفحة نقطة الوصول على docs.qcode.cc، وqcode.cc/models وqcode.cc/pay-as-you-go، جرى استرجاعها في 2026-11-10، واختبار QCode بنسخة magpie الطرفية في 2026-11-10؛ وصياغة زر الاستيراد في لوحة التحكم مأخوذة من نص موقع QCode نفسه.
Claude وGPT في magpie بمفتاح واحد
مفتاح API واحد من QCode لـClaude Code وCodex والمزيد، تُحتسب التكلفة لكل token؛ أسعار كل نموذج على /models.
قراءات ذات صلة
باقات الدفع حسب الاستخدام
باقات حصة لمرة واحدة صالحة لمدة 7 أيام، بلا اشتراك؛ أسعار كل نموذج على /models.
magpie مقابل CC Switch: كيف تختار
كيف يختلف الاثنان في التشغيل والعملاء وترجمة البروتوكول والتجاوز عند الفشل وإخفاء الخصوصية والترخيص، وكيف يتصل كل منهما بـQCode.
magpie لا يعمل: أخطاء 401 و405 وإصلاحاتها (2026-11)
السبب الرسمي والإصلاح لأخطاء magpie الشائعة: مفتاح تبديل لا يُطبَّق، و401 في Docker، و405 في ZCode، و400 في اختبار المزوّد، ونماذج مفقودة.
دليل الدفع بالعملات المشفرة
تسع عملات، و56 شبكة، وبدون رسوم منصة لرصيد API للبرمجة بالذكاء الاصطناعي.
تم التحقق من العبارات الواردة في هذه الصفحة في 2026-11-10 مقابل مستودع magpie وموقعه ووثائقه؛ والصفحات الرسمية هي المرجع. الإصدار الذي جرى التحقق منه: استخدم اختبار QCode في 2026-11-10 الإصدار magpie 0.1.3533؛ ويصدر magpie عدة مرات يوميًا، لذا تتبع أسماء القوائم والأوامر الإصدار الذي تثبته. يتّبع توافر نماذج QCode المسار /models.