ربط Cursor / Claude Code / Cherry Studio ببوابة AI مخصصة
الأدوات الذكية الرئيسية كلها تدعم API المخصص — أي يمكنك توجيهها إلى بوابتك الخاصة (مثل 4-4 AI) وتوحيد المفاتيح والفوترة. تغطي هذه المقالة إعداد أدوات الاستخدام الأوسع الثلاث والمنهج العام لتشخيص الأخطاء.
https://www.4-4.vip/v1)، وبوابات OpenAI المتوافقة الأخرى تعمل بالطريقة نفسها.Cursor
نموذج المحادثة في Cursor يمكن أن يعمل عبر واجهة مخصصة متوافقة مع OpenAI:
- افتح
Settings → Models(أو صفحة إعداداتModels)؛ - وسّع منطقة
OpenAI API Key: أدخل مفتاح البوابة (sk-...)؛ - علّم/املأ
Override OpenAI Base URL:https://www.4-4.vip/v1؛ - أضف إلى قائمة النماذج الأسماء المتاحة في بوابتك (مطابقة تمامًا لأسماء قنوات البوابة، مع حساسية لحالة الأحرف)؛
- بعد نجاح التحقق Verify، بدّل في أسفل المحادثة إلى النموذج المخصص فقط.
ملاحظة: الإكمال Tab المدمج في Cursor وجزء من Composer يسيران عبر خدمة Cursor الذاتية ولا تتأثر بهذا الإعداد؛ النماذج المخصصة تُستخدم أساسًا في المحادثة.
Claude Code
يستخدم Claude Code بروتوكول Anthropic. شرط المرور عبر البوابة أن تدعم البوابة نقطة نهاية بروتوكول Anthropic (/v1/messages) — البوابات المبنية على منظومة new-api (ومنها 4-4 AI) تدعم هذا التحويل؛ تُحوَّل طلبات بروتوكول Claude ثم تُوجَّه إلى قناة النموذج الفعلية.
الإعداد عبر متغيرات البيئة (في الطرفية التي تشغّل claude من خلالها):
export ANTHROPIC_BASE_URL="https://www.4-4.vip"
export ANTHROPIC_AUTH_TOKEN="sk-YOUR_GATEWAY_KEY"
# start
claude
وفي Windows PowerShell:
$env:ANTHROPIC_BASE_URL = "https://www.4-4.vip"
$env:ANTHROPIC_AUTH_TOKEN = "sk-YOUR_GATEWAY_KEY"
Cherry Studio
Cherry Studio هو الأكثر مباشرةً في دعم المزودين المخصصين المتوافقين مع OpenAI:
الإعدادات ← خدمات النماذج: أضف/اختر مزودًا متوافقًا مع OpenAI؛- عنوان API:
https://www.4-4.vip/v1(بعض الإصدارات تكمل /v1 تلقائيًا، انتبه إلى التكرار)؛ - مفتاح API: مفتاح البوابة؛
- أضف يدويًا أسماء النماذج المتاحة في إدارة النماذج، ثم اخترها في المحادثة بعد الحفظ.
القاعدة العامة: أي أداة متوافقة مع OpenAI
عشرات الأدوات (LobeChat وOpen WebUI وImmersive Translate وإضافات IDE المختلفة) تتبع المخطط نفسه في الإعداد — احفظ الثلاثية:
| عنصر الإعداد | القيمة | فخاخ شائعة |
|---|---|---|
| Base URL | https://www.4-4.vip/v1 | بعض الأدوات تحتاج /v1 وبعضها لا — عند ظهور 404 جرّب بإضافة /v1 وإزالتها |
| API Key | مفتاح البوابة (sk-...) | مسافات في البداية أو النهاية، مفتاح منتهٍ، رصيد مستنفد |
| اسم النموذج | الاسم كما هو في قناة البوابة | يجب أن يطابق جانب البوابة تمامًا؛ الأسماء غير الموجودة في إعدادات الأداة المسبقة لن تعمل |
دليل سريع للأخطاء
401 Unauthorized
- دخلت مسافات/فواصل أسطر مع نسخ المفتاح ← انسخه من جديد؛
- المفتاح معطل أو الرصيد منتهٍ ← راجع صفحة الرموز في لوحة تحكم البوابة؛
- صيغة ترويسة Authorization خاطئة ← يجب أن تكون
Bearer sk-....
404 Not Found
- مسار Base URL خاطئ ← جرّب بالتبديل بين «مع /v1» و«بدون /v1»؛
- نقطة نهاية البروتوكول المطلوبة غير مدعومة ← تأكد أن البوابة تدعم البروتوكول (OpenAI /v1/chat/completions أو Anthropic /v1/messages).
400 Model Not Found / لا قناة متاحة
- اسم النموذج لا يطابق قناة البوابة ← قارن الأسماء في صفحة النماذج/القنوات بلوحة التحكم؛
- القناة معطلة أو المجموعة بلا صلاحيات ← راجع نطاق النماذج وإعدادات مجموعة الرمز.
التدفق ينقطع / لا استجابة
- بروكسي الشركة يخزن SSE مؤقتًا ← جرّب على اتصال مباشر؛
- مهلة الأداة قصيرة جدًا ← أطلها؛ في المهام الطويلة تأكد أولًا من عدم فرض مهلة من جانب البوابة.
الأسئلة الشائعة (FAQ)
هل بياناتي آمنة عند المرور عبر البوابة؟
تنتقل طلباتك عبر البوابة إلى قناة النموذج الأمامية. تحقق من سياسات السجلات والخصوصية للبوابة عند اختيارها؛ ومع البيانات الحساسة أوقف تخزين سجلات المحادثات من جانب البوابة أو استخدم قنوات لا تحتفظ بالبيانات.
هل يمكن إعداد عدة بوابات في أداة واحدة؟
معظم الأدوات تدعم عدة مزودين مع تبديل فوري (مثل Cherry Studio وCursor). وبتعيين رمز مختلف لكل أداة تنفصل أيضًا إحصاءات الاستخدام وحدود الحصص.
لماذا يُنصح ببوابة موحدة بدل اتصال كل أداة مباشرة بمزودها؟
ثلاثة أسباب: إدارة مركزية للمفاتيح (تضييق مساحة التسرب)، فوترة واستخدام مرئيان في مكان واحد (بلا مطابقة بين منصات متعددة)، نماذج قابلة للاستبدال في أي وقت (فصل عن المزود — التغيير يمس إعداد البوابة فقط).
مقالات ذات صلة
مفتاح واحد للاتصال الموحد بنماذج GLM وDeepSeek وQwen وغيرها: فوترة موحدة واستخدام مرئي.
عرض النماذج والأسعار جرّب مجانًا