magpie لا يعمل؟ أخطاء 401 و405 وإصلاحاتها (نوفمبر 2026)
اعتبارًا من 2026-11-10، تقدّم وثائق magpie الرسمية وملاحظات الإصدار وقضايا المستودع سببًا وإصلاحًا لكل من هذه الأخطاء الشائعة: إذا ظل الوكيل يستخدم النموذج القديم بعد التبديل، فإن الجلسة قيد التشغيل تحتفظ بالنموذج الذي بدأت به، لذا ابدأ جلسة جديدة (وأعد تشغيل تطبيق Codex في حالة Codex)؛ ويعني الخطأ 401 في Docker أو على شبكة LAN أن الطلب لم يحمل مفتاح بوابة مفعّلًا، لذا أنشئ مفتاحًا باستخدام magpie gateway-key add؛ وبخصوص الخطأ 405 في ZCode، أجاب المؤلف في issue #425 بأن magpie لا يعيد كتابة prompts الخاصة بك ولا يتظاهر بأنه العميل الرسمي. مع QCode، الخطأ 400 على سطري chat وresponses في provider test متوقع، وإذا رأيت أول 24 نموذجًا فقط، فاختر ما تحتاجه باستخدام magpie provider models.
آخر تحديث 2026-11-14
وجّه هذه الأداة إلى نقطة نهاية QCode — مفتاح واحد لـ Claude وGPT والنماذج الصينية.
- الفوترة حسب token — الأسعار المباشرة على /models
- الدفع بالبطاقة (Visa / Mastercard) أو Apple Pay أو Google Pay أو العملات الرقمية
- خدمة ذاتية: شحن الرصيد والتفعيل فورًا
الأخطاء الأربعة الأكثر شيوعًا
ابدأ جلسة جديدة بعد التبديل
إجابة الأسئلة الشائعة الرسمية: تحتفظ الجلسة قيد التشغيل بما بدأت به، لذا ابدأ جلسة جديدة؛ وفي حالة Codex، أعد تشغيل تطبيق Codex أيضًا.
تتطلب الطلبات مفتاح بوابة
وثائق Docker الخاصة بـ magpie: لا يُستجاب لطلب صادر من المضيف أو من جهاز آخر إلا بمفتاح بوابة مفعّل، ويحصل على 401 بدونه. أنشئ مفتاحًا باستخدام magpie gateway-key add واسم (عندما يعمل magpie في Docker، ضع docker exec magpie في بداية الأمر).
ZCode: المبدأ الذي ذكره المؤلف
أُغلقت المسألة #425 (غير مخطط لها). مبدأ المؤلف: لا يعيد magpie كتابة prompts الخاصة بك ولا يتظاهر بأنه العميل الرسمي. منذ v0.1.590 تقول رسالة هذا الخطأ إن ZCode لا يقبل إلا الطلبات من تطبيقه الخاص، وتقترح إضافة مزوّد آخر إلى المجموعة.
الخطأ 400 في provider test متوقع
وثائق QCode: عندما يكون النموذج الأول نموذج Claude، يُظهر سطرا chat وresponses الخطأ 400، لأن Claude يُقدَّم فقط عبر نقطة نهاية Anthropic Messages؛ علامة الصح في سطر anthropic تعني أن Claude يعمل.
من أين تأتي أخطاء magpie؟
اعتبارًا من 2026-11-10، تأتي معظم أخطاء magpie من أحد ثلاثة مواضع: جلسة الوكيل، أو البوابة المحلية، أو نقطة نهاية النموذج خلفها. يشغّل magpie بوابة على جهازك عند 127.0.0.1:3425، ويكتب، بالنسبة إلى الوكلاء الذين يسردهم، عنوان البوابة وtoken في ملف إعداد الوكيل نفسه. يقرأ الوكلاء إعداداتهم عند بدء التشغيل، لذا ينطبق التبديل على الجلسات التي تبدأ بعده؛ ولا يستطيع الوكيل الاتصال ما دامت البوابة لا تعمل؛ وبمجرد أن تعمل البوابة في Docker أو تُشارك على شبكة LAN، تحتاج الطلبات من خارج الحاوية أو من أجهزة أخرى إلى مفتاح بوابة مفعّل. أدناه، يُدرج كل خطأ بنصه أو بالعرَض الذي يظهر به، مع السبب والأمر الواردين في وثائق magpie الرسمية وملاحظات الإصدار وقضايا المستودع. ابدأ بثلاثة أوامر تشخيصية: magpie healthcheck، وmagpie provider test مع معرّف المزوّد الخاص بك، وmagpie log. لإعدادات WSL، راجع /magpie-wsl-windows-setup.
2026-11-10: v0.1.3518 يعالج النص غير UTF-8
تقول ملاحظات الإصدار الرسمية إن v0.1.3518، المنشور في 2026-11-10، أصلح مشكلة كان فيها النص غير UTF-8 في جسم الطلب يصل إلى المزوّد على هيئة محرف الاستبدال � (U+FFFD). إذا تلقى النموذج نصًا غير UTF-8 أرسلته على هيئة �، فتحقق من أن magpie قد حدّث نفسه إلى هذا الإصدار أو إصدار أحدث؛ فنسخة magpie المثبتة تحدّث نفسها.
الخط الزمني
أُغلقت المشكلة #425 (ZCode يعيد 405) مع رد المؤلف؛ وأعاد الإصدار الذي صدر في اليوم نفسه صياغة رسالة الخطأ.
يرد المؤلف على شكوى بشأن قائمة نماذج غير مرتبة على X: أنشئ مجموعة توجيه واختر تلك المجموعة فقط في الوكيل.
تم التحقق من: README الرسمي، وdocs/start، وdocs/docker، والمرجع، والمشكلتين #425 و#4453؛ ونُشر الإصدار الذي يتضمن إصلاح النص غير UTF-8 في اليوم نفسه.
ما تصلحه المصادر الرسمية، وما تتركه مفتوحًا
موثّق من magpie
① تحتفظ الجلسة قيد التشغيل بالنموذج الذي بدأت به؛ ابدأ جلسة جديدة، وأعد تشغيل تطبيق Codex أيضًا عند استخدام Codex. ② بالنسبة إلى نموذج يعمل عبر magpie، تعمل البوابة مع التطبيق؛ إغلاق النافذة يبقيها في شريط القوائم أو علبة النظام، ويشغّل magpie serve البوابة وحدها، ويبقي magpie daemon install البوابة عاملة كخدمة؛ ويخرج magpie healthcheck بالرمز 0 ما دامت البوابة تستجيب. ③ على الاسترجاع المحلي يعمل أي token؛ بمجرد أن تصبح البوابة على الشبكة (0.0.0.0 في Docker، ومشاركة الشبكة المحلية)، تحتاج الطلبات البعيدة إلى مفتاح بوابة ممكّن وإلا فستحصل على 401، وتُعد توزيعة WSL خلف NAT بعيدة. ④ نص خطأ 401 في Docker هو السؤال الثاني في الأسئلة الشائعة أدناه؛ الإصلاح هو إنشاء مفتاح بوابة ووضعه في إعدادات الوكيل. ⑤ تُرفض صفحة المتصفح التي تُفتح دون مفتاحها (401)؛ استخدم الرابط من السجل، واضبط MAGPIE_WEB_KEY للحفاظ على المفتاح عبر عمليات إعادة التشغيل. ⑥ عند ضبط MAGPIE_ALLOW_IPS، يُرفض الطلب القادم من أي عنوان آخر بالرمز 403 قبل فحص مفتاحه. ⑦ يرسل magpie provider test مع معرّف المزوّد طلبًا صغيرًا واحدًا لكل API ويعرض زمن الاستجابة. ⑧ يطبع magpie log مكان السجلات، ويتابعها magpie log -f.
ما تتركه المصادر الرسمية مفتوحًا
حتى تاريخ 2026-11-10: ① لا تزال المشكلة #4453، رفض جلسات SSH البعيدة، مفتوحة: في جلسة SSH، يرفض Claude Desktop عنوان البوابة للاسترجاع المحلي 127.0.0.1:3425 الذي يكتبه magpie له، قائلًا إن الجلسات البعيدة غير متاحة مع تلك البوابة. لم يكن مؤلف المستودع قد رد عند التحقق من ذلك، لذا اتبع الإجابة الرسمية عند صدورها. ② تتبدل صياغة الأخطاء بين الإصدارات، مثلًا أُعيدت صياغة رسالة ZCode مرة واحدة، لذا رُتّبت الأخطاء هنا حسب معناها لا حسب صياغة واحدة بعينها. ③ يصدر magpie عدة إصدارات يوميًا؛ الإصدار الذي أصلح مشكلتك موجود في GitHub Releases.
401 واحد، حالتان
الاسترجاع المحلي
المرجع الرسمي: طلبات الاسترجاع المحلي متسامحة، ويعمل أي token، بما في ذلك مفتاح بوابة قديم أو معطّل؛ ويتصل الوكلاء بـ 127.0.0.1:3425 افتراضيًا.
Docker أو مشاركة الشبكة المحلية
بمجرد أن تصبح البوابة على الشبكة، تحتاج الطلبات البعيدة إلى مفتاح بوابة ممكّن يُرسل بصيغة Bearer أو x-api-key أو x-goog-api-key أو ?key=، وإلا فستحصل على 401. ويُعد كل من نشر منافذ Docker (حتى طلبات المضيف نفسه تصل عبر الجسر) وتوزيعة WSL خلف NAT بعيدين.
افحص magpie بهذا الترتيب
① تحقق من إصدارك أولًا: يصدر magpie عدة إصدارات يوميًا، وقد استخدم اختبار QCode لهذه الصفحة بتاريخ 2026-11-10 الإصدار 0.1.3533؛ وتحدّث نسخة magpie المثبّتة نفسها تلقائيًا، أو أعد تشغيل المثبّت الرسمي curl -fsSL https://usemagpie.ai/install.sh | sh. ② شغّل magpie healthcheck؛ يعني رمز الخروج 0 أن البوابة تستجيب. وعند عدم تشغيل أي بوابة، يبلّغ بعدم وجود بوابة على http://127.0.0.1:3425 (اختبار QCode، 2026-11-10)؛ عندئذ افتح التطبيق، أو شغّل magpie serve للبوابة وحدها. ③ شغّل magpie provider test مع معرّف المزوّد الخاص بك (qcode إذا أضفت QCode كما في وثائقه)؛ فهو يرسل طلبًا صغيرًا واحدًا لكل API، لترى أي سطر يفشل. ④ شغّل magpie log -n 200 لأحدث أسطر السجل، وأرفق المسار الذي يطبعه magpie log عند طلب المساعدة. ⑤ إذا لم يسرِ التبديل، ابدأ جلسة جديدة، وأعد تشغيل تطبيق Codex عند استخدام Codex. ⑥ لخطأ 401 في Docker أو على شبكة LAN، أنشئ مفتاحًا ضمن Gateway → Gateway keys، أو باستخدام magpie gateway-key add مع اسم (في Docker، ضع docker exec magpie في المقدمة). ⑦ بالنسبة إلى WSL، راجع /magpie-wsl-windows-setup.
سلوكان طبيعيان لدى QCode
اعتبارًا من 2026-11-10، تصف وثائق QCode نتيجتين طبيعيتين: ① عندما يكون النموذج الأول من نماذج Claude، يعرض magpie provider test على المزوّد qcode علامة ✗ 400 في سطري chat وresponses، قائلًا إن النموذج غير متاح على نقطة النهاية هذه: لا يُقدَّم Claude إلا على نقطة نهاية Anthropic Messages، لذا فإن علامة صح في سطر anthropic تعني أن Claude يعمل؛ للتحقق من GPT، شغّل magpie codex qcode/gpt-6.1-sol وأرسل طلبًا حقيقيًا. ② من دون models= عند إضافة المزوّد، لا يعرض magpie إلا أول 24 نموذجًا من القائمة؛ اختر النماذج التي تريد إتاحتها باستخدام magpie provider models متبوعًا بمعرّف المزوّد qcode ومعرّفات النماذج، وراجع https://qcode.cc/models لمعرفة النماذج المعروضة للبيع. يخدم المفتاح الواحد في QCode واجهتين متوافقتين مع Anthropic وOpenAI؛ وفي magpie، أدخل https://api.qcode.cc/api لـ anthropic، وhttps://api.qcode.cc/openai/v1 لـ chat، وhttps://api.qcode.cc/openai لـ responses. الفوترة لكل token، والأسعار حسب النموذج على /models. ثلاث خطوات للبدء: أنشئ حسابًا، واشحن الرصيد، وانسخ المفتاح (يبدأ بـ cr_)، ثم أضفه كما في صفحة magpie على docs.qcode.cc. هل تريد تجربته لبضعة أيام أولًا؟ تبدأ باقات الدفع حسب الاستخدام من $4 مقابل حصة تُستخدم لمرة واحدة خلال 7 أيام؛ راجع /pay-as-you-go.
الأسئلة الشائعة
غيّرت النموذج، لكن وكيل البرمجة لا يزال يستخدم النموذج القديم.
تحتفظ الجلسة قيد التشغيل بالنموذج الذي بدأت به، كما تقول الأسئلة الشائعة الرسمية. ابدأ جلسة جديدة، وبالنسبة إلى Codex أعد تشغيل تطبيق Codex أيضًا. تقرأ وكلاء البرمجة إعداداتها عند البدء، لذا يسري التغيير على الجلسة التالية. لإعادة وكيل البرمجة إلى ما كان عليه، اختر أحد نماذجه الخاصة في أداة الاختيار، أو شغّل magpie متبوعًا باسم الوكيل وdefault، على سبيل المثال magpie claude default.
401: مفتاح API المرسَل ليس مفتاح بوابة magpie ممكّنًا
هذا هو نص 401 المقتبس في وثائق Docker الخاصة بـ magpie: المفتاح الذي أرسله وكيل البرمجة من خارج الحاوية ليس مفتاح بوابة ممكّنًا (مع مشاركة LAN، تحتاج الطلبات الواردة من أجهزة أخرى إلى مفتاح بوابة أيضًا). تذكر الوثائق حالة واحدة: بعد الترقية من صورة أقدم، لا يزال وكيل البرمجة خارج الحاوية يرسل magpie أو مفتاحًا آخر ليس مفتاح بوابة. الإصلاح: أنشئ مفتاحًا ضمن Gateway → Gateway keys، أو باستخدام magpie gateway-key add مع اسم (في Docker، ضع docker exec magpie في المقدمة)، مما يطبع مفتاحًا جديدًا بصيغة sk-magpie-key-…، ثم ضعه في وكيل البرمجة بوصفه مفتاح API الخاص به. على واجهة الاسترجاع المحلية يعمل أي token.
ZCode: 405 الطريقة غير مسموح بها
يبدأ عنوان المشكلة #425 بعبارة ZCode provider returns 405 Method Not Allowed، وقد أُغلقت المشكلة (غير مخطط لها). قدّم ردّ المؤلف في 2026-10-01 المبدأ القائل إن magpie لا يعيد كتابة prompts الخاصة بك ولا يتظاهر بأنه العميل الرسمي. منذ v0.1.590 تقول رسالة الخطأ هذه إن ZCode لا يقبل إلا الطلبات من تطبيقه الخاص، وتقترح إضافة مزوّد آخر إلى المجموعة. إذا اتبعت ذلك وأضفت مزوّدًا يعمل بمفتاح API، فإن QCode يوفر نماذج GLM مثل glm-5.3 على واجهة Anthropic وواجهة OpenAI Chat معًا؛ راجع /models لكل نموذج.
يعرض سطرا chat وresponses في اختبار المزوّد 400. هل إعدادي خاطئ؟
لا، ما دام سطر anthropic يحمل علامة صح. لا يقدم QCode نماذج Claude إلا على نقطة نهاية Anthropic Messages؛ وعندما يكون النموذج الأول من نماذج Claude، يرسله الاختبار إلى chat وresponses أيضًا ويحصل على 400 بحكم التصميم، إذ تظهر الرسالة: النموذج 'claude-opus-5-5' غير متاح على نقطة النهاية هذه. للحصول على علامة صح في الأسطر الثلاثة كلها، ضع نموذج GPT مثل gpt-6.1-terra أولًا عندما تسرد النماذج باستخدام magpie provider models، كما اختبرت QCode في 2026-11-10؛ يمكنك أيضًا التحقق من GPT بتشغيل magpie codex qcode/gpt-6.1-sol وإرسال طلب حقيقي.
لماذا أرى بعض النماذج فقط في magpie، أو لماذا قائمة النماذج فوضوية إلى هذا الحد؟
في اختبار QCode، ومن دون models= عند إضافة المزوّد، لا يعرض magpie إلا أول 24 نموذجًا. كتابة معرّف المزوّد ومعرّفات النماذج بعد magpie provider models تستبدل القائمة كاملة بقائمتك؛ ولإتاحة نموذج واحد إضافي فقط، يستخدم المرجع +model-id (و -model-id يزيل واحدًا)، مع ترك الباقي كما هو. بالنسبة إلى قائمة فوضوية، يجيب المؤلف على X في 2026-11-05 بإنشاء مجموعة توجيه واختيار تلك المجموعة فقط في وكيل البرمجة؛ ويصف المرجع أيضًا خيار Only through routing groups على مزوّد يُبقي المزوّد كاملًا لمجموعات التوجيه.
يحصل وكيل البرمجة على 502 أو يتعذر عليه الاتصال، ولا يظهر شيء في علامة تبويب Routing في magpie؟
السبب في الأسئلة الشائعة الرسمية: أن تطبيق بروكسي (Surge وClash وmihomo وما شابه، مع تفعيل بروكسي النظام أو TUN أو الوضع المعزّز) قد أخذ طلب وكيل البرمجة إلى http://127.0.0.1:3425 وأرسله إلى مكان آخر، فلا يصل أبدًا إلى magpie. الإصلاح الرسمي: أضف قاعدتين توجّهان العناوين المحلية مباشرة، قبل قواعدك الأخرى، IP-CIDR,127.0.0.0/8,DIRECT,no-resolve وIP-CIDR6,::1/128,DIRECT,no-resolve، ثم اجعل الوكيل يرسل طلبًا جديدًا.
المصادر
إن README الخاص بـ magpie وdocs/start وdocs/docker على usemagpie.ai (بما فيها النسخ الصينية)، وdocs/reference.md في المستودع، وصفحات GitHub Releases للإصدارات المذكورة هنا، والمشكلتين #425 و#4453 مع تعليقاتهما، وأرشيف لمنشور المؤلف على X بتاريخ 2026-11-05، كلها قُرئت في 2026-11-10. QCode: qcode.cc/models وqcode.cc/pay-as-you-go وصفحة magpie على docs.qcode.cc وملاحظات الاختبار الخاصة بـ QCode، كلها بتاريخ 2026-11-10.
استخدم magpie بمفتاح QCode
يُدخَل مفتاح QCode واحد في حقول anthropic وchat وresponses في magpie، ويخدم الواجهتين المتوافقتين مع Anthropic وOpenAI؛ والفوترة لكل token، مع أسعار لكل نموذج على /models.
قراءات ذات صلة
باقات الدفع حسب الاستخدام
باقات حصة لمرة واحدة صالحة لمدة 7 أيام، دون اشتراك؛ أسعار كل نموذج على /models.
إعداد magpie مع Claude Code: بوابة محلية لـ Claude Code وCodex (2026-11)
إعداد magpie: أوامر التثبيت وإلغاء التثبيت، وثلاث طرق لإضافة مزوّد، واختيار النماذج لـ Claude Code وCodex، وعناوين QCode الثلاثة.
إعداد magpie مع WSL وmagpie على Windows (2026-11)
أين تُثبّت magpie مع WSL: تطبيق Windows وmagpie.exe، والوكلاء في توزيعات WSL، وحالة مشكلات WSL، وعناوين QCode الثلاثة.
دليل الدفع بالعملات المشفرة
تسع عملات، و56 شبكة، وبدون رسوم منصة لرصيد API للبرمجة بالذكاء الاصطناعي.
تم التحقق من العبارات الواردة في هذه الصفحة في 2026-11-10 مقابل وثائق magpie الرسمية وملاحظات الإصدار ومشكلات المستودع؛ وللصفحات الرسمية الأولوية. تتغير صياغة الأخطاء وأسماء القوائم بحسب الإصدارات، لذا اتبع الإصدار الذي تثبّته. يتّبع توفّر نماذج QCode ما ورد في /models.