# إعداد LobeChat

> **آخر تحقق**: 2026-11-12 · 📄 وفق الوثائق الرسمية (LobeHub v2.2.19؛ أُعيد التحقق من جزء نموذج Claude والأسعار الرسمية مقابل صفحتي نظرة عامة على النماذج والأسعار لدى Anthropic في 2026-11-12)

## نظرة سريعة

| العنصر | التفاصيل |
|---|---|
| النماذج التي يمكنك استخدامها | Claude ✅ (مزوّد Anthropic + Proxy URL) · GPT ✅ · النماذج الصينية ✅ (مزوّد OpenAI + Proxy URL) · Gemini ❌ (لا يقدّم QCode سلسلة Gemini — استخدم Claude أو GPT أو نموذجًا صينيًا) |
| البروتوكول وProxy URL | Anthropic Messages: `https://api.qcode.cc/api` · متوافق مع OpenAI: `https://api.qcode.cc/openai/v1` |
| مكان الإعداد | إعدادات التطبيق → مزوّدو الذكاء الاصطناعي، ثم مفتاح API الخاص بالمزوّد المحدد، وعناصر التحكم **Proxy URL** و**تحقّق** |
| مسار الاستضافة الذاتية | متغيرا البيئة `ANTHROPIC_PROXY_URL` و`OPENAI_PROXY_URL` بدلًا من واجهة التطبيق |
| الوثائق الرسمية | [مزوّدو نماذج الذكاء الاصطناعي](https://lobehub.com/docs/usage/providers) |

يُنشر التطبيق اليوم باسم **LobeHub** — ولا يزال نص النظرة العامة الخاص به يقول إن فكرة تعدد النماذج «بدأت بدعم LobeChat للنماذج المتعددة» — لذا فإن موقع الوثائق، وإصدارات سطح المكتب، وصورة `lobehub/lobehub`، وإصدار Community Edition مفتوح المصدر، تندرج جميعها تحت تلك العلامة. ابحث عن LobeChat وستصل إلى LobeHub.

## أي بروتوكول

| النماذج التي تريدها | المزوّد المراد تمكينه | Proxy URL |
|---|---|---|
| Claude (`claude-sonnet-5`، `claude-opus-5`، `claude-haiku-5-5`) | **Anthropic** | `https://api.qcode.cc/api` |
| GPT (`gpt-6-sol`، `gpt-5.6-terra`) | **OpenAI** | `https://api.qcode.cc/openai/v1` |
| النماذج الصينية (`deepseek-v4.1-flash`، `glm-5.3`، `qwen3.8-max`، `kimi-k3`) | **OpenAI** | `https://api.qcode.cc/openai/v1` |

🔴 **لا تستدعِ Claude عبر مزوّد OpenAI أبدًا.** يقدّم QCode Claude على نقطة نهاية Anthropic فقط؛ ويُرفض معرّف `claude-*` على نقطة النهاية المتوافقة مع OpenAI، كما لا تُقدَّم معرّفات `gpt-*` على نقطة نهاية Anthropic أيضًا. مفتاح QCode واحد (`cr_…`) يغطي كلا الإدخالين.

اكتب Proxy URL تمامًا كما في الجدول: **دون شرطة مائلة لاحقة**، ولا تلصق مسار طلب كاملًا مثل `/v1/chat/completions` في ذلك الحقل — يعرّفه LobeHub بأنه «عنوان Base URL الخاص بمزوّد API أو نقطة نهاية متوافقة». ليس موثّقًا ما إذا كان حقل Anthropic يتوقع أي مقطع مسار إضافي، لذا أدخل العنوان الذي يمنحك إياه QCode كما هو. راجع [نقاط النهاية ومسارات API](/docs/getting-started/endpoints-and-api-paths).
## التثبيت

اختر أولًا كيفية تشغيل التطبيق؛ فمكان وجود المفتاح يتبع ذلك.

- **سطح المكتب أو الويب** — «نزّل تطبيق macOS أو Windows أو Linux من صفحة التنزيل الرسمية»؛ نسخة سطح المكتب مبنية على Electron، وفي المتصفح تكتفي بـ«فتح LobeHub في متصفح حديث». اضبطه عبر واجهة التطبيق أدناه.
- **استضافة ذاتية، صورة Docker واحدة** (الأمر الرسمي؛ ويحتوي ملف env على المتغيرات من القسم الفرعي الأخير):

```bash
docker run -it -d -p 3210:3210 --network pg --env-file lobehub.env --name lobehub lobehub/lobehub
```

- **استضافة ذاتية، Docker Compose** (السكربت الرسمي، ثم compose):

```bash
mkdir lobehub && cd lobehub
bash <(curl -fsSL https://lobe.li/setup.sh) -l en
docker compose up -d
```

لتمكين تطبيق سطح المكتب من إدارة نسخة تستضيفها بنفسك، تشترط وثائق سطح المكتب أن «يكون إصدار نسختك المستضافة ذاتيًا 1.83.6 أو أحدث لدعم سطح المكتب» في ميزات الاتصال: انقر أيقونة Wi-Fi في الزاوية العلوية اليمنى، وأدخل عنوان نسختك، ثم اتصل. وتشترط الوثائق نفسها أيضًا أن تكون النسخة «مضبوطة بشكل صحيح باستخدام متغيرات البيئة المرتبطة بـ OIDC» قبل أن تتصل. إصدار الخادم الذي فُحصت هذه الصفحة مقابله هو v2.2.19 (2026-10-07)؛ و1.83.6 هو رقم سطح المكتب الذي استشهدت به تلك الوثائق، وليس الرقم نفسه.

إذن هناك مسارَان في هذه الصفحة: **السحابة وسطح المكتب يستخدمان حقول الواجهة**، **والاستضافة الذاتية يمكنها استخدام متغيرات البيئة**.

## الضبط

توضّح LobeHub صراحةً أن الحقول تعتمد على المزوّد: «افتح App Settings → AI Providers، ثم اختر المزوّد الذي تريد ضبطه. تعتمد الحقول المتاحة على المزوّد». التسلسل الموثّق هو «اختر مزوّدًا من القائمة وشغّل مفتاح التبديل الخاص به»، ثم «أدخل بيانات الاعتماد المعروضة في الصفحة. تستخدم معظم مزوّدات السحابة مفتاح API»، ثم «إذا كان Proxy URL متاحًا، فأدخل Base URL الخاص بـ API المزوّد أو نقطة نهاية متوافقة»، ثم «اختر Check لاختبار الاتصال»، ثم «فعّل نموذجًا في قائمة النماذج. يمكنك أيضًا جلب النماذج أو إضافتها عندما تكون هاتان العمليتان متاحتين». وتضيف الوثيقة أن «تغييراتك تُحفظ تلقائيًا. يمكنك بعد ذلك اختيار المزوّد والنموذج في إعدادات Agent».

هناك حدّان يجدر ذكرهما بوضوح. أولًا، الصياغة شرطية — *إذا كان Proxy URL متاحًا* — لذا لا تدّعي هذه الصفحة أن كل مزوّد يعرض ذلك الحقل، ولا تنشر LobeHub مصفوفة تقارن Cloud بـ Desktop لمن يفعل ذلك. إذا كانت نسختك لا تعرض حقل إدخال Proxy URL لـ Anthropic أو OpenAI، فلا تستطيع هذه الوثيقة إعادة توجيهه. ثانيًا، Cloud وDesktop ليسا نقيضين: «يمكن لتطبيق سطح المكتب استخدام خدمات Cloud ونماذج السحابة».

### ضبط Claude (مزوّد Anthropic)

دليل Anthropic الرسمي، بترتيبه الخاص:

1. «افتح App Settings → AI Providers، واختر Anthropic، وفعّل المزوّد»
2. «أدخل مفتاح API. إذا كنت تستخدم وكيلًا، فأدخل Proxy URL الخاص به» — مفتاح QCode `cr_…` الخاص بك، وProxy URL هو `https://api.qcode.cc/api`
3. «اختر Check لاختبار الاتصال»
4. «فعّل نماذج Claude التي تحتاجها، ثم اختر واحدًا في إعدادات Agent»

اختر المعرّفات من قائمة QCode: `claude-sonnet-5` للعمل اليومي، و`claude-sonnet-5-5`، و`claude-opus-5` أو `claude-opus-5-5` للمهام الصعبة، و`claude-haiku-5-5` للمهام الخفيفة؛ كما تتاح `claude-sonnet-4-6` و`claude-fable-5` و`claude-fable-5-1`. أحدث إصدار من Fable هو `claude-fable-5-2`: أصدرته Anthropic في 2026-11-09 بنافذة سياق سعة 1M token وما يصل إلى 128K token من الإخراج لكل طلب، بسعر رسمي قدره $8 لكل مليون token من الإدخال و$40 لكل مليون token من الإخراج (تم التحقق منه مقابل صفحتي نظرة عامة النماذج والأسعار لدى Anthropic في 2026-11-12)؛ ولا يزال `claude-fable-5-1` السابق متاحًا على QCode، بسعر رسمي قدره $10 للإدخال و$50 للإخراج. تغطي هذه الصفحة إدخالي Anthropic وOpenAI المدمجين فقط؛ وتوثّق LobeHub أدلة مزوّدين آخرين كثيرين، ولم يُتحقق من أي شيء هنا مقابلها.

### ضبط GPT والنماذج الصينية (مزوّد OpenAI)

بالشكل نفسه، خطوات دليل OpenAI نفسها:

1. «افتح App Settings → AI Providers، واختر OpenAI، وفعّل المزوّد»
2. «أدخل مفتاح API. إذا كنت تستخدم وكيلًا أو نقطة نهاية متوافقة، فأدخل Proxy URL الخاص بها» — المفتاح نفسه `cr_…`، وProxy URL هو `https://api.qcode.cc/openai/v1`
3. «اختر Check لاختبار الاتصال»
4. «فعّل نماذج OpenAI التي تحتاجها، ثم اختر واحدًا في إعدادات Agent»

تمرّ معرّفات العائلة الصينية عبر المزوّد نفسه وProxy URL نفسه: `deepseek-v4.1-flash`، `deepseek-v4-pro`، `glm-5.3`، `qwen3.8-max`، `kimi-k3` — راجع [النماذج الصينية](/docs/usage/cn-models). لا تحتاج إلى أدلة DeepSeek أو Qwen أو Moonshot المنفصلة لذلك؛ فإدخال واحد متوافق مع OpenAI يغطي القائمة كاملة. وإذا لم يكن معرّفك في المنتقي المدمج، فأضفه حيث تسمح الوثائق بجلب النماذج أو إضافتها.

### متغيرات البيئة للاستضافة الذاتية

في نشر Docker أو Compose، تُضبط نقطتا النهاية نفساهما لكل مزوّد في ملف env. توثّق الوثائق المرجعية `ANTHROPIC_PROXY_URL` كعنصر «يتجاوز Base URL الافتراضي لطلبات API الخاصة بـ Anthropic» و`OPENAI_PROXY_URL` كعنصر «يتجاوز Base URL الافتراضي لطلبات API الخاصة بـ OpenAI»، ما يجعلهما النظير في الاستضافة الذاتية لحقل Proxy URL في الواجهة:

| المتغير | القيمة الافتراضية الموثّقة | اضبطه على |
|---|---|---|
| `ANTHROPIC_API_KEY` | – | مفتاح QCode `cr_…` الخاص بك |
| `ANTHROPIC_PROXY_URL` | `https://api.anthropic.com` | `https://api.qcode.cc/api` |
| `OPENAI_API_KEY` | – | المفتاح نفسه |
| `OPENAI_PROXY_URL` | `https://api.openai.com/v1` | `https://api.qcode.cc/openai/v1` |
| `OPENAI_MODEL_LIST` | – | المعرّفات التي تريدها، انظر أدناه |
| `ANTHROPIC_CLIENT_TIMEOUT` | `295000` | اتركه كما هو ما لم تُقطع الاستدعاءات الطويلة |

`OPENAI_MODEL_LIST` «يُستخدم للتحكم في قائمة النماذج»: تضيف `+` نموذجًا، وتخفي `-` واحدًا، وتخفي `-all` المجموعة المدمجة أولًا — وهي الصيغة التي تريدها عندما تقدم نقطة النهاية فقط ما تسمّيه:

```bash
ANTHROPIC_API_KEY=cr_your_qcode_key
ANTHROPIC_PROXY_URL=https://api.qcode.cc/api
OPENAI_API_KEY=cr_your_qcode_key
OPENAI_PROXY_URL=https://api.qcode.cc/openai/v1
OPENAI_MODEL_LIST=-all,+gpt-6-sol,+gpt-5.6-terra,+glm-5.3,+deepseek-v4.1-flash
```

يعود كون اللاحقة `/v1` تنتمي إلى القيمة إلى خاصية نقطة النهاية، لا إلى LobeChat — إذ تطلب منك الوثائق أن «تتحقق من لاحقة الطلب لدى مزوّد خدمة الوكيل لديك»، وإذا عاد الرد فارغًا فإنها تقترح إضافة اللاحقة `/v1` وإعادة المحاولة. بالنسبة إلى QCode: تحتفظ قيمة OpenAI بـ `/openai/v1`، وتتوقف قيمة Anthropic عند `/api`. كما توثّق الوثائق المرجعية عناصر لكل مزوّد للخدمات الصينية (`DEEPSEEK_PROXY_URL`، `QWEN_PROXY_URL`، `MOONSHOT_PROXY_URL`)؛ لا توجّه أيًّا منها إلى QCode إلا إذا كنت تريد ذلك عمدًا خلف إدخال ذلك المزوّد.
## التحقق

يوجد الفحص الموثّق في التطبيق: «Select Check to test the connection» في بطاقة المزوّد. **لا تحتوي هذه الصفحة على مفتاح اختبار، لذلك لا يُزعم وجود أي نتيجة HTTP لأي إعداد أعلاه.** إذا فشل **Check**، فأصلح Proxy URL والمفتاح قبل المساس بأي شيء آخر.

للفصل بين مشكلة البوابة ومشكلة التطبيق، استدعِ نقاط النهاية مباشرةً:

```bash
KEY="cr_your_qcode_key"

# Anthropic endpoint — Claude ids only
curl -X POST https://api.qcode.cc/api/v1/messages \
  -H "x-api-key: $KEY" -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":32,"messages":[{"role":"user","content":"ping"}]}'

# OpenAI compatible endpoint — GPT and Chinese ids, never claude-*
curl -X POST https://api.qcode.cc/openai/v1/chat/completions \
  -H "authorization: Bearer $KEY" -H "content-type: application/json" \
  -d '{"model":"gpt-6-sol","messages":[{"role":"user","content":"ping"}]}'
```

تعني استجابة JSON تحتوي على `content` (Anthropic) أو `choices` (OpenAI) أن جهة نقطة النهاية قد استجابت، وأن المشكلة المتبقية تكمن في إعدادات التطبيق. يُحتسب الاستخدام لكل token؛ وتُدرج أسعار كل نموذج على [qcode.cc/models](https://qcode.cc/models).

## استكشاف الأخطاء وإصلاحها / القيود المعروفة

| العَرَض | ما تقوله الوثائق | ما يجب فعله |
|---|---|---|
| إجابة فارغة بعد تعيين `OPENAI_PROXY_URL` | قد تواجه «may encounter a situation where the AI returns an empty message»؛ الإصلاح الموثّق هو إعادة التحقق من المتغير ومن إضافة اللاحقة `/v1` بالشكل «suffix is added correctly (if required)» | أبقِ `https://api.qcode.cc/openai/v1` كما هو تمامًا، دون شرطة مائلة لاحقة |
| رفض معرّف `claude-*` | — | لا يقدّم QCode عائلة Claude على العنوان المتوافق مع OpenAI (`model_not_available_on_endpoint`)؛ انقله إلى مزوّد Anthropic باستخدام `https://api.qcode.cc/api` |
| تُقطع استدعاءات Anthropic الطويلة | `ANTHROPIC_CLIENT_TIMEOUT`، القيمة الافتراضية `295000`، وأن هذه المهلة «is also used by Anthropic-compatible providers that rely on the Anthropic SDK» | ارفعه في الاستضافة الذاتية، فقط للتوليدات الطويلة |
| منشور على Vercel | «حدّ مهلة قدره 10 ثوانٍ لدوال serverless» | حسب قراءتنا: تحتاج الإجابات الأطول من ذلك الحد إلى Docker أو مضيف آخر |
| عدم توفر أحد المزوّدين | «This does not guarantee automatic failover» | اضبط المزوّد الثاني بنفسك وبدّل يدويًا |
| خطأ في الاتصال، رفض المفتاح | «Check your API key for extra spaces. Check that the key type matches the provider» | أعد لصق المفتاح `cr_…`، وتأكد من المزوّد |
| معرّف النموذج الخاص بك ليس في القائمة | «Your account tier can exclude a model, or the provider can retire it» | بالنسبة إلى QCode، أضف المعرّف بنفسك — منتقي النماذج المدمج ليس كتالوج QCode |
| أخطاء حد معدل الطلبات | «You reached the provider's request rate limit» | خفّض معدل الطلبات، أو بدّل المزوّد |

هناك أمران لا يوفّرهما QCode: **gpt-6-luna** و**gpt-5.6-luna** — استخدم نموذج GPT آخر (`gpt-6.1-sol` / `gpt-6-sol` / `gpt-5.6-terra`)؛ و**سلسلة Gemini** — استخدم Claude أو GPT أو نموذجًا صينيًا بدلًا منها. إذا كان عنوان Anthropic الأساسي غير قابل للوصول من عندك، فإن المفتاح نفسه يعمل أيضًا على `https://asia.qcode.cc/api` و`https://us.qcode.cc/api`. لا توثّق LobeHub أيّ إصدار من LobeChat يعرض حقل Proxy URL ولأيّ مزوّد يعرضه، لذا فإن هذا الاختلاف خارج نطاق هذه الصفحة.

## ذات صلة

- [نقاط النهاية ومسارات API](/docs/getting-started/endpoints-and-api-paths) — البروتوكول مقابل عائلة النموذج
- [توافق الأدوات](/docs/ide/tool-compatibility) — ما تتحدثه كل أداة
- [تكامل Cherry Studio](/docs/ide/cherry-studio) — نقاط النهاية نفسها، وحقول تطبيق سطح المكتب
- [إعداد API لطرف ثالث في Claude Desktop](/docs/ide/claude-desktop)
- [النماذج الصينية](/docs/usage/cn-models)
- [دليل اختيار النموذج](/docs/usage/model-selection)
- [استكشاف الأخطاء وإصلاحها](/docs/reference/troubleshooting)