# إعداد magpie مع 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](https://usemagpie.ai) · [الوثائق](https://usemagpie.ai/docs/start) · [روابط الاستيراد](https://usemagpie.ai/docs/import) · [Docker](https://usemagpie.ai/docs/docker) · [المرجع](https://github.com/yetone/magpie/blob/main/docs/reference.md) |

## ما هو magpie، وكيف يختلف عن CC Switch

يشغّل magpie بوابة على جهازك (`127.0.0.1:3425`). وهو يدعم واجهات API الخاصة بـ OpenAI وAnthropic وGemini ويترجم بينها، بما في ذلك البث واستدعاءات الأدوات. عندما تختار نموذجًا لوكيل في magpie، يكتب magpie ذلك النموذج في ملف إعداد الوكيل نفسه. لذلك يتصل Claude Code وCodex بالبوابة المحلية؛ ويبقى مفتاح QCode الخاص بك في magpie، وتُمرّر البوابة كل طلب إلى QCode.

الفرق البنيوي عن [CC Switch](/docs/ide/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.
## التثبيت

المثبّت الرسمي:

```bash
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`، على سبيل المثال:

```bash
curl -fsSL https://usemagpie.ai/install.sh \
  | sh -s -- --proxy http://127.0.0.1:7890
```

**إلغاء التثبيت.** السطر الرسمي هو:

```bash
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 أعلاه يتبع ذلك.

**الخيار ب: أمر واحد في الطرفية (مُختبر)**

```bash
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 (الجذر)، ثم المفتاح، واحفظ.
## اختيار النماذج

```bash
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>` نموذجًا واحدًا ويبقي الباقي. على سبيل المثال:

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

## التحقق

```bash
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](/docs/ide/kimi-code).

الأدلة على هذا الموقع: [Codex](/docs/ide/codex)، [ZCode](/docs/ide/zcode)، [Qoder](/docs/ide/qoder)، [CodeBuddy](/docs/ide/codebuddy)، [MiniMax Code](/docs/ide/minimax-code)، [Kimi Code](/docs/ide/kimi-code)، [DeepSeek Harness](/docs/ide/deepseek-harness)، [T3 Code](/docs/ide/t3code)، [WorkBuddy](/docs/ide/workbuddy) و[OpenCode](/docs/ide/opencode). أي شيء آخر يقبل Base URL يمكنه استخدام البوابة أيضًا؛ يعطي README هذه المتغيرات:

```bash
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:

```bash
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 الخاصة بمزوّديك. فعّل الإعدادات → الشبكة والمشاركة → المشاركة على الشبكة المحلية، ثم افتح البوابة → مفاتيح البوابة → إضافة مفتاح بوابة وأنشئ مفتاحًا مسمّى لكل عميل. من الطرفية:

```bash
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](https://usemagpie.ai/docs/docker) الصورة `ghcr.io/yetone/magpie` والمنفذين 3425 (البوابة التي يستدعيها الوكلاء) و3430 (واجهة المستخدم في المتصفح). يجب أن يحمل الطلب القادم من خارج الحاوية مفتاح بوابة ممكّنًا، والطلب الذي لا يحمله يحصل على 401. أنشئ مفتاحًا باستخدام `docker exec magpie magpie gateway-key add "Docker client"`.

**النسخ الاحتياطي والمزامنة.** الأوامر الواردة في الوثائق:

```bash
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](https://qcode.cc/en/magpie-migrate-from-cc-switch)؛ وللاطلاع على مقارنة جنبًا إلى جنب، راجع [magpie مقابل CC Switch: كيف تختار](https://qcode.cc/en/magpie-vs-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](/docs/ide/cc-switch): أداة سطح مكتب تكتب نقطة النهاية والمفتاح في إعدادات كل عميل
- [Codex](/docs/ide/codex): صيغة Responses في `~/.codex/config.toml`
- [نقاط النهاية ومسارات API](/docs/getting-started/endpoints-and-api-paths): البروتوكولات الثلاثة ونطاقات الوصول الثلاثة
- [متغيرات البيئة](/docs/getting-started/environment): كيف تُستخدم `ANTHROPIC_BASE_URL` والمتغيرات المشابهة