إعداد magpie مع QCode: Claude Code وCodex
وجّه magpie إلى QCode: املأ عناوين anthropic وchat وresponses، وأضف المزوّد عبر رابط استيراد أو أمر واحد، ثم اختر النماذج.
تحتاج مفتاح API؟ أنشئ حسابًا ←نقاط النهاية وعناوين Base URL ←
في هذه الصفحة
- نظرة سريعة
- ما هو magpie، وكيف يختلف عن CC Switch
- أي بروتوكول
- التثبيت
- إضافة QCode
- اختيار النماذج
- التحقق
- العملاء الذين يعرفهم magpie
- كثرة النماذج: مجموعات التوجيه
- لفريق أو لعدة حواسيب: مفاتيح البوابة، والمشاركة عبر الشبكة المحلية، والنسخ الاحتياطي والمزامنة
- الانتقال من CC Switch
- الأسئلة الشائعة
- غيّرت النموذج، لكن وكيل البرمجة ما زال يستخدم النموذج القديم
- كيف ألغي تثبيت magpie؟
- يتعذر على Claude Code الاتصال عندما لا تكون البوابة قيد التشغيل
- هل تعني أسطر 400 الخاصة بـ chat وresponses في magpie provider test qcode إعدادًا خاطئًا؟
- لماذا لا أرى سوى بعض النماذج؟
- كيف أستعيد إعداد Claude Code السابق؟
- كيف أغيّر جهد الاستدلال في Codex؟
- ما المقصود بإخفاء الخصوصية، وهل هو مفعّل افتراضيًا؟
- كيف أوقف عدّ الاستخدام المجهول؟
- مواضيع ذات صلة
آخر تحقق: 2026-11-10 · 📄 وفق الوثائق الرسمية (2026-11-10) · ✅ تم اختبار الوصول إلى QCode مع magpie 0.1.3533 (2026-11-10؛ سابقًا مع magpie 0.1.1677 في 2026-10-27، بما في ذلك Claude Code 2.1.311 وCodex CLI 0.164.0)
نظرة سريعة¶
| العنصر | التفاصيل |
|---|---|
| النماذج التي يمكنك استخدامها | Claude ✅ عبر عنوان anthropic · GPT ✅ عبر chat / responses · النماذج الصينية ✅ عبر anthropic / chat · Gemini ❌: لا يوفّر QCode سلسلة Gemini؛ استخدم Claude أو GPT أو نموذجًا صينيًا |
| العناوين الثلاثة | anthropic: https://api.qcode.cc/api · chat: https://api.qcode.cc/openai/v1 · responses: https://api.qcode.cc/openai |
| أين تُعدّ | رابط الاستيراد (تطبيق سطح المكتب / رابط ويب) · أمر magpie provider add واحد · قسم Providers في التطبيق → Add provider |
| الوثائق الرسمية | usemagpie.ai · الوثائق · روابط الاستيراد · Docker · المرجع |
ما هو magpie، وكيف يختلف عن CC Switch¶
يشغّل magpie بوابة على جهازك (127.0.0.1:3425). وهو يدعم واجهات API الخاصة بـ OpenAI وAnthropic وGemini ويترجم بينها، بما في ذلك البث واستدعاءات الأدوات. عندما تختار نموذجًا لوكيل في magpie، يكتب magpie ذلك النموذج في ملف إعداد الوكيل نفسه. لذلك يتصل Claude Code وCodex بالبوابة المحلية؛ ويبقى مفتاح QCode الخاص بك في magpie، وتُمرّر البوابة كل طلب إلى QCode.
الفرق البنيوي عن CC Switch في جملة واحدة: يكتب CC Switch نقطة النهاية والمفتاح في إعداد كل عميل نفسه، ويتصل العميل بالمزوّد مباشرة؛ بينما يوجّه magpie العميل إلى بوابة محلية تُمرّر الطلبات.
أي بروتوكول¶
| حقل magpie | ما يعنيه في magpie | قيمة QCode |
|---|---|---|
anthropic |
Base URL لـ Anthropic Messages، الجذر بدون /v1 |
https://api.qcode.cc/api |
chat (يُسمى url في CLI) |
Base URL لـ OpenAI Chat Completions، ينتهي بـ /v1 |
https://api.qcode.cc/openai/v1 |
responses |
Base URL لـ OpenAI Responses | https://api.qcode.cc/openai |
يمرّ Claude عبر /api فقط؛ ولا تخدم العناوين المتوافقة مع OpenAI نموذج Claude. أرسل معرّفًا claude-* إلى chat أو responses فيعيد QCode model_not_available_on_endpoint؛ ويُجرى ذلك التحقق قبل المصادقة. يستخدم GPT كلا مساري OpenAI، وتعمل النماذج الصينية على كل من chat وanthropic.
لاستخدام نقطة الوصول الخاصة بآسيا أو أمريكا الشمالية، استبدل النطاق بـ asia.qcode.cc أو us.qcode.cc؛ وتبقى المسارات كما هي. تمتلك النطاقات الثلاثة القدرات نفسها ولا تختلف إلا في توجيه الشبكة.
الوصف الرسمي لـ responses في magpie هو Base URL ينتهي بـ /v1. وبالنسبة إلى QCode، أدخل https://api.qcode.cc/openai (نفس base_url في إعداد Codex الخاص بـ QCode). تم اختباره مع magpie 0.1.3533 في 2026-11-10: ينجح سطر responses في magpie provider test qcode بهذا العنوان؛ وقد تم اختبار جلسات Codex عبره مع magpie 0.1.1677 في 2026-10-27.
التثبيت¶
المثبّت الرسمي:
curl -fsSL https://usemagpie.ai/install.sh | sh
يضع المثبّت الأمر magpie في ~/.local/bin والتطبيق في موضعه: /Applications على Mac، وقائمة التطبيقات على Linux. على Windows، نزّل magpie-windows-amd64.exe (ARM: magpie-windows-arm64.exe) من صفحة الإصدار؛ أما بنيات الطرفية فقط فتُسمّى magpie-cli-<os>-<arch>، مثل magpie-cli-windows-amd64.exe. يعمل magpie على macOS وWindows وLinux كتطبيق شريط قوائم، ونافذة، وTUI، وواجهة ويب، وCLI، وكذلك في Docker وعلى Termux.
على Linux، يثبّت السكربت تطبيق سطح المكتب؛ وعند غياب سطح المكتب يثبّت بنية الطرفية، ويحدد الخيار --gui أو --tui أيهما يُثبَّت. خلف جدار حماية، يقبل المثبّت وmagpie update الخيار --proxy، على سبيل المثال:
curl -fsSL https://usemagpie.ai/install.sh \
| sh -s -- --proxy http://127.0.0.1:7890
إلغاء التثبيت. السطر الرسمي هو:
curl -fsSL https://usemagpie.ai/install.sh | sh -s -- --uninstall
يعيد وكلاءك كما كانوا، ثم يزيل ما ثبّته السكربت. تبقى إعداداتك ومزوّدوك واستخدامك في ~/.config/magpie من أجل تثبيتك مجددًا؛ أضف --purge لحذفها أيضًا. إذا ثبّت بطريقة أخرى، فإن magpie uninstall أو Settings → Uninstall magpie يفعل ما يفعله --purge ويترك البرنامج نفسه لك لتحذفه.
Docker. الصورة هي ghcr.io/yetone/magpie، لخادم أو NAS؛ ويغطيها القسم الخاص بمفاتيح البوابة والمشاركة والمزامنة أدناه.
إضافة QCode¶
الخيار أ: رابط الاستيراد (تطبيق سطح المكتب والويب)
يطلب magpie ترميز كل قيمة بصيغة URL. هذا هو رابط QCode، دون مفتاح:
magpie://import?name=QCode&anthropic=https%3A%2F%2Fapi.qcode.cc%2Fapi&chat=https%3A%2F%2Fapi.qcode.cc%2Fopenai%2Fv1&responses=https%3A%2F%2Fapi.qcode.cc%2Fopenai&models=gpt-6.1-sol%2Cgpt-6.1-terra%2Cgpt-5.6-sol%2Cclaude-opus-5-5%2Cclaude-sonnet-5-5%2Cclaude-haiku-5-5&website=https%3A%2F%2Fqcode.cc&keys=https%3A%2F%2Fqcode.cc%2Fdashboard
على الويب، استخدم الصيغة القابلة للنقر بالمعاملات نفسها بعد # (لا ترسل المتصفحات الجزء اللاحق إلى الخادم أبدًا، ويعرض الرابط التنزيل عندما لا يكون magpie مثبّتًا):
https://usemagpie.ai/import#name=QCode&anthropic=https%3A%2F%2Fapi.qcode.cc%2Fapi&chat=https%3A%2F%2Fapi.qcode.cc%2Fopenai%2Fv1&responses=https%3A%2F%2Fapi.qcode.cc%2Fopenai&models=gpt-6.1-sol%2Cgpt-6.1-terra%2Cgpt-5.6-sol%2Cclaude-opus-5-5%2Cclaude-sonnet-5-5%2Cclaude-haiku-5-5&website=https%3A%2F%2Fqcode.cc&keys=https%3A%2F%2Fqcode.cc%2Fdashboard
دون مفتاح في الرابط، يلصق المستخدم المفتاح في حوار magpie، كما تقول الوثائق الرسمية؛ لا يُحفظ شيء حتى يُضغط على Add. في الطرفية، لا يعرض magpie import دون مفتاح سوى ما سيُضاف ولا يحفظ شيئًا (اختُبر في 2026-10-27)، لذا ينبغي لمستخدمي الطرفية استخدام الخيار ب. لاستبدال مفتاح مزوّد محفوظ، شغّل magpie provider key qcode cr_xxx.
تحتاج روابط الاستيراد إلى magpie 0.1.8 أو أحدث. المعاملات التي يقبلها رابط الاستيراد، كما تسردها صفحة الاستيراد الرسمية:
| المعامل | المعنى (رسمي) |
|---|---|
name أو preset |
الاسم الذي يُعرف به المزوّد في magpie، بحد أقصى 80 حرفًا؛ ويستخدم معرّف preset نقاط النهاية التي يعرفها magpie مسبقًا |
chat |
Base URL الخاص بـ OpenAI Chat Completions، وينتهي بـ /v1 (يضيف magpie /chat/completions) |
responses |
Base URL الخاص بـ OpenAI Responses، وينتهي بـ /v1 |
anthropic |
Base URL الخاص بـ Anthropic Messages: الجذر، دون /v1 |
gemini |
Base URL الخاص بـ Google Gemini API، وينتهي بـ /v1beta |
key |
مفتاح API الخاص بالمستخدم؛ احذفه ويلصق المستخدم مفتاحًا في الحوار |
models |
معرّفات النماذج التي تُعرض على الوكلاء، مفصولة بفواصل |
id |
المعرّف الذي يستخدمه الوكلاء في id/model؛ القيمة الافتراضية هي الاسم، بأحرف صغيرة وشرطات |
catalog |
معرّف مزوّد models.dev الذي تنطبق بياناته الوصفية (أسماء العرض، وأحجام السياق، ومستويات الاستدلال، والأسعار) |
website، keys |
موقعك، والصفحة التي ينشئ فيها المستخدمون المفاتيح (https) |
icon |
صورة خاصة بك (https)، بحد أقصى 1 MB |
balance، balance_path، balance_method |
من أين يُقرأ رصيد المفتاح، وأين يكون المبلغ في رد JSON، وGET أو POST |
region |
مع preset له مناطق، أي منطقة |
مطلوب واحد على الأقل من chat وresponses وanthropic وgemini عند غياب preset. يجب أن تكون Base URLs من نوع https، باستثناء http العادي إلى localhost وloopback والعناوين الخاصة و*.local. نصيحة صفحة الاستيراد نفسها بشأن المفاتيح: يجب ألا تحمل صفحة عامة مثل README مفتاحًا أبدًا؛ احذف key ويلصق المستخدم مفتاحه الخاص. رابط QCode أعلاه يتبع ذلك.
الخيار ب: أمر واحد في الطرفية (مُختبر)
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
اختُبر مع magpie 0.1.3533 في 2026-11-10: يضيف الأمر المزوّد دفعة واحدة (✓ added QCode (qcode)) ويجلب قائمة النماذج من QCode؛ ثم يعرض magpie provider qcode عناوين chat وresponses وanthropic. ويسرد magpie providers كل مزوّديك.
الخيار ج: التطبيق
افتح علامة التبويب Providers، واضغط + Add provider، واختر Custom (التسمية الرسمية: Custom · any compatible URL)، وأدخل Name، وBase URL متوافقًا مع OpenAI (ينتهي بـ /v1) و/أو قاعدة متوافقة مع Anthropic (الجذر)، ثم المفتاح، واحفظ.
اختيار النماذج¶
magpie claude qcode/claude-sonnet-5-5 # main model
magpie claude opus qcode/claude-opus-5-5 # the opus slot in Claude Code
magpie codex qcode/gpt-6.1-sol # Codex
magpie claude default # restore the previous Claude Code setup
magpie codex default # restore the previous Codex setup
يكتب magpie عنوان البوابة المحلية في ~/.claude/settings.json (ANTHROPIC_BASE_URL هو http://127.0.0.1:3425) إلى جانب token magpie؛ ويبقى مفتاح QCode في magpie ولا يُكتب في إعدادات Claude Code. تعيين النموذج الرئيسي فقط يعيّن أيضًا خانة opus إلى النموذج نفسه؛ لوضع Opus في خانة opus، شغّل magpie claude opus qcode/claude-opus-5-5 بشكل منفصل. يعيّن magpie خانة haiku إلى qcode/claude-haiku-5-5 تلقائيًا.
من دون models= عند إضافة المزوّد، يعرض magpie أول 24 من نماذج القائمة فقط (اختُبر مع magpie 0.1.3533 في 2026-11-10: 24 exposed of 28). اختر النماذج التي تريد عرضها باستخدام magpie provider models qcode <id> <id> …. من دون +، تحل المعرّفات التي تعطيها محل القائمة كاملة (يُظهر الإخراج the ids given are now the whole list)؛ ويضيف magpie provider models qcode +<model> نموذجًا واحدًا ويبقي الباقي. على سبيل المثال:
magpie provider models qcode gpt-6.1-sol gpt-6.1-terra gpt-5.6-sol \
claude-opus-5-5 claude-sonnet-5-5 claude-haiku-5-5
magpie provider models qcode +glm-5.3
magpie providers
المعرّفات الموصى بها: gpt-6.1-sol، وgpt-6.1-terra، وgpt-5.6-sol، وclaude-opus-5-5، وclaude-sonnet-5-5 وclaude-haiku-5-5؛ مع وضع معرّف GPT أولًا، يُظهر magpie provider test qcode ✓ في الأسطر الثلاثة كلها (انظر التحقق). النماذج المعروضة للبيع مدرجة في https://qcode.cc/models. الفوترة حسب token، وسعر كل نموذج مدرج في https://qcode.cc/models.
التحقق¶
magpie healthcheck
magpie provider test qcode
يخرج magpie healthcheck بالرمز 0 ما دامت البوابة تستجيب؛ وعند عدم تشغيل أي بوابة يطبع magpie: no gateway at http://127.0.0.1:3425: … ويخرج بالرمز 1 (اختُبر مع magpie 0.1.3533 في 2026-11-10؛ الأمر يعمل رغم أن magpie --help لا يدرجه). يرسل magpie provider test qcode طلبًا صغيرًا واحدًا إلى كل من chat وresponses وanthropic ويعرض زمن الاستجابة.
مع وضع نموذج GPT أولًا في القائمة، كما في المثال أعلاه، تُظهر الأسطر الثلاثة كلها ✓ ويخرج الأمر بالرمز 0؛ ويختار سطر anthropic نموذج Claude من تلقاء نفسه (اختُبر مع magpie 0.1.3533 في 2026-11-10). عندما يكون النموذج الأول نموذج Claude، يُظهر سطرا chat وresponses ✗ مع 400 · Model 'claude-haiku-5-5' is not available on this endpoint. ويخرج الأمر بالرمز 1. هذا سلوك QCode كما صُمم: لا يُقدَّم Claude إلا عبر نقطة نهاية Anthropic Messages، لذا فإن ✓ في سطر anthropic تعني مع ذلك أن Claude يعمل.
بعد ذلك أرسل «ping» في Claude Code واطلب من Codex قراءة ملف. كما اختُبر مع magpie 0.1.1677 في 2026-10-27، طلبات Claude عبر magpie تطابق اتصالًا مباشرًا بـ QCode، والتخزين المؤقت للـ prompt يعمل كالمعتاد، ويستخدم Codex واجهة Responses API.
العملاء الذين يعرفهم magpie¶
يسرد README الخاص بـ magpie الوكلاء الذين يمكنه ربطهم. ومن بين من توجد له أدلة إعداد على هذا الموقع أو يسأل عنه مستخدمو QCode: Claude Code وCodex وOpenCode وZCode وQoder وCodeBuddy وWorkBuddy وKimi Code وMiniMax Code وDeepSeek Harness وT3 Code (قائمة README أطول). يعرض magpie فقط الوكلاء المثبتين على جهازك، واختيار نموذج في magpie يكتبه في إعدادات ذلك الوكيل نفسه. يوضح المرجع الملف الذي يُربط من خلاله كل واحد:
| العميل | ما يكتبه magpie إليه (وفقًا للمرجع) |
|---|---|
| Claude Code | ~/.claude/settings.json |
| Codex | ~/.codex/config.toml |
| ZCode | ~/.zcode/v2/provider_config.json وconfig.json |
| WorkBuddy | ~/.workbuddy/models.json (النسخة الدولية: ~/.workbuddy-ai/models.json) |
| CodeBuddy | ~/.codebuddy/models.json |
| Kimi Code | ~/.kimi/config.toml |
| MiniMax Code | ~/.minimax/config.yaml |
| Qoder (CLI) | ~/.qoder/settings.json (يشير المرجع إلى أنه يحتاج إلى خطة Qoder مع BYOK) |
صف Kimi Code هو صياغة المرجع؛ تسمّي وثائق Kimi Code CLI الخاصة ~/.kimi-code/config.toml بوصفه ملف الإعدادات الحالي (~/.kimi/config.toml كان يخص kimi-cli الأقدم)، راجع Kimi Code.
الأدلة على هذا الموقع: Codex، ZCode، Qoder، CodeBuddy، MiniMax Code، Kimi Code، DeepSeek Harness، T3 Code، WorkBuddy وOpenCode. أي شيء آخر يقبل Base URL يمكنه استخدام البوابة أيضًا؛ يعطي README هذه المتغيرات:
export OPENAI_BASE_URL=http://127.0.0.1:3425/v1 OPENAI_API_KEY=magpie
export ANTHROPIC_BASE_URL=http://127.0.0.1:3425 ANTHROPIC_API_KEY=magpie
تظهر نماذج QCode في هؤلاء العملاء بصيغة qcode/<model id>. وكما في جدول البروتوكول أعلاه، تُقدَّم نماذج Claude على عنوان anthropic وGPT على chat / responses.
كثرة النماذج: مجموعات التوجيه¶
عندما تطول قائمة النماذج، تضع مجموعة التوجيه عدة نماذج خلف اسم واحد. يعرّفها المرجع الرسمي هكذا: المجموعة هي عدة نماذج يختارها الوكيل كنموذج واحد، group/<id>. في رد على X بتاريخ 2026-11-05، وصف مؤلف magpie الاستخدام: أنشئ مجموعة في صفحة التوجيه، وأضف النموذج نفسه من كل مزوّد إليها، واختر تلك المجموعة فقط في الوكيل، فيبدّل magpie حسب الترتيب أو السرعة أو الحصة؛ ويمكن أيضًا ضبط مزوّد على «المرور عبر مجموعات التوجيه فقط» كي تبقى قائمة النماذج مرتبة. يسمي المرجع ذلك الخيار المرور عبر مجموعات التوجيه فقط: «للاحتفاظ بمزوّد كامل لمجموعات التوجيه، استخدم خيار المرور عبر مجموعات التوجيه فقط الخاص به بدلًا من ذلك.»
من الطرفية، صيغة الأمر في الوثائق الرسمية هي magpie group add "<name>" models=… routing=order، ثم magpie claude group/<id>. مع نماذج QCode:
magpie group add "Daily coding" \
models=qcode/claude-sonnet-5-5,qcode/claude-opus-5-5 routing=order
magpie claude group/daily-coding
تتضمن أوضاع التوجيه order («استخدم النموذج الأول حتى يتعذر عليه الإجابة، ثم الذي يليه») وrotate («انتقل إلى العضو التالي في كل دور») وusage («استخدم العضو الأقل استخدامًا أولًا»). لم نشغّل مثال المجموعة هذا بأنفسنا؛ إنه يتبع الصياغة الموثقة. تُقدَّم نماذج Claude على عنوان anthropic، لذا تستخدم مجموعة Claude Code نماذج Claude.
لفريق أو لعدة حواسيب: مفاتيح البوابة، والمشاركة عبر الشبكة المحلية، والنسخ الاحتياطي والمزامنة¶
مفاتيح البوابة. تشير الوثائق إلى أن البوابة تصدر مفاتيح بوابة للعملاء، منفصلة عن مفاتيح API الخاصة بمزوّديك. فعّل الإعدادات → الشبكة والمشاركة → المشاركة على الشبكة المحلية، ثم افتح البوابة → مفاتيح البوابة → إضافة مفتاح بوابة وأنشئ مفتاحًا مسمّى لكل عميل. من الطرفية:
magpie gateway-key add team-a
magpie gateway-key list
magpie gateway-key limit team-a week --tokens 2m --cost 5
magpie gateway-key models team-a qcode/*
يمكن أن يكون لكل مفتاح حدّه الخاص (tokens، أو تكلفة تقديرية، أو كليهما، لكل يوم أو أسبوع أو شهر، أو كل N يوم أو ساعة) وقائمة النماذج الخاصة به. تضيف إجابة المؤلف على المسألة #1496 (المغلقة في 2026-10-12) أن الاستخدام يُحتسب لكل مفتاح: الاستخدام → نظرة عامة → مفاتيح البوابة يجمع tokens والتكلفة حسب المفتاح، ويمكن في الاستخدام → الطلبات التصفية حسب المفتاح، ويحتوي ملف CSV المصدَّر على العمودين caller_key_id وcaller_key_name. يبقى مفتاح QCode داخل magpie؛ يحصل أعضاء الفريق على مفاتيح البوابة، لا على مفتاح QCode.
الفحص الذاتي للاستخدام وتدوير المفاتيح. يمكن لعضو الفريق الذي يملك مفتاح بوابة أن يفتح /me في متصفح على العنوان الذي يصل به إلى البوابة (على سبيل المثال http://192.168.1.10:3999/me)، ويكتب مفتاحه، ويرى حدود ذلك المفتاح، واستخدامه خلال اليوم و7 أيام و30 يومًا، والنماذج التي يجوز له استخدامها، وإعدادًا جاهزًا للنسخ لـ Claude Code وCodex وأي عميل متوافق مع OpenAI؛ ولا تعرض الصفحة شيئًا عن المفاتيح أو المزوّدين الآخرين. تعرض البوابة → مفاتيح البوابة ذلك العنوان مع زر نسخ، بحيث يمكنك توزيعه مع المفاتيح. يمكن إعادة تسمية كل مفتاح بوابة أو تعطيله أو تدويره أو إزالته بشكل مستقل: يحافظ التدوير على الاسم وحالة التمكين والحدود وسجل الاستخدام، وتؤدي إزالة المفتاح إلى إبطال وصوله عن بُعد.
magpie الخاص بحاسوب آخر. تصف الوثائق magpie واحدًا يخدم عدة حواسيب: شاركه على الشبكة، ثم أضفه على كل حاسوب آخر بوصفه magpie بعيدًا، على سبيل المثال magpie provider add remote-magpie sk-magpie-… url=http://192.168.1.20:3425 id=office. يبقى magpie الخاص بكل حاسوب هو الذي يربط وكلاءه.
Docker. لخادم أو NAS، تعطي الصفحة الرسمية Docker الصورة ghcr.io/yetone/magpie والمنفذين 3425 (البوابة التي يستدعيها الوكلاء) و3430 (واجهة المستخدم في المتصفح). يجب أن يحمل الطلب القادم من خارج الحاوية مفتاح بوابة ممكّنًا، والطلب الذي لا يحمله يحصل على 401. أنشئ مفتاحًا باستخدام docker exec magpie magpie gateway-key add "Docker client".
النسخ الاحتياطي والمزامنة. الأوامر الواردة في الوثائق:
magpie backup # asks for a passphrase twice
magpie backup --no-keys ~/b.magpie-backup # no API keys in it
magpie restore magpie.magpie-backup # on the other machine
يُشفَّر الملف على جهازك (AES-256-GCM، والمفتاح مشتق من عبارة المرور باستخدام PBKDF2-SHA256). تُبقي الإعدادات → المزامنة والنسخ الاحتياطي النسخة الاحتياطية نفسها على مجلد WebDAV (تذكر الوثائق Nextcloud وSynology ضمن أمور أخرى)، أو حاوية S3، أو مستودع GitHub خاص، وتحدّث كل جهاز كل 3 دقائق أثناء تشغيل البوابة؛ ولا يخزّن الخادم سوى النص المشفّر. في المسألة #28 (المغلقة في 2026-09-25) كتب المؤلف أن مزامنة WebDAV وصلت في v0.1.76 وأن عبارة المرور نفسها تُستخدم على الحواسيب الأخرى. تبقى إعدادات الوكيل وحجم النافذة خاصة بكل حاسوب.
الانتقال من CC Switch¶
يقول README إن Import يجلب المزوّدين من CC Switch وClaude Code وCodex وAlma، وتقول صفحة البدء الرسمية إن Import… يقرأ settings.json الخاص بـ Claude Code وconfig.toml الخاص بـ Codex، ولا يغيّر شيئًا فيهما، وينقل المزوّدين الذين تحدّدهم. وفي رد على X بتاريخ 2026-11-09 كتب مؤلف magpie أن إعداد CC Switch يمكن استيراده بنقرة واحدة، وأن استخدامهما معًا يعمل أيضًا. وبما أنك تضيف QCode بالعناوين الثلاثة أعلاه، فإن إعادة إضافته عبر رابط الاستيراد سريعة بالقدر نفسه.
ثمة أمر يجب معرفته عن سجل Codex: وصفت المسألة #887 (المغلقة في 2026-10-14) أنه بعد الانتقال إلى magpie، لم تعد قائمة محفوظات Codex تعرض الجلسات المنشأة تحت مزوّد CC Switch (وكانت الملفات لا تزال موجودة)، وطالبت بترحيل يدوي. جواب المؤلف: في v0.1.999 (2026-10-05)، يسرد Sessions → Codex الجلسات المنشأة تحت مزوّد آخر، ويغيّر Move to magpie… علامة المزوّد فقط بعد نسخ الملفات احتياطيًا، ويعيد Undo تلك الجلسات؛ وأضاف المؤلف أن هذا الإصدار لم يُشغَّل بعد على سجل CC Switch حقيقي. للحصول على دليل خطوة بخطوة، راجع الترحيل من CC Switch إلى magpie؛ وللاطلاع على مقارنة جنبًا إلى جنب، راجع magpie مقابل CC Switch: كيف تختار.
الأسئلة الشائعة¶
غيّرت النموذج، لكن وكيل البرمجة ما زال يستخدم النموذج القديم¶
تحتفظ الجلسة قيد التشغيل بما بدأت به. ابدأ جلسة جديدة؛ وبالنسبة إلى Codex، أعد تشغيل تطبيق Codex أيضًا. هذا هو الجواب الرسمي في دليل البدء.
كيف ألغي تثبيت magpie؟¶
شغّل curl -fsSL https://usemagpie.ai/install.sh | sh -s -- --uninstall؛ فهو يعيد وكلاءك إلى ما كانوا عليه قبل أن يزيل البرنامج. وتبقى إعداداتك في ~/.config/magpie ما لم تضف --purge. التفاصيل في قسم التثبيت.
يتعذر على Claude Code الاتصال عندما لا تكون البوابة قيد التشغيل¶
شغّل magpie healthcheck أولًا: يعني رمز الخروج 0 أن البوابة تستجيب، ويعني رمز الخروج 1 مع magpie: no gateway at http://127.0.0.1:3425 أنها ليست قيد التشغيل. تعمل البوابة مع التطبيق، وإغلاق النافذة يبقيها في شريط القوائم أو علبة النظام. يمكنك أيضًا تشغيل magpie serve للبوابة وحدها، أو magpie daemon install للإبقاء عليها كخدمة (systemd على Linux، وlaunchd على macOS).
هل تعني أسطر 400 الخاصة بـ chat وresponses في magpie provider test qcode إعدادًا خاطئًا؟¶
لا، ما دام سطر anthropic يحمل ✓. عندما يكون أول نموذج في القائمة نموذج Claude، يرسله الاختبار إلى chat وresponses أيضًا، وترفضه QCode هناك بحسب التصميم لأن نماذج Claude تُقدَّم فقط على نقطة النهاية Anthropic Messages. ضع نموذج GPT أولًا، كما في magpie provider models qcode gpt-6.1-sol … أعلاه (تصبح المعرّفات التي تعطيها القائمة كاملة)، وتصبح الأسطر الثلاثة كلها ✓.
لماذا لا أرى سوى بعض النماذج؟¶
من دون models= عند الإضافة، لا يكشف magpie إلا عن أول 24 (24 exposed of 28 في 2026-11-10). يستبدل magpie provider models qcode <id> … القائمة بالمعرّفات التي تعطيها، ويضيف magpie provider models qcode +<model> واحدًا ويبقي الباقي، ويبيّن magpie providers عدد النماذج التي يكشف عنها كل مزوّد. توجد قائمة النماذج المعروضة للبيع في https://qcode.cc/models.
كيف أستعيد إعداد Claude Code السابق؟¶
شغّل magpie claude default، أو اختر أحد نماذج الوكيل الخاصة به في أداة الاختيار. يزيل magpie ما كتبه ويستعيد القيم التي استبدلها.
كيف أغيّر جهد الاستدلال في Codex؟¶
استخدم magpie codex effort <level>، على سبيل المثال magpie codex effort high؛ ويعرض magpie codex effort القيمة الحالية. كما يعمل إعطاء المستوى وحده، على سبيل المثال magpie codex xhigh.
ما المقصود بإخفاء الخصوصية، وهل هو مفعّل افتراضيًا؟¶
إنه معطّل افتراضيًا؛ فعّله في الإعدادات → الخصوصية. تتحول مفاتيح API والمفاتيح الخاصة وtokens وعناوين البريد الإلكتروني وأرقام البطاقات والهويات التي يتحقق مجموعها الاختباري إلى عناصر بديلة مثل {{API_KEY_k3v9x2mq}} قبل أن يغادر الطلب جهازك، ثم تُعاد في الرد؛ وتُحفظ القيم في الذاكرة فقط.
كيف أوقف عدّ الاستخدام المجهول؟¶
أوقف خيار «عدّني مستخدمًا» في الإعدادات → الخصوصية، أو عيّن DO_NOT_TRACK=1 / MAGPIE_NO_STATS=1. ترسل نسخة magpie الصادرة مرة واحدة يوميًا دفعة مجهولة واحدة تتضمن معرّفًا عشوائيًا يُنشأ على جهازك، وإصداره ونظامه، والمعرّفات المدمجة للوكلاء والمزوّدين والنماذج التي يُستخدم معها.
مواضيع ذات صلة¶
- CC Switch: أداة سطح مكتب تكتب نقطة النهاية والمفتاح في إعدادات كل عميل
- Codex: صيغة Responses في
~/.codex/config.toml - نقاط النهاية ومسارات API: البروتوكولات الثلاثة ونطاقات الوصول الثلاثة
- متغيرات البيئة: كيف تُستخدم
ANTHROPIC_BASE_URLوالمتغيرات المشابهة
ابدأ مع QCode
مفتاح API واحد لـ Claude Code وCodex وغيرها — تُحسب حسب التوكن، وأسعار كل نموذج على qcode.cc/models